Jenis Update

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

Terapkan Waktu

Kontrol ketika pembaruan diterapkan setelah diunduh. Plugin memeriksa pembaruan 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
Kasus Pengguna atBackground	context: Halaman/area: Halaman solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/cordova-to-capacitor-ai.astro. Kunci pesan `solutions_cordova_to_capacitor_ai_table_use_case` (Solutions Cordova To Capacitor Ai Table Use Case).	Aplikasi paling banyak; gangguan minimal
autoUpdate: atInstall	Aplikasikan segera hanya setelah instalasi segar atau pembaruan toko aplikasi asli; jika tidak, gunakan atBackground	Pengguna baru mendapatkan versi terbaru; pengguna yang sudah ada menggunakan aplikasikan di latar belakang
autoUpdate: onLaunch	Aplikasikan segera hanya pada awal transisi (dibunuh → depan); kemudian kembali ke atBackground	Keseimbangan antara kebaruan dan stabilitas sesi
autoUpdate: always	Periksa pada setiap transisi ke depan dan aplikasikan segera ketika pembaruan tersedia	Pembaruan kritis, aplikasi dengan state sederhana
autoUpdate: onlyDownload	Periksa dan download secara otomatis, emit updateAvailabledan tidak pernah menerapkan secara otomatis	Aplikasi yang menampilkan notifikasi pembaruan sendiri atau mengontrol kapan memanggil set()

Konfigurasi di capacitor.config.ts:

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

Trik

Untuk detail lengkap dan pengaturan splashscreen, lihat Perilaku Pembaruan.

Kondisi Penundaan

Kondisi yang harus dipenuhi sebelumnya, context: Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `create_an_issue_and_discuss_before_working_on_a_new_feature`). Halaman/area: Situs web pemasaran Capgo. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman contributing.astro. Kunci pesan `create_an_issue_and_discuss_before_working_on_a_new_feature` (Buat Isu Dan Diskusikan Sebelum Bekerja Pada Fitur Baru). | Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `mention_issue_before_working`). Halaman/area: Situs web pemasaran Capgo. Peran: Kalimat situs web. Dilihat di: halaman contributing.astro. Kunci pesan `mention_issue_before_working` (Sebutkan Isu Sebelum Bekerja). Sebuah pembaruan dipasang. Gunakan setMultiDelay untuk menggabungkannya (semua kondisi harus dipenuhi).

Kondisi	Deskripsi	Contoh
tanggal	Tunggu sampai setelah tanggal waktu tertentu	Sinkronisasi dengan rilis server
latar belakang	Tunggu durasi minimum (ms) setelah aplikasi dibackground	Hindari menerapkan selama aplikasi beralih cepat
versi native	Minta versi biner native minimum	Block update pada code native 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

Kondisi ini akan menimbulkan efek setelah event kill pertama, bukan event latar belakang seperti yang lain. Ini akan diperbaiki dalam rilis masa depan. kill Pemblokiran Versi (Kebijakan Saluran)

Bagian berjudul “Pemblokiran Versi (Kebijakan Saluran)”

Mengontrol mana Mengupdate versi semver Saluran akan mengirim secara otomatis. Atur melalui --disable-auto-update On Channels.

Strategi	Menghalangi	Mengizinkan	Penggunaan Kasus
Konteks: Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/cordova-to-capacitor-ai.astro.	Tidak ada	Tidak ada	Versi bundle apa pun yang ditargetkan oleh pengguna.
utama	Lebih besar dari utama version_build, misalnya 1.2.3 -> 2.0.0	Untuk utama yang sama, misalnya 1.2.3 -> 1.9.0 atau 1.2.3 -> 1.2.4	Mencegah perubahan yang memecahkan dari mencapai native code yang lama
kecil	Berbeda dari utama atau kecil version_build, misalnya 1.2.3 -> 1.3.0	Untuk utama dan kecil yang sama, misalnya 1.2.3 -> 1.2.4	Tetapkan pembaruan di dalam satu garis kecil native
perbaikan	Perubahan nomor versi 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	Mode ketat: tidak ada perubahan versi inti
metadata	Tidak ada min_update_version, atau version_build di bawahnya	Bundle target yang min_update_version nomornya kurang dari atau sama dengan version_build	Aturan kompatibilitas kustom per bundle

Perbandingan 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 perlu pengaturan yang hati-hati. Lihat CLI perintah dan Target Versi untuk informasi lebih lanjut.

Jenis Pengiriman

Bagaimana bundle ditransfer

ke perangkat.	Jenis	Deskripsi
Kapan Menggunakan	Bundle Penuh	Bundle JS penuh diunduh secara keseluruhan
Pertama kali menginstal, perubahan besar, atau ketika delta tidak tersedia	Hanya file yang berubah saja yang diunduh	Versi paling umum; 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

Trik

Ketika menggunakan mode aplikasi instan (atInstall, onLaunchatau always) aktifkan Update delta

context

Kategori	Jenis
Aplikasikan Waktu	off, atBackground, atInstall, onLaunch, always, onlyDownload
Syarat Penundaan	date, background, nativeVersion, kill
Pemblokiran Versi	none, major, minor, patch, metadata
Pengiriman	context: Halaman/area: Halaman produk/penawaran perusahaan. Peran: Label UI. Kunci pesan `enterprise_delivery_label` (Label Pengiriman Perusahaan).

Paket Penuh, Delta (manifest)

• Referensi Cepat Sifat Perbaruian (Konfigurasi Waktu dan Penundaan)
• Targeting Versi — Rute Versi Berdasarkan Saluran
• Pembaruan Delta (Manifest) — Aktifkan Download Parsial
• Saluran Saluran

— Konfigurasi dan Prioritas Saluran

Bab berjudul “Teruskan dari Jenis Pembaruan” Jika Anda menggunakan Jenis Pembaruan untuk merencanakan pengiriman pembaruan hidup, hubungkannya dengan Pembaruan Hidup Capgo untuk alur kerja produk di Capgo Live Updates, Ringkasan untuk detail implementasi di Ringkasan, Fitur untuk detail implementasi di Fitur, Pengaturan Perbarui untuk detail implementasi di Pengaturan Perbarui, dan Mulai untuk detail implementasi di Mulai.