Skip to main content

CodePush プラグインを使用する

概要

Initialize and run a CodePush project after successfully installing the CodePush CLI plugin.

CodePush プロジェクトを初期化する

CodePushプラグインを正常にインストールし、認証を設定したら、Bitrise CLIから新しいプロジェクトを開始できます。プロジェクトを開始するには、以下のコマンドを実行します。

bitrise :codepush init

このコマンドは、 .codepush.json 現在のディレクトリにあるファイル。このファイルにはアプリ ID が保存されています。これをバージョン管理にコミットして、チームが同じ設定を共有できるようにすることができます。

When running the init command for the first time, the CLI will prompt you for the app ID. You can get it from the URL of the app in Release Management: https://app.bitrise.io/release-management/workspaces/<workspace-slug>/connected-apps/<app-id>/, or via the API.

 Enter your app ID (UUID):
>a3f47d2c-6b9e-4f1a-9d2b-7c8e5a1b2c3d

または、次のように ID を渡すこともできます --app-id フラグ。これはグローバル設定なので、これを使用すれば、の実行時にアプリ ID の入力を求められることはなくなります init 同じディレクトリ内のコマンド:

bitrise :codepush init --app-id a3f47d2c-6b9e-4f1a-9d2b-7c8e5a1b2c3d

別のオプションは設定することです $CODEPUSH_APP_ID 環境変数。アプリ ID が複数のソースから入手できる場合、プラグインは次の順序でそれらを解決します

  1. --app-id フラグ (最優先)

  2. $CODEPUSH_APP_ID 環境変数

  3. codepush.json 現在のディレクトリにあるファイル

既存のものを上書きできます .codepush.json を含むファイル --force フラグ:

bitrise :codepush init --force --app-id a3f47d2c-6b9e-4f1a-9d2b-7c8e5a1b2c3d

アップデートのバンドルとプッシュ

CodePush 経由でアプリを更新するには、更新バンドルを作成して Codepush サーバーにプッシュする必要があります。CodePush CLI プラグインには、

  • codepush bundle: React Native プロジェクトと Expo プロジェクト用の JavaScript バンドルを生成します。プロジェクトタイプ、エントリファイル、Hermes 設定、Metro 設定を自動検出します

  • codepush push: ビルド済みバンドルをデバイスにプッシュします。アプリケーションバージョンとデプロイ名または ID を指定する必要があります

アプリをプラットフォームごとに個別にバンドルします。

codepush bundle --platform ios
codepush bundle --platform android

ビルド済みのバンドルをプッシュします。APP_UUID を、リリース管理のアプリの URL から取得できるアプリの UUID に置き換えてください

codepush push ./codepush-bundle \
  --app-id <APP_UUID> --deployment Staging --app-version 1.0.0

アプリのバンドルとプッシュを 1 つのステップで行うこともできます。

codepush push --bundle --platform ios \
  --app-id <APP_UUID> --deployment Staging --app-version 1.0.0

プロモートとパッチ適用

CLI で既存の CodePush リリースを更新するには、次の 2 つのコマンドを使用します。

  • promote: あるデプロイメントから別のデプロイメントにリリースをコピーします。リリースをステージング環境から本番環境に移行する場合に最も一般的に使用されます

  • patch: コードを再デプロイせずに既存のリリースのメタデータを更新します。

メタデータを上書きしながら、リリースをステージングから本番環境に移動します。

codepush promote \
  --source-deployment Staging \
  --destination-deployment Production \
  --app-id <APP_UUID> \
  --rollout 25 --description "Gradual rollout"

パス --no-duplicate-release-error ターゲットデプロイメントに同じ内容のリリースが既に含まれている場合、エラーではなく警告を表示して 0 を終了します。

特定のリリースにパッチを適用する:

codepush patch --deployment Production --label v5 --mandatory true --app-id <APP_UUID>

最新リリースでのロールアウトを増やす:

codepush patch --deployment Production --rollout 50 --app-id <APP_UUID>

ロールバック

を使用して、以前のバージョンを反映した新しいリリースを作成できます。 rollback コマンド。

直前のリリースへのロールバック:

codepush rollback --deployment Production --app-id <APP_UUID>

特定のリリースへのロールバック

codepush rollback --deployment Production --target-release v3 --app-id <APP_UUID>

CodePush デプロイメントの管理

CodePush デプロイを作成して、デプロイキーを取得します。CodePush アップデートをアプリにリリースするには、デプロイキーが必要です

CLIプラグインでは、デプロイメントを一覧表示したり、その詳細やリリース履歴を表示したりすることもできます。デプロイからすべてのリリースをクリアすることもできます

すべてのデプロイメントを一覧表示:

codepush deployment list --app-id <APP_UUID>
codepush deployment list --display-keys --app-id <APP_UUID>

を使用して新しい配置を作成します deployment add コマンド。名前を設定し、アプリ ID を入力する必要があります。

codepush deployment add Beta --app-id <APP_UUID>

既存のカスタムデプロイキーを使用して新しいデプロイを作成します。

codepush deployment add Beta --key my-custom-key --app-id <APP_UUID>

デプロイの詳細と最新リリースを表示するには deployment info。デプロイ名とアプリ ID を入力する必要があります。

codepush deployment info Staging --app-id <APP_UUID>

でリリース履歴を表示する deployment history コマンド。デフォルトでは直近の 10 リリースが表示されますが、次のものも使用できます。 --limit その値を変更するフラグ。

codepush deployment history Staging --app-id <APP_UUID>
codepush deployment history Staging --limit 25 --app-id <APP_UUID>

リリースの作成者に問い合わせることもできます。

codepush deployment history Staging --display-author --app-id <APP_UUID>

を使用してデプロイの名前を変更します deployment rename コマンド。を設定する必要があります OldName と NewName 属性:

codepush deployment rename OldName --name NewName --app-id <APP_UUID>

を使用してデプロイメントからすべてのリリースをクリア deployment clear。これは破壊的な操作であり、 --yes CI 設定のフラグ。

codepush deployment clear Staging --app-id <APP_UUID> --yes

を使用してデプロイを削除します deployment remove コマンド。これは破壊的な操作であり、必要なのは --yes CI 設定のフラグ。

codepush deployment remove Beta --app-id <APP_UUID> --yes

コードプッシュアップデートの管理

CodePush CLI プラグインを使用してアプリの更新を管理します。更新の詳細を表示したり、処理状況を確認したり、更新を削除したりできます

で最新のアップデートの詳細を表示 update info コマンド:

codepush update info Staging --app-id <APP_UUID>

特定のアップデートをラベル別に表示するには --label フラグ:

codepush update info Staging --label v5 --app-id <APP_UUID>

でアップデートの処理状況を確認してください update status コマンド。これはプッシュ後に便利です:

codepush update status Staging --app-id <APP_UUID>

を使用して特定の更新を削除します update remove コマンド。を使用してください。 --label 更新を指定するフラグと --yes 削除を確認するには:

codepush update remove Staging --label v3 --app-id <APP_UUID> --yes
このセクションの内容: