Bagaimana Menggunakan Semantik Versi dengan Pembaruan Capgo OTA

Inginkan untuk memudahkan perbarui aplikasi dan pengendalian versi? Semantic Versi (SemVer) dicampur dengan CapgoCapgo's Over-The-Air (OTA) updates memudahkan pengelolaan Capacitor apps easier and faster. Here’s how:

• context: __CAPGO_KEEP_0__ Versi menggunakan format MAJOR.MINOR.PATCH:

  • MAJOR: Untuk perubahan yang memecah.
  • MINOR: Untuk 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 Steps:

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

• Manajemen Versi dan Saluran:

  • Pilih saluran terpisah (misalnya, “beta” untuk tes, “produksi” untuk rilis stabil).
  • Kontrol kebijakan pembarui (pembarui otomatis patch, persetujuan manual untuk perubahan besar).
  • Pilihan pengembalian untuk pembarui gagal.

• Proses Pengembangan:

  • Mengupdate nomor versi sesuai dengan aturan SemVer.
  • Test thoroughly before deploying.
  • Use CLI commands to upload and distribute updates.

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

Tips Cepat: Selalu tes perbarui dan gunakan saluran untuk mengelola peluncuran rollover secara efektif.

Penggunaan Versi Semantik | Tingkatkan Kemampuan

Capgo Petunjuk Pengaturan

Berikut cara mengatur Capgo untuk mengelola pembaruan OTA dan kontrol versi dengan mudah.

Langkah Awal Pengaturan

Mulai dengan menginstal plugin pembaruan __CAPGO_KEEP_0__ plugin pembaruan Capgo:

npm install @capgo/capacitor-updater  
npx cap sync

Pastikan Anda capacitor.config.json file menggunakan format versi semantik:

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

Untuk proyek yang lebih tua, perbarui detail versi di lokasi-lokasi berikut:

• package.json Setelah diatur, inisialisasi __CAPGO_KEEP_0__ dengan kunci __CAPGO_KEEP_1__ Anda: version field)
• android/app/build.gradle (update versionName)
• ios/App/App.xcodeproj/project.pbxproj (update CURRENT_PROJECT_VERSION)

Setelah terkonfigurasi, inisialisasi Capgo dengan kunci API Anda:

npx @capgo/cli@latest init YOUR_API_KEY

Referensi Cepat:

Pengintegrasian Kontrol Versi

Capgo bekerja dengan baik dengan platform CI/CD, membuat Pembaruan Otomatis Sederhana. Platform yang didukung termasuk:

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

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

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

Hal ini memastikan bahwa Capgo tidak akan 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();

Setup ini memastikan aplikasi Anda siap untuk pembaruan OTA yang lancar dan pengelolaan versi.

Penggunaan Versi Semantik dengan Capgo

Pengelolaan Nomor Versi

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

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

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 menguji fitur-fitur baru.
  • Tetapkan saluran “produksi” (misalnya, 1.2.0) untuk rilis stabil.
  • Tambahkan saluran khusus platform (misalnya "ios-hotfix" dengan versi 1.2.1) ketika menangani masalah khusus platform.

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

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

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

• Strategi Rollback Versi: Use pre-release identifiers to maintain clear rollback options. This approach allows you to revert to a previous version if problems occur, while keeping versioning consistent across all channels.

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

sbb-itb-f9944d2

sbb-itb-f9944d2

Setelah pengaturan manajemen versi Anda siap, ikuti langkah-langkah ini untuk mengirimkan pembaruan OTA secara efektif.

Persiapan Perbarui

Mulai dengan mengupdate versi di package.json dan capacitor.config.jsonPastikan versi mengikuti format SemVer (MAJOR.MINOR.PATCH):

• Perbaikan Bug: Tingkatkan nomor PATCH (misalnya 1.0.1 → 1.0.2)
• Fitur Baru: Tingkatkan nomor MINOR (misalnya 1.0.0 → 1.1.0)
• Pembaruan Struktural: Tingkatkan nomor MAJOR (misalnya 1.0.0 → 2.0.0)

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

Selanjutnya, putuskan strategi pembaruan Anda Strategi Pembaruan. Anda dapat memilih dari:

• Auto-Update: Mengaktifkan persyaratan versi minimum secara otomatis.
• Pengendalian Manual: Mengatur persyaratan versi spesifik untuk pembaruan.
• Channel-BasedGunakan saluran untuk tes dan peluncuran yang disiapkan.

Capgo CLI Perintah Pembaruan

Use Capgo’s CLI to deploy your update with ease. Here’s how:

# 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 pengunduhan yang aman dengan enkripsi akhir-ke-akhir dan pengelolaan kunci yang aman.

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

Setelah diunduh, Anda dapat memantau pembaruan melalui dashboard Capgo. Pembaruan biasanya mencapai pengguna dalam beberapa menit setelah mereka membuka aplikasi. Prosesnya berjalan seperti ini:

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

Untuk penggunaan perusahaan, Anda mungkin ingin mengintegrasikan otomatisasi CI/CD.

“Kami menerapkan pengembangan agile dan @Capgo sangat penting dalam menyampaikan kontinu ke pengguna kami!”

Pengembangan Masalah dan Tips

Pengelolaan Versi Masalah

Pengelolaan versi semantik dalam @Capgo dapat membuat proses pembaruan menjadi rumit. Untuk menghindari menghapus pekerjaan pengembangan, konfigurasi berikut dalam file Anda: capacitor.config.json file:

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

Jika update gagal, Anda dapat melakukan hal berikut:

• context autoUpdate ke false selama pengembangan.
• Hapus aplikasi.
• Reinstall aplikasi dengan versi yang diperbaiki.
• Nonaktifkan ulang fitur auto-update setelah semua stabil.

Untuk pembaruan versi utama, gunakan disableAutoUpdateBreaking flag dan dengarkan majorAvailable event to handle updates properly:

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.

Pengendalian Versi Tim

Untuk pembaruan versi utama, gunakan flag dan dengarkan event untuk menghandle pembaruan dengan benar: __CAPGO_KEEP_0__

"“Menguji setiap perubahan sebelum menggabungkannya dengan repositori utama akan memperkuat kestabilan dan menghindari kesalahan yang mahal”” [4]

Berikut beberapa cara untuk memastikan konsistensi:

• Definisikan satu cabang sebagai repositori utama untuk berperan sebagai sumber kebenaran. Gunakan saluran __CAPGO_KEEP_0__ yang terpisah untuk lingkungan pengembangan dan produksi.
• Gunakan saluran Capgo yang terpisah untuk lingkungan pengembangan dan produksi.
• Automatisasi unggah versi melalui alur CI/CD.
• Dokumentasikan semua perubahan code dengan pesan komit yang jelas dan terperinci.

Untuk tim yang lebih besar, matrix pengelolaan versi berikut dapat membantu mengorganisir pembaruan:

Langkah-Langkah Pemulihan Update

Meskipun telah berhati-hati, pembaruan dapat gagal. Jika itu terjadi, ikuti langkah-langkah pemulihan ini:

1. Kembali ke bundle stabil sebelumnya.
2. Naikkan nomor versi untuk setiap perbaikan baru (perlu diingat: nomor versi tidak dapat digunakan kembali setelah penghapusan) [2].
3. Verify updates during app startup to ensure they work as expected.

Updater Capgo dirancang untuk mengatasi gangguan. Misalnya, jika server tidak dapat dijangkau atau update dihapus, aplikasi tetap berfungsi normal [3]. Selain itu, permintaan jaringan yang gagal secara otomatis akan diulang selama aplikasi diluncurkan berikutnya [3]Ini meminimalkan waktu down waktu dan memastikan operasi yang lebih lancar.

Ringkasan

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

Apa yang dikatakan para pengembang:

“Kami mengeluarkan Capgo pembaruan OTA 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]

sistem versi MAJOR.MINOR.PATCH membuatnya mudah untuk menyampaikan perubahan yang mengganggu, fitur baru, dan perbaikan bug [5]. Hal ini sangat membantu bagi tim yang mengelola beberapa rilis setiap minggu melalui Capgo’s platform.

Capgo’s solusi yang terenkripsi, yang terintegrasi dengan alat CI/CD, juga ramah anggaran - menghemat biaya hingga $26,100 selama lima tahun [1]. Saluran yang dapat disesuaikan memastikan pembaruan mencapai pengguna yang tepat pada waktu yang tepat.

“Kami menerapkan pengembangan yang berkelanjutan dan @Capgo sangat kritis dalam menyampaikan secara terus-menerus kepada pengguna kami!” - Rodrigo Mantica [1]

Teruskan dari Cara Menggunakan Versi Semantik dengan Capgo OTA Updates

Jika Anda menggunakan Cara Menggunakan Versi Semantik dengan Capgo Perbarui OTA Untuk merencanakan rollback dan pengendalian versi, hubungkannya Rollbacks untuk detail implementasi di Rollbacks, Target Versi untuk detail implementasi di Target Versi, Pengaturan Perbarui untuk detail implementasi di Pengaturan Perbarui, bundle untuk detail implementasi di bundle, dan Perbarui Capgo Langsung untuk alur kerja produk di Capgo Live Updates.