Lompat ke konten utama
Tutorial

Update your Capacitor apps seamlessly using Capacitor-updater

Selamat Capacitor Komunitas Ionic, hari ini saya akan membantu Anda mengatur pembarui Capacitor-updater ke dalam aplikasi Anda. Dengan demikian Anda dapat melakukan perilisan yang halus.

Kredit artikel

Martin Donadieu

Penulis

Valeria

Pengulas

Jordan

Editor

Update your Capacitor apps seamlessly using Capacitor-updater

Apa itu pembarui Capacitor?

Pembarui Capacitor, teknologi yang membantu dalam pengiriman pembaruan aplikasi dan perbaikan kepada pengguna akhir secara instan.

Ini sangat baik jika Anda ingin melakukan perbaikan bug kritikal dan mengirimkannya secara instan tanpa harus melewati ulasan App Store.

Anda dapat memikirkannya sebagai

kecepatan web

kecepatan samping

Capgo keeps your app’s JavaScript bundle in sync with the Capgo server, and every time the user opens the app, it checks with the Capgo server if a new update is available to the bundle. And of course, it comes with tons of awesome configurations which can help you fine-tune your user’s experience.

I use Capgo in all my projects I build. That allows me to put less time in the App Store review process.

pembaruan samping pembaruan samping.

Memahami Versi Semantik dengan Capgo

Capgo menggunakan versi semantik (semver) untuk menentukan kapan dan bagaimana pembaruan harus diterapkan pada aplikasi Anda. Hal ini memastikan bahwa pengguna hanya menerima pembaruan yang kompatibel dan mencegah perubahan yang memecah otomatis diterapkan.

Versi semantik mengikuti format MAJOR.MINOR.PATCH:

  • MAJOR: Perubahan yang memerlukan rilis aplikasi native di toko
  • MINOR: Fitur-fitur baru yang kompatibel mundur
  • PATCH: Perbaikan bug yang kompatibel mundur

Contoh, jika aplikasi Anda berada di versi 1.0.0 dan Anda ingin memperbarui ke 1.0.1 (perbaikan), Capgo akan secara otomatis menerapkan pembaruan ini. Namun, jika Anda ingin memperbarui dari 1.0.0 ke 2.0.0 (versi mayor), hal ini akan memerlukan rilis aplikasi native di toko aplikasi karena menunjukkan perubahan yang mengganggu.

pengaturan saluran Capgo memungkinkan Anda untuk mengonfigurasi jenis-jenis update mana yang akan diterapkan secara otomatis:

  • Strategi Mayor: Memungkinkan semua update (gunakan dengan hati-hati)
  • Strategi Minor: Memungkinkan update minor dan patch saja
  • Strategi Patch: Hanya memungkinkan update patch
  • Strategi Metadata: Memerlukan persyaratan versi minimum untuk dipenuhi

Anda dapat menguji bagaimana kombinasi versi yang berbeda bekerja dengan logika update Capgo menggunakan Alat Tester SemverAlat ini membantu Anda memahami secara tepat kapan pembaruan akan diterapkan berdasarkan konfigurasi saluran Anda.

Apakah ada batasan?

Sebaik apa pun itu terdengar, ada beberapa hal yang perlu kita ingat. Perlu diingat bahwa pembaruan OTA hanya berfungsi dengan bundle web.Anda mungkin berpikir bahwa ini tidak benar-benar merupakan batasan besar karena, dalam Capacitor JS, kita menulis hampir semua code dalam JS CSS dan HTML.

Sementara ini mungkin benar, masih ada modul native yang kita instalasikan ke aplikasi kita. Jika sebuah modul mengubah direktori Android atau iOS, Anda tidak dapat menggunakan OTA untuk memperbarui aplikasi Anda..

Auto Capgo Configuration

It’s time to sign up, and get your API key to upload your first version! Begin by signing up for a Capgo account.

Once you’re logged into Capgo, You will have an onboarding page

Onboarding halaman

Pilih langkah-langkah di halaman onboarding untuk menambahkan aplikasi pertama Anda.

Ikuti CLI panduan

Dari baris perintah, langsung ke root aplikasi Capacitor, jalankan:

npx @capgo/cli@latest init Untuk menginstal Capgo ke dalam aplikasi Capacitor Anda, CLI akan memandu Anda melalui proses pengaturan aplikasi dengan Capgo.

Jika Anda ingin melakukannya secara manual, Anda dapat mengikuti langkah-langkah di bawah.

Pengaturan Konfigurasi Capgo secara manual

Pasang plugin

Akhirnya Anda harus memiliki code ini ditambahkan ke aplikasi Anda:

npm i @capgo/capacitor-updater && npx cap sync Untuk menginstal plugin ke dalam aplikasi Capacitor Anda.

Dan kemudian tambahkan code ini ke aplikasi Anda untuk memberitahu plugin native bahwa bundle JS sehat (jika Anda tidak melakukannya, plugin native akan kembali ke versi sebelumnya):

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Perintah ini akan memberitahu plugin native bahwa instalasi telah berhasil.

Kemudian lakukan npm run build && npx cap copy untuk memperbarui aplikasi Anda.

Masuk ke Capgo CLOUD

Pertama, gunakan all apikey yang ada di akun Anda untuk masuk dengan CLI:

npx @capgo/cli@latest login YOU_KEY

Tambahkan aplikasi pertama Anda

Mari kita mulai dengan membuat aplikasi pertama di Capgo Cloud dengan CLI.

npx @capgo/cli@latest app add

Perintah ini akan menggunakan semua variabel yang didefinisikan di file konfigurasi Capacitor untuk membuat aplikasi.

Unggah versi pertama Anda

Jalankan perintah untuk membangun code dan kirimkannya ke Capgo dengan: npx @capgo/cli@latest bundle upload

Versi nama secara default akan menggunakan yang ada di package.json file.

Cek di Capgo Jika build ada.

Anda bisa bahkan menguji dengan aplikasi sandbox mobile saya Buat channel default.

Setelah Anda telah mengirimkan aplikasi ke __CAPGO_KEEP_0__, Anda perlu membuat channel Anda

untuk memungkinkan aplikasi menerima pembaruan dari Capgo. default to let apps receive updates from Capgo.

npx @capgo/cli@latest channel set production -s default

Untuk aplikasi Anda menerima pembaruan langsung dari Deploy, Anda perlu menjalankan aplikasi di perangkat atau emulator. Cara termudah untuk melakukannya adalah dengan menjalankan perintah berikut untuk meluncurkan aplikasi lokal di emulator atau perangkat yang terhubung ke komputer Anda.

Buka aplikasi, letakkan di latar belakang dan buka lagi, Anda harus melihat di log bahwa aplikasi melakukan pembaruan.

npx cap run [ios | android]

Open the app, put it in the background and open it again, you should see in the logs the app did the update.

Selamat! 🎉 Anda telah berhasil mengaktifkan Live Update pertama Anda. Ini hanya awal dari apa yang bisa Anda lakukan dengan Live Updates. Untuk mengetahui lebih lanjut, lihat dokumentasi Live Updates yang lengkap. Dokumentasi Live Updates.

Jika Anda ingin menghentikan penerimaan update lokal, jalankan perintah ini npx @capgo/cli@latest channel set

Keep going from Update your Capacitor apps seamlessly using Capacitor-updater

Jika Anda menggunakan Update your Capacitor apps seamlessly using Capacitor-updater untuk merencanakan migrasi dan operasi bisnis, hubungkan dengan Capgo Enterprise untuk alur kerja produk di Capgo Enterprise, Alternatif Ionic Enterprise Plugin untuk alur kerja produk di Alternatif Ionic Enterprise Plugin, Alternatif Capgo untuk alur kerja produk di Capgo Alternatif Capgo Konsultasi untuk alur kerja produk di Capgo Konsultasi, dan Capgo Layanan Premium untuk alur kerja produk di Capgo Layanan Premium.

Pembaruan Langsung untuk aplikasi Capacitor

Ketika bug layer web masih aktif, kirimkan perbaikan melalui Capgo daripada menunggu hari-hari untuk persetujuan toko aplikasi. Pengguna mendapatkan pembaruan di latar belakang sementara perubahan native tetap dalam jalur review normal.

Bantuan Manusia dari Martin

Mulai Sekarang

Terbaru dari Blog Kami

Capgo memberikan Anda wawasan terbaik yang Anda butuhkan untuk menciptakan aplikasi mobile profesional yang sebenarnya.