概要

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

常に最新のCLIを使用する

常にCapgoとCLIを最新の状態に保つ @latest (例えば npx @capgo/cli@latest)。CLIは独自のバージョニングを実行し、プラグインのメジャーバージョンやCLIのメジャーバージョンと一致する必要はありません。__CAPGO_KEEP_1__の最新バージョンは、サポートされているアップデートプラグインのバージョンに関係なく互換性があります。CLIのバージョニングを参照してください。 注意 need to match your plugin major or Capacitor major. The latest CLI stays compatible with any supported updater plugin version. See ライブアップデートはJavaScriptバンドル変更に限られます。ネイティブCapgoを更新する必要がある場合、例えばプラグインを追加または削除したりネイティブプロジェクトの構成を変更したりする場合は、アプリストアに新しいネイティブバイナリビルドを提出する必要があります。.

__CAPGO_KEEP_1__

code

How Live Updates Work

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

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

2. チャンネルは、特定のユーザー グループにアップデートをターゲットにすることを可能にします。チャンネルを使用して、異なるリリース トラックを管理できます。たとえば、 Production, Staging、 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__がアップデートを検出してダウンロードします。アプリが再起動すると、新しいバンドルが読み込まれます。

「はじめに」

1. ライブアップデートを使用するには、次の手順に従ってください: Capgoクイックスタートを完了してください アプリをCapgoにセットアップし、Capgo SDKをインストールする。

2. アプリのcode内で CapacitorUpdater.notifyAppReady() Capgoが初期化を完了した後、このアプリが更新を受け取る準備ができたことをCapgo SDKに通知します。

3. CapgoにJSバンドルをビルドし、アップロードする。

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

4. アップデートがダウンロードされるまで、アプリを開いて待機します。ステータスを確認するには:

   npx @capgo/cli@latest app debug

5. アップデートがダウンロードされた後、アプリを閉じて再起動して、新しいバンドルをロードする。

「 ライブアップデートのデプロイ 詳細はこちらのガイドを参照してください。

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は何ですか?

Capgo CLIは、開発者やチームがライブアップデートワークフローにおける制御と柔軟性を必要とする場合に設計されています。CLIをCI/CDパイプラインに組み込むことで、次のことが可能になります。

• ビルドとデプロイのタイミングを、Capgoの組み込みの自動化に依存せずに決定できます。
• ビルドとデプロイのステップの間に、codeの署名、QAテスト、またはマネージャーの承認などの独自のプロセスを挿入できます。
• Capgoを既存のDevOpsツールとワークフローに統合できます。

認証

Capgoを使用するには、CLIを使用するには、APIキーの認証が必要です。 API キーを Capgo アカウント設定で生成できます。

ログインしてAPIキーセキュアに保存するには、

npx @capgo/cli@latest login [API_KEY]

このコマンドは、ログイン後に各コマンドにAPIキーコンテンツを提供する必要がなくなります。

CLIツールとの主な違い

CLIの場合、Capgoは開発とCI/CDの両方の用途に使用されます。CLIは、ライブアップデート機能セットにのみ焦点を当てています。

• Capgo uses a single CLI for both development and CI/CD use cases, as Capgo is focused solely on the live update feature set.

• CapgoのCLIは、ライブアップデートワークフローに特化しているため、より汎用的な__CAPGO_KEEP_2__ツールで見つけることができる機能やコマンドが含まれていない場合があります。 @capgo/cli __CAPGO_KEEP_0__の__CAPGO_KEEP_1__は、ライブアップデートワークフローに特化しているため、より汎用的な__CAPGO_KEEP_2__ツールで見つけることができる機能やコマンドが含まれていない場合があります。 npx.

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

次のステップ

チャンネル

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

ロールバック

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

アップデートの動作

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

高速アップデート

高速アップデートを使用してアップデートプロセスを速める方法を学びます。

「概要」から続けて

If you are using 概要 を計画するダッシュボードとAPIの操作に接続する APIの概要 APIの概要の実装詳細について 導入 導入の実装詳細について APIのキー APIのキーに関する実装詳細について デバイス デバイスに関する実装詳細について バンドル __CAPGO_KEEP_0__の実装詳細については、Bundlesの詳細を参照してください。