Jenis Update

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

Aplikasikan Waktu

Kontrol ketika Perbarui setelah diunduh.

Jenis	Deskripsi	Penggunaan
autoUpdate: atBackground	Unduh di latar belakang, terapkan ketika pengguna mematikan aplikasi 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 yang sudah ada menggunakan alur default.
autoUpdate: onLaunch	Terapkan segera pada instalasi, update toko aplikasi, atau setelah aplikasi dibunuh.	Keseimbangan antara keaslian dan stabilitas sesi
autoUpdate: always	Terapkan segera setiap kali update diunduh (termasuk pada resume)	Perbaikan kritis, aplikasi dengan state sederhana
autoUpdate: onlyDownload	Unduh secara otomatis dan emit updateAvailable, tapi tidak pernah terapkan atau atur bundle berikutnya secara otomatis	Aplikasi yang menampilkan notifikasi 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'
  }
}

Tip

Untuk detail 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 hingga setelah tanggal/tanggal waktu tertentu	Koordinasikan dengan rilis server-side
latar belakang	Tunggu durasi minimum (ms) setelah aplikasi ditetapkan ke latar belakang	Hindari menerapkan selama aplikasi beralih dengan cepat
nativeVersion	Memerlukan versi biner native minimum	Blokir update pada native code yang tidak kompatibel
kill	Tunggu hingga event kill aplikasi berikutnya	Terapkan hanya 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

Perlu diingat kill Kondisi ini akan menimbulkan efek setelah kejadian pembunuhan pertama, bukan latar belakang seperti yang lainnya. Hal ini akan diperbaiki dalam rilis masa depan.

Pemblokiran Versi (Kebijakan Saluran)

Mengontrol update semver apa saja update yang akan diaktifkan secara otomatis oleh saluran. Ditetapkan melalui --disable-auto-update pada saluran.

Strategi	Menghalangi	Mengizinkan	Kasus Pengguna
tidak ada	Tidak ada	Semua pembaruan	Default; pembaruan otomatis penuh
besar	0.0.0 → 1.0.0	Sama besar (misalnya 1.x → 1.y)	Mencegah perubahan yang mengganggu mencapai native yang lama
kecil	0.0.0 → 1.1.0, 1.1.0 → 1.2.0	Sama kecil (misalnya 1.2.x → 1.2.y)	Kontrol yang lebih ketat dalam besar
patch	Perubahan apa pun kecuali patch bump	Hanya 0.0.311 → 0.0.314	Sangat ketat; 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

Peringatan

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

Jenis Pengiriman

Bagaimana bundle dipindahkan

ke perangkat.	Deskripsi	Kapan Menggunakan
Full bundle	Seluruh bundle JavaScript 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

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

Referensi Cepat

Kategori	Tipe
Waktu aplikasi	off, atBackground, atInstall, onLaunch, always, onlyDownload
Kondisi delay	date, background, nativeVersion, kill
Penghalang Versi	none, major, minor, patch, metadata
Antar Jemput	Paket lengkap, Delta (manifest)

Terkait

• Perbarui Sifat — Konfigurasi waktu dan delay penggunaan
• Pencarian Versi — Rute versi berdasarkan saluran
• Pembaruan Delta (manifest) — Aktifkan download parsial
• Saluran — Konfigurasi dan keutamaan saluran

Teruskan dari Jenis Update

Jika Anda menggunakan Jenis Update untuk merencanakan pengiriman update hidup, hubungkannya dengan Capgo Live Updates untuk alur kerja produk di Capgo Live Updates, Ringkasan untuk detail implementasi di Ringkasan, Fitur untuk detail implementasi di Fitur Sikap Update untuk detail implementasi di Update Behavior, dan Mula Menggunakan untuk detail implementasi di Mula Menggunakan.