Live Update を無視した Native ビルドのテスト

インストール

新しいネイティブバイナリをテストする際は、バイナリ内に組み込まれたウェブアセットから起動することを確認してください。live updateが以前ダウンロードされたものではなく、バイナリ内から起動するようにします。以下のセーフガードの1つまたは複数を使用してください。

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

Set 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. エミュレータと開発用ビルドの更新をコンソールでブロックします。

Capgoコンソールでアプリを開き、 チャンネル, するチャンネルを選択し、 チャンネルを選択し、 情報オフ両方 開発用ビルド と エミュレータを許可する.

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

3. 自然ビルドのCIでのみLive Updateを有効にする

「3. CIビルドでのみLive Updateを有効にする」のセクション 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 は同期時にネイティブプロジェクトにこの構成をコピーします。変数が設定されていない場合、ローカルビルドとエミュレータビルドは autoUpdate: false コピー

実行

コピー CapacitorUpdater.version 実行
Disable コピー 実行 エミュレータを許可する チャンネルでテストするビルドタイプのときに
ローカルでビルドする CAPGO_LIVE_UPDATES.
設定 CAPGO_LIVE_UPDATES=true only before npx cap sync のみ

関連チャンネル
チャンネルルーティングとポリシー更新の動作
バージョン対象設定 — 本バンドルはネイティブバージョンと互換性を維持する。

Live Update を無視した Native ビルドのテスト

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

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

3. 自然ビルドのCIでのみLive Updateを有効にする

実行

ネイティブのCIジョブで