メインコンテンツへスキップ

Linux、Windows、CI上でAndroid StudioなしのAndroid Release Build

コマンドラインのみで、Capacitor アプリの署名済み Android AAB を生成します。keytool による keystore 作成、ターミナルからの Gradle 実行、Play Console のサービスアカウント、そして keystore をラップトップから遠ざける Capgo Build クラウド代替手段。

Android Studio なしで Android リリースビルド Capgo ブログ イラスト

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 が準備済みのプロジェクトから署名とアップロードを実行します。

Capacitor アプリ向けの Live Updates

Web レイヤーのバグが本番で発生したら、App Store の審査を何日も待たずに Capgo で修正を配信しましょう。ネイティブの変更は通常の審査フローに残したまま、ユーザーはバックグラウンドでアップデートを受け取れます。

最新のブログ記事

Capgoは、真にプロフェッショナルなモバイルアプリを作るために必要な最高のインサイトを提供します。