Jenis Pembaruan

Capgo mendukung beberapa jenis pembaruan jarak jauh (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 terapkan segera setelah instalasi segar atau pembaruan toko aplikasi asli; jika tidak, gunakan atBackground	Pengguna baru mendapatkan versi terbaru; pengguna yang sudah ada gunakan terapkan di latar belakang
autoUpdate: onLaunch	Hanya terapkan segera setelah boot pertama (dibunuh → foreground); kemudian kembali ke atBackground	Keseimbangan antara kebaruan dan stabilitas sesi
autoUpdate: always	Periksa setiap transisi ke depan dan terapkan segera setiap kali update tersedia	Pembaruan kritis, aplikasi dengan state sederhana
autoUpdate: onlyDownload	Periksa dan download secara otomatis, emit updateAvailable, dan tidak pernah terapkan 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 sebuah perbarui diinstal. Gunakan setMultiDelay untuk menggabungkannya (semua syarat harus dipenuhi).

Kondisi	Deskripsi	Contoh
tanggal	Tunggu hingga setelah tanggal/tanggal spesifik tertentu	Koordinasikan dengan rilis sisi server
latar belakang	Tunggu durasi minimum (ms) setelah aplikasi di background	Hindari menerapkan selama aplikasi switch cepat
versi native	Memerlukan versi biner native minimum	Block update pada versi native tidak kompatibel code
Mati	Tunggu sampai event mati aplikasi berikutnya	Aplikasikan 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

Yang kill Kondisi ini akan menimbulkan event mati pertama kali, bukan event latar belakang seperti yang lain. Ini akan diperbaiki dalam rilis masa depan.

Pemblokiran Versi (Kebijakan Saluran)

Mengontrol update update semver salah satu saluran akan secara otomatis mengirimkan. Ditetapkan 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_buildatau contoh seperti ini 1.2.3 -> 2.0.0	Sama mayor, contoh seperti ini 1.2.3 -> 1.9.0 atau 1.2.3 -> 1.2.4	Mencegah perubahan breaking mencapai native code yang lama
minor	Mayor atau minor yang berbeda dari version_buildatau contoh seperti ini 1.2.3 -> 1.3.0	Sama mayor dan minor, contoh seperti ini 1.2.3 -> 1.2.4	Simpan pembaruan di satu garis minor native
patch	Perubahan apa pun pada nomor mayor, minor, atau patch, contoh seperti ini 1.0.0 -> 1.0.1	Hanya perubahan pada 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_buildbukan 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 Target Versi untuk informasi lebih lanjut.

Jenis Pengiriman

How the bundle is transferred to the perangkat. Jenis Deskripsi

Menggunakan	Bundle lengkap	Bundel JavaScript lengkap diunduh.
Pertama kali menginstal, 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__	__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
Mundurkan kondisi	date, background, nativeVersion, kill
Pemblokiran versi	none, major, minor, patch, metadata
Pengiriman	Bundel lengkap, Delta (manifest)

Terkait

• Perilaku Update — Konfigurasi waktu dan mundur
• Pengaturan Versi — Rute versi berdasarkan saluran
• Delta (manifest) Perbarui – Aktifkan download parsial
• Saluran – Konfigurasi dan urutan saluran

Teruskan 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, Panduan Umum untuk detail implementasi di Overview, Fitur-Fitur untuk detail implementasi di Fitur-Fitur, Pengaturan Perbarui untuk detail implementasi di Pengaturan Perbarui, dan Mulai Langkah Pertama untuk detail implementasi di Mulai Langkah Pertama.