Berikut Cara Menggunakan Pengaturan Versi Semantik dengan Pembaruan Capgo OTA

Inginkan memudahkan update aplikasi dan pengendalian versi? Versi Semantik (SemVer) digabungkan dengan Capgofitur pembaruan Over-The-Air (OTA) dari Capacitor membuat pengelolaan

• __CAPGO_KEEP_0__ lebih mudah dan cepat. Berikut cara kerjanya: MAJOR.MINOR.PATCH:

  • Asas Versi Semantik: Penggunaan Perubahan Versi Semantik dengan __CAPGO_KEEP_0__ Capgo OTA Updates.
  • MINOR: Pengembangan Fitur Baru yang Kompatibel dengan Versi Sebelumnya.
  • PATCH: Pengembangan Perbaikan Bug.

• Mengapa Menggunakan SemVer dengan Capgo?

  • Komunikasi yang Jelas tentang Perbarui.
  • Pengelolaan Versi yang Lebih Cerdik.
  • Menghindari Konflik Ketergantungan.
  • Perencanaan Rilis yang Terorganisir.

• Capgo Setup Langkah-Langkah:

  1. Install 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.

• Pengelolaan Versi dan Saluran::

  • Pilih 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 yang gagal.

• Proses Pengiriman:

  • Perbarui nomor versi sesuai dengan aturan SemVer.
  • Test secara menyeluruh sebelum mengembangkan.
  • Pakai perintah CLI untuk mengunggah dan mendistribusikan perbarui.

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

Tips Cepat: Selalu test perbarui dan gunakan saluran untuk mengelola peluncuran yang dipersiapkan secara efektif.

Pengaturan Versi Sematis | Tingkatkan Kemampuan

Capgo Petunjuk Pengaturan

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

Langkah Awal Pengaturan

Mulai dengan menginstal plugin pembaruan __CAPGO_KEEP_0__ Capgo updater plugin:

npm install @capgo/capacitor-updater  
npx cap sync

Untuk proyek yang lebih tua, update detail versi di lokasi-lokasi berikut: capacitor.config.json (cari bidang)

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

(update)

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

Once configured, initialize Capgo with your API key:

npx @capgo/cli@latest init YOUR_API_KEY

Pastikan file Anda menggunakan format versi semantik: (untuk __CAPGO_KEEP_0__) dan (untuk __CAPGO_KEEP_1__). Untuk proyek yang lebih tua, update detail versi di lokasi-lokasi berikut: (cari bidang) (update) (update) Setelah dikonfigurasi, inisialisasi __CAPGO_KEEP_0__ dengan kunci __CAPGO_KEEP_1__ Anda: Tabel Referensi Cepat:

Pengintegrasian Kontrol Versi

Membangun Capgo berfungsi dengan baik dengan platform CI/CD, sehingga Pembaruan Otomatis Sederhana. Platform yang didukung termasuk:

• Aksi GitHub
• 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 pengiriman 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 cara kerjanya:

• Versi Utama (X.0.0): Tambahkan angka MAJOR untuk perubahan yang mengganggu konsistensi.
• Versi Minor (1.X.0): Tingkatkan nomor MINOR untuk fitur-fitur baru yang tetap kompatibel.
• Versi Patch (1.0.X): Tingkatkan 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 kerja sama 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.
  • 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: Mengontrol bagaimana pembaruan diterapkan menggunakan opsi pengaturan Capgo.

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

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

• Strategi Rollback Versi: Gunakan identifikasi pra-rilis 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 pembaruan, menguji fitur baru, dan menjaga stabilitas dalam proses pengiriman aplikasi.

sbb-itb-f9944d2

Pengiriman Pembaruan OTA

: Setelah pengaturan manajemen versi Anda siap, ikuti langkah-langkah berikut untuk mengirimkan pembaruan OTA dengan efektif.

Persiapan Pembaruan

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

• Pembaruan Bug: Tambahkan nomor PATCH (misalnya 1.0.1 → 1.0.2)
• Pembaruan Fitur Baru: Tambahkan nomor MINOR (misalnya 1.0.0 → 1.1.0)
• Pembaruan Perubahan Besar: Tambahkan 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 . Anda dapat memilih dari:Pembaruan Strategi

• Auto-Update: Otomatis terapkan persyaratan versi minimum.
• Manual Control: Tentukan persyaratan versi pasti untuk pembaruan.
• Channel-Based: Gunakan saluran untuk tes dan peluncuran rolut.

Capgo CLI Perintah Pembaruan

Pakai Capgo’s CLI untuk mengunduh pembaruan Anda dengan mudah. Berikut cara-cara:

# 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-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) 🙂”

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

• Aplikasi memeriksa pembaruan.
• Unduh pembaruan di latar belakang.
• Mengaktifkan versi baru 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!”

Pembelajaran dan Tips

Masalah Pengelolaan Versi

Pengelolaan versi semantik di Capgo dapat membuat proses pembaruan menjadi rumit. Untuk menghindari menghapus 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 
    } 
  } 
}

Set

• ke autoUpdate context false selama pengembangan.
• Uninstalllah aplikasi.
• Reinstal aplikasinya dengan versi yang diperbaiki.
• Reaktifkan pembaruan otomatis setelah segalanya stabil.

Untuk pembaruan versi utama, gunakan flag dan dengarkan event untuk menghandle pembaruan dengan benar: disableAutoUpdateBreaking Oleh karena itu, kombinasi konfigurasi ini dengan praktik tim yang baik dapat menjaga 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.

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

Berikut beberapa metode untuk memastikan konsistensi:

“Melakukan tes setiap perubahan sebelum menggabungkannya dengan repositori utama akan memperkuat stabilitas dan menghindari kesalahan yang mahal” [4]

Berikut beberapa metode untuk memastikan konsistensi:

• Definisi satu cabang sebagai repository utama untuk berperan sebagai sumber kebenaran. Menggunakan saluran __CAPGO_KEEP_0__ yang terpisah untuk lingkungan pengembangan dan produksi.
• Use separate Capgo channels for development and production environments.
• Meng dokumentasikan semua __CAPGO_KEEP_0__ perubahan dengan pesan komit yang jelas dan rinci.
• Document all code changes with clear and detailed commit messages.

Lingkungan

Langkah Pemulihan Perbarui

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

1. Kembali ke bundle stabil sebelumnya.
2. Tambahkan nomor versi yang lebih tinggi untuk patch baru (perlu diingat: nomor versi tidak dapat digunakan kembali setelah dihapus). [2].
3. Periksa pembaruan selama aplikasi startup untuk memastikan bahwa 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 diretry selama aplikasi diluncurkan berikutnya. [3]Ini membuat aplikasi lebih stabil dan mengurangi waktu down.

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

Berikut ini adalah apa yang dikatakan oleh pengembang:

“Kami mengeluarkan Capgo pembaruan OTA di produksi untuk basis pengguna kami sebesar +5000. Kami melihat operasi yang sangat lancar hampir semua pengguna kami sudah update dalam menit-menit setelah OTA di-deploy ke @Capgo.” - colenso [1]

Sistem versi MAJOR.MINOR.PATCH membuatnya mudah untuk berkomunikasi 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, diintegrasi 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 berlatih pengembangan agile dan @Capgo sangat kritis dalam menyampaikan secara terus-menerus kepada pengguna kami!” - Rodrigo Mantica [1]

Teruskan dari Cara Menggunakan Versi Semantik dengan Capgo Pembaruan OTA

Jika Anda menggunakan How to Use Semantic Versioning dengan Capgo Pembaruan OTA untuk merencanakan rollback dan pengendalian versi, hubungkannya dengan Rollbacks untuk detail implementasi di Rollbacks, Targeting Versi context: Halaman/area: Halaman pemasaran solusi Capgo. Peran: Judul bagian atau halaman. Dilihat di: halaman solusi/target-versi.astro. Kunci pesan `solutions_version_targeting_title` (Judul Target Versi Solusi). | Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/target-versi.astro. Kunci pesan `solutions_version_targeting` (Target Versi Solusi). untuk detail implementasi di Targeting Versi, Behavior Pembaruan untuk detail implementasi di Behavior Pembaruan, bundle Capgo Live Updates Capgo Pembaruan Langsung