ライブ アップデートなしでネイティブ ビルドをテストする

新しいネイティブバイナリをテストする際は、バイナリに含まれるウェブアセットから起動するようにしてください。Live Updateでダウンロードしたものではありません。以下のセーフガードの1つまたは複数を使用してください。

1. Native Baseline Versionのバージョンを上げる

設定 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 バンドルよりも高いネイティブベースラインを持っています。バンドル内のアセットを検証する必要がある場合には、ネイティブバージョンを再利用しないでください。

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

Open your app in the Capgo console, go to チャンネルを選択し、 情報 タブ。有効 オフ 両方 開発用ビルドの許可 と エミュレータの許可.

チャンネル情報タブに表示される開発用ビルドの許可とエミュレータの許可の設定

注意

注意

スクリーンショットは、設定の場所と強調表示されたスイッチの有効/無効の状態を示しています。開発ビルドやエミュレータを送信しないようにするチャンネルでは、両方のスイッチをオフにします。

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 ステップで変数を設定する際に、変数を設定するだけにします。__CAPGO_KEEP_0__ は、この設定を Sync 時にネイティブ プロジェクトにコピーします。変数を設定しないと、ローカル ビルドとエミュレータ ビルドは

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

クイック チェックリスト npx cap sync after setting the variable because Capacitor copies this configuration into the native projects during sync. Without the variable, local builds and emulator builds keep autoUpdate: false Run

Copy to clipboard

1. バージョンを増やす CapacitorUpdater.version ネイティブバイナリ用の
2. 無効 開発用ビルドを許可 そして エミュレータを許可 チャンネルでテストするビルドタイプのときに
3. ローカルでビルドする CAPGO_LIVE_UPDATES.
4. 設定 CAPGO_LIVE_UPDATES=true のみ npx cap sync ネイティブのCIジョブで

ライブアップデートを受け取るものにすべき

• チャンネル —チャンネルルーティングとポリシー
• 更新動作 —更新のチェックと適用
• バージョン対象 —ネイティブバージョンと互換性のあるバンドルを維持