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

新しいネイティブバイナリをテストする際は、バイナリ内に組み込まれたウェブアセットから始めてください。ライブアップデートをダウンロードしたものではなく。

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

設定 CapacitorUpdater.version ネイティブリリース用のバージョンから始めて、ネイティブビルドごとにバージョンを上げることで、インストール済みのバイナリを古いバンドルと区別し、デフォルトではダウンロードしたバンドルを削除します。 resetWhenUpdate: true「1. ネイティブベースラインバージョンを上げる」のセクション

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;

__CAPGO_KEEP_0__でビルドされたバイナリは、既存の version: '1.4.1' のネイティブ基準よりも高いネイティブ基準を持つ。 1.4.0 バンドルされたアセットを検証する必要がある場合、ネイティブバージョンを再利用しないでください。

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

Capgoコンソールでアプリを開き、 チャンネルを選択し、ビルドで使用されているチャンネルを選択し、 情報 を選択してください。 をオフにします。 両方 __CAPGO_KEEP_0__ チャンネル情報タブに表示される開発用ビルドとエミュレーターの設定 チャンネル情報タブに表示される制御はこちらです。両方の強調表示された設定を無効にすると、開発用ビルドとエミュレーターのバンドルされたウェブアセットに更新が届きます。 注意.

スクリーンショットは、設定の場所と強調表示されたスイッチの状態を示しています。両方のスイッチをオフにすると、開発用ビルドやエミュレーターの更新が配信されないチャンネルが作成されます。

3.ネイティブCIビルドでのみライブ更新を有効にする

「3.ネイティブCIビルドでのみライブ更新を有効にする」

Allow development build

Allow Emulators

チームが、ローカル、エミュレータ、開発者ビルドがデフォルトで安全になるように、環境変数を通じてライブ更新をオプトインするようにしたい場合、以下の設定を使用します。ライブ更新のチェックは、 CAPGO_LIVE_UPDATES 「exact」 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

変数を設定した後、__CAPGO_KEEP_0__はネイティブプロジェクトにこの設定をコピーするため、ライブ更新のチェックを行わないローカルビルドとエミュレータビルドが残ります。 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 「Quick Checklist」

ネイティブバイナリの使用バージョンを

1. Quick Checklist CapacitorUpdater.version Set the variable only in the CI step that synchronizes and builds the native app:
2. 無効 開発用ビルドを許可 と エミュレータを許可 テストするビルドタイプのチャンネルでライブ更新を受け取るべきネイティブ CI ジョブのみ前に
3. ローカルでビルドする CAPGO_LIVE_UPDATES.
4. に設定 CAPGO_LIVE_UPDATES=true のみ npx cap sync ライブ更新を受け取るべきネイティブ CI ジョブで

関連

• チャンネル — チャネルルーティングとポリシー。
• Update Behavior — 更新がチェックされ適用される時。
• Version Targeting — ネイティブバージョンと互換性のあるバンドルを維持する。