Versi

Capgo menggunakan versi semantik (semver) untuk plugin, CLI, dan produk yang kami kirimkan — praktik yang sama yang kami rekomendasikan untuk bundel aplikasi Anda sendiri.

Halaman ini menjelaskan bagaimana versi-versi tersebut berhubungan dengan satu sama lain, apa yang tetap kompatibel di antara mayor, dan bagaimana menetapkan mayor Capacitor yang lebih tua dengan tag LTS.

Aturan Cepat

Produk	Pengaturan Versi Utama	Catatan Kompabilitas
Capgo plugin	Ikuti versi yang sesuai Capacitor versi utama	Versi Utama Plugin 8 Target Capacitor 8, 7 Target Capacitor 7, dan seterusnya
Capgo CLI	Otonom	Tidak sinkronkan versi utama CLI dengan plugin atau Capacitor. Gunakan selalu CLI yang terbaru
Capgo Console	Independent	Mengikuti siklus rilis sendiri; kompatibel dengan versi plugin pembaruan yang didukung

Selalu gunakan versi terbaru CLI

Jalankan CLI dengan @latest (contoh) npx @capgo/cli@latest ...Versi CLI utamanya Tidak perlu sesuai dengan versi utama plugin atau versi Capacitor utama. Versi terbaru CLI kompatibel dengan versi plugin pembaruan apa pun yang didukung.

Plugin mengikuti versi utama Capacitor

Setiap Capgo plugin mayor mengikuti mayor Capacitor yang dibangun untuknya:

• @capgo/capacitor-updater@8 → Capacitor 8
• @capgo/capacitor-updater@7 → Capacitor 7
• dan pola yang sama untuk plugin lainnya Capgo

Ketika Capacitor mengirimkan mayor baru, Capgo mengirimkan plugin mayor yang sesuai. Itulah saat kita mungkin mengubah opsi default jika opsi default baru lebih baik untuk pilihan jangka panjang untuk generasi Capacitor ini.

kestabilan API antar mayor

API plugin tetap stabil antar mayor kecuali perubahan yang dibuat untuk semua orang (misalnya, kebutuhan platform Capacitor yang memaksa perubahan yang sama pada semua konsumen). Anda biasanya dapat berpindah antar mayor plugin Capgo saat Anda mengupgrade Capacitor tanpa harus menulis ulang integrasi Anda.

Opsi default mungkin masih berubah pada mayor baru. Lihat catatan rilis dan panduan migrasi (lihat pengatur ulang mengupgrade Migrasi di sidebar pembaruan ketika Anda meningkatkan.

CLI dan Console menggunakan versi mereka sendiri.

Capgo CLI dan Capgo Console tidak tidak berbagi versi utama dengan plugin atau Capacitor.

• Kamu tidak perlu __CAPGO_KEEP_0__ utama karena Anda berada di CLI 8 atau pembaruan. 8 because you are on Capacitor 8 or updater 8.
• terbaru terbaru CLI.
• Versi terbaru CLI dan Console tetap kompatibel dengan versi yang didukung. @capgo/capacitor-updater (dan pembaruan terkait) versi utama.

Pemberian versi CLI yang lama tidak disarankan. Lebih baik:

npx @capgo/cli@latest bundle upload --channel=production

Tag LTS untuk mayor plugin sebelumnya

Saat Anda tetap menggunakan versi utama Capacitor yang lebih tua, instal plugin utama yang sesuai Capgo dengan tag dist LTS daripada menyalin file lock yang sudah ketinggalan zaman selamanya.

# Latest Capgo updater for Capacitor 7
npm i @capgo/capacitor-updater@lts-v7

# Same pattern for other majors
npm i @capgo/capacitor-updater@lts-v6
npm i @capgo/capacitor-updater@lts-v5
npm i @capgo/capacitor-updater@lts-v4

Penerbitan rilis LTS sebelumnya mayor plugin di luar pembaruan On Demand.

Pengembang Balik Updater vs Plugin Lainnya

Paket	Backport Versi Sebelumnya Besar
@capgo/capacitor-updater	Mirroring Backport Bulanan ke v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 tetap tersedia untuk Capacitor 4 tetapi tidak dalam siklus bulanan tersebut
Plugin Capgo Lainnya	context: Halaman/Areas: Halaman produk/harga perusahaan. Peran: Kalimat copy situs web. Dilihat di: halaman enterprise.astro. Simpan produk/merek Capgo dan istilah pengembang secara tepat. Pesan kunci `enterprise_130_plugins` (Enterprise 130 Plugins).

On Demand

Bab Tertentu “Sifat yang Sama, Versi Nomor yang Dibalik”

Jika rilis terbaru adalah 8.3.4, maka garis Capacitor 7 LTS diterbitkan sebagai 7.3.4 dengan set fitur dan perbaikan bug , disesuaikan dengan __CAPGO_KEEP_0__ major tersebut.Instal dengan tag ketika Anda ingin “terbaru untuk Capacitor major ini”:

Install with the tag when you want “latest for this Capacitor major”:

npm i @capgo/capacitor-updater@lts-v7   # resolves to the current 7.x LTS, e.g. 7.3.4

Judul bagian “LTS adalah backport dari terbaru”

(atau lts-v7 LTS is a backport of latest lts-v6Rilis …) adalah Versi terbaru dari Jadi pekerjaan yang sama dapat berjalan pada versi sebelumnya Capacitor.

Karena itu mengikuti versi terbaru, garis LTS publik API Mungkin berubah Ketika versi terbaru berubah — meskipun nomor mayor tetap pada 7. Tatalah LTS sebagai “tindakan saat ini Capgo pada versi lama Capacitor,” bukan sebagai legasi API yang abadi.

Bagaimana hal ini berpengaruh pada aplikasi Anda

1. Perbarui Capgo plugin ketika Anda mengupgrade Capacitor mayor.
2. Selalu jalankan @capgo/cli@latest — CLI mayor sinkron dengan Capacitor/plugin tidak perlu.
3. Apakah Anda ingin tetap menggunakan Capacitor 7 (atau lebih lama)? Gunakan @lts-v7 (atau tag yang sesuai), bukan versi lama yang sembarangan 7.x yang berusia beberapa bulan.
4. Versi bundle live-update Anda sendiri dengan semver seperti Capgo versi paketnya. Lihat versi bundle dan saluran dan context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman trust.astro. Kunci pesan `dan` (Dan)..

targeting versi

• Judul bagian “Dokumen terkait” Perintah instalasi dan tag LTS untuk pembaruan
• CLI ringkasan Perintah Capgo CLI untuk menjalankan
• Kompatibilitas asli Peran: Label UI pendek atau item navigasi. Dilihat di: halaman live-update.astro. Pesan kunci `live_update_v2_comp_compat_l` (Live Update V2 Comp Compat L).
• Ketika perubahan memerlukan biner toko vs bundle OTA — example of a Capacitor-aligned plugin major upgrade