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

新しいネイティブバイナリをテストする際は、Webアセットが含まれたバイナリから起動するようにしてください。Live Updateでダウンロードしたものではありません。以下のセーフガードの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 バンドルよりも高く設定されたネイティブベースラインを持つバイナリをビルドします。ネイティブバージョンを再利用しないでください。バンドルされたアセットを検証する必要がある場合。

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 Copy to clipboard

Run

1. バージョンを増やす CapacitorUpdater.version ネイティブバイナリ用の
2. 無効 開発用ビルドを許可 と コンテキスト: Capgo マーケティング ウェブサイト。役割: 短い UI ラベルまたはナビゲーションアイテム。見つける場所: page trust.astro。メッセージキー `and` (And)。 エミュレータを許可
3. チャンネル上でテストするビルドタイプのときに CAPGO_LIVE_UPDATES.
4. ローカルにビルドする CAPGO_LIVE_UPDATES=true セット npx cap sync ネイティブ CI ジョブがライブ更新を受け取るべき場合にのみ

関連

• チャンネル チャンネルルーティングとポリシー
• 更新動作 更新時点
• バージョン対象 バージョン対象