- Bitriseドキュメントへようこそ!
- 入門
- Androidアプリ入門
Androidアプリ入門
メールまたはGitプロバイダーを介してサインアップし、リポジトリに接続して、Androidアプリの最初のビルドを実行することにより、Bitriseの使用を開始します。
このガイドでは、AndroidアプリをBitriseに追加する方法、デフォルトのワークフローで実行できること、そして最後にアプリをテストしてデプロイする方法について説明します。 bitrise.io そしてGooglePlayストアへ。
Bitriseアカウントをお持ちですか?
サインアップしていることを確認してください bitrise.io Bitriseアカウントにアクセスできます。アカウントを登録する方法は複数あります。
BitriseへのAndroidアプリの追加
-
あなたのBitriseに行きます ダッシュボード。
-
クリック + 上部のメニューバーにサインオンして、 WebUIに新しいアプリを追加する、に移動します 新しいアプリを作成する ページ。
または、CLIを使用してアプリを追加することもできます。詳細については、チェックアウトしてください CLIからの新しいアプリの追加。
-
アプリを追加するアカウントを選択します。
-
アプリのプライバシーを次のいずれかに設定します 民間 また 公衆 をクリックします 次。
プライベート アプリとパブリック アプリ
パブリック アプリとプライベート アプリの最も重要な違いは、アプリがパブリックの場合、ビルド URL を知っている全員がビルド ログを表示できることです。 公開アプリ.プライベート アプリを使用すると、誰がアプリにアクセスできるかを完全に制御できます。
-
リポジトリをホストするGitホスティングサービスを選択してから、プロジェクトをホストする独自のリポジトリを見つけて選択します。
-
リポジトリアクセスを設定するように求められたら、をクリックします いいえ、SSHキーを自動追加します。
-
プロジェクトの構成を含むブランチの名前を入力します-
主要
たとえば、-次にクリックします 次。 -
Bitriseがプロジェクトを検証している間待ちます。スキャナーはあなたを探しています
build.gradle
とgradlew
ファイル。それらが存在する場合、プロジェクトはAndroidプロジェクトとして検出されます。 -
Bitrise Scannerは、デフォルトでプロジェクトのモジュールを選択します。モジュールリストから選択するモジュールが他にもある場合は、プロジェクトに最適なモジュールを選択してください。
-
構築するバリアントを選択します(すべてのバリアントを選択ですべてのバリアントを生成しますアーティファクト)そしてテスト用のバリアントも選択します。
-
プロンプトが表示されたらWebhookを登録して、コードがリポジトリにプッシュされたときにBitriseがビルドを自動的に開始できるようにします。これにより、最初のビルドも開始されます。 主要な ワークフロー-メッセージをクリックすると、ビルドページに移動します。
ビルドページで、 ビルドログ クリックすると ワークフローの編集 、ビルドの実行に使用されたデフォルトの自動生成されたワークフローを変更できます。
Androidアプリの依存関係の管理
Gradleビルドシステムでは、依存関係として外部バイナリまたは他のライブラリモジュールを含めることができます。 Bitriseは、ビルドプロセス中にアプリにこれらの依存関係をインストールできます。
ビルドの依存関係の追加
Androidプロジェクトへの依存関係の追加について詳しくは、以下をご覧ください。 https://developer.android.com/studio/build/dependencies
-
プロジェクトが
build.gradle
ファイルには、すべての依存関係が一覧表示されます。 -
でアプリを開きます ビットライズ。
-
クリック ワークフロー メインページのボタン。
-
からワークフローを選択します ワークフロー ドロップダウンメニュー。
-
ワークフローに Androidビルド ステップ。
プロジェクトスキャナーがと呼ばれるワークフローを生成した場合 配備 アプリを最初に追加するとき、そのワークフローにはステップが含まれます。リストされているすべての依存関係をインストールします
build.gradle
追加の構成なしでファイル。 -
ワークフローにインストールが欠落していることが含まれていることを確認してください AndroidSDKコンポーネント ステップ。
ステップは、 Androidビルド ワークフローにステップインします。プロジェクトに必要なすべてのAndroidSDKツールがインストールされます。
Androidアプリのテスト
CIプロセス中にAndroidアプリをテストするのを支援するためのいくつかのステップがあります。
-
NS Android Lint ステップは、AndroidプロジェクトのソースファイルでLintを実行し、潜在的な構文エラーを検出して、コードエラーをなくします。
-
NS Androidユニットテスト ステップは、プロジェクトの単体テストを実行します。さまざまなモジュールとフレーバーすべてに対して実行できます。 Androidユニットテスト
-
NS [ベータ版] Android向け仮想デバイステスト Firebase TestLabを使用して、仮想デバイスでAndroidテストを実行します。 Androidのデバイステスト
NS Androidユニットテスト ステップと [ベータ版] Android向け仮想デバイステスト ステップは両方とも結果をにエクスポートできます テストレポート アドオン。これを行うには、ワークフローに Bitrise.ioにデプロイします ワークフローの最後にステップします。
Androidアプリに署名する
AndroidアプリをGooglePlayに公開するには、アプリにデジタル署名する必要があります。 Bitriseはこれを行うこともできます。キーストアファイルをアップロードし、必要な認証を提供するだけです。
その他のコード署名オプション
このセクションでは、Androidサインステップを使用してAndroidアプリに署名する方法について説明します。アプリに署名する方法は他にもあります。関連ガイドの他のオプションを確認してください。 Androidコード署名
-
でアプリを開きます ビットライズ。
-
クリック ワークフロー メインページのボタン。
-
に行く コード署名とファイル タブ。
-
キーストアファイルをにドラッグアンドドロップします Androidキーストアファイル 分野。
-
記入してください キーストアのパスワード、 キーストアエイリアス、 と 秘密鍵のパスワード フィールドをクリックしてクリックします メタデータを保存する。
-
からワークフローを選択します ワークフロー ドロップダウンメニュー。
-
追加します Androidサイン ワークフローに進みます。
以上です。次回ビルドを実行するときは、 Androidサイン ステップは、生成されたバイナリに署名します。
Androidアプリをbitrise.ioにデプロイする
このセクションでは、Androidアプリをにデプロイする方法について説明します。 bitrise.io。
へのデプロイ bitrise.io ビルド中に生成されたビルド アーティファクトは、ビルドが完了するとダウンロードできるようになります。これを使用して、たとえば独自のテスト デバイスでアプリをテストできます。
アプリをにデプロイするには bitrise.io:
-
ワークフローに Androidビルド アプリを構築する手順。
オプションで、アプリを作成できます。 Gradleランナー ステップ。これにはもう少し構成が必要ですが、より広範なカスタマイズが可能です。
-
追加します Bitrise.ioにデプロイします ワークフローに進みます。
他のユーザーへの通知
あなたは使用することができます 通知:ユーザーの役割 そしてその 通知:メール デプロイに関する通知を設定するためのステップの入力。
-
オプションで、 アプリの公開ページを有効にしますか? ステップの入力 真実 だからステップ パブリック インストール ページを有効にします あなたのアプリのために。
-
ビルドを実行します。
の Bitrise.io にデプロイする ステップはアプリをデプロイします。ビルドの URL を使用して、生成されたバイナリをチーム メンバーと共有できます。
この例では、 debug
Android アプリのバリアントとして、bitrise.io にデプロイします。
format_version: '11' default_step_lib_source: https://github.com/bitrise-io/bitrise-steplib.git project_type: android app: envs: - opts: is_expand: false BITRISE_SOURCE_DIR: /app workflows: docs-example-workflow: steps: - [email protected]: inputs: - variant: debug - [email protected]: {}
初めてGooglePlayの展開を設定する
Google Playにデプロイすると、アプリがGoogleのオンラインストアに公開されます。初めてそれを行うとき、これは単にに展開するよりも少し多くの作業を必要とします bitrise.io。必要な構成が整ったら、それは非常に簡単になります。
Google Playのデプロイを初めて構成するときは、Google PlayデベロッパーアカウントをAPIプロジェクトにリンクし、APIアクセスを設定して、サービスアカウントのJSONキーをBitriseにアップロードする必要があります。
-
最初のAABまたはAPKを手動でGooglePlayにアップロードします GooglePlayコンソールを使用する。
-
リンク GooglePlayデベロッパーコンソールをAPIプロジェクトに変換します。
-
サービスアカウントを使用してAPIアクセスクライアントを設定する:Google Developer Consoleでサービスアカウントを作成するときは、選択する必要があることに注意してください
json
なので キータイプ。 -
あなたのサービスアカウントに必要な権利を付与します GooglePlayコンソール。に移動 設定、 それから ユーザーと権限、 それから 新しいユーザーを招待する。 Google Play Publisher APIの動作方法により、サービスアカウントに少なくとも次の権限を付与する必要があります。
-
アクセスレベル:アプリ情報を表示します。
-
リリース管理:本番リリースを管理し、テストトラックリリースを管理します。
-
店舗のプレゼンス:店舗のリスト、価格設定、配布を編集します。
-
-
オプションの手順として、ストアリストに翻訳を追加できます。 アプリを翻訳してローカライズする。
-
でアプリを開きます ビットライズ。
-
クリック ワークフロー メインページのボタン。
-
に行く コード署名とファイル タブに移動し、サービス アカウントの JSON キーを 汎用ファイル ストレージ.
GooglePlayへのデプロイ
Google Playにデプロイするには、署名済みのAPKまたはAABファイルと GooglePlayデプロイ ステップ。
-
アプリを初めてデプロイする場合は、 GooglePlayの設定が正しく設定されていることを確認してください。
-
でアプリを開きます ビットライズ。
-
クリック ワークフロー メインページのボタン。
-
に行く コード署名とファイル タブをクリックしてコピーします 環境変数 アップロードしたサービス アカウントの JSON キー ファイルの URL を格納するキー。
-
をコピーします 環境変数 アップロードしたファイルのURLを保存するキー。
例えば:
BITRISEIO_SERVICE_ACCOUNT_JSON_KEY_URL
。 -
ワークフローを開き、を追加します GooglePlayデプロイ それにステップします。
-
の中に サービスアカウントのJSONキーファイルパス 入力し、サービスアカウントのJSONキーをアップロードしたときに生成された環境変数を 一般的なファイルストレージ。生成されたEnvVarに加えて、ステップの入力フィールドにファイルパスを追加することもできます。ファイルパスはローカルまたはリモートにすることもできます。
-
リモートJSONキーファイルの場合、たとえば、任意のダウンロード場所を値として指定できます。
https://URL/TO/key.json
。 -
ローカルJSONキーファイルの場合、ファイルパスのURLを値として指定できます。たとえば、
file://PATH/TO/key.json
。
-
-
の中に パッケージ名 入力し、アプリのパッケージ名を追加します。
-
の中に 追跡 入力して、APKをデプロイするトラックを追加します(たとえば、alpha / beta / rollout / productionまたは設定したカスタムトラック)。
それで全部です!ビルドを開始またはスケジュールして、URLを外部テスターと共有するか、選択したアプリストアでアプリを配布してください。