概要

Capgoのライブアップデート機能を使用して、実時間でアプリのJavaScriptバンドルをリモートで更新できます。アプリストアのレビュープロセスを経ることなく、ユーザーに直接JSアップデートをプッシュして、バグを即座に修正し、新機能をリリースできます。

注意

ライブアップデートはJavaScriptバンドル変更に限られます。codeのネイティブ部分を追加または削除したり、ネイティブプロジェクトの構成を変更したりする必要がある場合は、アプリストアに新しいネイティブバイナリビルドを提出する必要があります。

ライブアップデートのしくみ

Capgoのライブアップデートシステムには2つの主なコンポーネントがあります。

1. CapgoのSDK、アプリにインストールするものです。SDKは、利用可能なアップデートをチェックし、バックグラウンドでダウンロードします。

2. チャンネル、ユーザーを特定のグループにターゲットにすることができる機能です。チャンネルを使用して、リリーストラックを管理することができます。 Production, Staging, and Dev.

When you upload a new JS bundle to Capgo and assign it to a channel, the Capgo SDK in apps configured for that channel will detect the update and download it. The next time the app restarts, the new bundle will be loaded.

アプリを__CAPGO_KEEP_0__に新しいJSバンドルをアップロードし、チャンネルに割り当てると、__CAPGO_KEEP_1__が__CAPGO_KEEP_2__を検出し、指定されたチャンネルに設定されているアプリでアップデートをダウンロードします。アプリが再起動すると、新しいバンドルが読み込まれます。

Live Updatesを使用するには、以下の手順に従ってください。

1. を完了してください。 CapgoのQuickstart Capgoにアプリを設定し、Capgo SDKをインストールするには、以下の手順に従ってください。

2. code内で、 CapacitorUpdater.notifyAppReady() Capgo SDKにアプリが起動したことを通知します。

3. Capgo:JSバンドルをビルドし、Cloudflareにアップロードしてください。

   npm run build
   npx @capgo/cli@latest bundle upload --channel=production

4. アプリを開いて、更新をダウンロードしてください。更新のステータスを確認するには、以下のコマンドを実行してください。

   npx @capgo/cli@latest app debug

5. 更新がダウンロードされたら、アプリを閉じて再起動してください。

詳細は ライブアップデートの Deploying Live Updates

The Capgo CLI

The Capgo CLI is a powerful tool that allows developers to interact with Capgo’s services from their own CI/CD pipelines. With the CLI, you have granular control over when builds are produced and deployed, enabling you to integrate Capgo into your existing enterprise workflows.

「Capgo CLI」は、開発者がCI/CDパイプラインで__CAPGO_KEEP_2__のサービスと対話できる強力なツールです。__CAPGO_KEEP_3__を使用すると、ビルドの生成と展開を細かく制御できます。これにより、__CAPGO_KEEP_4__を既存のエンタープライズワークフローに統合できます。

The Capgo CLI is designed for developers and teams who need more control and flexibility in their live update workflows. By using the CLI in your CI/CD pipelines, you can:

• 「Capgo __CAPGO_KEEP_1__」は、開発者やチームがライブアップデートワークフローでより多くの制御と柔軟性が必要な場合に設計されています。__CAPGO_KEEP_2__をCI/CDパイプラインに組み込むことで、次のことができます。
• codeを自社のプロセスに組み込んでください。例えばcode署名、QAテスト、またはマネージャーの承認など
• Capgoを既存のDevOpsツールとワークフローに統合してください

認証

To use the Capgo CLI, you’ll need to authenticate with your API key. You can generate an API key in your Capgo account settings.

APIキーを安全に保存し、ログインするには、以下のコマンドを実行してください

npx @capgo/cli@latest login [API_KEY]

このコマンドは、ログイン後に使用するために保存されます。APIキーを毎回指定する必要はありません。

CLIツールと他のツールとの主な違い

If you’re familiar with other live update CLI tools, there are a few key things to note about Capgo’s CLI:

• CapgoはCLIを1つだけ使用し、開発とCI/CDの用途で使用します。Capgoは、ライブアップデート機能セットにのみ焦点を当てています。

• CapgoのCLIには、別のインストールステップが必要ありません。 @capgo/cli __CAPGO_KEEP_0__はパッケージと一緒にバンドルされており、直接__CAPGO_KEEP_0__の__CAPGO_KEEP_1__を使用して実行できます。 npx.

• CapgoのCLIは、ライブアップデートワークフローに特化しているため、より一般的なCLIツールで見つけることができる機能やコマンドが含まれていない可能性があります。

次のステップ

チャンネル

チャンネルを使用して、異なるリリーストラックを管理し、特定のユーザーにアップデートをターゲットにする方法を学びます。

ロールバック

アップデートが問題を引き起こした場合に、前のJSバンドルバージョンに戻す方法を発見してください。

アップデートの動作

アプリでアップデートがダウンロードされ、適用される方法と時期をカスタマイズしてください。

高速更新

高速更新を使用して更新プロセスを速める方法を学びましょう。

概要から続ける

__CAPGO_KEEP_0__を使用している場合 概要 APIと接続して、APIの概要を計画し、APIの操作を行います。 APIの概要 APIの概要の実装詳細については、APIの概要を参照してください。 概要 概要の実装詳細については、概要を参照してください。 APIのキー APIの実装詳細についてのキーの デバイス __CAPGO_KEEP_0__の実装詳細についてのデバイス、そして バンドル __CAPGO_KEEP_0__の実装詳細についてのバンドル。