Tipe 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.

Jadwal Aplikasi

Pengaturan ketika pembaruan diterapkan setelah diunduh. Plugin memeriksa pembaruan ketika aplikasi berpindah ke latar depan dan pada timer yang berulang sementara aplikasi tetap terbuka. periodCheckDelay Pengaturan interval tersebut (default 10 menit).

Jenis	Deskripsi	Penggunaan
context atBackground	Pengaturan Otomatis: "	Aplikasi paling banyak; gangguan minimal
autoUpdate: atInstall	Aplikasikan langsung setelah instalasi segar atau pembaruan toko aplikasi asli; jika tidak gunakan atBackground	User baru mendapatkan versi terbaru; pengguna yang sudah ada menggunakan aplikasi latar
autoUpdate: onLaunch	Aplikasikan langsung setelah aplikasi dibuka dari awal (dibunuh → ke depan); kemudian kembali ke atBackground	Keseimbangan antara kebaruan dan stabilitas sesi
autoUpdate: always	Periksa pada setiap transisi ke depan dan aplikasikan langsung 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 informasi lengkap dan pengelolaan splashscreen, lihat Perilaku Pembaruan.

Syarat Penundaan

Syarat yang harus dipenuhi sebelumnya, sebelum memulai pekerjaan baru, pastikan Anda telah membahas dan membuka isu terkait di forum atau komunitas pengembang. Hal ini dapat membantu Anda mendapatkan umpan balik dan saran dari pengembang lain sebelum memulai proyek baru. Selain itu, membuka isu juga dapat membantu Anda memahami apa yang telah dilakukan oleh pengembang lain sebelumnya dan apa yang perlu Anda lakukan untuk mengembangkan proyek tersebut lebih lanjut. Dengan demikian, Anda dapat memastikan bahwa proyek Anda tidak mengulangi pekerjaan yang telah dilakukan oleh pengembang lain dan dapat berkontribusi pada kemajuan proyek tersebut. Sebuah pembaruan dipasang. Gunakan setMultiDelay untuk menggabungkannya (semua kondisi harus dipenuhi).

Kondisi	Deskripsi	Contoh
Tanggal	Tunggu sampai setelah tanggal/tanggal spesifik	Koordinasikan dengan rilis server-side
Latar belakang	Tunggu durasi minimum (ms) setelah aplikasi dibackground	Hindari menerapkan selama aplikasi beralih cepat
Versi Nativ	Minta versi biner native minimal	Block update pada biner native yang tidak kompatibel code
Hilangkan	Tunggu sampai event kill aplikasi berikutnya	Terapkan 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 diaktifkan setelah event kill pertama, bukan event latar belakang seperti yang lain. Ini akan diperbaiki dalam rilis masa depan. kill Pemblokiran Versi (Kebijakan Saluran)

Pemblokiran Versi (Kebijakan Saluran)

Mengontrol mana Mengupdate versi semver Saluran akan secara otomatis mengirimkan. Tentukan 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. 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 saja targetnya
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 dapat merusak dari 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 perubahan di dalam satu garis kecil
perbaikan	Apapun perubahan 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	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

Perbandingan ini membandingkan bundle target terhadap basis 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
Penuh bundle	Bundle JS penuh sepenuhnya diunduh	Pertama kali menginstal, perubahan besar, atau ketika delta tidak tersedia
context: Halaman/area: Capgo Builder / produk halaman native cloud build. Peran: Label UI singkat atau item navigasi. Kunci pesan `native_build_builder_credit_first` (Kredit Pembangun Native Build Pertama).	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 pendek 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
Penghalang Versi	none, major, minor, patch, metadata
Pengiriman	Bundle Penuh, Delta (manifest)

Terhubung

• Sifat Perbarui — Konfigurasi waktu aplikasi dan penundaan
• Targeting Versi --- Rute Versi Berdasarkan Saluran
• Pembaruan Delta (Manifest) --- Aktifkan Download Parsial
• Saluran --- Konfigurasi dan Urutan Prioritas Saluran

Teruskan 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.