Rollback

Sementara Capgo’s live updates memungkinkan Anda untuk segera menyampaikan perbaikan dan perbaikan kepada 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 oleh pengguna, termasuk baik pilihan kembali manual 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__ mencakup mekanisme keamanan bawaan untuk melindungi pengguna Anda dari update yang rusak. Jika terjadi kesalahan JavaScript sebelum metode dipanggil, plugin akan secara otomatis kembali ke versi sebelumnya yang berfungsi.

Bagaimana Pelindung Kembali Otomatis Berfungsi

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 dimuat. Metode ini menandakan bahwa:

• Paket JavaScript dimuat tanpa adanya 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. Mendeteksi bahwa update gagal untuk diinisialisasi dengan benar
2. Mengembalikan secara otomatis ke bundle sebelumnya yang berfungsi
3. Menggunakan label update yang bermasalah untuk mencegahnya dari diterapkan 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()

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

Bagian appReadyTimeout Nilai waktu tunggu 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.

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.

Untuk mengembalikan menggunakan tab Riwayat:

1. Masuk ke Capgo Dashboard.

2. Navigasikan ke bagian “Saluran”.

3. Klik nama saluran yang ingin Anda kembalikan.

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

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

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

7. Konfirmasi bahwa Anda ingin kembali ke bangun ini.

Methode Alternatif: Menggunakan Ikon Mahkota

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

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

Catatan

Rolling back 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.

Menggunakan rollback, perangkat yang dikonfigurasi 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.

Mempercepat 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 dikonfigurasi.

Ini adalah jalur percepatan, bukan perintah armada paksa. Pengiriman tetap berdasarkan usaha terbaik dan tergantung pada jadwal pemrograman latar belakang sistem operasi, ketersediaan jaringan, dan status perangkat. Ini 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 Periksa Update Diam.

Melepaskan Saluran

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

Untuk melepaskan saluran:

1. Berlayar ke saluran di Capgo Dashboard.

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

3. Konfirmasi bahwa Anda ingin melepas saluran.

Setelah saluran dilepaskan, saluran tersebut tidak akan mendistribusikan update apa pun. Perangkat yang dikonfigurasi untuk saluran tersebut akan tetap pada build saat ini hingga saluran tersebut terhubung kembali ke build.

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 Dibuat secara Paksa

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

Untuk memaksa paket bawaan pada saluran:

1. Berlayar ke saluran di Capgo Dashboard.

2. Klik tombol “Paket Bawaan”.

3. Konfirmasi bahwa Anda ingin memaksa paket bawaan.

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

Pilihan rollback yang lebih agresif ini berbeda dengan kembali ke versi sebelumnya tertentu, karena membuang semua update live yang diterbitkan sejak aplikasi terakhir diterbitkan ke toko aplikasi.

Peringatan

Berhati-hatilah ketika memaksa bundle bawaan, karena akan mempengaruhi semua perangkat di saluran. Pastikan Anda telah mempertimbangkan dampaknya dan memiliki rencana untuk melanjutkan 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 Anda dan mengatasi masalah.

Beberapa strategi termasuk:

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

• Melacak 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, melepas, atau memaksa bundle yang terintegrasi, dan siapa yang memiliki otoritas untuk melakukannya
• Mengkomunikasikan kepada pengguna tentang masalah dan penyelesaian, 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 Targeting Versi context: Halaman/area: Halaman pemasaran solusi Capgo. Peran: Judul bagian atau halaman. Dilihat di: halaman solusi/targeting-versi.astro. Kunci pesan `solutions_version_targeting_title` (Judul Targeting Versi Solusi). | Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/targeting-versi.astro. Kunci pesan `solutions_version_targeting` (Targeting Versi Solusi). Perilaku Update untuk detail implementasi di Perilaku Update, bundle untuk detail implementasi di bundle, Capgo Live Updates for the product workflow in Capgo Live Updates, and Rollback Strategies for Capacitor Live Updates for the practical context in Rollback Strategies for Capacitor Live Updates.