Androidアプリ入門

概要

メールまたはGitプロバイダーを介してサインアップし、リポジトリに接続して、Androidアプリの最初のビルドを実行することにより、Bitriseの使用を開始します。

このガイドでは、Android を追加する方法を説明します。 アプリ Bitrise へ、デフォルトは何ですか ワークフロー できること、そして最後にアプリをテストしてデプロイする方法ビットライズアイオそしてGoogle Playストアへ。

Bitriseアカウントをお持ちですか？

サインアップしていることを確認してください bitrise.io Bitriseアカウントにアクセスできます。アカウントを登録する方法は複数あります。

BitriseへのAndroidアプリの追加

Bitrise にログインし、ダッシュボード。
クリック新しいアプリを追加ボタン。
下プロジェクトへのアクセス、アプリを所有するワークスペースを選択します。
アプリのプライバシーを設定します。

注意

この設定は後で変更することはできません。アプリをプライベートにする必要があるにもかかわらず、誤ってパブリックアプリとして追加したことに気付いた場合は、アプリを削除して再度追加する必要があります。
- プライベートアプリには、あなた、ワークスペースメンバー、およびアプリでの作業に招待されたユーザーのみがアクセスできます。アプリのリポジトリにアクセスするには認証が必要です。
- 公開アプリ彼らのことを暴露するビットライズ.yml そしてビルドログを全員に送信します。公開アプリのビルド URL がある場合は、そのビルドログを表示して、トラブルシューティングなどに役立てることができます。パブリックアプリは認証を必要とせず、SSH キーを持つことはできません。
リポジトリ URL を設定するには、2 つのオプションのいずれかを選択します。
- とともにリモートリポジトリの選択オプションを使用すると、接続されている Git プロバイダーアカウントのリポジトリのリストからリポジトリを選択できます。ドロップダウンメニューから Git プロバイダーを選択し、クリックします。リポジトリを選択してください... リストからリポジトリを選択します。
- の URLを手動で入力してくださいこのオプションでは、接続された Git プロバイダーアカウントは必要ありません。URL を入力するだけで、認証フェーズに進むことができます。を設定している場合を除き、SSH URL を使用することを強くお勧めします。パブリックアプリ。
リポジトリURL

あなたはできるでしょうプロジェクトのリポジトリ URL を変更する後で。また、いつでもアカウントを Git プロバイダーサービスに接続または切断することができます。

Git プロバイダーアカウントを使用して Bitrise にサインアップした場合、そのアカウントはすでに接続されており、そこから任意のリポジトリを選択できます。
SSHキーを追加するの中に Bitrise を承認するセクション。これはプライベートアプリにのみ関係します。パブリックアプリは SSH キーを持つことができず、認証を必要としません。次の 3 つのオプションから 1 つを選択します。
- 生成された SSH キーをリポジトリに自動追加します: このオプションを使用することをお勧めします。 SSH キーペアが自動的に生成され、公開キーがリポジトリに登録されます。接続された Git プロバイダーアカウントにリポジトリに対する管理者権限が必要です。
- 生成された SSH キーを Git プロバイダーに手動でコピーします: SSH キーペアが生成されるので、公開キーをコピーして Git プロバイダーに手動で登録できます。たとえば、同じ SSH キーを使用して複数のリポジトリにアクセスする必要がある場合に便利です。
- 独自の SSH キーを Bitrise に追加する: このオプションを選択した後、独自の SSH キーを生成し、ここに秘密キーを貼り付けることができます。公開キーをリポジトリに手動で追加することも必要です。 SSH キーペアを生成するには、次の手順を実行します。独自の SSH キーペアの生成。
SSH キーはいつでも設定できます

現時点で有効な機能する SSH キー接続を設定できない場合でも、心配する必要はありません。アプリの追加に進んでください。後で SSH 接続をセットアップできます。 SSHキーの構成。
リポジトリのデフォルトのブランチを選択します。このブランチにはプロジェクトの構成が含まれている必要があります。
- 前の手順で SSH アクセスを正常に構成した場合、またはパブリックアプリを追加している場合、Bitrise はリポジトリを解析し、ドロップダウンメニューからブランチを選択できるようにします。
- リポジトリアクセスを構成していない場合は、ブランチ名を手動で入力する必要があります。
アプリのデフォルトのブランチは後で変更できます。
Bitriseがアプリを自動的に構成しようとしている間待ちます。

プロジェクトの種類

プロジェクトタイプの検出は、アプリの初期構成を支援するのに役立ちます。ただし、アプリを追加した後はいつでも、プロジェクトタイプを含むすべての設定を変更できますのでご安心ください。
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 追加の構成なしでファイル。
ワークフローに以下が含まれていることを確認してください。 不足している Android SDK コンポーネントをインストールする ステップ。

ステップは、 Androidビルド ワークフローにステップインします。プロジェクトに必要なすべてのAndroidSDKツールがインストールされます。

Androidアプリのテスト

CIプロセス中にAndroidアプリをテストするのを支援するためのいくつかのステップがあります。

NS Android Lint ステップは、AndroidプロジェクトのソースファイルでLintを実行し、潜在的な構文エラーを検出して、コードエラーをなくします。
NS Androidユニットテスト ステップは、プロジェクトの単体テストを実行します。さまざまなモジュールとフレーバーすべてに対して実行できます。 Android 単体テストの実行
の Android の仮想デバイスのテスト Firebase TestLab を使用して、仮想デバイス上で Android テストを実行します。 Androidのデバイステスト

の Android単体テスト ステップと Android の仮想デバイスのテスト ステップはどちらも結果をテストレポートアドオン。これを行うには、ワークフローに次のものが含まれていることを確認するだけです。 Bitrise.io にデプロイする ワークフローの最後のステップ。

Androidアプリに署名する

AndroidアプリをGooglePlayに公開するには、アプリにデジタル署名する必要があります。 Bitriseはこれを行うこともできます。キーストアファイルをアップロードし、必要な認証を提供するだけです。

その他のコード署名オプション

このセクションでは、Androidサインステップを使用してAndroidアプリに署名する方法について説明します。アプリに署名する方法は他にもあります。関連ガイドの他のオプションを確認してください。 Androidコード署名

キーストアファイルを生成する。
でアプリを開きますビットライズ。
クリックワークフローメインページのボタン。
[ワークフローとパイプライン] ページでは、次のことができます。
- クリック bitrise.yml を編集するにアクセスするためのボタンビットライズ.yml ワークフローエディターのタブ。
- クリックワークフロー名の横にあるボタンをクリックして、ワークフローエディターでワークフローを開きます。
に行くコード署名とファイルタブ。
キーストアファイルをにドラッグアンドドロップします Androidキーストアファイル 分野。
記入してください キーストアのパスワード、 キーストアエイリアス、と 秘密鍵のパスワード フィールドをクリックしてクリックします メタデータを保存する。
クリックワークフロー名の横にあるボタンをクリックします。
追加します Androidサイン ワークフローに進みます。

以上です。次回ビルドを実行するときは、 Androidサイン ステップは、生成されたバイナリに署名します。

Androidアプリをbitrise.ioにデプロイする

このセクションでは、Androidアプリをにデプロイする方法について説明します。 bitrise.io。

へのデプロイ bitrise.io ビルド中に生成されたビルドアーティファクトは、ビルドが完了するとダウンロードできるようになります。これを使用して、たとえば独自のテストデバイスでアプリをテストできます。

アプリをにデプロイするには bitrise.io：

ワークフローエディター

ビットライズ.yml

ワークフローに Androidビルド アプリを構築する手順。

オプションで、アプリを作成できます。 Gradleランナー ステップ。これにはもう少し構成が必要ですが、より広範なカスタマイズが可能です。
追加します Bitrise.ioにデプロイします ワークフローに進みます。

他のユーザーへの通知

使用できます通知: ユーザーの役割そしてその通知: 電子メールデプロイに関する通知を設定するステップの入力。入力名をクリックすると、その構成方法の詳細が表示されます。
オプションで、アプリの公開ページを有効にしますか? ステップの入力真実だからステップパブリックインストールページを有効にしますあなたのアプリのために。
ビルドを実行します。

を開きます。 bitrise.yml アプリのファイル。
必ず確認してください ワークフロー が含まれています android-build ステップ アプリを構築します。
```
workflows:
  example-workflow:
    steps:
    - android-build@1:
```
オプションで、次のコマンドを使用してアプリを構築できます。 gradle-runner ステップ。これにはもう少し構成が必要ですが、より広範なカスタマイズが可能になります。
をセットする module および/または variant 何を構築するかをステップに指示するための入力。

この例では、Android プロジェクトのデバッグバリアントを構築しています。
```
workflows:
  example-workflow:
    steps:
    - android-build@1:
        inputs:
        - variant: debug
    - deploy-to-bitrise-io: {}
```
を追加します。 deploy-to-bitrise-io ワークフローに進みます。
```
workflows:
  example-workflow:
    steps:
    - android-build@1:
        inputs:
        - variant: debug
    - deploy-to-bitrise-io: {}
```
他のユーザーに通知する

使用できます notify_user_groups そしてその notify_email_list デプロイに関する通知を設定するステップの入力:
- の notify_user_groups 入力を使用すると、に基づいて通知を送信できます。アクセスロールユーザーに付与されます。たとえば、全員に通知するように入力を設定できます。管理者そして開発者役割。複数の役割をカンマで区切って設定します。 - notify_user_groups: admins, testers。
- の notify_email_list input はシークレットのみを受け入れます。シークレットには電子メールアドレスのカンマ区切りリストが含まれている必要があります。
オプションで、アプリの公開ページを有効にしますか? ステップの入力真実だからステップパブリックインストールページを有効にしますあなたのアプリのために。
ビルドを実行します。

の Bitrise.io にデプロイする ステップはアプリをデプロイします。ビルドの URL を使用して、生成されたバイナリをチームメンバーと共有できます。

例1 Android アプリを Bitrise にデプロイするための bitrise.yml

この例では、 debug Android アプリのバリアントとして、bitrise.io にデプロイします。

初めて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 ファイルそしてその Google Playのデプロイ ステップ。

ワークフローエディター

ビットライズ.yml

導入しようとしている場合は、 アプリ 初めて、 Google Playの設定が正しく設定されていることを確認してくださいそしてあなたはサービスアカウントのJSONキーをBitriseにアップロードしました。

サービスアカウントのJSONキーファイルのアップロード

サービスアカウントの JSON キーを Bitrise にアップロードすることをお勧めしますが、必須ではありません。他の場所に保存して、そのキーへの直接リンクを提供することもできます。
ワークフローエディターを開き、コード署名とファイルタブ。
Generic File Storage で、アップロードされたサービスアカウントの JSON キーを見つけ、その名前の下にあるシークレット環境変数をコピーします。

例えば、 BITRISEIO_SERVICE_ACCOUNT_JSON_KEY_URL。
ワークフローを開き、を追加します GooglePlayデプロイ それにステップします。
の中に サービスアカウントのJSONキーファイルのパス を入力し、コピーした環境変数を貼り付けます。
サービスアカウントのJSONキーファイルへのダイレクトパス

サービスアカウントの JSON キーを Bitrise にアップロードしたくない場合は、ステップの入力フィールドにファイルパスを直接追加することもできます。ファイルパスはローカルまたはリモートにすることもできます。
- リモート JSON キーファイルの場合、値として任意のダウンロード場所を指定できます。たとえば、 https://URL/TO/key.json。
- ローカル JSON キーファイルの場合は、ファイルパス URL を値として指定できます。たとえば、次のようになります。 file://PATH/TO/key.json。
の中に パッケージ名 入力し、アプリのパッケージ名を追加します。
の中に追跡入力して、APKをデプロイするトラックを追加します（たとえば、alpha / beta / rollout / productionまたは設定したカスタムトラック）。

導入しようとしている場合は、 アプリ 初めて、 Google Playの設定が正しく設定されていることを確認してくださいそしてあなたはサービスアカウントのJSONキーをBitriseにアップロードしました。

サービスアカウントのJSONキーファイルのアップロード

サービスアカウントの JSON キーを Bitrise にアップロードすることをお勧めしますが、必須ではありません。他の場所に保存して、そのキーへの直接リンクを提供することもできます。
アプリを開きます bitrise.yml ファイルを追加して、 google-play-deploy そこに向かって進んでください。
```
deploy-workflow:
  steps: 
  - google-play-deploy: 
      inputs:   
```
の中に service_account_json_key_path 入力するには、サービスアカウントの JSON キーファイルへのパスを指定する必要があります。

ファイルを Bitrise にアップロードした場合は、ワークフローエディターの汎用ファイルストレージにダウンロード URL を保存している環境変数を見つけることができます。
```
deploy-workflow:
  steps: 
  - google-play-deploy: 
      inputs:   
      - service_account_json_key_path: "$BITRISEIO_SERVICE_ACCOUNT_JSON_KEY_URL"
```
サービスアカウントの JSON キーを Bitrise にアップロードしなかった場合は、入力に直接パスを設定できます。ファイルパスは、ローカルまたはリモートの場所を指すことができます。
- リモート JSON キーファイルの場合、値として任意のダウンロード場所を指定できます。たとえば、 https://URL/TO/key.json。
- ローカル JSON キーファイルの場合は、ファイルパス URL を値として指定できます。たとえば、次のようになります。 file://PATH/TO/key.json。

の中に package 入力、追加パッケージ名アプリの。

deploy-workflow:
  steps: 
  - google-play-deploy: 
      inputs:   
      - service_account_json_key_path: "$BITRISEIO_SERVICE_ACCOUNT_JSON_KEY_URL"
      - package_name: myApp

の中に track 入力として、アプリのバイナリをデプロイするトラック (たとえば、alpha/beta/rollout/production または設定したカスタムトラック) を追加します。
```
deploy-workflow:
  steps: 
  - google-play-deploy: 
      inputs:   
      - service_account_json_key_path: "$BITRISEIO_SERVICE_ACCOUNT_JSON_KEY_URL"
      - package_name: myApp
      - track: alpha
```

それで全部です！ビルドを開始またはスケジュールして、URLを外部テスターと共有するか、選択したアプリストアでアプリを配布してください。

このセクションの内容:

参照:

アプリワークフロービットライズ.ymlワークフローステップステップアプリアプリ

Androidアプリ入門

Bitriseアカウントをお持ちですか？

BitriseへのAndroidアプリの追加

注意

リポジトリURL

SSH キーはいつでも設定できます

プロジェクトの種類

Androidアプリの依存関係の管理

ビルドの依存関係の追加

Androidアプリのテスト

Androidアプリに署名する

その他のコード署名オプション

Androidアプリをbitrise.ioにデプロイする

他のユーザーへの通知

他のユーザーに通知する

初めてGooglePlayの展開を設定する

GooglePlayへのデプロイ

サービスアカウントのJSONキーファイルのアップロード

サービスアカウントのJSONキーファイルへのダイレクトパス

サービスアカウントのJSONキーファイルのアップロード

検索結果