Live Update を使用しない Native ビルドのテスト

このプラグインの設定用の質問とインストールの手順と完全なマークダウンガイドをコピーする

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

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

Set CapacitorUpdater.version コンテキスト:HTMLテキストフラグメント(親キー`compare_capawesome_step2_text`) 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コンソールでアプリを開き、 チャンネル, するチャンネルを選択し、を開きます。 Information 情報 タブを開きます。両方の 開発用ビルドと and エミュレータを許可する.

Capgo {channel} の情報タブに表示される、開発用ビルドの許可とエミュレータの許可の設定 — これらのコントロールは、{channel} の情報タブにあります。両方の設定を無効にすると、開発用ビルドとエミュレータがバンドルされたウェブアセットに残ります。

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

3. 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 CI ステップでネイティブアプリを同期およびビルドするときにのみ変数を設定してください。Capacitor は、この構成をネイティブプロジェクトに同期するときに、この構成をコピーします。変数を設定しないと、ローカルビルドとエミュレータビルドはライブアップデートをチェックしないままです。 autoUpdate: false ライブアップデートをチェックしない

クイックチェックリスト

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

関連チャンネル
チャンネルルーティングとポリシー更新の動作
バージョン対象 __CAPGO_KEEP_0__