Jenis Perbarui

Copas prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

Capgo mendukung beberapa jenis pembaruan melalui udara (OTA). Halaman ini menampilkan dan menjelaskan semua jenis pembaruan tersebut sehingga Anda dapat memilih kombinasi yang tepat untuk aplikasi Anda.

Terapkan Waktu

Kontrol ketika pembaruan diterapkan setelah diunduh.

Jenis	Deskripsi	Penggunaan
Default	Unduh di latar belakang, terapkan ketika pengguna mengalihkan ke latar belakang atau membunuh aplikasi	Aplikasi kebanyakan; gangguan minimal
directUpdate: `atInstall`	Terapkan segera hanya pada instalasi baru atau pembaruan aplikasi toko	Pengguna baru mendapatkan versi terbaru; pengguna yang sudah ada menggunakan alur default
directUpdate: `onLaunch`	Terapkan segera pada instalasi, pembaruan toko, atau setelah aplikasi dibunuh	Keseimbangan antara kebaruan dan stabilitas sesi
directUpdate: `always`	Terapkan segera setiap kali pembaruan diunduh (termasuk pada resume)	Perbaikan kritis, aplikasi dengan state sederhana

Konfigurasi di capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    directUpdate: false, // default
    // or: 'atInstall' | 'onLaunch' | 'always'
  }
}

Mengatur Keterlambatan

Kondisi yang harus dipenuhi sebelum sebelumnya setMultiDelay sebelumnya

Kondisi	Deskripsi	Contoh
tanggal	Tunggu hingga setelah tanggal/tanggal spesifik	Koordinasikan dengan rilis server-side
latar belakang	Tunggu durasi minimum (ms) setelah aplikasi dibackground	Hindari menerapkan selama aplikasi switch cepat
versi native	Tuntut versi biner native minimum	Blokir update pada native code yang tidak kompatibel
Bunyikan	Tunggu sampai event bunyikan aplikasi berikutnya	Hanya berlaku pada restart penuh

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    { kind: 'date', value: '2023-06-01T00:00:00.000Z' },
    { kind: 'background', value: '60000' },
  ],
});

Pengaturan Versi Blokir (Kebijakan Saluran)

Mengontrol pembaruan semver akan secara otomatis mengirimkan saluran. Ditetapkan melalui --disable-auto-update pada saluran.

Strategi	Blokir	Mengizinkan	Kasus Penggunaan
tidak ada	Tidak ada	Semua pembaruan	Default; pembaruan otomatis penuh
maju	0.0.0 → 1.0.0	Sama mayor (misalnya 1.x → 1.y)	Mencegah perubahan yang mengganggu dari native yang lebih tua
minor	0.0.0 → 1.1.0, 1.1.0 → 1.2.0	Sama minor (misalnya 1.2.x → 1.2.y)	Kontrol yang lebih ketat dalam major
patch	Semua perubahan except patch bump	Hanya 0.0.311 → 0.0.314	Sangat ketat; hanya patch-only updates
metadata	Perbarui tanpa `min_update_version`	Perbarui dengan metadata kompatibilitas eksplisit	Aturan kompatibilitas kustom per bundle

npx @capgo/cli channel set production --disable-auto-update major

Jenis Pengiriman

Bagaimana bundle dikirimkan ke perangkat. Jenis

Deskripsi	Kapan Menggunakan	Bundle Penuh
Seluruh bundle JS diunduh	Pertama kali instal, perubahan besar, atau ketika delta tidak tersedia	Delta (manifest)
Hanya file yang berubah diunduh	Pembaruan terbanyak; lebih cepat dan ramah bandwidth	__CAPGO_KEEP_0__

# Full bundle (default)
npx @capgo/cli bundle upload --channel production

# Delta updates
npx @capgo/cli bundle upload --channel production --delta

Referensi Cepat

Kategori	Tipe
Aplikasikan waktu	Default, `atInstall`, `onLaunch`, `always`
Syarat menunda	`date`, `background`, `nativeVersion`, `kill`
Penghalang versi	`none`, `major`, `minor`, `patch`, `metadata`
Pengiriman	Bundle lengkap, Delta (manifest)

Perbarui perilaku — Konfigurasi waktu aplikasi dan menunda
Pengaturan Versi — Rute versi berdasarkan saluran
Delta (manifest) Updates — Aktifkan download parsial
Saluran — Konfigurasi dan urutan saluran