ライブ更新なしでネイティブビルドをテストする

インストールステップとフルマークダウンガイドのセットアップ用質問をコピーします。このプラグインについてです。

新しいネイティブバイナリをテストするときは、バイナリ内に組み込まれたウェブアセットから始めてください。ライブアップデートをダウンロードしたものから始めてはいけません。以下のセーフガードの1つまたは複数を使用してください。

1. ネイティブベースラインバージョンを上げる

セット CapacitorUpdater.version ネイティブリリース用のバージョンを使用し、ネイティブビルドごとにバージョンを上げます。新しいネイティブベースラインは、インストール済みのバイナリを古いバンドルと区別し、デフォルトではダウンロードしたバンドルを削除します。 resetWhenUpdate: trueクリップボードにコピー

import type { CapacitorConfig } from '@capacitor/cli';
import pkg from './package.json';

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      // Keep this aligned with, and increase it for, every native build.
      version: pkg.version,
      autoUpdate: 'atBackground',
    },
  },
};

export default config;

は、 version: '1.4.1' よりも高いネイティブベースラインを持っています。ネイティブバージョンを再利用してはなりません。組み込まれたアセットを検証する必要がある場合に限ります。 1.4.0 __CAPGO_KEEP_0__

2. エミュレータと開発用ビルドの更新をコンソールでブロックする

アプリを開いてCapgoコンソールに移動し、 チャンネルを選択し、使用しているビルドのチャンネルを選択し、情報タブを開き、 両方の 開発用ビルドの許可とエミュレータの許可 をオフにします.

Capgo チャンネル情報タブで、開発用ビルドとエミュレーターの設定を表示します — チャンネル情報タブの制御はこちらにあります。両方の設定を無効にすると、開発用ビルドとエミュレーターのウェブアセットがバンドルされます。

このチャンネルポリシーは、選択したビルドタイプのみのアップデート配信をブロックします。物理デバイスに署名されたプロダクションビルドは、チャンネルの他の設定に従ってアップデートを受け取ることができます。

3. Native CI ビルドでのみライブアップデートを有効にする

開発、エミュレータ、ローカルビルドを安全に保証したいチームは、環境変数を通じてライブアップデートをオプトインするようにします。以下の設定では、 CAPGO_LIVE_UPDATES は正確に true:

import type { CapacitorConfig } from '@capacitor/cli';
import pkg from './package.json';

const liveUpdatesEnabled = process.env.CAPGO_LIVE_UPDATES === 'true';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      // Bump package.json for every native build.
      version: pkg.version,
      // Local builds are off; native CI explicitly enables live updates.
      autoUpdate: liveUpdatesEnabled ? 'atBackground' : false,
    },
  },
};

export default config;

CI ステップでネイティブアプリを同期およびビルドする際にのみ、変数を設定してください:

- run: CAPGO_LIVE_UPDATES=true npx cap sync
- run: ./build-native-app.sh

実行 npx cap sync Capacitor がこの設定をネイティブプロジェクトにSync中にコピーするため、変数を設定しないとローカルビルドとエミュレータビルドは autoUpdate: false ライブアップデートのチェックを行わない。

クイックチェックリスト

__CAPGO_KEEP_0__ を使用したバージョンを CapacitorUpdater.version ネイティブバイナリ用に
無効 開発用ビルドを許可 、 エミュレータを許可 チャンネルでテストするビルドタイプのときに通知を受け取る。
ローカルでビルドすることなく CAPGO_LIVE_UPDATES.
セット CAPGO_LIVE_UPDATES=true CIジョブの前に npx cap sync ネイティブのCIジョブでライブアップデートを受け取るようにする。

チャンネル — チャンネルルーティングとポリシー。
アップデートの動作 — アップデートのチェックと適用時。
バージョン対象設定 — __CAPGO_KEEP_0__ bundles に対応するネイティブバージョンと互換性を維持する。