もし Capacitor Android Gradle Plugin 9 (AGP 9) へのアップグレード後にプラグインのビルドが失敗する場合、軽微ながらも重要な Gradle の設定問題に直面している可能性があります。
この記事では、特に以下のような検索意図に対応しています:
- Capacitor plugin build エラー AGP 9
- Android Gradle Plugin 9 plugin build 失敗
proguard-android.txt見つかりません- AGP 9
getDefaultProguardFileエラー - Capacitor AGP アップグレード後に Android build 失敗
短く言うと:
proguard-android.txtは、AGP 9 のプラグインビルドで参照する安全なデフォルト基準ではなくなりました。- 切り替え先:
proguard-android-optimize.txt. - 再ビルドして確認してください。
長いバージョンも重要です。特に、多数のプラグインや大規模な Capacitor ワークスペースを管理している場合です。本記事では以下を解説します:
- ビルドチェーンにおける Android と AGP の役割
- Capacitor とは何か、プラグインのビルドがどのように動作するか
- とは Capgo とは、なぜリリースの信頼性に重要なのか
- 古いプラグインテンプレートを壊すAGP 9の具体的な変更点
- 1つのリポジトリでも複数でも安全に移行する戦略
この文脈でのAndroidとは?
Androidでは はOSであり、ビルドエコシステムでもあります。AndroidでCapacitorアプリやプラグインをリリースする場合、プロジェクトは以下を経由します:
- Gradle ビルドシステムとして。
- Android Gradle Plugin(AGP) Android固有のGradle統合として。
- AndroidのSDKツールチェーンは、パッケージング、シュリンク、リンティング、および
.aar,.apk、または.aab出力生成を行います。
AGPのバージョンが変わると、デフォルト設定や内部ファイルも変更されることがあります。AGP 8で動作していたプラグイン設定でも、削除または非推奨になったベースラインを参照している場合、AGP 9では失敗する可能性があります。
Capacitorとは?
Capacitor ネイティブAPIを呼び出しつつ、Web code(TypeScript、JavaScript、HTML、CSS)でiOS/Androidアプリを構築できるクロスプラットフォームランタイムです。
Capacitorアプリには通常、以下が含まれます:
- Webレイヤー(UIとビジネスロジック)
- Native shell(
ios/,android/) - JavaScriptにネイティブ機能を公開するプラグイン
各プラグインには独自の Native Build 設定があります。Android の場合、各プラグインには android/build.gradle AGP が正しく解析・コンパイルする必要があるファイルが含まれています。
プラグインの Gradle 設定が古いと、Web 側の code が正しくても、アプリ全体のビルドが失敗することがあります。
Capgo とは?
Capgo Capacitor の配信と運用に関するツールを提供します:
- Live Updates Web bundle の変更用
- プラグインエコシステムとネイティブ機能パッケージ
- Capacitor チーム向けの CI/CD フレンドリーなアップデートワークフロー
Live Updatesを利用していても、Native Buildの安定性は不可欠です。クリーンなAndroidビルドが依然として必要なケース:
- App Store / Play Storeへのリリース
- ネイティブプラグインのアップグレード
- プラットフォーム SDK の移行
- チームのオンボーディングとCIの信頼性
だからこそ、AGP 9への互換性修正が重要です。プラグイン層の信頼性を保ち、デリバリーパイプラインを予測可能に保てます。
なぜAGP 9で古いプラグイン設定が壊れるのか
多くのプラグインテンプレートは従来、以下を使用していました:
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
AGP 9の環境では、古いテンプレートや設定が想定する場所に古いファイルが存在する保証がなくなるため、この従来のベースライン参照が失敗することがあります。
典型的な症状は、次のフェーズでのGradleエラーです: assemble, lint、または build 多くの場合、ProGuardベースラインリソースの不足や無効なデフォルトファイル参照を指します。
簡単な背景:ProGuard、R8、baselineファイル
- R8 はAndroidビルドにおける最新のcode shrinker/optimizerです。
proguard-rules.proはプロジェクト/プラグインのカスタムkeepルールです。getDefaultProguardFile(...)はAndroidが提供するbaselineを注入します。
以下を参照する場合:
proguard-android.txt-> レガシーな最小限のbaselineproguard-android-optimize.txt-> モダンで最適化されたbaseline(現在の構成における推奨デフォルト)
AGP 9に対応するには、以下に切り替えるのが proguard-android-optimize.txt 現実的な解決策です。
1行の修正
プラグインとアプリモジュールのGradleファイルを更新してください:
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
最低限、以下を確認してください:
android/build.gradle各プラグインでexample-app/android/app/build.gradleプラグインのリポジトリで- 新しいプラグインの Gradle 設定を作成するジェネレーター/テンプレートファイル
1つのプラグインの移行ガイド
1. 古い参照を見つける
rg -n "proguard-android\\.txt" android example-app
2. 置き換える
perl -pi -e "s/proguard-android\\.txt/proguard-android-optimize.txt/g" \
android/build.gradle example-app/android/app/build.gradle
3. Bunで検証する
bun run verify:android
プラグインに完全な検証スクリプトがある場合は、以下を実行します:
bun run verify
全プラグインリポジトリを一括更新
1つのワークスペースで多くのプラグインリポジトリを管理している場合は、自動化しましょう:
rg -l "proguard-android\\.txt" capacitor-* \
--glob '!**/node_modules/**' \
--glob '!**/.gradle/**' \
--glob '!**/build/**' \
| xargs perl -pi -e "s/proguard-android\\.txt/proguard-android-optimize.txt/g"
次に、追跡対象のプラグインソースで古いファイルがまだ使われていないか検証します:
for d in capacitor-*; do
[ -d "$d/.git" ] || continue
git -C "$d" grep -n "proguard-android\\.txt" -- || true
done
No matches と表示された場合は、追跡対象のプラグインファイルから古いベースライン参照がなくなったことを意味します。
Capgo ロールアウト状況
すべての公式 Capgo Capacitor プラグインリポジトリとテンプレートで、この移行を完了しました:
- プラグインのAndroidモジュールが参照するようになりました:
proguard-android-optimize.txt - プラグインのサンプルAndroidアプリも更新されました
- プラグインのスキャフォールディングテンプレートを更新し、新規プラグインがデフォルトでAGP 9セーフになるようにしました
これにより、AGP 9アップグレードでよくある失敗がCIに到達する前に防げます。
現在のビルドが通っていても、これが重要な理由
次のような場合は、失敗にすぐ気づかないことがあります:
- CIのキャッシュがまだ問題を覆い隠している
- プロジェクト間でAGPのバージョンが混在している
- ローカル開発時に一部のモジュールのみを再ビルドしている
しかし、クリーンビルドや新しい環境、ランナーのアップグレードによって、最終的には問題が表面化します。今移行を進めることで、潜在的な不安定さを排除できます。
置換後もビルドに失敗する場合のトラブルシューティング
以下の点を確認してください:
-
すべてのモジュールにパッチが適用されているか。 プラグインモジュール、アプリモジュール、サンプル、テンプレートアセットを確認してください。
-
共有スクリプト内に別の参照がないか。 リポジトリ全体(カスタムGradleスクリプトを含む)を検索してください。
-
キャッシュがクリーンか。 以下を実行:
./gradlew cleanその後、再ビルドしてください。 -
AGP / Gradle / JDK のバージョンが揃っているか。 使用しているAGPバージョンでAndroidドキュメントがサポートする組み合わせを使用してください。
-
CIがローカルと同じバージョンを使用しているか。 環境の差異を防ぐため、CIではJDKとGradle wrapperのバージョンを固定してください。
-
パッチを当てる対象は、
node_modulesだけではありません。 一時的な依存関係ディレクトリではなく、追跡対象のプラグインソースを修正してください。
SEO FAQ: AGP 9のCapacitorプラグインのビルドエラー
修正方法 proguard-android.txt AGP 9で見つからない場合は?
以下を置き換え:
getDefaultProguardFile('proguard-android.txt')
次を使用:
getDefaultProguardFile('proguard-android-optimize.txt')
その後、クリーンビルドを実行してください。
Android Gradle Plugin 9にアップグレードした後、Capacitor プラグインのビルドが失敗するのはなぜですか?
ほとんどの失敗は、プラグイン内のレガシーなGradle設定が原因です。 android/build.gradle 依然として以下を参照しているファイル: proguard-android.txt。AGP 9プロジェクトでは次を使用します: proguard-android-optimize.txt.
多くの Capacitor プラグインで、AGP 9への最速の移行パスは何ですか?
ワークスペース全体の検索・置換コマンドを使い、次で検証します: git grep さらに実行: bun run verify:android 代表的なプラグインで。
これはCapacitor特有の問題ですか?
いいえ。非推奨のProGuard baseline参照を使用しているAndroidモジュール(appまたはlibrary)では、同様のAGP 9ビルドエラーが発生する可能性があります。多くのリポジトリが古いテンプレートを共有しているため、プラグインエコシステムでは特に目立ちます。
この移行に関連するキーワードは?
社内のランブックやサポートページにこれを記載する場合は、次のような用語を含めてください:
- AGP 9 ビルドエラー
- Android Gradle Plugin 9 ProGuardファイルが見つからない
- Capacitor プラグインのAndroidビルドに失敗しました
proguard-android.txt代替proguard-android-optimize.txt移行
関連リンク
- Android Developers: アプリのビルド概要
- Android Gradle Plugin: リリースノート
- Android code のシュリンキング: R8とルール
- Gradle ドキュメント: ビルドツールの基本
- Capacitor ドキュメント: 公式ドキュメント
- Capgo ドキュメント: 自動更新ドキュメント
まとめ
この AGP 9 の問題は単純ですが、マルチプラグインのワークスペースでは見逃しがちです。関連するすべての箇所を proguard-android.txt を使用して proguard-android-optimize.txt 置き換えれば、Android のビルドは再び予測可能になります。
Capgo プラグインを使用している場合、このマイグレーションは公式リポジトリにすでに適用されているため、予期せぬ問題が少なくアップグレードできます。
CapacitorプラグインのAGP 9ビルドエラー修正の続きを読む
使用している場合 Capacitor プラグインの AGP 9 ビルドエラー修正 CI/CD自動化を計画するには、次と連携してください Capgo での CI/CD 設定 Capgo CI/CDでのプロダクトワークフローについては、 Capgo Native Build Capgo Native Buildsでのプロダクトワークフローについては、 Capgo インテグレーション Capgo インテグレーションでのプロダクトワークフロー向けに、 CI/CD 連携 CI/CD Integrationの実装詳細については、 GitHub Actions 連携 GitHub Actions Integrationの実装詳細については。