Cara Menggunakan Versi Semantik dengan Capgo Perbarui OTA

Ingin memudahkan perbarui aplikasi dan pengontrolan versi? Versi Semantik (SemVer) dibandingkan dengan CapgoPembaruan Over-The-Air (OTA) dari membuat pengelolaan Capacitor aplikasi lebih mudah dan cepat. Berikut ini caranya:

• 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 pembaruan.
  • Pengelolaan versi yang lebih cerdas.
  • Menghindari konflik dependensi.
  • Perencanaan rilis yang terorganisir.

• Capgo Pengaturan 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. Gunakan Capgo CLI untuk mengemas dan mengunggah pembaruan.

• Manajemen Versi dan Saluran:

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

• Proses Pengembangan:

  • Perbarui nomor versi mengikuti aturan SemVer.
  • Tes secara menyeluruh sebelum mengembangkan.
  • Gunakan CLI perintah 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 Semantik | Tingkatkan Kemampuan

Capgo Panduan Pengaturan

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

Langkah-Langkah Pengaturan Awal

Mulai dengan menginstal Capgo plugin pembarui:

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" 
}

__CAPGO_KEEP_0__

• package.json Cari lapangan (look for the version lapangan (field)
• android/app/build.gradle Saat ini (update versionName)
• ios/App/App.xcodeproj/project.pbxproj Saat ini (update CURRENT_PROJECT_VERSION)

Setelah terkonfigurasi, 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 update otomatis Dukungan platform 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, peringatkan 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 Versi Semantik dengan Capgo

Pengelolaan Nomor Versi

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

• Versi Mayor (X.0.0): Tingkatkan nomor MAJOR untuk perubahan yang memecahkan 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.

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: Susunlah proses pengiriman Anda dengan membuat saluran yang terpisah 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 spesifik platform (misalnya, “ios-hotfix” dengan versi 1.2.1) ketika menangani masalah-masalah spesifik platform.

• Pengaturan Konfigurasi Perbarui: Kendalikan bagaimana perbarui diterapkan menggunakan opsi konfigurasi Capgo_. Misalnya:

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

  Pengaturan ini memastikan pengguna secara otomatis menerima perbarui patch, sementara perbarui 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, sementara menjaga konsistensi versi di semua saluran.

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

sbb-itb-f9944d2

Deploy Update Per OTA

Setelah pengaturan manajemen versi Anda sudah siap, ikuti langkah-langkah ini untuk mengdeploy 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):

• 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: Meningkatkan nomor MAJOR (misalnya 1.0.0 → 2.0.0)

Periksa secara menyeluruh bangunan Anda dan pastikan aplikasi berkomunikasi dengan server menggunakan notifyAppReady.

Selanjutnya, putuskan strategi perbaruan Anda. Anda dapat memilih dari:

• Auto-Update : Menggunakan secara otomatis persyaratan versi minimum.
• Manual Control : Mengatur persyaratan versi yang tepat untuk perbaruan.
• Channel-Based : Menggunakan saluran untuk pengujian dan peluncuran yang terencana.

Capgo CLI Perintah Perbarui

Menggunakan Capgo’s CLI untuk memperbarui 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 perbarui yang aman dengan enkripsi akhir-ke-awal dan pengelolaan kunci yang aman.

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

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

• Aplikasi memeriksa perbarui.
• Mengunduh perbarui di latar belakang.
• Mengidentifikasi versi baru sebagai aktif ketika pengguna keluar dari aplikasi.
• Mengaplikasikan perbarui pada peluncuran berikutnya.

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

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

Pengembangan dan Tips

Masalah Pengelolaan Versi

Menangani pengelolaan versi semantik di Capgo dapat terkadang memperumit proses pengaktifan pembaruan. Untuk menghindari menggantikan pekerjaan pengembangan Anda, konfigurasi berikut di dalam capacitor.config.json file:

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

Jika pembaruan gagal, berikut adalah langkah-langkah yang dapat Anda lakukan:

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

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

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

Dengan menggabungkan konfigurasi-konfigurasi ini dengan praktik tim yang baik, Anda dapat mempertahankan konsistensi versi dan mengurangi kesalahan.

Pengendalian Versi Tim

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 kestabilan dan menghindari kesalahan yang mahal” [4]

Berikut beberapa metode untuk memastikan konsistensi:

• Tentukan satu cabang sebagai repositori utama untuk berfungsi sebagai sumber kebenaran.
• 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 rinci.

Untuk tim yang lebih besar, tabel manajemen versi berikut dapat membantu mengatur pembaruan:

Langkah-Langkah Pemulihan Update

Meskipun 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. Verifikasi update selama aplikasi startup untuk memastikan mereka berfungsi seperti yang diharapkan.

Capgo’s updater 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 diulang selama peluncuran aplikasi berikutnya [3]. Ini meminimalkan waktu down dan memastikan operasi yang lebih lancar.

Ringkasan

Penggunaan Versi Semantik, yang 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]. Konfigurasi ini memungkinkan pengembang untuk membarui aplikasi dengan cepat dan dalam cara yang terkendali, menghindari keterlambatan aplikasi toko.

Berikut ini adalah apa yang dikatakan oleh pengembang:

“Kami mengeluarkan pembaruan OTA __CAPGO_KEEP_0__ di produksi untuk basis pengguna kami yang lebih dari 5000. Kami melihat operasi yang sangat lancar hampir semua pengguna kami sudah terupdate dalam menit-menit setelah pembaruan OTA di-deploy ke @Capgo.” - colenso 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]

. Hal ini sangat membantu bagi tim yang mengelola beberapa rilis setiap minggu melalui platform __CAPGO_KEEP_0__. [5]Capgo’s

Capgo’s solusi terenkripsi, diintegrasi dengan alat-alat CI/CD, juga lebih hemat biaya - menghemat biaya hingga $26.100 selama lima tahun [1]. Saluran yang dapat disesuaikan memastikan pembaruan 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]

Kami berlatih pengembangan berkelompok dan @Capgo sangat kritis dalam menyampaikan secara terus-menerus kepada pengguna kami!

Teruskan dari Cara Menggunakan Semantik Versi dengan __CAPGO_KEEP_0__ Pembaruan OTA How to Use Semantic Versioning with Capgo OTA Updates Cara Menggunakan Semantik Versi dengan __CAPGO_KEEP_0__ Pembaruan OTA untuk merencanakan rollback dan pengendalian versi, hubungkannya dengan Rollbacks untuk detail implementasi di Rollbacks, Version Targeting Perilaku Update untuk detail implementasi di Perilaku Update, bundle untuk detail implementasi di bundle, dan Capgo Live Updates untuk alur kerja produk di Capgo Live Updates.