ReactNativeアプリの使用を開始する

概要

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

Expoプロジェクト

React NativeプロジェクトでExpoを使用する場合は、専用のガイドがあります。 Expoアプリの使用を開始する。

ReactNativeプロジェクトをで簡単にセットアップおよび構成できますビットライズ。 React NativeリポジトリはAndroidプロジェクトとiOSプロジェクトで構成できるため、AndroidアプリとiOSアプリで通常行うように構成を行う必要があります。 BitriseでReactNativeプロジェクトを実行すると、最初にAndroid、次にiOSビルドがビルドされることがわかります。

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

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

ReactNativeアプリをBitriseに追加する

この手順では、アプリをBitriseに追加し、リポジトリに接続し、リポジトリアクセスを設定し、ブランチを選択し、プロジェクトを検証するプロセスについて説明します。以下では、ReactNative固有の構成もいくつか取り上げます。

Bitrise にログインし、ダッシュボード。
をクリックします新規プロジェクトボタン。
[選択] ビットライズ CI の設定。
アンダープロジェクトアクセスで、プロジェクトを所有するワークスペースを選択します。
プロジェクトの CI ビルドにアクセスできるユーザーを設定します。

プライバシーは最後

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

次の中から選択できます。
- 接続されている Git プロバイダーアカウント:いずれか経由 OAuth コネクションまたは GitHub アプリによるリポジトリへのアクセス。
- 接続されていない Git プロバイダーアカウント:接続するよう求められます。
- その他: GitHub/GitLab/Bitbucket 以外の Git プロバイダー。
リポジトリを選択します。
- 接続されている Git アカウントを選択した場合は、をクリックできますリポジトリを選択してください。そのアカウントで利用可能なリポジトリから選択します。
- いずれの場合も、URL は手動で入力できます Git リポジトリ (クローン) URL。SSH URL を設定する場合を除き、SSH URL を使用することを強くお勧めしますパブリックプロジェクト。
リポジトリ URL

次のことができるようになりますプロジェクトのリポジトリー URL を変更します。後で。また、アカウントを Git プロバイダーサービスにいつでも接続または切断できます
OAuth接続を使用する場合は、 SSHキーを追加するの中に Bitriseを承認するセクション。

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

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

プロジェクトの種類

プロジェクトタイプの検出は、アプリの初期構成を支援するのに役立ちます。ただし、アプリを追加した後はいつでも、プロジェクトタイプを含むすべての設定を変更できますのでご安心ください。
Bitriseがプロジェクトを検証している間待ちます。選択したブランチで構成ファイルが利用できる場合、スキャナーはアプリをReactNativeアプリとして検出します。

プロジェクトが1つのモジュールのみで構成されている場合、そのモジュールは自動的に選択されます。 モジュール。プロジェクトに複数のモジュールが含まれている場合は、モジュールを選択できますが、メインのモジュールをお勧めします。
の中に 変異体 フィールドで、プロジェクトに適したバリアントを選択します。選ぶ すべてのバリアントを選択 すべてのバリアントをビルドします。選ぶ デバッグ また リリース APKまたはIPAファイルを生成する場合。
の中に プロジェクト（またはワークスペース） フィールドで、XcodeプロジェクトまたはXcodeワークスペースパスを選択します。
の中に スキーム名を選択、スキーム名を選択します。プロジェクトにSHAREDスキームがない場合、スキャナーの検証は失敗します。 Bitriseを手動でXcodeスキームにポイントすることもできますが、共有されている場合は、自動的に検出されます。
の ipaエクスポート方法を選択します、.ipaファイルのエクスポート方法を選択します：アドホック、アプリストア、開発、またはエンタープライズ方法。心配しないでください。後で変更できます。
プロンプトが表示されたら Webhook を登録すると、コードがリポジトリにプッシュされたとき、またはプルリクエストが作成されたときに Bitrise が自動的にビルドを開始できるようになります。
完了したら、をクリックしますプロジェクトページを表示新しく追加されたプロジェクトのホームページに移動します。そこから、始めることができますワークフローの編集そしてビルドの実行。

これで、ReactNativeプロジェクトが正常にセットアップされました。 bitrise.io！最初のビルドは自動的に開始されます。最初のビルドで生成されたアーティファクトを確認できますアーティファクトビルドのページのタブ。

の依存関係のインストールリアクトネイティブアプリ

Bitriseプロジェクトスキャナーが正常にスキャンした場合リアクトネイティブ事業、 npmコマンドを実行します また ヤーンコマンドを実行する ステップはデフォルトのワークフローに含まれます。これらの手順により、不足しているJavascriptの依存関係をアプリにインストールできます。

ネイティブAndroidの依存関係については、 不足しているAndroidSDKコンポーネントをインストールする ステップ。

ネイティブiOSの依存関係については、特に、 Homebrewインストール ステップまたは CocoaPodsインストールを実行します ステップ。

npmを使用してJavascriptの依存関係をインストールするには：

npmの代わりにYarnを使用する

このガイドでは、npmを使用してJavascriptの依存関係をインストールしています。ただし、 ヤーンコマンドを実行する 手順：追加の構成を必要とせずに、不足しているJS依存関係をインストールできます。

でアプリを開きますビットライズ。
クリックワークフローメインページのボタン。
ワークフローに npmコマンドを実行します ステップ。
の中に 実行する引数を指定したnpmコマンド 入力フィールド、タイプ インストール。

を使用して npm ci コマンドの代わりに npm install

すでに最新版をお持ちの場合 package-lock.json プロジェクトでファイルを使用することをお勧めします。 シ コマンドイン実行する引数を指定した「npm」コマンド入力。使用する npm ci に比べてビルド時間が大幅に短縮されるだけでなく、 npm install しかし、より信頼性の高いビルドも同様です。

ReactNativeアプリのコード署名

React Nativeアプリは、AndroidとiOSの2つのプロジェクトで構成できます。どちらも、署名手順が異なります。プロジェクトのワークフローエディタの[コード署名]タブをクリックすると、すべてのiOSおよびAndroidコード署名フィールドが1ページに表示されます。プラットフォーム固有の手順に従って、iOSとAndroidの両方のアプリにコード署名します。

Androidプロジェクトに署名する

すべてのAndroidアプリは、Androidデバイスにインストールする前に、証明書を使用してデジタル署名する必要があります。 Bitriseでは、この目的のために専用のステップを使用できますが、最初にキーストアファイルが必要になります。

キーストアファイルを生成する。
Bitriseでアプリを開くには、管理者アプリチームでの役割。
に移動します設定タブ。
左側で [] を選択します。コード署名メニューから。
でアンドロイドタブ、クリックキーストアファイルを追加。
ダイアログで、ファイルをドラッグアンドドロップして必須フィールドに入力し、をクリックします続行
クリックワークフロー名の横にあるボタンをクリックします。
を追加 アンドロイドサイン ワークフローにステップアップ。

Android Sign ステップの前提条件

必ず追加してください 人造人間のサイン ビルドステップの後のステップ (Android ビルド ステップまたは Gradle ランナー ステップ) をワークフローに追加します。

Xcode プロジェクト用の署名付き IPA の作成

概要

Apple接続が正しく設定されていて、コード署名ファイルをビルドで利用できるようにしておけば、BitriseでXcodeプロジェクト用の署名付きIPAファイルを簡単に作成できます。

ビットライズでの iOS コードサイニングの概要

コードサイニングのアセット管理に使用できるステップの概要については、次のサイトをご覧ください。 iOS コード署名ページ。

Bitriseを使えば、Xcodeプロジェクト用の署名付きIPAファイルを簡単に作成することができます。

設定が完了しました Apple サービス接続ビットライズで。
きみのコード署名ファイルは正しく管理されている。。
当社の関連インプットを設定します iOS 用 Xcode アーカイブとエクスポート ステップ。

配布物と開発署名証明書をアップロードする

プロジェクトの開発署名証明書と配布署名証明書の両方をアップロードすることを強くお勧めします。開発署名証明書をアップロードしていない場合、自動プロビジョニングオプション付きの Steps では、ビルドを開始するたびにその場で証明書が生成されます。その結果、最終的に証明書の数が最大数に達し、新しいビルドを開始できなくなる可能性があります。

設定がすべて完了したら、お使いのIPAエクスポートの設定に進んでください ワークフロー。

[en] Workflow Editor

[en] bitrise.yml

必要なことを確認してくださいコード署名ファイルが収集され、アップロードされました。
お持ちであることを確認してください iOS 用 Xcode アーカイブとエクスポート ワークフローにステップイン。
を設定 配布方法 ステップの入力。

オプションは以下のとおりです。
- app-store: アプリを App Store にデプロイする場合はこれを選択してください。配布証明書と App Store プロビジョニングプロファイルが必要です。
- ad-hoc: アプリをアドホックテスターにデプロイしたい場合はこれを選択してください。配布証明書とアドホックプロビジョニングプロファイルが必要です
- enterprise: Apple Enterprise アカウントを持っていて、そのアカウントを使ってアプリを配布したい場合はこれを選択してください。
- development: 内部テストにはこれを選択してください。開発者証明書と開発プロビジョニングプロファイルが必要です。
を設定 自動コード署名 コード署名に使用したい Apple サービス接続に入力します。選択できるオプションは以下のとおりです。
- off 自動コード署名を使用しない場合。
- api-key API キー認証を使用する場合。
- apple-id Apple ID 認証を使用する場合。
ワークフローを保存し、新しいビルドを開始します。

すべてを確認してください必要なコード署名ファイルビルドで使用できます。
[en] Open the bitrise.yml file of your app.
[en] Make sure you have the xcode-archive Step in your Workflow.
```
my-workflow:
  steps:
  - xcode-archive:
      inputs:
```
[en] Set the distribution_method input to the correct value. The available options are:
- [en] app-store: Choose this if you want to deploy the app to the App Store. Requires a Distribution certificate and an App Store provisioning profile.
- [en] ad-hoc: Choose this if you want to deploy the app to ad-hoc testers. Requires a Distribution certificate and an Ad Hoc provisioning profile.
- [en] enterprise: Choose this if you have an Apple Enterprise account and want to use that to distribute your app.
- [en] development: Choose this for internal testing. Requires a Developer certificate and a Development provisioning profile.
```
my-workflow:
  steps:
  - xcode-archive:
      inputs:
      - distribution_method: development
```
[en] Set the automatic_code_signing input to the Apple service connection you want to use for code signing. The available options are:
- [en] off if you don’t do automatic code signing.
- [en] api-key if you use API key authorization.
- [en] apple-id if you use Apple ID authorization.
```
my-workflow:
  steps:
  - xcode-archive:
      inputs:
      - automatic_code_signing: api-key
      - distribution_method: development
```

それがすべてです。Xcode は、プロジェクトのバンドル ID とチーム ID の設定、および設定したエクスポート方法に基づいて、適切な署名ファイルを自動的に選択します

別のチームのコード署名ファイルによる IPA ファイルの署名

別のチームのコード署名ファイルを使用して IPA ファイルに署名したい場合があります。例えば:

会社のコード署名ファイルを内部ビルドに使用し、クライアントのコード署名ファイルをApp Storeの配布に使用する場合。
Apple IDを自動コード署名に使用していて、そのApple IDが複数のチームに属している場合は、このエクスポート入力に使用するデベロッパーポータルチームを使用して、自動コード署名アセット管理に使用するチームを指定します。

そのためには:

新しい開発チームの正しいコード署名ファイルがBitriseにアップロードされていることを確認してください。
このエクスポートオプションに使用するデベロッパーポータルチームも設定します (さらに 配布方法)。
を設定 配布方法。

ReactNativeアプリのテスト

ReactNativeの組み込みテストメソッドを使用できます。冗談ユニットテストを実行します。

でアプリを開きますビットライズ。
クリックワークフローメインページのボタン。
追加します npmコマンドを実行します ワークフローに進みます。
の中に 実行する引数を指定したnpmコマンド 入力フィールド、タイプ テスト。

React Native テストの詳細ガイドについては、以下を参照してください。 React Native アプリのテスト。

リアクトネイティブのテスト結果を表示する

Bitriseでは、テスト結果を1つの便利な場所で表示および分析できます。テスト結果の展開と表示.

デフォルトでは、テストは次のコマンドで実行されます。 npm コマンドを実行する ステップはテストレポートに表示されません。ただし、結果はエクスポートできます。基本的なプロセスは次のとおりです。

を生成します。 junit.xml ビルド中にファイルを作成します。

たとえば、次のように使用できますジェスト・ジュニットレポートを作成するため。
を追加 テスト結果をテストレポートにエクスポートする ワークフローにステップアップ。
でカスタムテスト結果が存在するパス入力して、次のフォルダを追加します。 junit.xml ファイルやその他のテスト結果が見つかります。
の中にテスト結果の検索パターン入力、設定 *.xml。
の中にテストの名前入力して、テスト実行の名前を設定します。

テスト結果はこの名前で表示されます。
持っていることを確認してください Bitrise.io にデプロイする ワークフローにステップインします。

ReactNativeアプリのデプロイ

ReactNativeアプリを次の場所にデプロイできます。

bitrise.io：これにより、生成されたバイナリをダウンロードし、パブリックインストールページを介して他のユーザーと共有できます。
オンラインストア：複数の異なるオンラインストアを統合しています。これらのガイドでは、GooglePlayとAppleのAppStoreに公開する方法を紹介します。

コードプッシュ

Bitrise CodePushを使用して、ユーザーのデバイスにアップデートをデプロイすることができます。CodePush はその一部です。リリース管理また、React NativeアプリとExpoアプリでもサポートされています。

CodePush の詳細については、以下の公式ガイドをご覧ください。ビットライズコードプッシュ.

クロスプラットフォームアプリをbitrise.ioにデプロイする

The bitrise.ioにデプロイします ステップは、ビルドに関連するすべてのアーティファクトをにアップロードします アーティファクト ビルドのページのタブ。

パブリックインストールページを使用して、生成されたアプリファイル（Androidの場合はAAB、iOSの場合はIPAファイル）をチームメンバーと共有できます。パブリックインストールページは、生成されたアプリバイナリをデバイスにインストールできる他のユーザーと共有できるURLです。 AAB / APKまたはIPAファイルが作成されたことをユーザーグループまたは個々のユーザーに通知することもできます。

expo.ioへの公開

NS Bitrise.ioにデプロイします ステップはExpoコマンドを使用せず、に公開しません expo.io。このステップでは、アーティファクトをBitriseに公開しますが、特定のプラットフォームに固有のものではありません。

に公開する必要がある場合 expo.io、をセットする イジェクト後にexpopublishを実行しますか？ の入力 イジェクトエキスポ にステップ yes。その場合、公開するExpoアカウントのユーザー名とパスワードを入力する必要があることに注意してください expo.io。

でアプリを開きますビットライズ。
クリックワークフローメインページのボタン。
あなたが持っていることを確認してください bitrise.ioにデプロイします ワークフローにステップインします。
の中に 通知：ユーザーの役割、この役割が付与されている人だけに通知されるように、役割を追加します。または、 通知：メール 通知するユーザーの電子メールアドレスを含むフィールド。

これらのメールアドレスを次のように設定してください秘密！これらの詳細は、以下で変更することもできます。通知クリックすると目で生成されたバイナリの横にあるアイコン アーティファクト タブ。
ステップでパブリックインストールページを生成する場合は、アプリの公開ページを有効にしますか？への入力 NS。

アプリストアコネクトへのアプリのデプロイ

アプリをiTunesConnectにプッシュするたびに、固有のビルドとバージョン番号が必要であることに注意してください。いずれかまたは両方をインクリメント展開する前に。

あなたが働いていることを確認してください AppleDeveloperアカウントへの接続。
自分のマシンで少なくとも1回はIPAファイルを生成します。
必要なコード署名ファイルをすべてアップロード Bitrise へ。

アプリを App Store Connect にデプロイするには、配布タイプの証明書と App Store タイプのプロビジョニングプロファイルが必要です。
確認してください iOS用のXcodeアーカイブとエクスポート ステップはワークフローにあります。
をセットする 自動コード署名 コード署名に使用するAppleサービス接続への入力。使用可能なオプションは次のとおりです。
- off 自動コード署名を使用しない場合、またはAppleサービス認証にステップ入力のみを使用する場合。
- api-key 使用する場合 APIキー認証。
- apple-id 使用する場合 AppleID認証。
をセットする エクスポート方法を選択してください ステップの入力 app-store。

このステップでは、エクスポートされた.ipaファイルのパスが$ BITRISE_IPA_PATH環境変数に保存されます。
追加します Deploy to iTunes Connect ワークフローに進みます。
必要な入力を入力します。
- アプリのAppleIDまたはバンドルIDのいずれかが必須の入力です。 2つのうちの1つを提供する必要があります。
- あなたが設定した場合 レビューのために送信 に true、ステップは、送信がiTunes Connectで処理されるのを待ってから、指定されたバージョンのアプリをレビューのために送信します。
- のデフォルト値 アプリバージョンの更新をスキップ 入力は No。別の方法でアプリのバージョン番号をインクリメントした場合にのみ変更してください。
- 複数のチームにリンクされているiTunesConnectアカウントを使用する場合は、チームIDまたはチーム名のいずれかを入力してください。
ビルドを開始します。

すべてがうまくいけば、アプリはiTunes Connectに送信され、TestflightまたはAppStoreから配布できます。

AndroidプロジェクトをGooglePlayにデプロイする

あなたは使用することができます GooglePlayにデプロイする ワークフローにステップインして、デジタル署名されたAAB / APKをGooglePlayストアにアップロードします。

コード署名を構成するあなたのアプリのために。
GooglePlayアクセスを構成します。

これを行う必要があるのは、アプリの最初のGooglePlayデプロイの場合のみです。
あなたが持っていることを確認してください GooglePlayにデプロイする 後のステップ Androidサイン ワークフローにステップインします。
次のように、必須の入力フィールドに入力します。
- サービスアカウントのJSONキーファイルパス：このフィールドはリモートURLを受け入れることができるため、アップロードされたサービスアカウントのJSONキーを含むEnvVarを指定する必要があります。例えば： $BITRISEIO_SERVICE_ACCOUNT_JSON_KEY_URL。
- パッケージ名：Androidアプリのパッケージ名。
- 追跡：APKをデプロイするトラック（たとえば、alpha / beta / rollout / productまたは設定したカスタムトラック）。

このセクションの内容:

参照:

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