Cara Menggunakan Semantic Versioning dengan Capgo Perbaruan OTA

Ingin memudahkan perbaruan aplikasi dan pengendalian versi? Versi Semantik (SemVer) dibandingkan dengan Capgo’s Perbaruan Over-The-Air (OTA) membuat pengelolaan Capacitor aplikasi lebih mudah dan lebih cepat. Berikut adalah cara-cara:

• Dasar-Dasar Versi Semantik: 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.

• Setup Capgo Langkah-Langkah:

  1. Pasang plugin pembaruan Capgo.
  2. Konfigurasi versi aplikasi Anda di capacitor.config.json dan file lainnya.
  3. Inisialisasi 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 (pembaruan otomatis untuk patch, persetujuan manual untuk perubahan besar).
  • Opsi pengembalian untuk pembaruan gagal.

• Proses Pengembangan:

  • Perbarui nomor versi mengikuti aturan SemVer.
  • Uji coba secara menyeluruh sebelum mengembangkan.
  • Pakai 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 mengotomasi pembaruan.

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

Pengaturan Versi Semantis | Tingkatkan Kemampuan

Capgo Petunjuk Pemasangan

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

Langkah-Langkah Awal

Mulai dengan menginstal plugin perbarui __CAPGO_KEEP_0__ Capgo updater plugin:

npm install @capgo/capacitor-updater  
npx cap sync

Untuk proyek yang lebih tua, perbarui detail versi di lokasi-lokasi ini: capacitor.config.json (cari bidang

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

(perbarui

• package.json (perbarui version __CAPGO_KEEP_0__ Live Update Dashboard Interface
• android/app/build.gradle Berikut cara mengatur __CAPGO_KEEP_0__ untuk mengelola perbarui OTA dan pengendalian versi dengan mudah. versionName)
• ios/App/App.xcodeproj/project.pbxproj Langkah-Langkah Awal Pengaturan Awal Mulai dengan menginstal plugin perbarui __CAPGO_KEEP_0__ Pastikan file Anda menggunakan format versi semantik: Untuk proyek yang lebih tua, perbarui detail versi di lokasi-lokasi ini: (cari bidang ) (perbarui ) (perbarui CURRENT_PROJECT_VERSION)

Setelah dikonfigurasi, inisialisasi Capgo dengan kunci API Anda:

npx @capgo/cli@latest init YOUR_API_KEY

Tabel Referensi Cepat:

Integrasi Pengendalian Versi

Capgo bekerja dengan baik dengan platform CI/CD, membuat perbaruan otomatis sederhana. Platform yang didukung termasuk:

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

Jika Anda bekerja pada pengembangan lokal, Anda dapat menonaktifkan pembaruan 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, 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 pengiriman OTA yang lancar dan pengelolaan versi.

Menggunakan Semantik Versi dengan Capgo

Pengelolaan Nomor Versi

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

• Versi Mayor (X.0.0): Perlu meningkatkan nomor MAJOR untuk perubahan yang memecahkan konsistensi.
• Versi Minor (1.X.0): Perlu meningkatkan nomor MINOR untuk fitur-fitur baru yang tetap konsisten.
• Versi Patch (1.0.X): Perlu meningkatkan 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 Pengelolaan 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-fitur baru.
  • Tahan saluran “produksi” (misalnya, 1.2.0) untuk rilis stabil.
  • Menambahkan saluran khusus platform (misalnya “ios-hotfix” dengan versi 1.2.1) ketika menangani masalah khusus platform.

• Update Konfigurasi Kebijakan: Mengontrol bagaimana update diterapkan menggunakan opsi konfigurasi Capgo.

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

  Contoh:

• Konfigurasi ini memastikan bahwa pengguna secara otomatis menerima update patch, sementara update minor dan major memerlukan persetujuan manual.Strategi Rollback Versi

: Menggunakan identifikasi pre-release untuk menjaga opsi rollback yang jelas. Pendekatan ini memungkinkan Anda untuk kembali ke versi sebelumnya jika terjadi masalah, 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 konfigurasi manajemen versi Anda siap, ikuti langkah-langkah berikut untuk mengirimkan update OTA dengan efektif.

Persiapan Update 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)
• Perubahan Besar: Tingkatkan nomor MAJOR (misalnya 1.0.0 → 2.0.0)

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

Selanjutnya, putuskan pada Strategi Perbarui. Anda dapat memilih dari:

• Auto-Update: Otomatis memenuhi persyaratan versi minimum.
• Manual Control: Spesifikkan persyaratan versi pasti untuk perbarui.
• Channel-Based: Gunakan saluran untuk tes dan peluncuran yang terencana.

Capgo CLI Perintah Perbarui

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 [channelId] [appId]

Capgo memastikan pengunduhan yang aman dengan enkripsi akhir-ke-awal dan pengelolaan kunci yang aman.

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

Setelah di-deploy, Anda dapat memantau update melalui dashboard Capgo.

• Update biasanya mencapai pengguna dalam beberapa menit setelah mereka membuka aplikasi.
• Prosesnya berjalan seperti ini:
• Aplikasi memeriksa update.
• Mengunduh update di latar belakang.

Mengaktifkan versi baru ketika pengguna keluar dari aplikasi.

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

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

Version Management Issues

Kami berlatih pengembangan agile dan @Capgo sangat kritis dalam menyampaikan secara terus-menerus kepada pengguna! capacitor.config.json Masalah Penyelesaian dan Tips

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

Pengelolaan Versi Masalahnya

• Set autoUpdate ke false selama proses pengembangan.
• Uninstall aplikasi.
• Reinstall dengan versi yang telah diperbaiki.
• Nonaktifkan ulang fitur auto-update setelah semua stabil.

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

Once individual updates are managed, it’s crucial for teams to establish strong version control practices.

By combining these configurations with good team practices, you can maintain version consistency and reduce errors.

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

Berikut beberapa metode untuk memastikan konsistensi:

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

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

Pembaruan Langkah-Langkah Pemulihan

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

1. Kembali ke bundle stabil sebelumnya.
2. Tambahkan nomor versi baru untuk setiap perbaikan (perlu diingat: nomor versi tidak dapat digunakan kembali setelah penghapusan) [2].
3. Periksa pembaruan selama aplikasi startup untuk memastikan mereka berfungsi seperti yang diharapkan.

Updater Capgo 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 diulang selama aplikasi diluncurkan kembali. [3]Kemampuan ini meminimalkan waktu down dan memastikan operasi yang lebih lancar.

Ringkasan

Penggunaan Versi Semantik, dikombinasikan dengan Capgo, telah membuat pembaruan OTA untuk aplikasi Capacitor lebih efisien. Dengan 947,6 juta pembaruan yang terkirim dan 1.400 aplikasi produksi yang menggunakan sistem ini, proses pengembangan telah menjadi 81% lebih efisien [1]Penggunaan Versi Semantik, dikombinasikan dengan __CAPGO_KEEP_0__, telah membuat pembaruan OTA untuk aplikasi __CAPGO_KEEP_1__ lebih efisien. Dengan 947,6 juta pembaruan yang terkirim dan 1.400 aplikasi produksi yang menggunakan sistem ini, proses pengembangan telah menjadi 81% lebih efisien [1]. Ini setup memungkinkan pengembang untuk memperbarui aplikasi dengan cepat dan dalam cara yang terkendali, menghindari keterlambatan aplikasi toko.

Berikut ini apa yang dikatakan oleh pengembang:

“Kami mengeluarkan pembaruan OTA untuk pengguna kami yang berjumlah lebih dari 5000. Kami melihat operasi yang sangat lancar, hampir semua pengguna kami sudah terupdate dalam beberapa menit setelah pembaruan OTA dijalankan di @__CAPGO_KEEP_0__.” - colenso Capgo OTA updates Hal ini sangat membantu bagi tim yang mengelola beberapa rilis setiap minggu melalui platform Capgo. [1]

Sistem __CAPGO_KEEP_0__ yang [5]. This is especially helpful for teams managing several releases each week through Capgo’s platform.

Capgo’s Saluran yang dapat disesuaikan memastikan pembaruan mencapai pengguna yang tepat pada waktu yang tepat.“Kami menerapkan pengembangan agile dan @__CAPGO_KEEP_0__ sangat kritis dalam menyampaikan pembaruan secara terus-menerus kepada pengguna kami!” - Rodrigo Mantica [1]__CAPGO_KEEP_0__

Capgo [1]

Teruskan dari Cara Menggunakan Versi Semantik dengan Capgo Perbarui OTA

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