Langsung ke konten utama
Tutorial

Update your Capacitor apps seamlessly using Capacitor-updater

Greetings Capacitor Ionic Community, today I'll be helping you setup Capacitor-updater into your app. So that you can do seamless releases.

Kredit artikel

Martin Donadieu

Pengarang

Valeria

Pengulas

Jordan

Pengedit

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 bagus jika Anda ingin melakukan perbaikan bug kritikal dan mengirimkan secara instan tanpa harus melewati ulasan App Store.

Anda dapat memikirkannya sebagai kemampuan "seperti web" untuk mengunduh pembaruan secara sisi segera setelah tersedia.

Moreover, it provides rollbacks if the new update crashes the app

Bagaimana cara kerjanya?

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.

Saya menggunakan Capgo di semua proyek yang saya bangun. Itu memungkinkan saya untuk menghabiskan waktu yang lebih sedikit dalam proses tinjauan App Store.

Anda dapat membaca lebih lanjut tentang itu di sini.

Mengerti 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 Anda 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
  • MINOR: Fitur baru yang kompatibel mundur
  • PATCH: Perbaikan bug yang kompatibel mundur

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

Capgo’s pengaturan saluran memungkinkan Anda mengonfigurasi jenis-jenis pembaruan yang secara otomatis diterapkan:

  • Strategi Utama: Izinkan semua pembaruan (gunakan dengan hati-hati)
  • Strategi Minor: Izinkan pembaruan minor dan patch saja
  • Strategi Patch: Hanya izinkan pembaruan patch saja
  • Strategi Metadata: Memerlukan persyaratan versi minimum untuk dipenuhi

Kamu bisa menguji bagaimana kombinasi versi berbeda bekerja dengan logika pembaruan Capgo menggunakan alat tester Semver kami. Alat Tester Semver. Alat ini membantu kamu memahami secara tepat kapan pembaruan akan diterapkan berdasarkan konfigurasi channel kamu.

Apakah ada batasan?

As good as it may sound, there are a few things that we need to keep in mind. The first thing is that OTA updates Hanya berfungsi dengan bundle web. You may think that this isn’t really a big limitation because, in Capacitor JS, we write almost all code in JS CSS and HTML. While this may be true, there still are native modules that we install to our app. If a module changes your android or iOS directories, you can’t use OTA to update your app. That’s because these directories’ contents are used to compile Native binaries, which OTA can’t update. Even native app cannot update this part.

Sementara ini mungkin benar, masih ada modul native yang kami instal ke aplikasi kami. sini untuk IOS.

Auto Capgo Configuration

Sekarang saatnya untuk mendaftar dan mendapatkan kunci API Anda untuk mengunggah versi pertama! Mulailah dengan Tapi kamu bisa mengatur CI/CD untuk mengatasi bagian ini, saya membuat tutorial tentang cara melakukannya di sini untuk IOS, Auto Capgo Configuration, Waktunya untuk mendaftar dan mendapatkan kunci Capgo untuk mengunggah versi pertama! Mulailah dengan mendaftar untuk akun Capgo.

Setelah Anda masuk ke Capgo, Anda akan memiliki halaman onboarding

Halaman Pendaftaran

Ikuti langkah-langkah di halaman onboarding untuk menambahkan aplikasi pertama Anda

Ikuti panduan CLI

Dari command line, langsung ke root direktori aplikasi Capacitor Anda, jalankan:

npx @capgo/cli@latest init Untuk menginstal Capgo ke dalam aplikasi Capacitor, CLI akan membantu Anda mengatur aplikasi dengan Capgo.

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

Konfigurasi Manual Capgo

Instal plugin

Anda seharusnya memiliki code ini ditambahkan ke aplikasi Anda:

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

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

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

CapacitorUpdater.notifyAppReady()

Ini akan memberitahu plugin asli bahwa instalasi telah berhasil.

Lalu 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 ditentukan 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

Secara default, nama versi akan menjadi yang ada di package.json Dapatkan di

Cek di Capgo jika ada build yang tersedia.

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

Atur saluran default

Setelah Anda telah mengirimkan aplikasi ke Capgo, Anda perlu membuat saluran Anda default biarkan aplikasi menerima pembaruan dari Capgo.

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

Receive a Live Update on a Device

For your application to receive a live update from Deploy, you’ll need to run the app on a device or an emulator. The easiest way to do this is simply to use the following command to launch your local app in an emulator or a device connected to your computer.

npx cap run [ios | android]

Buka aplikasi, lakukan background dan buka lagi, Anda harus melihat di log bahwa aplikasi melakukan update.

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

Jika Anda perlu menghentikan menerima pembaruan lokal, jalankan perintah ini: npx @capgo/cli@latest channel set

Teruskan dari Pembaruan Capacitor aplikasi Anda secara lancar menggunakan Capacitor-pembaruan.

Jika Anda menggunakan Pembaruan Capacitor aplikasi Anda secara lancar menggunakan Capacitor-pembaruan. untuk merencanakan migrasi dan operasi bisnis, hubungkan dengan Capgo Enterprise untuk alur kerja produk di Capgo Enterprise, Alternatif Plugin Enterprise Ionic Dugaan Alternatif Plugin Bisnis Enterprise Ionic Alternatif Capgo untuk alur produk di Alternatif Capgo Capgo Konsultasi untuk alur produk di Capgo Konsultasi, dan Capgo Layanan Premium untuk alur produk di Capgo Layanan Premium.

Live update 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.

Dukungan manusia dari Martin

Mulai Sekarang

Terbaru dari Blog Kami

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