概要

CapgoのLive Updates機能を使用して、実時間でアプリのJavaScriptバンドルをリモートで更新できます。アプリストアのレビュープロセスを経ることなく、バグを即座に修正し、新機能を配信できます。

常に最新のCLIを使用します。

常にCapgo CLIを実行します。 @latest (例えば npx @capgo/cli@latest). The CLI follows its own versioning and does __CAPGO_KEEP_0__は独自のバージョニングを採用し、 need to match your plugin major or Capacitor major. The latest CLI stays compatible with any supported updater plugin version. See Capgoのバージョニングとは異なり、プラグインのメジャーバージョンやCapgoのメジャーバージョンに合わせる必要はありません。最新の__CAPGO_KEEP_1__は、サポートされているアップデートプラグインのバージョンに関係なく互換性があります。詳しくは.

注記

JavaScript バンドル変更のみ対象のライブアップデートです。 code の更新が必要な場合、例えばプラグインの追加または削除、または code のプロジェクト設定の変更など、ネイティブ code をアップデートする必要があります。

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

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

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

2. チャンネル、ユーザーを特定のグループに分け、アップデートをターゲットにします。チャンネルを使用して、リリーストラックを管理できます。 Production, Stagingアップロードした新しい JS バンドルを __CAPGO_KEEP_0__ にアップロードし、チャンネルに割り当てると、チャンネルに設定されているアプリで __CAPGO_KEEP_1__ __CAPGO_KEEP_2__ がアップデートを検出してダウンロードします。アプリが再起動すると、新しいバンドルが読み込まれます。 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__

1. __CAPGO_KEEP_0__ Capgo クイックスタート Capgoにアプリをセットアップし、Capgo SDKをインストールするには

2. アプリのcode内で CapacitorUpdater.notifyAppReady() Capgo SDKにアプリが初期化完了した後、呼び出してください。この呼び出しにより、Capgo SDKがアプリが更新を受け取る準備ができたことを知らせます。

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

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

4. アプリを開いて、更新をダウンロードするのを待ってください。状態を確認するには:

   npx @capgo/cli@latest app debug

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

See the ライブアップデートのデプロイ の詳細については、

「Capgo CLI」

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

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 の CLI に慣れている場合は、以下の点に注意してください。

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

• Capgo CLI は、別途インストールする必要がありません。__CAPGO_KEEP_2__ は、 @capgo/cli パッケージであり、直接実行可能です。 npx.

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

次のステップ

チャンネル

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

ロールバック

以前のJSバンドルバージョンに戻す方法を学びましょう。

アップデートの動作

アップデートのダウンロードと適用のタイミングと方法をカスタマイズしましょう。

高速アップデート

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

Overviewから続けてください

Capgoを使用している場合 Overview APIとCapgoを接続して APIの概要 APIの概要の実装詳細 Capgoの導入 Capgoのキーの実装詳細 API Keys for the implementation detail in API Keys, Capacitor デバイスの実装詳細については、 バンドル バンドルの実装詳細については。