Android Studio は優れた IDE ですが、ストア対応の Android ビルドには必須ではありません。生成された android/ フォルダには Capacitor プロジェクトの Gradle ラッパーが含まれており、どのターミナルからもビルドと署名が可能です。ディスプレイのない Linux サーバー、Studio が遅い Windows マシン、そして CI において重要です。
このガイドでは、コマンドラインのみで署名済み AAB をビルドし、その後 Capgo のビルド によるクラウド版を、ラップトップに keystore を置きたがらないチーム向けに紹介します。
前提条件
- JDK 21 (
java -versionは 21 を表示します)。 - Android コマンドライン SDK と
platform-tools,build-tools、および Capacitor バージョン (API 36 は Capacitor 8、API 35 は Capacitor 7) に一致するプラットフォーム。 Linuxガイド と Windows ガイド インストールを扱います。 ANDROID_HOMEエクスポート済み、またはandroid/local.propertiesを使用してsdk.dir=....- Capacitor アプリで
android/によって生成bunx cap add android.
1) 署名用 keystore の作成
keytool はすべてのプラットフォームの JDK に含まれています:
keytool -genkeypair -v \
-keystore release.jks \
-keyalg RSA -keysize 2048 -validity 10000 \
-alias release
プロンプトに回答し、ストアパスワードとキーパスワードを選択してください。ファイルと両方のパスワードは今すぐパスワードマネージャーまたはシークレットボルトに保存してください。絶対にコミットしないでください release.jks.
Play Console でアプリを作成する際に Play App Signing を有効にしてください。Google が最終的な署名キーを保持し、あなたの keystore はアップロードキーとなり、紛失した場合にリセットできます。
2) Gradle に署名方法を伝える
シークレットを外部に漏らさない build.gradle。を作成 android/keystore.properties (gitignore対象):
storeFile=/absolute/path/to/release.jks
storePassword=your-store-password
keyAlias=release
keyPassword=your-key-password
その後、以下で参照します: android/app/build.gradle:
def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file("keystore.properties")
if (keystorePropertiesFile.exists()) {
keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}
android {
signingConfigs {
release {
if (keystorePropertiesFile.exists()) {
storeFile file(keystoreProperties['storeFile'])
storePassword keystoreProperties['storePassword']
keyAlias keystoreProperties['keyAlias']
keyPassword keystoreProperties['keyPassword']
}
}
}
buildTypes {
release {
signingConfig signingConfigs.release
minifyEnabled false
}
}
}
追加 android/keystore.properties と *.jks まで .gitignore.
3) バージョンを上げる
Google Playは、次のようなアップロードを拒否します: versionCode Google Playが以前に確認したものです。編集: android/app/build.gradle:
defaultConfig {
versionCode 12
versionName "1.4.0"
}
通常、チームは次の値を導出します: versionCode CIの実行番号やgitのコミット数から、手動編集を避けるために。
4) ターミナルからAABをビルドする
bun run build
bunx cap sync android
cd android
./gradlew bundleRelease
Windowsの場合は次を使用します: .\gradlew.bat bundleRelease。署名済みbundleは次に書き出されます: android/app/build/outputs/bundle/release/app-release.aab.
adb で直接インストールするための APK が必要ですか? ./gradlew assembleRelease を生成します app-release.apk 内の outputs/apk/release/。以下でインストールします adb install。 adb install ガイド でエッジケースをカバーしています。
5) 署名を検証
$ANDROID_HOME/build-tools/36.0.0/apksigner verify --print-certs app/build/outputs/apk/release/app-release.apk
AAB の場合、 jarsigner -verify -verbose app-release.aab 署名と証明書フィンガープリントを確認します。SHA-256 を、Play Console の「アプリの完全性」セクションに表示されているものと照合してください。
6) コマンドラインから Google Play にアップロード
Play Console からの手動アップロードも可能です。自動化するには、Google Cloud でサービスアカウントを作成し、Play Console の「ユーザーと権限」でアクセス権を付与して、その JSON キーをダウンロードします。その後、Google Play Developer API または fastlane supply のようなツールでアップロードします:
bundle exec fastlane supply --aab android/app/build/outputs/bundle/release/app-release.aab \
--track internal --json_key play-service-account.json --package_name com.example.app
新規アプリの最初のアップロードは、Play Console で手動で行う必要があります。API は、既存のアプリのビルドのみを受け付けます。
7) クラウド代替手段: Android 向け Capgo Build
上記の手順は機能しますが、ビルドを行うすべてのマシンに keystore が残ってしまいます。Capgo Build は、keystore を暗号化されたボルトに保管し、アップロードした準備済みの android/ プロジェクトからビルドし、AAB を Play のトラックにプッシュできます。
認証情報を一度だけ保存します:
bunx @capgo/cli@latest build credentials save --platform android \
--keystore ./release.jks \
--keystore-alias "release" \
--keystore-key-password "key-password" \
--keystore-store-password "store-password" \
--play-config ./play-service-account.json
または bunx @capgo/cli@latest build init --platform android に案内してもらうこともできます。その後、リリースはすべて以下のように:
bun run build
bunx cap sync android
bunx @capgo/cli@latest build request com.example.app --platform android --build-mode release
ログがターミナルにストリームされます。 --output-upload を追加すると、AAB または APK のダウンロードリンクを取得でき、 --ai-analytics 失敗したビルドを自動で解説させるには。同じコマンドが Windows、Linux、macOS、CI で動作します。GitHub Actions の例はこちらにあります: Android ビルドガイド.
Capgo は準備済みのネイティブプロジェクトのみを受け取るため、プライベートな npm レジストリや Web ビルドのシークレットは、お客様の環境内に保持されます。
8) Web の変更による再ビルドをやめる
プラグイン、権限、アイコン、および Capacitor のアップグレードには、署名済みのネイティブビルドが必要です。以下のすべてにおいて: dist/, Capgo Live Update 新しい Web bundle をインストール済みのアプリに直接プッシュします:
bunx @capgo/cli@latest bundle upload --channel production
これで、週の Gradle 実行のほとんどがなくなります。
トラブルシューティング
SDK location not found:設定ANDROID_HOMEまたは作成android/local.properties.Keystore was tampered with, or password was incorrect:ストアのパスワードが間違っているか、Git の CRLF 変換でファイルが破損しています。マークする*.jksバイナリとして.gitattributesバージョン管理されるべきですが、そうすべきではありません。Unsupported class file major versionJDKが21より新しいか、古い場合。- PlayがAABを拒否:「異なるキーで署名されています」Play App Signingはアップロードキーを期待します。Play Consoleに登録されたkeystoreを使用するか、アップロードキーのリセットをリクエストしてください。
- Windowsでのビルドが遅い除外
~/.gradleとSDKをDefenderから除外し、プロジェクトを短いローカルパスに配置してください。 - Gradleでメモリ不足:追加
org.gradle.jvmargs=-Xmx4gまでandroid/gradle.properties.
まとめ
Capacitor の Android リリースには、JDK、SDK、Gradle wrapper が必要で、Android Studio は不要です。keystore は以下で作成します keytool、署名は以下で行います keystore.properties、ビルドは以下で実行します bundleRelease、Play API でアップロードします。keystore をラップトップから切り離し、すべての OS で同じコマンドを使いたい場合は、Capgo Build が準備済みのプロジェクトから署名とアップロードを実行します。