Androidアプリバンドルの生成とデプロイ
Bitriseを使ってAndroid App Bundleを作成する手順は、APKを生成する場合とほぼ同じです。コードからAndroid App Bundle(.aab)ファイルをコンパイルするには、いくつかのStepの入力を調整するだけです。その後、バンドルに署名してGoogle Play Storeにデプロイします。
以下のStepsは、記載されたバージョン以降である必要があります。Stepsの旧バージョンではバンドル作成に対応していません。
- Android Build 0.10.0以降
- Gradle Runner 1.9.0以降
- Android Sign 1.3.0以降
- Deploy to Google Play 1.6.0以降
Android App Bundleファイルの生成Click to copy link
Android App Bundleは、Gradle Runner StepまたはAndroid Build Stepのいずれかを使って作成できます。
Gradle Runner Stepを使用するClick to copy link
- Workflow Editor
- Configuration YAML
-
Bitrise にアクセスして Log in、左側の Bitrise CI を選択し、プロジェクトを選択します。
-
メインページの Workflows ボタンをクリックします。
-
Workflow内のAndroid Unit TestとAndroid Lint Stepsの後にGradle Runner Stepを挿入します。
-
Gradle RunnerのConfigセクションをクリックします。
-
Gradle task to run入力フィールドに、たとえば
bundleReleaseまたはbundleDebugを設定して、プロジェクトのバンドルを作成します。
同じWorkflow内のAPKとAAB1つのWorkflowでAndroid App BundleとAPKの両方を生成したい場合は、Gradle task to run入力フィールドに追加のタスクを指定できます。リリースバージョンを生成するには、入力値を
bundleRelease assembleReleaseに設定してください。
-
アプリのConfiguration YAMLファイルを開きます。
-
Workflow内の
android-unit-testとandroid-lintStepsの後にgradle-runnerStepを挿入します。my-workflow:steps:- activate-ssh-key:run_if: '{{getenv "SSH_RSA_PRIVATE_KEY" | ne ""}}'- git-clone: {}- install-missing-android-tools: {}- android-lint: {}- android-unit-test: {}- gradle-runner: -
gradle-runnerのgradle_task入力に、たとえばbundleReleaseまたはbundleDebugを設定して、プロジェクトのバンドルを作成します。my-workflow:steps:- activate-ssh-key:run_if: '{{getenv "SSH_RSA_PRIVATE_KEY" | ne ""}}'- git-clone: {}- install-missing-android-tools: {}- android-lint: {}- android-unit-test: {}- gradle-runner:inputs:- gradle_task: bundleRelease同じWorkflow内のAPKとAAB1つのWorkflowでAndroid App BundleとAPKの両方を生成したい場合は、
gradle_task入力フィールドに追加のタスクを指定できます。リリースバージョンを生成するには、入力値をbundleRelease assembleReleaseに設定してください。
この方法により、StepはAPKの代わりにAndroid App Bundleを生成します。
Android Build Stepを使用するClick to copy link
Android Build Stepを使用しても、AndroidアプリのAndroid App Bundleを生成できます。
- Workflow Editor
- Configuration YAML
-
Bitrise にアクセスして Log in、左側の Bitrise CI を選択し、プロジェクトを選択します。
-
メインページの Workflows ボタンをクリックします。
-
Workflow内のAndroid Unit TestとAndroid Lint Stepsの後にAndroid Build Stepを追加します。
-
Project Location入力フィールドにAndroidプロジェクトのルートディレクトリを指定します。
-
Build typeに移動し、ビルドタイプとして
aabを選択します。
同じWorkflow内のAPKとAAB1つのWorkflowでAPKとAndroid App Bundleの両方を生成したい場合は、Android Build Stepsを2つ続けて追加し、一方をAndroid App Bundleをビルドするように、もう一方をAPKをビルドするように設定します。
-
アプリのConfiguration YAMLを開きます。
-
Workflow内の
android-unit-testとandroid-lintStepsの後にandroid-buildStepを追加します。my-workflow:steps:- activate-ssh-key:run_if: '{{getenv "SSH_RSA_PRIVATE_KEY" | ne ""}}'- git-clone: {}- install-missing-android-tools: {}- android-lint: {}- android-unit-test: {}- android-build: -
project_location入力フィールドにAndroidプロジェクトのルートディレクトリを指定します。 -
build_type入力の値をaabに設定します。my-workflow:steps:- activate-ssh-key:run_if: '{{getenv "SSH_RSA_PRIVATE_KEY" | ne ""}}'- git-clone: {}- install-missing-android-tools: {}- android-lint: {}- android-unit-test: {}- android-build:inputs:- build_type: aab同じWorkflow内のAPKとAAB1つのWorkflowでAPKとAndroid App Bundleの両方を生成したい場合は、
android-buildStepsを2つ続けて追加し、一方をAndroid App Bundleをビルドするように、もう一方をAPKをビルドするように設定します。
Android App Bundleの署名Click to copy link
Android App Bundleファイルの署名方法は、APKの署名方法と同じです。最も簡単な方法は、キーストアファイルをBitriseにアップロードし、Android Sign Stepを使用することです。
- Workflow Editor
- Configuration YAML
-
キーストアファイルをBitriseにアップロードします。
-
Workflow EditorでWorkflowを開き、ビルドStepの後にAndroid Sign Stepを追加します。
-
Keystore password、Key alias、およびKey passwordの各入力フィールドが入力されていることを確認します。
デフォ ルトの入力値キーストアファイルをアップロードし、必要な認証情報を入力すると、Android Sign StepのKeystore url、Keystore password、Keystore alias、Private key passwordの各入力は自動的に入力されます。
-
App file path入力フィールドに、使用しているビルドStepの出力と同じ出力環境変数が表示されていることを確認します。
たとえば、Android Buildは、Stepが生成したAPKやAABファイルを指す$BITRISE_APK_PATHまたは$BITRISE_AAB_PATH環境変数をエクスポートします。この入力は、デフォルトでこれらの環境変数を参照します。
その他の設定オプションAndroid Sign Stepで利用可能なすべての設定オプションについては、Workflow Editorをご覧ください。以下のこと ができます。
- Page alignment入力でメモリページアライメントを有効または無効にします。
- Signer tool入力で、アプリの署名に使用するツールを選択します。
automatic(デフォルト。APKにはapksigner、AABにはjarsignerを使用)、apksigner、またはjarsigner。 - APK Signature Scheme入力で、特定のSignature Schemeを強制します。
-
キーストアファイルをBitriseにアップロードします。
-
アプリのConfiguration YAMLファイルで、Workflow内のビルドStep(たとえば
android-build)の後にsign-apkStepを追加します。sign-android-workflow:steps:- android-build: {}- sign-apk@1:inputs: -
keystore_url、keystore_password、keystore_aliasの各入力が正しい場所を指していることを確認します。sign-android-workflow:steps:- android-build: {}- sign-apk@:inputs:- keystore_url: "$BITRISEIO_ANDROID_KEYSTORE_URL"- keystore_password: "$BITRISEIO_ANDROID_KEYSTORE_PASSWORD"- keystore_alias: "$BITRISEIO_ANDROID_KEYSTORE_ALIAS"デフォルトの入力値キーストアファイルをBitriseにアップロードし、必要な認証情報を入力していれば、入力を設定する必要はまったくありません。Stepの
step.yml設定ファイルで定義されているdefault valueが、キーストアファイルと必要な認証情報を指します。 -
android_app入力フィールドに、使用しているビルドStepの出力と同じ出力環境変数が表示されていることを確認します。たとえば、
android-buildは、Stepが生成したAPKやAABファイルを指す$BITRISE_APK_PATHまたは$BITRISE_AAB_PATH環境変数をエクスポートします。この入力は、デフォルトでこれらの環境変数を参照します。Stepは、この 入力で指定された場所にある署名対象のバイナリを探します。
sign-android-workflow:steps:- android-build: {}- sign-apk@1:inputs:- keystore_url: "$BITRISEIO_ANDROID_KEYSTORE_URL"- keystore_password: "$BITRISEIO_ANDROID_KEYSTORE_PASSWORD"- keystore_alias: "$BITRISEIO_ANDROID_KEYSTORE_ALIAS"- android_app: "$BITRISE_APK_PATH\\n$BITRISE_AAB_PATH"その他の設定オプションandroid-signStepで利用可能なすべての設定オプションについては、step.yml fileをご覧ください。以下のことができます。page_align入力でメモリページアライメントを有効または無効にします。signer_tool入力で、アプリの署名に使用するツールを選択します。automatic(デフォルト。APKにはapksigner、AABにはjarsignerを使用)、apksigner、またはjarsigner。signer_scheme入力で、特定のSignature Schemeを強制します。
Android App BundleをGoogle PlayにデプロイするClick to copy link
AABファイルのデプロイは、Google PlayへのAPKのデプロイと大きく変わりません。
アプリストアでの配信前にバンドルを確認したい場合は、Gradle Runner / Android Build Stepsの後にDeploy to Bitrise.io Stepを追加できます。これにより、バンドルがBuildのページのArtifactsタブにアップロードされます。
初めてGoogle Playデプロイを設定するClick to copy link
Google playへのデプロイでは、アプリがGoogleのオンラインストアに公開されます。初めて行う場合、bitrise.ioへの単純なデプロイよりも少し手間がかかりますが、必要な設定が整えば非常にシンプルになります。
Google Playデプロイを初めて設定する際は、Google Play DeveloperアカウントをAPIプロジェクトにリンクし、APIアクセスを設定して、サービスアカウントのJSONキーをBitriseにアップロードする必要があります。
-
Google Play Consoleを使用して、最初のAABまたはAPKを手動でGoogle Playにアップロードします。
-
Google Play Developer ConsoleをAPIプロジェクトにリンクします。
-
サービスアカウントを使用してAPI Access Clientsを設定する: Google Developer Consoleでサービスアカウントを作成する際は、Key Typeとして
jsonを選択する必要があるのでご注意ください。 -
Google Play Consoleを使って、サービスアカウントに必要な権限を付与します。Settings、次にUsers & permissions、次にInvite new userの順に進みます。Google Play Publisher APIの仕組み上、サービスアカウントには少なくとも以下の権限を付与する必要があります。
- Access level: アプリ情報の表示。
- Release management: 本番リリースの管理、テストトラックリリースの管理。
- Store presence: ストア掲載情報、価格、配信の編集。
-
オプションの手順として、ストア掲載情報に翻訳を追加できます。Translate & localize your app。