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
context atBackground	Pemeriksaan dan download pada setiap periksa latar depan, terapkan ketika aplikasi berpindah ke latar belakang	Aplikasi paling banyak; gangguan minimal
autoUpdate: atInstall	Aplikasikan segera hanya setelah instalasi segar atau pembaruan aplikasi asli; jika tidak, gunakan atBackground	Pengguna baru mendapatkan versi terbaru; pengguna yang sudah ada menggunakan aplikasi 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: Sebelum bekerja pada fitur baru, context: Sebelum bekerja pada fitur baru Sebuah pembaruan dipasang. Gunakan setMultiDelay untuk menggabungkannya (semua kondisi harus dipenuhi).

Kondisi	Deskripsi	Contoh
tanggal	Tunggu sampai setelah tanggal dan waktu tertentu	Sinkronkan dengan rilis server
latar belakang	Tunggu durasi minimum (ms) setelah aplikasi di background	Hindari menerapkan selama aplikasi berpindah dengan cepat
versi native	Memerlukan versi biner native minimum	Mencegah pembaruan pada versi native yang tidak kompatibel code
Hilangkan	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. Hal ini akan diperbaiki dalam rilis masa depan. kill Pembaruan Versi (Kebijakan Saluran)

Bagian Pembaruan Versi (Kebijakan Saluran)

Mengatur mana-mana perbaruan semver saluran mana akan secara otomatis mengirimkan. Atur melalui --disable-auto-update saluran on.

Saat Strategi	Memblokir	Mengizinkan	Penggunaan Kasus
context: Halaman/area: Halaman pemasaran 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).	tidak ada	Tidak ada	Versi bundle apa pun yang ditargetkan
perubahan besar	Lebih besar dari perubahan besar version_build, misalnya 1.2.3 -> 2.0.0	Perubahan besar yang sama, misalnya 1.2.3 -> 1.9.0 atau 1.2.3 -> 1.2.4	Mencegah perubahan besar yang mengganggu mencapai native code
perubahan kecil	Berbeda dari perubahan besar atau kecil version_build, misalnya 1.2.3 -> 1.3.0	Perubahan besar dan kecil yang sama, misalnya 1.2.3 -> 1.2.4	Tetapkan pembaruan di satu garis minor 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 lebih kecil atau sama dengan version_build	Aturan kompatibilitas kustom per bundle

Pemeriksaan ini membandingkan bundle target dengan dasar native yang dikirimkan sebagai version_buildbukan bundle yang diunduh saat ini yang dikirimkan 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	Penuh bundle	Bundle JS penuh selesai diunduh
Pertama kali install, 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 Perbarui delta context

Page/area: Halaman produk/pricing perusahaan. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman enterprise.astro. Kunci pesan `enterprise_delta_updates` (Perbarui Delta Perusahaan).

Kategori	Jenis
Aplikasikan Waktu	off, atBackground, atInstall, onLaunch, always, onlyDownload
Syarat Penundaan	date, background, nativeVersion, kill
Pemblokiran Versi	none, major, minor, patch, metadata
Pengiriman	konten

Bundle Penuh, Delta (manifest)

• Pengaturan perilaku pembaruan — Konfigurasi waktu aplikasi dan penundaan
• Targeting Versi --- Rute Versi Berdasarkan Saluran
• Pembaruan Delta (Manifest) --- Aktifkan Download Parsial
• Saluran --- Konfigurasi dan Urutan Saluran

Lanjutkan dari Jenis Pembaruan

Jika Anda menggunakan Jenis Pembaruan untuk merencanakan pengiriman pembaruan hidup, hubungkannya dengan Capgo Pembaruan Hidup 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.