Menguji Bangun Nadi Asli Tanpa Live Update

Ketika menguji biner native baru, pastikan bahwa itu dimulai dari aset web yang dibundel dalam biner tersebut—bukan dari live update yang telah diunduh sebelumnya. Gunakan salah satu atau kombinasi dari tindakan di bawah ini.

1. Tingkatkan Versi Dasar Native

Set CapacitorUpdater.version from the version used for your native release, and increase it for every native build. A newer native baseline makes the installed binary distinct from older bundles and, with the default resetWhenUpdate: trueMenghapus bundle yang telah diunduh ketika aplikasi native yang lebih baru diinstal.

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;

Contohnya, sebuah file biner yang dibangun dengan version: '1.4.1' memiliki dasar native yang lebih tinggi daripada yang ada 1.4.0 Paket. Jangan mengulangi versi asli native ketika Anda perlu memverifikasi aset yang dibundel.

2. Blokir Emulator dan Update Pembangunan di Konsole

Terbuka aplikasi Anda di konsol Capgo, pergi ke SaluranPilih saluran yang digunakan oleh bangunan, dan buka Information Informasi Matikan kedua Biarkan bangunan pengembangan dan Biarkan Emulator.

Kontrol-kontrol ini ada di tab Informasi saluran. Matikan pengaturan yang dihias untuk menjaga bangunan pengembangan dan emulator tetap pada aset web bundel mereka.

Peringatan

Gambar tangkapan layar menunjukkan di mana Anda dapat menemukan pengaturan; tombol yang dihiasnya telah diaktifkan. Matikan kedua tombol tersebut untuk saluran yang tidak boleh mengirimkan pembaruan hidup ke build pengembangan atau emulator.

Pengaturan saluran ini hanya menghalangi pengiriman pembaruan untuk jenis build yang dipilih. Perangkat fisik yang telah disertifikasi produksi masih dapat menerima pembaruan berdasarkan pengaturan lain saluran.

3. Aktifkan Pembaruan Hidup Hanya di Build CI Asli

Untuk tim yang ingin membuat build lokal, emulator, dan pengembang menjadi aman secara default, aktifkan pembaruan hidup melalui variabel lingkungan. Konfigurasi di bawah mengaktifkan pembaruan hanya jika CAPGO_LIVE_UPDATES adalah tepatnya 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;

Atur variabel hanya di langkah CI yang menyinkronkan dan membangun aplikasi asli:

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

Jalankan npx cap sync setelah mengatur variabel karena Capacitor mengcopy konfigurasi ini ke proyek native selama sinkronisasi. Tanpa variabel, build lokal dan emulator tetap autoUpdate: false dan tidak memeriksa update live.

Daftar Periksa Cepat

1. Naikkan versi yang digunakan oleh CapacitorUpdater.version untuk biner native.
2. Matikan Biarkan build pengembangan dan Biarkan Simulator saat menguji jenis build tersebut di saluran.
3. Membangun secara lokal tanpa CAPGO_LIVE_UPDATES.
4. Set CAPGO_LIVE_UPDATES=true hanya sebelum npx cap sync dalam pekerjaan CI asli yang harus menerima pembaruan hidup.

Related

• Saluran — Rute dan kebijakan saluran.
• Perilaku Pembaruan — Ketika pembaruan dicek dan diterapkan.
• Target Versi Tetapkan paket untuk kompatibel dengan versi native.