Rollback

Sementara Capgo’s pembaruan hidup memungkinkan Anda untuk segera menyampaikan perbaikan dan perbaikan kepada pengguna, ada situasi di mana Anda mungkin perlu kembali ke versi sebelumnya dari aplikasi Anda. Mungkin pembaruan baru memperkenalkan masalah kritis yang tidak terduga, atau mungkin Anda ingin kembali perubahan tertentu sambil Anda bekerja pada solusi.

Capgo menyediakan beberapa cara untuk mengelola bangunan saluran dan mengontrol versi aplikasi Anda yang diterima pengguna, termasuk baik opsi kembali manual dan mekanisme keamanan otomatis.

Pelindung Pembaruan Otomatis

Capgo includes a built-in safety mechanism to protect your users from broken updates. If a JavaScript error occurs before the notifyAppReady() __CAPGO_KEEP_0__ mencakup mekanisme keamanan bawaan untuk melindungi pengguna dari pembaruan yang rusak. Jika terjadi kesalahan JavaScript sebelum metode dipanggil, plugin akan secara otomatis kembali ke versi sebelumnya yang berfungsi.

How Automatic Rollback Bekerja

When a new update is downloaded and applied, Capgo expects your app to call notifyAppReady() dalam jangka waktu yang dapat disesuaikan untuk memastikan bahwa update berhasil diunduh. Metode ini menandakan bahwa:

• Bundle JavaScript dimuat tanpa kesalahan kritis
• Fungsi inti aplikasi Anda berfungsi
• Update aman untuk dipertahankan

Jika notifyAppReady() is not called due to a JavaScript crash or critical error, Capgo will:

1. Deteksi bahwa update gagal untuk diinisialisasi dengan benar
2. Otomatis kembali ke bundle sebelumnya yang berfungsi
3. Mark update yang bermasalah sebagai gagal untuk mencegahnya dari diterapkan lagi

Tips

Pastikan untuk memanggil notifyAppReady() di inisialisasi aplikasi Anda code setelah komponen inti Anda telah dimuat dengan sukses. Hal ini memastikan perlindungan rollback otomatis berfungsi dengan benar.

import { CapacitorUpdater } from '@capgo/capacitor-updater'

// Call this after your app has successfully initialized
await CapacitorUpdater.notifyAppReady()

Perlindungan otomatis ini membantu memastikan bahwa bahkan jika Anda tidak sengaja mengirimkan pembaruan yang rusak, pengguna Anda tidak akan terjebak dengan aplikasi yang tidak berfungsi.

Konfigurasi Waktu Tunggu

Anda dapat mengonfigurasi berapa lama Capgo menunggu notifyAppReady() untuk dipanggil dengan mengatur appReadyTimeout di konfigurasi Capacitor Anda:

{
  "plugins": {
    "CapacitorUpdater": {
      "appReadyTimeout": 10000
    }
  }
}

Jumlah waktu yang ditentukan dalam milidetik. Waktu tunggu default biasanya 10 detik, tetapi Anda dapat menyesuaikan ini berdasarkan kebutuhan inisialisasi aplikasi Anda. Jika aplikasi Anda membutuhkan waktu lebih lama untuk dimuat karena proses inisialisasi yang kompleks, Anda mungkin ingin meningkatkan nilai ini. appReadyTimeout Kembali ke Paket Sebelumnya

Bab berjudul “Kembali ke Paket Sebelumnya”

Every time you upload a new build and assign it to a channel, Capgo keeps a history of those builds. If you need to revert a specific update, you can select one of these previous builds to redeploy to the channel.

The primary way to roll back is through the rollback interface, which is located in the 4th tab (History) when viewing a channel in the Capgo Dashboard. This tab provides a comprehensive view of all available builds for the channel, allowing you to easily select and revert to any previous version.

Masuk ke

1. Dashboard Capgo Capgo Dashboard.

2. Klik nama saluran yang ingin Anda kembalikan.

3. Kembali ke Saluran Sebelumnya

4. Pergi ke tab ke-4 (Riwayat) di tampilan saluran.

5. Cari bangunan yang ingin Anda kembali ke dalam riwayat bangunan.

6. Pilih bangunan tersebut untuk membuatnya bangunan aktif untuk saluran.

7. Konfirmasi bahwa Anda ingin kembali ke bangunan ini.

Methode Alternatif: Menggunakan Ikon Mahkota

Sebagai cara kedua, Anda juga dapat kembali secara langsung dari tab pertama dengan mengklik ikon mahkota di samping bangunan mana pun di riwayat bangunan saluran:

1. Dalam tab pertama tampilan saluran, cari bangunan yang ingin Anda kembali ke.
2. Klik ikon mahkota di samping bangunan tersebut untuk membuatnya bangunan aktif untuk saluran.
3. Konfirmasi bahwa Anda ingin kembali ke bangunan ini.

Catatan

Rollback ke versi sebelumnya hanya akan mempengaruhi saluran yang dipilih. Jika Anda memiliki beberapa saluran (misalnya Produksi, Staging, dll.), Anda perlu mengulangi proses rollback untuk setiap saluran yang terpengaruh.

Setelah melakukan rollback, perangkat yang dikonfigurasikan untuk mendengarkan saluran yang diperbarui akan menerima versi sebelumnya ketika mereka memeriksa update berikutnya. Versi yang dirollback akan dianggap sebagai update baru, sehingga alur update dan kondisi yang biasa berlaku.

Percepatan Rollback Kritis dengan Pemberitahuan

Mengarahkan ulang saluran biasanya akan efektif pada saat perangkat memeriksa update berikutnya. Capgo Pemberitahuan dapat mengirimkan pemberitahuan periksa update diam ke aplikasi yang didukung sambil berada di latar belakang. Dengan integrasi pembaruan diaktifkan, aplikasi dapat memeriksa, mengunduh, dan menginstal rollback sesuai dengan mode pembaruan yang dikonfigurasikan.

Ini adalah jalur percepatan, bukan perintah armada paksa. Pengiriman tetap berdasarkan usaha terbaik dan tergantung pada jadwal pengaturan latar belakang sistem operasi, ketersediaan jaringan, dan keadaan perangkat. Tidak dapat memperbarui aplikasi offline atau aplikasi yang dipaksa keluar, sehingga tidak dapat menjanjikan waktu yang pasti untuk mencapai setiap perangkat.

Untuk mengatur jalur ini, ikuti Pemberitahuan: Aktifkan Periksa Update Diam.

Menghubungkan Kembali Saluran

Jika Anda ingin menghentikan sementara update pada saluran sambil menyelidiki masalah, Anda dapat melepas koneksi saluran dari versi sekarang.

To melepaskan sebuah saluran:

1. Navigasikan ke saluran di Capgo Dashboard.

2. Klik tombol “Melepaskan” di samping build saat ini.

3. Konfirmasi bahwa Anda ingin melepaskan saluran.

Setelah saluran melepaskan, saluran tidak akan mendistribusikan update baru. Perangkat yang dikonfigurasi ke saluran tersebut akan tetap pada build saat ini sampai saluran terhubung ke build lagi.

Ini berguna jika Anda telah mengidentifikasi masalah dengan update tetapi belum yakin build mana yang ingin Anda kembali ke. Melepaskan saluran memberikan waktu untuk menyelidiki tanpa memasukkan update lebih lanjut.

Menggunakan Paket Bawaan yang Dibangun secara Paksa

Dalam situasi yang lebih parah, Anda mungkin ingin mengembalikan semua perangkat pada saluran ke build web yang awalnya dikemas dengan binary native aplikasi Anda. Ini dikenal sebagai “paket bawaan yang dibangun”.

Untuk memaksa paket bawaan pada saluran:

1. Navigasikan ke saluran di Capgo Dashboard.

2. Klik tombol “Paket Bawaan”.

3. Konfirmasi bahwa Anda ingin memaksa bundle bawaan.

Ketika Anda memaksa bundle bawaan, semua perangkat yang terkonfigurasi ke saluran tersebut akan kembali ke build web yang dikemas asli pada update cek berikutnya. Hal ini terjadi tanpa memandang build mana yang mereka jalankan saat ini.

Option ini lebih agresif daripada mengembalikan ke build sebelumnya tertentu, karena membuang semua update live yang diterbitkan sejak aplikasi terakhir diterbitkan ke toko aplikasi.

Pertimbangan

Hati-hati ketika memaksa bundle bawaan, karena akan mempengaruhi semua perangkat di saluran. Pastikan Anda telah mempertimbangkan dampak dan memiliki rencana untuk maju sebelum mengambil tindakan ini.

Pengawasan dan Mengatasi Masalah

Untuk menangkap masalah dengan cepat dan meminimalkan dampak update yang bermasalah, penting untuk memiliki rencana untuk mengawasi rilis dan mengatasi masalah.

Beberapa strategi termasuk:

Untuk peluncuran yang masih terbatas pada kelompok, gunakan Rollout yang Berkelanjutan untuk menghentikan paparan atau membersihkan target sebelum mengubah bundle stabil untuk seluruh saluran.

• Memantau laporan kegagalan dan umpan balik pengguna segera setelah merilis pembaruan.
• Menggunakan peluncuran fase atau sistem saluran yang dipersiapkan untuk menguji pembaruan pada kelompok yang lebih kecil sebelum peluncuran luas.
• Mempunyai proses keputusan yang jelas untuk ketika harus mengembalikan, melepaskan, atau memaksa bundle bawaan, dan siapa yang memiliki otoritas untuk melakukannya.
• Komunikasi dengan pengguna tentang masalah dan solusi, jika perlu.

Dengan kombinasi pemantauan yang hati-hati dengan kemampuan untuk segera mengelola pembaruan yang bermasalah, Anda dapat menyampaikan pengalaman aplikasi yang terus-menerus meningkat sambil mengurangi gangguan bagi pengguna Anda.

Teruskan dari Rollbacks

Jika Anda menggunakan Rollbacks untuk merencanakan pengembalian dan pengendalian versi, hubungkan dengan Target Versi untuk detail implementasi di Target Versi, Perilaku Pembaruan untuk detail implementasi di Perilaku Pembaruan, bundle untuk detail implementasi di bundle, Capgo Pembaruan Hidup for the product workflow in Capgo Live Updates, and untuk alur produk di Capacitor Pembaruan Hidup, dan Strategi Rollback untuk Capacitor Pembaruan Hidup