コンテンツにジャンプ

Push fixes to users in minutes, build signed iOS and Android apps without a Mac, and roll back in one click.

一般的なCapgo設定では、 開発 チャンネル 運用 チャンネル。CIはOTAバンドルを devにアップロードし、 production 日本語 --fail-on-incompatible CIは、CIでビルドされるlive updateが新しいネイティブcodeを必要とするものを間違って配信することができない。

Live Update Cloudflare Capacitor GitHub

Capgoのネイティブパッケージの比較の背景について知りたい場合は、まず codeCIブランチでOTA vs Capgo ビルドが自動的に選択される全CIブランチについては、 SDK.

npm

このガイドは dev と production チャンネルはすでに存在します。必要に応じて作成してください:

ターミナルウィンドウ
npx @capgo/cli@latest channel add production com.example.app
npx @capgo/cli@latest channel add dev com.example.app
チャンネル誰が受け取るか通常のアップロード
dev内部/QAビルドJSのCIプッシュ(および意図的なネイティブベースライン)
productionストアユーザーリリース用にアップロードまたはプロモートされる場合のみ

--fail-on-incompatible Live Updateは両チャネルでデフォルトの良い設定です。 毎日OTAのアップロード。アップロードしているバンドルのネイティブパッケージを、現在のチャンネルで公開されているバンドルと比較します。 チャンネルチャンネル

チャンネル

チャンネル

チャンネル

チャンネル
npx @capgo/cli@latest bundle upload com.example.app \
--channel production \
--fail-on-incompatible \
--auto-min-update-version

--fail-on-incompatible チャンネル --auto-min-update-version チャンネル metadata 戦略 (推奨の下記). チャンネルがまだない場合 metadata まだない場合は省略 --auto-min-update-version まだ変更されていない場合

オプションのCIゲート前アップロード:

ターミナルウィンドウ
npx @capgo/cli@latest bundle releaseType com.example.app --channel production
# → OTA safe to upload with --fail-on-incompatible
# → native stop; ship a native binary first (see below)

意図的なネイティブブーム (フラグを一度だけ)

セクション「意図的なネイティブブーム (フラグを一度だけ)」

あなた cannot 新しいネイティブのcodeが必要なバンドルをアップロードする --fail-on-incompatibleアップロードすることができないバンドルが新しいネイティブ Capacitor を必要とする場合、Capacitor を維持することができます。 そのフラグは、正確にそのケースをブロックするために存在します。 プラグイン、Capacitor バージョン、または他のネイティブ依存関係が意図的に変更された場合:

  1. Ship the matching ネイティブバイナリ App Store / Play Store または Capgo Capgo ビルド).
  2. JS バンドルのアップロード without --fail-on-incompatible.
  3. Prefer --auto-min-update-version チャンネルを有効にしながら metadata アップデートの戦略
  4. 新しいアプリをインストールするまで、古いバイナリ上のデバイスは新しいバンドルを受信しないようにするため --fail-on-incompatible そのベースラインアップロード後、通常のOTA CIに戻し --auto-min-update-version チャンネルが有効なまま metadata).
  1. 1回ごとにチャネルごとに: メタデータゲーティングを有効にする

    ターミナルウィンドウ
    npx @capgo/cli@latest channel set production com.example.app --disable-auto-update metadata

    上記のステップを繰り返す dev そのチャネルも意図的にネイティブのベースラインを受け取る場合。 この切り替え後、チャネルにアップロードされるすべてのアップロードには --auto-min-update-version または --min-update-version.

  2. チャネルにマッチしたOTAベースラインをアップロードする

    これは、チャネルに新しいネイティブパッケージを記録します。 その後

  3. ネイティブバイナリを配信する --fail-on-incompatible)

    ターミナルウィンドウ
    npx @capgo/cli@latest bundle upload com.example.app \
    --channel production \
    --auto-min-update-version

    このチャンネルに新しいネイティブパッケージが追加されます。 bundle releaseType / --fail-on-incompatible Baselineを使用します。

  4. 保護されたOTAアップロードを再開します。

    次のJSのみリリースでは、両方のフラグを使用します。

    ターミナルウィンドウ
    npx @capgo/cli@latest bundle upload com.example.app \
    --channel production \
    --fail-on-incompatible \
    --auto-min-update-version

よくある質問

FAQ

Section titled “フラグを省略してアップロードするのは正解ですか?” --auto-min-update-version はい。新しいバイナリを出荷した後、チャンネルのネイティブ基準を進めるには、チャンネルのライブバンドルのネイティブパッケージと一致しないアップロードはフラグを残してください。そうしないと、CI で意図しないネイティブの漂流が失敗しない可能性があります。

Yes. That is the supported way to advance the channel’s native baseline after you ship a new binary. Keep the flag on every other OTA upload so accidental native drift still fails CI.

はい、もしそれがあなたのプロセスと一致する場合。同じルールを実行してください。 per チャンネル:互換性のチェックは、対象チャンネルにライブしているものに基づいて行われます。プロモーションまたは再アップロードは production only after dev looks good、 --fail-on-incompatibleと使用してください。各チャンネルに新しいネイティブパッケージを記録する必要がある場合は、

新しいネイティブ バンドルをアップロードした場合、フラグがまだ有効なままです。

Section titled “フラグがまだ付いていて新しいネイティブバンドルをアップロードした場合”

CI fails and Capgo does not ship that upload. That is the expected outcome. Either the change was accidental (fix the native packages and retry as OTA), or it was intentional (use the native path above).

どのフラグをどのジョブに付けるか

Section titled “どのジョブにどのフラグを付けるか?”
パス状況アップロードフラグ
OTAJSのみ;ネイティブパッケージはチャンネルに合わせる--fail-on-incompatible + --auto-min-update-version チャンネルがオンの場合に必要 metadata)
ネイティブベースライン新しいネイティブバイナリ + マッチングのJSバンドルなし --fail-on-incompatible;保持 --auto-min-update-version

アップロード、互換性、releaseType、関連フラグのリファレンス

ネイティブ + OTA チャンネル ワークフローから続ける

ネイティブ + OTA チャンネル ワークフローから続ける Native + OTA チャネルワークフロー Live Updateをnativeリリース間で安全に保つには、接続する必要があります。 Native互換性 パッケージ比較ルールのために Auto OTAまたはNative CIブランチングのために バージョン目標設定 ページ/エリア: Capgoのソリューションマーケティングページ。役割: セクションまたはページヘッダー。見られる場所: ソリューション/バージョン目標設定.astro。メッセージキー `solutions_version_targeting_title` (ソリューション バージョン目標設定タイトル)。 Capgo CLI バンドル参照 メタデータフロア、そして