コンテンツにジャンプ
Capgo - Capacitor アプリ向けライブ更新 Capgo

概要

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

Live Updatesのしくみ

__CAPGO_KEEP_0__のLive Updateシステムには2つの主なコンポーネントがあります。

Capgo’s Live Update system has two key components:

  1. The Capgo SDK, which you install in your app. The SDK checks for available updates and downloads them in the background.

  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.

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

Getting Started

「Getting Started」

  1. Live Updates を使用するには、以下の手順に従ってください。 Cloudflare での Capgo Quickstart を完了して、Capgo にアプリを設定し、__CAPGO_KEEP_1__ __CAPGO_KEEP_2__ をインストールしてください。 to set up your app in Capgo and install the Capgo SDK.

  2. code Quickstart CapacitorUpdater.notifyAppReady() after your app has finished initializing. This tells the Capgo SDK that your app is ready to receive updates.

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

    ターミナルウィンドウ
    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

Capgo CLIの設定方法を参照してください。

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

What is the Capgo CLI for?

「Capgo CLIの目的は何ですか?」

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

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

認証

「認証」

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

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

ターミナルウィンドウ
npx @capgo/cli@latest login [API_KEY]

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

CLI ツールとの主な違い

「CLI ツールとの主な違い」というセクション

CLI ツールの Capgo に慣れている場合は、Capgo の CLI について以下の点に注意してください。

  • Capgo は、Capgo がライブ更新機能セットに特化しているため、開発と CI/CD の両方の用途に CLI を使用します。

  • Capgo の CLI は、別途インストールする必要がありません。__CAPGO_KEEP_2__ と同梱されており、直接実行できます。 @capgo/cli __CAPGO_KEEP_0__ の __CAPGO_KEEP_1__ は、ライブ更新ワークフローに特化しているため、より汎用的な __CAPGO_KEEP_2__ ツールに含まれる機能やコマンドが含まれていない可能性があります。 npx.

  • Capgo’s CLI is designed specifically for the live update workflow, so it may not include some features or commands found in more general-purpose CLI tools.

「次のステップ」というセクション

チャンネル

__CAPGO_KEEP_0__

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

ロールバック

更新が問題を引き起こした場合に、前のJSバンドルバージョンに戻る方法を学びましょう。

アップデートの動作

アプリ内でアップデートがダウンロードされ、適用される方法をカスタマイズしましょう。

高速アップデート

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

概要から続ける

概要から続けるセクション

Capgoを使用している場合 概要 ダッシュボードとAPIのオペレーションを計画する場合、Capgoと接続しましょう。 API 在给一宝义的图形一个给一宝义的图形 for the implementation detail in API Overview, 一宝义的图形 一宝义的图形的给一宝义的图形 API Keys for the implementation detail in API Keys, 一宝义的图形 一宝义的图形和 一宝义的图形 一宝义的图形的给一宝义的图形