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 を使用して、生成されたバイナリをチームメンバーと共有できます。

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

この例では、 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を外部テスターと共有するか、選択したアプリストアでアプリを配布してください。

このセクションの内容:

参照: