Bagaimana Menggunakan Pengkodean Versi Semantik dengan Pembaruan Capgo OTA

Inginkan untuk memudahkan pembaruan aplikasi Pertanyaan tentang pengendalian versi? Pengendalian Versi Semantik (SemVer) digabungkan dengan CapgoPenggunaan Over-The-Air (OTA) Capgo membuat pengelolaan Capacitor mudah dan lebih cepat. Berikut adalah cara kerjanya:

• Pengendalian Versi Semantik Dasar: Penggunaan format versi MAJOR.MINOR.PATCH:

  • Penggunaan untuk perubahan besar. Penggunaan untuk perubahan kecil.
  • Penggunaan untuk perubahan kecil. Untuk fitur-fitur baru yang kompatibel ke belakang.
  • PATCH: Untuk perbaikan bug.

• Mengapa Menggunakan SemVer dengan Capgo?

  • Komunikasi yang jelas tentang update.
  • Pengelolaan versi yang lebih cerdas.
  • Menghindari konflik dependensi.
  • Perencanaan rilis yang terorganisir.

• Capgo Setup Langkah-Langkah:

  1. Instal plugin pembarui Capgo.
  2. Konfigurasi versi aplikasi Anda di capacitor.config.json dan file lainnya.
  3. Mulai dengan kunci API Anda.
  4. Pilih Capgo CLI untuk mengemas dan mengunggah pembaruan.

• Pengelolaan Versi dan Saluran:

  • Pilih saluran yang berbeda (misalnya, “beta” untuk pengujian, “produksi” untuk rilis stabil).
  • Kontrol kebijakan pembaruan (pembaruan otomatis untuk patch, persetujuan manual untuk perubahan besar).
  • Opsi pengembalian untuk pembaruan yang gagal.

• Proses Pengembangan:

  • Perbarui nomor versi mengikuti aturan SemVer.
  • Uji secara menyeluruh sebelum mengembangkan.
  • Gunakan perintah CLI untuk mengunggah dan mendistribusikan update.

Capgo memastikan update mencapai pengguna dengan cepat dan dapat diandalkan, dengan alat untuk mengatasi gangguan dan menjaga stabilitas. Cocok untuk tim yang menggunakan alur kerja CI/CD untuk mengotomasi update.

Tips Cepat: Selalu tes update dan gunakan saluran untuk mengelola peluncuran berjenjang secara efektif.

Pengaturan Versi Semantik | Tingkatkan Kemampuan

Capgo Petunjuk Pengaturan

Berikut cara mengatur Capgo untuk mengelola update OTA dan pengendalian versi dengan mudah.

Langkah-Langkah Pengaturan Awal

Mulai dengan menginstal Capgo plugin pembaruan:

npm install @capgo/capacitor-updater  
npx cap sync

Pastikan Anda capacitor.config.json context

{ 
  "appId": "com.example.app", 
  "appName": "My App", 
  "version": "1.0.0" 
}

format versi semantik:

• package.json Untuk proyek yang lebih tua, update detail versi di lokasi-lokasi berikut: version (cari bidang)
• android/app/build.gradle (update) versionName)
• ios/App/App.xcodeproj/project.pbxproj (update) CURRENT_PROJECT_VERSION)

Once configured, initialize Capgo with your API key:

npx @capgo/cli@latest init YOUR_API_KEY

Setelah dikonfigurasi, inisialisasi __CAPGO_KEEP_0__ dengan kunci __CAPGO_KEEP_1__ Anda:

Integrasi Pengendalian Versi

Capgo berfungsi dengan baik dengan platform CI/CD, sehingga update otomatis sederhana. Platform yang didukung termasuk:

• GitHub Actions
• GitLab CI
• Azure DevOps
• Jenkins
• CircleCI

Jika Anda bekerja pada pengembangan lokal, Anda dapat menonaktifkan update otomatis dengan menambahkan ini ke konfigurasi Anda:

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

ini memastikan Capgo tidak menggantikan perubahan lokal Anda. Setelah setup Anda siap, unggah versi pertama Anda:

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

Terakhir, notifikasi plugin asli tentang kesehatan bundle di file utama aplikasi Anda:

import { CapacitorUpdater } from '@capgo/capacitor-updater';  
CapacitorUpdater.notifyAppReady();

Konfigurasi ini memastikan aplikasi Anda siap untuk pengiriman OTA yang lancar dan pengelolaan versi.

Menggunakan Versi Semantik dengan Capgo

Pengelolaan Nomor Versi

Capgo menggunakan Versi Semantik (SemVer) untuk mengelola versi aplikasi, yang dibentuk sebagai MAJOR.MINOR.PATCHBerikut cara kerjanya:

• Versi Utama (X.0.0): Tingkatkan nomor MAJOR untuk perubahan yang memutuskan kembali kompatibilitas.
• Versi Minor (1.X.0): Tingkatkan nomor MINOR untuk fitur baru yang tetap kompatibel.
• Versi Patch (1.0.X): Perbaiki nomor PATCH untuk perbaikan bug yang tidak mempengaruhi konsistensi.

Dengan mengikuti aturan SemVer, Anda dapat memudahkan pengelolaan versi dan memastikan pembaruan yang lebih lancar di seluruh saluran pengiriman.

Pedoman Pengendalian Versi

Capgo memungkinkan Anda mengelola pengiriman dengan efektif dengan mengatur saluran yang berbeda untuk tahap-tahap alur kerja Anda.

• Pengelolaan Versi Berdasarkan Saluran: Organisir proses pengiriman Anda dengan membuat saluran yang berbeda untuk pengujian dan produksi. Misalnya:

  • Pakai saluran “beta” (misalnya, 1.2.0-beta) untuk pengujian fitur baru.
  • Tetapkan saluran “produksi” (misalnya, 1.2.0) untuk rilis stabil.
  • Tambahkan saluran yang spesifik untuk platform (misalnya, “ios-hotfix” dengan versi 1.2.1) ketika menangani masalah yang spesifik untuk platform.

• Konfigurasi Kebijakan Pembaruan: Kendalikan bagaimana pembaruan diterapkan menggunakan opsi konfigurasi Capgo . Misalnya:

  {
    "plugins": {
      "CapacitorUpdater": {
        "disableAutoUpdate": "minor"
      }
    }
  }

  Pengaturan ini memastikan pengguna secara otomatis menerima pembaruan patch, sementara pembaruan minor dan mayor memerlukan persetujuan manual.

• Strategi Rollback Versi: Gunakan identifikasi pre-release untuk menjaga opsi rollback yang jelas. Pendekatan ini memungkinkan Anda untuk kembali ke versi sebelumnya jika masalah terjadi, sambil menjaga konsistensi versi di semua saluran.

Praktik terbaik ini membuat lebih mudah untuk mengelola update, menguji fitur baru, dan menjaga stabilitas dalam proses pengiriman aplikasi Anda.

sbb-itb-f9944d2

Pengiriman Update OTA

: Setelah setup manajemen versi Anda siap, ikuti langkah-langkah ini untuk mengirimkan update OTA dengan efektif.

Persiapan Update

: Mulai dengan mengupdate versi di : dan __CAPGO_KEEP_0__.config.json capacitor.config.jsontext

• Pembaruan Bug: Tingkatkan nomor PATCH (misalnya 1.0.1 → 1.0.2)
• Pengembangan Baru: Tingkatkan nomor MINOR (misalnya 1.0.0 → 1.1.0)
• Pengubahan Besar: Tingkatkan nomor MAJOR (misalnya 1.0.0 → 2.0.0)

Tes secara menyeluruh build Anda dan pastikan aplikasi berkomunikasi dengan server menggunakan notifyAppReady.

Selanjutnya, putuskan strategi Pembaruan. Anda dapat memilih dari:

• Pembaruan Otomatis: Enforce otomatis persyaratan versi minimum.
• Kontrol Manual: Spesifikasikan persyaratan versi yang tepat untuk pembaruan.
• Berbasis Channel: Gunakan saluran untuk tes dan peluncuran yang dikemas.

Capgo CLI Perintah Pembaruan

Gunakan Capgo’s CLI untuk mengirimkan pembaruan Anda dengan mudah. Berikut cara melakukannya:

# Initialize Capgo in your project
npx @capgo/cli@latest init [apikey]

# Upload your update bundle
npx @capgo/cli bundle upload [appId]

# Add a new distribution channel
npx @capgo/cli channel add [channelName] [appId]

Capgo memastikan pengiriman yang aman dengan enkripsi akhir-ke-akhir dan manajemen kunci yang aman.

“@Capgo adalah cara pintar untuk membuat push code yang panas (dan bukan untuk semua uang di dunia seperti dengan @AppFlow) 🙂”

Saat sudah diinstal, Anda dapat memantau pembaruan melalui dashboard Capgo. Pembaruan biasanya mencapai pengguna dalam beberapa menit setelah mereka membuka aplikasi. Prosesnya berlangsung seperti ini:

• Aplikasi memeriksa pembaruan.
• Mengunduh pembaruan di latar belakang.
• Mengaktifkan versi baru ketika pengguna keluar dari aplikasi.
• Melakukan pembaruan pada peluncuran berikutnya.

Mungkin Anda ingin mengintegrasikan otomatisasi CI/CD untuk penggunaan skala besar.

“Kami menerapkan pengembangan berbasis agile dan @Capgo sangat kritis dalam menyampaikan kontinu kepada pengguna kami!”

Pemecahan Masalah dan Tips

Pengelolaan Versi

Pengelolaan versi semantik di Capgo dapat membuat proses pembaruan menjadi rumit. Untuk menghindari menggantikan pekerjaan pengembangan Anda, konfigurasi berikut di file Anda: capacitor.config.json Jika pembaruan gagal, berikut adalah langkah yang dapat Anda lakukan:

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

Setel

• ke autoUpdate context: Halaman/area: Halaman produk pembaruan hidup. Peran: Label UI singkat atau item navigasi. Kunci pesan `live_update_dynamic_label_to` (Label Dinamis Pembaruan Hidup Ke). false selama pengembangan.
• Menghapus aplikasi.
• Reinstalasinya dengan versi yang diperbaiki.
• Nonaktifkan ulang otomatisasi pembaruan setelah semua stabil.

Untuk pembaruan versi utama, gunakan flag dan dengarkan event untuk menghandle pembaruan dengan benar: disableAutoUpdateBreaking Menggabungkan konfigurasi ini dengan praktik tim yang baik, Anda dapat mempertahankan konsistensi versi dan mengurangi kesalahan. majorAvailable Pengendalian Versi Tim

CapacitorUpdater.addListener('majorAvailable', (info) => {
  console.log(`Major update available: ${info.version}`);
  // Add your update prompt logic here
});

Setelah pembaruan individu diatur, sangat penting bagi tim untuk menetapkan praktik pengendalian versi yang kuat.

“Menguji setiap perubahan sebelum menggabungkannya dengan repositori utama akan memperkuat stabilitas dan menghindari kesalahan yang mahal”

Berikut beberapa metode untuk memastikan konsistensi:

Tentukan satu cabang sebagai [4]

repositori utama

• Reinstalasinya dengan versi yang diperbaiki. Nonaktifkan ulang otomatisasi pembaruan setelah semua stabil. untuk berperan sebagai sumber kebenaran.
• Menggunakan saluran Capgo yang terpisah untuk lingkungan pengembangan dan produksi.
• Mengupload versi secara otomatis melalui alur CI/CD.
• Mendokumentasikan semua code perubahan dengan pesan komit yang jelas dan rinci.

Untuk tim yang lebih besar, matriks manajemen versi berikut dapat membantu mengorganisir pembaruan:

Langkah-Langkah Pemulihan Update

Meskipun dengan langkah-langkah pencegahan, update dapat gagal. Jika itu terjadi, ikuti langkah-langkah pemulihan berikut:

1. Kembali ke bundle stabil sebelumnya.
2. Perbarui nomor versi untuk setiap perbaikan baru (perlu diingat: nomor versi tidak dapat digunakan kembali setelah penghapusan) [2].
3. Pastikan pembaruan selama aplikasi startup untuk memastikan mereka berfungsi dengan baik.

Updater Capgo dirancang untuk mengatasi gangguan. Misalnya, jika server tidak dapat diakses atau pembaruan dihapus, aplikasi tetap berfungsi normal. [3]Selain itu, permintaan jaringan yang gagal secara otomatis akan diulang selama aplikasi diluncurkan berikutnya. [3]Ini kekuatan tahan banting yang dibangun secara dalam untuk mengurangi waktu down dan memastikan operasi yang lebih halus.

Ringkasan

Penggunaan Versi Semantik, dikombinasikan dengan Capgo, telah membuat pembaruan OTA untuk aplikasi Capacitor lebih efisien. Dengan 947,6 juta pembaruan yang disampaikan dan 1.400 aplikasi produksi yang menggunakan sistem ini [1]proses pengembangan telah menjadi 81% lebih efisien. [1]Setup ini memungkinkan pengembang untuk memasukkan pembaruan dengan cepat dan terkendali, menghindari penundaan aplikasi toko.

Berikut ini apa yang dikatakan oleh pengembang:

“Kami mengeluarkan} pembaruan OTA Capgo in production for our user base of +5000. We’re seeing very smooth operation almost all our users are upto date within minutes of the OTA being deployed to @Capgo.” - colenso [1]

Versi sistem perubahan besar, kecil, dan patch membuat mudah untuk berkomunikasi perubahan besar, fitur baru, dan perbaikan bug. [5]. This is especially helpful for teams managing several releases each week through Capgo’s platform.

Capgo’s Solusi yang terenkripsiSolusi ini yang terintegrasi dengan alat CI/CD juga sangat ramah biaya - menghemat biaya hingga $26,100 dalam lima tahun. [1]Jaringan yang dapat disesuaikan memastikan perbaruan mencapai pengguna yang tepat pada waktu yang tepat.

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” - Rodrigo Mantica [1]

Keep going from How to Use Semantic Versioning with Capgo OTA Updates

Jika Anda menggunakan How to Use Semantic Versioning with Capgo OTA Updates untuk merencanakan rollback dan pengendalian versi, hubungkannya dengan Pengembalian Rollback untuk detail implementasi di Pengembalian Rollback, Target Versi context untuk detail implementasi di Target Versi, Perilaku Perbarui untuk detail implementasi di Perilaku Perbarui, bundle Capgo Live Updates Capgo Perbarui Langsung