Jenis Update

Capgo supports several types of over-the-air (OTA) updates. This page lists and explains all of them so you can choose the right combination for your app.

Waktu Penerapan

Pengendalian kapan Perbarui diterapkan setelah diunduh. Plugin memeriksa perbarui ketika aplikasi berpindah ke latar depan dan pada timer yang berulang sementara aplikasi tetap terbuka. periodCheckDelay pengaturan interval (default 10 menit).

Jenis	Pengenalan	Penggunaan
autoUpdate: atBackground	Periksa dan download pada setiap periksa latar depan, terapkan ketika aplikasi berpindah ke latar belakang	Banyak aplikasi; gangguan minimal
autoUpdate: atInstall	Jalankan segera hanya setelah instalasi baru atau pembaruan aplikasi asli; jika tidak, gunakan atBackground	New users get latest; existing users use background apply
autoUpdate: onLaunch	Jalankan segera hanya pada awal (dibunuh → depan); kemudian kembali ke atBackground	Keseimbangan antara kebaruan dan stabilitas sesi
autoUpdate: always	Periksa pada setiap transisi ke depan dan jalankan segera ketika pembaruan tersedia	Pembaruan kritis, aplikasi dengan state sederhana
autoUpdate: onlyDownload	Periksa dan download secara otomatis, emit updateAvailable, dan tidak pernah jalankan secara otomatis	Applikasi yang menampilkan notifikasi pembaruan sendiri atau mengontrol kapan memanggil pembaruan 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 pengelolaan splashscreen, lihat Pengaturan Pembaruan.

Syarat Penundaan

Syarat yang harus dipenuhi sebelum sebuah pembaruan diinstal. Gunakan setMultiDelay Untuk menggabungkannya (semua kondisi harus dipenuhi).

Kondisi	Deskripsi	Contoh
Tanggal	Tunggu sampai setelah tanggal/tanggapan spesifik	Koordinasi dengan rilis sisi server
Latar belakang	Tunggu durasi minimum (ms) setelah aplikasi di background	hindari menerapkan selama aplikasi switch cepat
Versi Native	Minta versi biner native minimum	Perbarui blok pada native code yang tidak kompatibel
Hancurkan	Tunggu sampai event kill 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

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

Judul bagian “Perbarui Versi (Kebijakan Saluran)”

Mengontrol mana Perbarui Semver a channel will auto-deliver. Set via --disable-auto-update di saluran.

Strategi	Penyekatan	Mengizinkan	Penggunaan Kasus
none	Tidak Ada	Versi bundle target apa pun	Versi Apapun Paket Target
major	Versi mayor lebih tinggi dari version_build, misalnya 1.2.3 -> 2.0.0	Versi mayor sama, misalnya 1.2.3 -> 1.9.0 atau 1.2.3 -> 1.2.4	Untuk mencegah perubahan yang memecah dari versi native code
minor	Versi mayor atau minor yang berbeda dari version_build, misalnya 1.2.3 -> 1.3.0	Versi mayor dan minor yang sama, misalnya 1.2.3 -> 1.2.4	Untuk mempertahankan pembaruan di satu garis minor native
patch	Perubahan apa pun pada nomor mayor, minor, atau patch, misalnya 1.0.0 -> 1.0.1	Hanya perubahan sufiks sementara 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	Perubahan mode ketat: tidak ada perubahan versi inti
metadata	Tidak ada min_update_version, atau version_build di bawahnya	Target bundle yang mana min_update_version lebih kecil atau sama dengan version_build	Aturan kompatibilitas kustom per bundle

Periksa ini membandingkan bundle target terhadap baseline native yang dikirim sebagai version_buildbukan bundle yang diinstal saat ini yang dikirim sebagai version_name.

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

Peringatan

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

Jenis Pengiriman

Bagaimana cara mengirimkan bundle ke perangkat. ke ponsel.

Type	Deskripsi	Kapan Menggunakan
Tipe Penuh	Seluruh bundle JS diunduh	Pertama instal, perubahan besar, atau ketika delta tidak tersedia
Delta	Hanya file yang berubah saja diunduh	Update Terbaru; 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 Update Delta to minimize download time and improve UX.

Panduan Cepat

Kategori	Jenis
Aplikasikan waktu	off, atBackground, atInstall, onLaunch, always, onlyDownload
Syarat penundaan	date, background, nativeVersion, kill
Pemblokiran versi	none, major, minor, patch, metadata
Pengiriman	Paket lengkap, Delta

Related

• Bagian berjudul “Terhubung” Konfigurasi waktu aplikasi dan penundaan
• — Konfigurasi waktu dan penundaan aplikasikan --- Rute Versi Berdasarkan Saluran
• Perubahan Delta --- Hanya Download File yang Berubah
• Saluran --- Konfigurasi dan Prioritas Saluran

Teruskan dari Jenis Update

Jika Anda Menggunakan Jenis Update Untuk Membuat Rencana live update Pengiriman, Hubungkan dengan Capgo Pembaruan Langsung untuk Alur Kerja Produk di Capgo Live Updates, Ringkasan untuk detail implementasi di Ringkasan, Fasilitas untuk detail implementasi di Fasilitas, Perilaku Update untuk detail implementasi di Perilaku Update, dan Mulai Menggunakan untuk detail implementasi di Mulai.