Flutter アプリのビルドとデプロイメント完全ガイド

Flutter アプリを本番環境にリリースする際のビルドプロセスは、開発者にとって重要なステップです。この記事では、Android と iOS 向けのリリースビルドの作成方法と、効率的なワークフローについて詳しく解説します。

基本的なビルドコマンド

Android 向けビルド

1. App Bundle (推奨)

Google Play Store への配布には App Bundle 形式が推奨されています：

flutter clean && flutter pub get && flutter build appbundle --release

このコマンドは以下の処理を順次実行します：

• flutter clean: 既存のビルドファイルを削除
• flutter pub get: 依存関係を取得・更新
• flutter build appbundle --release: リリース用の App Bundle を作成

2. APK ビルド

直接インストールやテスト配布用には APK を使用：

flutter build apk --release

より効率的なビルドのために、ABI ごとに分割することも可能：

flutter build apk --release --split-per-abi

iOS 向けビルド

基本的な iOS ビルド

flutter build ios --release

App Store 配布用

flutter build ipa --release

プロジェクト設定の管理

version の設定

pubspec.yaml でアプリのバージョンを管理：

version: 1.0.0+6

• 1.0.0: ユーザー向けバージョン番号
• 6: ビルド番号（内部管理用）

.gitignore の設定

適切な .gitignore の設定はプロジェクト管理において重要です：

# Flutter/Dart
.dart_tool/
.packages
.pub/
build/
flutter_export_environment.sh

# IDE
*.iml
.idea/
.vscode/

# macOS
.DS_Store

# Android
*.jks
key.properties

# iOS
*.mobileprovision
*.p12
Pods/
ios/Runner.xcworkspace/xcshareddata/
ios/Runner.xcworkspace/xcuserdata/

# その他
*.log
*.zip

効率的なビルドワークフロー

1. クリーンビルドの実行

問題が発生した際は、クリーンビルドを実行：

flutter clean
flutter pub get
flutter build [target] --release

2. マルチプラットフォーム対応

両プラットフォーム向けに一括ビルド：

# Android
flutter build appbundle --release
flutter build apk --release

# iOS  
flutter build ios --release

3. ビルド前のチェック項目

• [ ] バージョン番号の更新
• [ ] 依存関係の最新化
• [ ] テストの実行
• [ ] コードの静的解析

トラブルシューティング

よくある問題と解決方法

ビルドエラーが発生する場合

flutter clean
flutter pub cache repair
flutter pub get

iOS ビルドでの署名エラー

• Xcode での署名設定を確認
• Provisioning Profile の有効期限をチェック

Android ビルドでのキーストアエラー

• key.properties ファイルの設定を確認
• キーストアファイルのパスが正しいかチェック

まとめ

Flutter アプリのビルドプロセスは、適切なコマンドの理解と設定ファイルの管理が重要です。この記事で紹介したワークフローを参考に、効率的なデプロイメントパイプラインを構築してください。

定期的なクリーンビルドの実行と、プラットフォーム固有の設定の確認を怠らないことで、スムーズなリリースプロセスを維持できます。