Capgo menggunakan 2 variabel utama untuk mengelola versi di aplikasi Capacitor Anda:
- Versi Native
- Versi JavaScript
Semua pilihan versi ditentukan di sisi server oleh Capgo.
Sistem versioning
Untuk mengelola versi Capgo, gunakan sistem SemVer. Baca spesifikasi SemVer atau cek kompatibilitas update Capgo dengan Semver Tester.
Versi
Di mana Capgo menemukan versi untuk dibandingkan
Anda bisa override perilaku ini dengan mengatur version key di
capacitor.config.jsonfile docs di sini Native Build akan diabaikan untuk semua platform.
iOS
Di iOS, variabel diatur di proyek Anda di sini ios/App/App/Info.plist di bawah keyCFBundleShortVersionString atau ios/App/App.xcodeproj/project.pbxproj di bawah key MARKETING_VERSION jika MARKETING_VERSION sudah diatur di Info.plist Anda.
Android
Di Android, variabel diatur di proyek Anda di sini android/app/build.gradle di bawah key defaultConfig.versionName
JavaScript ( versi bundle Capgo )
Di JavaScript, var dapat diatur di package.json di bawah key version
Jika tidak, Anda harus menyediakannya di perintah upload.
Perilaku default
Beginilah cara kerja channel Capgo jika Anda tidak mengubah pengaturan apa pun.
Perilaku ini akan didasarkan pada channel unik yang Anda jadikan default.
Saat instalasi baru aplikasi Capacitor Anda
Saat user mendownload aplikasi Ionic Anda untuk pertama kali dan membukanya, aplikasi akan menghubungi server Capgo.
Saat ini, ada 4 kemungkinan output:
- Versi native bundle (1.2.3) lebih rendah dari versi bundle Capgo (1.2.4), Capgo mengirimkan bundle-nya ke user.
- Versi native bundle (1.2.3) sama dengan versi bundle Capgo (1.2.3), Capgo mengirimkan pesan “no need to update”.
- Versi native bundle (1.2.4) lebih tinggi dari versi bundle Capgo (1.2.3), Capgo mengirimkan pesan “no need to update”.
- Versi bundle native (1.2.3) lebih rendah dari versi bundle Capgo (2.2.3), Capgo akan mengirim “no need to update”.
Pengaturan lainnya
Nonaktifkan auto-downgrade pada native
Jika Anda mengubah pengaturan ini menjadi false, Capgo akan selalu menganggapnya sebagai sumber versi yang tepercaya.\nBerikut adalah perilakunya:
- Versi native (1.2.4) lebih tinggi dari versi Capgo (1.2.3)
Capgo mengirimkan versinya ke user.
Nonaktifkan strategi auto-upgrade
Ada beberapa strategi yang bisa Anda pilih. Pelajari lebih lanjut di sini di sini
Versi bundle JavaScript
Versi bundle JavaScript adalah versi yang Anda kirim saat melakukan npx @capgo/cli@latest bundle upload --channel production
Jika Anda tidak menggunakan opsi --bundle 1.2.3, Capgo akan mengambil versi bundle dari package.json file Anda (pada key version).
Setelah aplikasi Ionic Anda menginstal satu versi dari Capgo, versi inilah yang akan dibandingkan untuk:
- Versi JavaScript bundle mereka (1.2.3) lebih rendah dari versi bundle Capgo (1.2.4), Capgo mengirimkan bundle-nya ke user.
Dengan beberapa kondisi guard:
- Jika versi native bundle lebih tinggi dari versi Capgo, maka
Disable auto downgrade under nativekondisi tersebut akan diterapkan. - Jika versi native bundle jauh lebih rendah (MAJOR) dari versi Capgo, maka
Disable auto upgrade above majorkondisi tersebut akan diterapkan.
update App Store
Saat Anda merilis aplikasi JS Capacitor di App Store, prosesnya sangat sederhana.
User Anda akan mendapatkan versi baru dari store dan secara default menghapus semua local update di aplikasi mereka.
Jika Anda ingin mengubah perilaku tersebut, Anda perlu mengatur pengaturannya resetWhenUpdate baca selengkapnya di sini
Ini hanya bisa diubah dari sisi aplikasi, tidak dari cloud seperti pengaturan lainnya.
Pengaturan lainnya
Selain semua perilaku ini, Anda juga bisa memiliki pengaturan khusus yang terkait dengan deviceID.
Di Capgo, Anda bisa memilih untuk menimpa (override) perilaku untuk setiap deviceID.
Anda dapat menghubungkan satu deviceID ke:
- versi bundle tertentu
- channel tertentu
Ini akan melewati semua pengaturan yang telah dibuat di atas.
Pelajari lebih lanjut di artikel di bawah ini.
Lanjut ke Cara Kerja Versi di Capgo
Jika Anda menggunakan Cara Kerja Versi di Capgo untuk merencanakan pekerjaan plugin native, hubungkan dengan Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi pada Menambahkan atau Memperbarui Plugin, Alternatif Plugin Ionic Enterprise untuk alur kerja produk di alternatif plugin Ionic Enterprise, dan Capgo Native Build untuk alur kerja produk di Capgo Native Builds.