Pengaturan Versi

Copy prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

Capgo menggunakan Pengaturan Versi Semantik (semver) untuk plugin, CLI, dan produk yang kami kirimkan — praktek yang sama yang kami rekomendasikan untuk bundel aplikasi Anda sendiri.

This page explains how those versions relate to each other, what stays compatible across majors, and how to pin older Capacitor majors with LTS tags.

Aturan Cepat

Peraturan Cepat	Pengaturan Versi Utama	Catatan konsistensi
Capgo plugin	Ikuti yang sesuai Capacitor utama	Versi utama plugin `8` Target Capacitor 8, `7` Target Capacitor 7, dan seterusnya
Capgo CLI	Independent	Jangan sinkronkan CLI mayor dengan plugin atau Capacitor. Selalu gunakan CLI terbaru
Capgo Konsol	Independent	Mengembangkan versi sendiri; kompatibel dengan versi plugin pembaruan yang didukung

Bagian berjudul “Plugin mengikuti versi mayor Capacitor”

Every Capgo plugin major tracks the Capacitor major it is built for:

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

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

stabilitas API antar versi

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

Opsi default mungkin masih berubah pada versi baru. Lihat catatan rilis dan panduan migrasi (lihat pengaturan pembaruan dan panduan di bawah Migrasi di sidebar pengaturan pembaruan) saat Anda meningkatkan versi.

CLI dan Console menggunakan versi masing-masing

Versi Capgo CLI dan Capgo Console tidak tidak bagikan versi utama dengan plugin atau Capacitor

Anda tidak tidak perlu CLI major 8 karena Anda berada di Capacitor 8 atau pembaruan 8.
Selalu instal atau panggil __CAPGO_KEEP_0__ yang terbaru terbaru CLI
Versi terbaru CLI dan Console tetap kompatibel dengan versi yang didukung mana pun @capgo/capacitor-updater (dan pembaruan terkait) versi utama.

Mengunci versi CLI yang lama tidak disarankan. Lebih baik:

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

Tag LTS untuk mayor plugin sebelumnya

Jika Anda tetap menggunakan mayor Capacitor yang lebih lama, instal plugin mayor 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

Di luar pembaruan, rilis LTS mayor plugin sebelumnya diterbitkan sesuai permintaan.

Updater backports vs plugin lainnya

Paket	Backport sebelumnya mayor
`@capgo/capacitor-updater`	Mirroring bulanan backport 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	Pada permintaan

Fitur yang sama, nomor versi yang dipantulkan

Judul Bagian: Sifat yang sama, nomor versi yang dipantulkan

Jika rilis terbaru adalah 8.3.4dan garansi Capacitor 7 LTS ini dipublikasikan sebagai 7.3.4 dengan satu set fitur dan perbaikan bug yang sama, disesuaikan untuk Capacitor mayor ini.

Instal dengan tag ketika Anda ingin “terbaru untuk Capacitor mayor ini”:

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

LTS adalah backport dari terbaru

Setelah plugin mayor baru dipasang, sebuah lts-v7 (atau lts-v6Rilis …) adalah sebuah backport terbaru jadi pekerjaan yang sama berjalan pada versi sebelumnya Capacitor mayor.

Karena itu mengikuti terbaru, garis LTS publik API mungkin berubah ketika terbaru berubah — meskipun nomor mayor tetap pada 7. Tatal LTS sebagai “tindakan Capgo saat ini pada versi Capacitor yang lebih tua,” bukan sebagai legasi API yang terkekang selamanya.

Apa ini berarti untuk aplikasi Anda

Perbarui Capgo plugin ketika Anda meningkatkan Capacitor mayor.
Selalu jalankan @capgo/cli@latest — CLI mayor sinkron dengan Capacitor/plugin tidak perlu.
Tetapkan pada Capacitor 7 (atau lebih lama)? Gunakan @lts-v7 atau tag yang sesuai, bukan versi lama yang sembarangan 7.x dari beberapa bulan yang lalu.
Versi sendiri paket update live dengan semver seperti cara Capgo mengatur versi paketnya. Lihat versi paket dan saluran dan targeting versi.

Tambahkan Aplikasi perintah instalasi dan tag LTS untuk pembaruan
Ringkasan CLI — cara menjalankan perintah Capgo CLI
Kompatibilitas Asli ketika perubahan memerlukan file biner toko vs paket OTA
Dari V7 ke V8 Contoh plugin Capacitor yang sejalan dengan pembaruan besar