Jenis Update

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 update diterapkan setelah diunduh.

Jenis	Deskripsi	Penggunaan
autoUpdate: atBackground	Unduh di latar belakang, terapkan ketika pengguna mengalihkan atau membunuh aplikasi	Aplikasi kebanyakan; gangguan minimal
autoUpdate: atInstall	Terapkan segera hanya pada instalasi baru atau update toko aplikasi	Pengguna baru mendapatkan versi terbaru; pengguna lama menggunakan alur default
__CAPGO_KEEP_0__: onLaunch	Teraplikasikan segera saat instalasi, penyimpanan update, atau setelah aplikasi dimatikan	Keseimbangan antara kebaruan dan stabilitas sesi
__CAPGO_KEEP_0__: always	Teraplikasikan segera setiap kali update diunduh (termasuk saat diresume)	Perbaikan kritis, aplikasi dengan state sederhana
__CAPGO_KEEP_0__: onlyDownload	Unduh secara otomatis dan emit updateAvailable, tetapi tidak pernah teraplikasikan atau atur bundle berikutnya secara otomatis	Aplikasi yang menampilkan prompt update sendiri atau mengontrol secara tepat kapan untuk memanggil set()

Konfigurasi di capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    autoUpdate: 'atBackground', // default; true is still accepted
    // or: 'off' | 'atInstall' | 'onLaunch' | 'always' | 'onlyDownload'
  }
}

Tips

Untuk informasi lengkap dan pengaturan splashscreen, lihat Pengaturan Perbarui.

Syarat Penundaan

Syarat yang harus dipenuhi sebelum sebuah perbarui diinstal. Gunakan setMultiDelay untuk menggabungkannya (semua syarat harus dipenuhi).

Syarat	Deskripsi	Contoh
tanggal	Tunggu sampai setelah tanggal/ketika tertentu	Koordinasikan dengan rilis server-side
latar belakang	Tunggu durasi minimum (ms) setelah aplikasi dibackground	Mencegah aplikasi penggantian cepat
versi native	Minta versi native binary minimum	Mencegah pembaruan pada native code yang tidak kompatibel
kill	Tunggu sampai event kill 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' },
  ],
});

Bahaya

The kill Kondisi ini akan diaktifkan setelah event pembunuhan pertama, bukan event latar belakang seperti yang lainnya. Ini akan diperbaiki dalam rilis masa depan.

Pengaturan Versi Blokir (Kebijakan Saluran)

Mengontrol update semver apa saluran akan mendapatkan pengiriman otomatis. Ditetapkan melalui --disable-auto-update pada saluran.

Strategi	Bloks	Mengizinkan	Kasus Pengguna
tidak ada	Tidak ada	Versi bundle apa pun	Default; pembaruan otomatis penuh
maju	Lebih besar dari versi maju version_buildVersi maju lebih besar dari 1.2.3 -> 2.0.0	, misalnya 1.2.3 -> 1.9.0 atau 1.2.3 -> 1.2.4	Mencegah perubahan yang mengganggu dari mencapai native code yang lama
kecil	Berbeda mayor atau kecil dari version_buildcontoh 1.2.3 -> 1.3.0	Sama mayor dan kecil, contoh 1.2.3 -> 1.2.4	Tetapkan pembaruan di satu garis minor native
perbaikan	Perubahan apapun mayor, kecil, atau perbaikan nomor, contoh 1.0.0 -> 1.0.1	Hanya perubahan sufiks sementara MAJOR.MINOR.PATCH tetap identik, contoh 1.0.0-beta.1 -> 1.0.0-beta.2 atau 1.0.0+build.1 -> 1.0.0+build.2	Mode paling ketat: tidak ada pergerakan versi inti
metadata	Tidak ada min_update_version, atau version_build di bawahnya	Bundle target yang min_update_version lebih kecil dari atau sama dengan version_build	Aturan kompatibilitas kustom per bundle

Pemeriksaan ini membandingkan bundle target terhadap dasar native yang dikirim sebagai version_build, bukan bundle yang diunduh saat ini yang dikirim sebagai version_name.

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

Peringatan

patch dan metadata memerlukan pengaturan yang hati-hati. Lihat CLI perintah dan Target Versi untuk informasi lebih lanjut.

Jenis Pengiriman

Bagaimana bundle dikirimkan ke perangkat.

Tipe	Deskripsi	Kapan Menggunakan
Full bundle	Seluruh bundle JS diunduh	Pertama kali install, perubahan besar, atau ketika delta tidak tersedia
Delta (manifest)	Hanya file yang berubah diunduh	Pembaruan paling banyak; lebih cepat dan ramah bandwidth

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

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

Tips

Ketika menggunakan mode aplikasi instan (atInstall, onLaunch, atau always), aktifkan Perbarui Delta untuk mengurangi waktu download dan meningkatkan UX.

Referensi Cepat

Kategori	Jenis
Waktu aplikasi	off, atBackground, atInstall, onLaunch, always, onlyDownload
Kondisi penundaan	date, background, nativeVersion, kill
Penghalang versi	none, major, minor, patch, metadata
Pengiriman	Bundle lengkap, Delta (manifest)

Terkait

• Sikap Perbarui — Konfigurasi pengaturan waktu dan penundaan
• Pengaturan Versi — Rute routing versi berdasarkan saluran
• Pembaruan Delta (manifest) — Aktifkan download parsial
• Saluran — Konfigurasi dan urutan saluran

Teruskan dari Tipe Update

Jika Anda menggunakan Tipe Update untuk merencanakan pengiriman update hidup secara langsung, hubungkan dengan Capgo Live Updates untuk alur kerja produk di Capgo Live Updates, Ringkasan untuk detail implementasi di Ringkasan, Fitur untuk detail implementasi di Fitur-Fitur Pengaturan Perbarui untuk detail implementasi di Pengaturan Perbarui, dan Mulai untuk detail implementasi di Mulai.