Cara Menggunakan Versi Semantik dengan Capgo Pembaruan OTA

Ingin memudahkan pembaruan aplikasi dan pengendalian versi? Semantic Versioning (SemVer) yang dikombinasikan dengan Capgoupdate Over-The-Air (OTA) dari Capacitor membuat pengelolaan

• __CAPGO_KEEP_0__ lebih mudah dan cepat. Berikut adalah caranya: MAJOR.MINOR.PATCH:

  • Dasar-Dasar Pengendalian Versi Semantik: Versi menggunakan format
  • MAJOR: Untuk perubahan yang memecah (breaking changes).
  • 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. Pasang plugin pembaruan Capgo.
  2. Konfigurasi versi aplikasi Anda di capacitor.config.json dan file lainnya.
  3. Mulai dengan kunci API Anda.
  4. Gunakan Capgo CLI untuk mengemas dan mengunggah pembaruan.

• Manajemen Versi dan Saluran:

  • Gunakan saluran terpisah (misalnya, “beta” untuk pengujian, “produksi” untuk rilis stabil).
  • Kontrol kebijakan pembaruan (otomatis update patch, persetujuan manual untuk perubahan besar).
  • Opsi rollback untuk pembaruan gagal.

• Proses Pengembangan:

  • Perbarui nomor versi mengikuti aturan SemVer.
  • Lakukan pengujian secara menyeluruh sebelum mengembangkan.
  • Gunakan perintah CLI untuk mengunggah dan mendistribusikan pembaruan.

Capgo memastikan pembaruan 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 mengotomatisasi pembaruan.

Tips Cepat: Selalu tes pembaruan dan gunakan saluran untuk mengelola peluncuran yang dipersiapkan secara efektif.

Pengaturan Versi Semantis | Tingkatkan Kemampuan

Capgo Petunjuk Pemasangan

Here’s how to set up Capgo for managing OTA updates and version control with ease.

Berikut cara mengatur __CAPGO_KEEP_0__ untuk mengelola pembaruan OTA dan pengendalian versi dengan mudah.

Langkah-Langkah Pemasangan Awal Mulai dengan menginstal plugin pembaruan Capgo:

npm install @capgo/capacitor-updater  
npx cap sync

Pastikan file Anda menggunakan format versi semantik: capacitor.config.json Untuk proyek yang lebih tua, update detail versi di lokasi-lokasi ini:

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

(cari bidang

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

Once configured, initialize Capgo with your API key:

npx @capgo/cli@latest init YOUR_API_KEY

Aksi Kunci

Pengintegrasian Kontrol 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 
    } 
  } 
}

Hal ini memastikan 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

Akhirnya, perluas plugin asli tentang kesehatan bundle di file utama aplikasi Anda:

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

Pengaturan 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.PATCH. Berikut cara kerjanya:

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

Untuk mengikuti aturan SemVer, Anda dapat memudahkan pengelolaan versi dan memastikan pembaruan yang lebih lancar di semua 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 yang spesifik untuk platform (misalnya, “ios-hotfix” dengan versi 1.2.1) ketika menangani masalah-masalah yang spesifik untuk platform.

• Konfigurasi Kebijakan Pembaruan: Kontrol bagaimana pembaruan diterapkan menggunakan opsi konfigurasi Capgo’s. 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 mempertahankan opsi rollback yang jelas. Pendekatan ini memungkinkan Anda untuk kembali ke versi sebelumnya jika masalah terjadi, sementara 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.

sbb-itb-f9944d2

Pengiriman Update OTA

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

Persiapan Update

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

• Pembaruan Perbaikan Bug: Tingkatkan nomor PATCH (misalnya 1.0.1 → 1.0.2)
• Fitur Baru: Tingkatkan nomor MINOR (misalnya 1.0.0 → 1.1.0)
• Perubahan Patah: Pastikan Anda telah menguji secara menyeluruh dan memastikan aplikasi berkomunikasi dengan server menggunakan

Selanjutnya, putuskan strategi notifyAppReady.

update Anda . Anda dapat memilih dari:Auto-Update

• : Otomatiskan pengaturan versi minimum.Manual Control
• update strategy: Spesifikkan persyaratan versi yang tepat untuk pembaruan.
• Channel-Based: 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 [channelId] [appId]

Capgo memastikan pengiriman yang aman dengan enkripsi akhir-ke-akhir dan pengelolaan 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.
• Mengidentifikasi versi baru sebagai aktif ketika pengguna keluar dari aplikasi.
• Mengaplikasikan pembaruan pada peluncuran berikutnya.

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

“Kami menerapkan pengembangan agile dan @Capgo sangat kritis dalam menyampaikan secara terus-menerus kepada pengguna kami!”

Masalah Pemecahan dan Tips

Masalah Pengelolaan Versi

Pengelolaan versi semantik di Capgo dapat mengakibatkan komplikasi dalam proses update. Untuk menghindari menghapus pekerjaan pengembangan Anda, konfigurasi berikut di dalam file: capacitor.config.json file:

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

Jika update gagal, berikut adalah langkah yang dapat Anda lakukan:

• Set autoUpdate ke false selama pengembangan.
• Uninstall aplikasi.
• Reinstall aplikasi dengan versi yang telah diperbaiki.
• Aktifkan kembali pembaruan otomatis setelah segalanya stabil.

Untuk pembaruan versi utama, gunakan flag dan dengarkan event untuk menghandle pembaruan dengan benar: disableAutoUpdateBreaking Dengan menggabungkan konfigurasi-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

• untuk berperan sebagai sumber kebenaran. For major version updates, use the __CAPGO_KEEP_0__ and listen for the __CAPGO_KEEP_1__ event to handle updates properly: By combining these configurations with good team practices, you can maintain version consistency and reduce errors.
• Gunakan saluran Capgo yang terpisah untuk lingkungan pengembangan dan produksi.
• Automatisasi unggah versi melalui alur CI/CD.
• Dokumentasikan semua code perubahan dengan pesan komit yang jelas dan terperinci.

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

Langkah-Langkah Pemulihan Update

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

1. Kembali ke bundle stabil sebelumnya.
2. Tingkatkan 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 seperti yang diharapkan.

Capgo’s pembarui adalah dirancang untuk mengatasi gangguan. Misalnya, jika server tidak dapat dijangkau atau pembaruan dihapus, aplikasi tetap berfungsi normal [3]Selain itu, permintaan jaringan yang gagal secara otomatis akan diulang selama aplikasi startup berikutnya [3]Kemampuan ini untuk bertahan diri meminimalkan waktu down dan memastikan operasi yang lebih halus

Ringkasan

Versi Semantik, digabungkan 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]Konfigurasi ini memungkinkan pengembang untuk memasang pembaruan dengan cepat dan terkendali, menghindari keterlambatan aplikasi toko

Berikut ini adalah apa yang dikatakan oleh pengembang:

“Kami mengeluarkan Capgo pembaruan OTA di produksi untuk basis pengguna kami yang lebih dari 5000. Kami melihat operasi yang sangat halus hampir semua pengguna kami sudah update dalam menit-menit setelah pembaruan OTA dijalankan di @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 platform Capgo.

Capgo’s solusi yang terenkripsi, diintegrasikan dengan alat CI/CD, juga ramah anggaran - menghemat biaya hingga $26,100 dalam lima tahun [1]. Saluran yang dapat disesuaikan memastikan update 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]