Jenis Update

Capgo mendukung beberapa jenis pembaruan over-the-air (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. Plugin memeriksa update ketika aplikasi berpindah ke latar depan dan pada timer yang berulang sementara aplikasi tetap terbuka. periodCheckDelay Kontrol interval tersebut (default 10 menit).

Jenis	Deskripsi	Penggunaan
autoUpdate: atBackground	Pemeriksaan dan download pada setiap periksa latar depan, terapkan ketika aplikasi berpindah ke latar belakang	Aplikasi kebanyakan; gangguan minimal
autoUpdate: atInstall	Hanya aplikasikan segera setelah instalasi segar atau pembaruan toko aplikasi asli; jika tidak, gunakan atBackground	Pengguna baru mendapatkan versi terbaru; pengguna yang sudah ada gunakan aplikasi latar belakang
autoUpdate: onLaunch	Aplikasikan segera hanya pada awal (dibunuh → foreground); kemudian jatuh kembali ke atBackground	Keseimbangan antara kebaruan dan stabilitas sesi
autoUpdate: always	Periksa pada setiap transisi foreground dan aplikasikan segera setiap kali update tersedia	Pembaruan kritis, aplikasi dengan state sederhana
autoUpdate: onlyDownload	Periksa dan download secara otomatis, emit updateAvailable, dan tidak pernah aplikasikan secara otomatis	Aplikasi yang menampilkan prompt pembaruan 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 detail lengkap dan pengaturan splashscreen, lihat Pengaturan Perbarui.

Keterlambatan Syarat

Syarat-syarat yang harus dipenuhi sebelum sebelum setMultiDelay sebelum pembaruan diinstal. Gunakan untuk menggabungkannya (semua syarat harus dipenuhi).

Kondisi	Deskripsi	Contoh
tanggal	Tunggu hingga setelah tanggal/tanggal spesifik	Sikapi dengan rilis server-side
latar belakang	Tunggu durasi minimum (ms) setelah aplikasi dibackground	Hindari mengaplikasikan selama aplikasi switch cepat
versi native	Tuntut versi biner native minimum	Blokir update pada versi native tidak kompatibel code
Matikan	Tunggu sampai event matikan 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 menimbulkan event matikan pertama, bukan event latar belakang seperti yang lainnya. Ini akan diperbaiki dalam rilis masa depan.

Pengaturan Blok Versi (Kebijakan Saluran)

Mengontrol versi update semver salah satu saluran akan secara otomatis mengirimkan. Atur melalui --disable-auto-update pada saluran.

Strategi	Blokir	Mengizinkan	Penggunaan Kasus
tidak ada	Tidak ada	Versi bundle apa pun yang dituju	Default; pembaruan otomatis penuh
maju	Lebih besar dari versi mayor version_buildcontohnya 1.2.3 -> 2.0.0	Sama mayor, contohnya 1.2.3 -> 1.9.0 atau 1.2.3 -> 1.2.4	Mencegah perubahan mayor mencapai native code yang lama
minor	Mayor atau minor yang berbeda dari version_buildcontohnya 1.2.3 -> 1.3.0	Sama mayor dan minor, contohnya 1.2.3 -> 1.2.4	Simpan pembaruan di satu garis minor native
patch	Perubahan apa pun pada nomor mayor, minor, atau patch, contohnya 1.0.0 -> 1.0.1	Hanya perubahan sufiks MAJOR.MINOR.PATCH tetap identik, misalnya 1.0.0-beta.1 -> 1.0.0-beta.2 atau 1.0.0+build.1 -> 1.0.0+build.2	Mode ketat: tidak ada pergerakan versi core
metadata	Kosong min_update_versionatau version_build di bawahnya	Bundel target yang min_update_version lebih kecil dari atau sama dengan version_build	Aturan kompatibilitas kustom per bundel

Pemeriksaan ini membandingkan bundel target terhadap dasar native yang dikirim sebagai version_builddan bukan bundel 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 Pengaturan Target Versi untuk informasi lebih lanjut.

Jenis Pengiriman

How the bundle is transferred to the perangkat. Bagaimana bundle ditransfer ke perangkat. Type

Deskripsi	Kapan Menggunakan	Bundle Lengkap
Bundel JS lengkap diunduh.	Pertama kali instal, perubahan besar, atau ketika delta tidak tersedia.	Delta (manifest)
Hanya file yang berubah diunduh.	Pembaruan paling banyak; 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

Tips

Ketika menggunakan mode aplikasi instan (atInstall, onLaunch, atau always), aktifkan Perubahan delta untuk mengurangi waktu download dan meningkatkan pengalaman pengguna.

Referensi Cepat

Kategori	Tipe
Aplikasikan waktu	off, atBackground, atInstall, onLaunch, always, onlyDownload
Membatalkan kondisi	date, background, nativeVersion, kill
Menghalangi versi	none, major, minor, patch, metadata
Pengiriman	Bundle lengkap, Delta (manifest)

Terkait

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

Lanjutkan dari Jenis Perbarui

Jika Anda menggunakan Jenis Perbarui untuk merencanakan pengiriman perbarui hidup, hubungkannya dengan Capgo Perbarui Hidup untuk alur kerja produk di Capgo Perbarui Hidup, Ringkasan Untuk detail implementasi di Overview, Fitur-Fitur Untuk detail implementasi di Fitur-Fitur, Pengaturan Perbarui Untuk detail implementasi di Pengaturan Perbarui, dan Mulai Langkah Untuk detail implementasi di Mulai Langkah.