Rollback

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

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

Pelindung Kembali 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__ termasuk mekanisme keamanan bawaan untuk melindungi pengguna dari update 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 di-load. Metode ini menandakan bahwa:

• The JavaScript bundle loaded without critical errors
• Fungsi inti aplikasi Anda berfungsi
• Update tersebut aman untuk dipertahankan

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

1. Detect bahwa update gagal untuk diinisialisasi dengan benar
2. Otomatis kembali ke bundle sebelumnya yang masih berfungsi
3. Mark update tersebut sebagai gagal untuk mencegahnya dari aplikasi lagi

Tips

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

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 secara 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 milisecond. 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 yang 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. The

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

5. Temukan build yang ingin Anda kembalikan ke dalam sejarah build.

6. Pilih build tersebut untuk menjadikannya build aktif untuk saluran.

7. Konfirmasi bahwa Anda ingin kembali ke build ini.

Methode Alternatif: Menggunakan Ikon Mahkota

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

1. Di tab pertama tampilan saluran, cari build yang ingin Anda kembalikan.
2. Klik ikon mahkota di samping build tersebut untuk menjadikannya build aktif untuk saluran.
3. Konfirmasi bahwa Anda ingin kembali ke build 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 biasa berlaku.

Mempercepat Rollback Kritis dengan Pemberitahuan

Mengarahkan ulang saluran biasanya akan efektif pada saat perangkat memeriksa update berikutnya. Capgo Pemberitahuan dapat mengirimkan pemberitahuan pemeriksaan 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 yang dipaksa keluar, sehingga tidak dapat menjanjikan waktu yang pasti untuk mencapai setiap perangkat.

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

Menghilangkan Hubungan Saluran

Jika Anda ingin menghentikan update sementara pada saluran sambil menyelidiki masalah, Anda dapat menghilangkan hubungan 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 dilepaskan, saluran tidak akan mendistribusikan update baru. Perangkat yang dikonfigurasi untuk saluran tersebut akan tetap pada build saat ini hingga saluran terkait dengan 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 memasarkan update lebih lanjut.

Menggunakan Paket Bawaan yang Dibuat 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 dibuat secara paksa”.

Untuk memaksa paket bawaan yang dibuat secara paksa 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 periksa update berikutnya. Hal ini terjadi tanpa peduli dengan build apa yang mereka jalankan saat ini.

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

Pertimbangan

Hatihati 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 paket stabil untuk seluruh saluran.

• Memantau laporan kegagalan dan umpan balik pengguna segera setelah mengeluarkan 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 paket bawaan, dan siapa yang berwenang untuk melakukannya.
• Komunikasi dengan pengguna tentang masalah dan solusi, jika perlu.

Dengan menggabungkan 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, hubungkannya dengan Pengendalian Target Versi untuk detail implementasi di Target Versi, Pengaturan Perbarui untuk detail implementasi di Pengaturan Perbarui, bundle untuk detail implementasi di bundle, Capgo Live Updates untuk alur kerja produk di Capgo Live Updates, dan Strategi Rollback untuk Capacitor Live Updates untuk konteks praktis di Strategi Rollback untuk Capacitor Live Updates.