Mengembalikan

Capgo menyediakan beberapa cara untuk mengelola build kanal dan mengontrol versi aplikasi yang diterima oleh pengguna, termasuk baik pilihan rollback manual dan mekanisme keamanan otomatis.

Capgo provides several ways to manage a channel’s builds and control the version of your app that users receive, including both manual rollback options and automatic safety mechanisms.

Pengamanan Rollback Otomatis

Capgo memiliki mekanisme keamanan bawaan untuk melindungi pengguna Anda dari pembaruan yang rusak. Jika terjadi kesalahan JavaScript sebelum metode dipanggil, plugin akan secara otomatis kembali ke versi sebelumnya yang masih berfungsi. notifyAppReady() Bagaimana Pengamanan Rollback Otomatis Berfungsi

Judul Bagian “Bagaimana Pengamanan Rollback Otomatis Berfungsi”

When a new update is downloaded and applied, Capgo expects your app to call notifyAppReady() Paket JavaScript dimuat tanpa kesalahan kritis

• Fungsi inti aplikasi Anda masih berfungsi
• Pembaruan aman untuk dipertahankan
• Jika

Jika notifyAppReady() tidak disebut karena crash atau kesalahan JavaScript yang kritikal, Capgo akan:

1. Mendeteksi bahwa update gagal diinisialisasi dengan benar
2. Mengembalikan secara otomatis ke bundle yang berfungsi sebelumnya
3. Menggunakan label update yang gagal untuk mencegahnya diaplikasikan lagi

Tip

Pastikan untuk memanggil notifyAppReady() code setelah komponen inti Anda telah dimuat dengan sukses dalam inisialisasi aplikasi Anda. Ini memastikan proteksi rollback otomatis berfungsi dengan benar.

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

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

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

Mengatur Waktu Tunggu

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

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

The appReadyTimeout nilai ditentukan dalam milisecond. Waktu tunggu default biasanya adalah 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.

Mengembalikan ke Versi Sebelumnya

Setiap kali Anda mengunggah build baru dan mengasosiasikannya dengan saluran, Capgo menyimpan riwayat build tersebut. Jika Anda membutuhkan untuk mengembalikan update tertentu, Anda dapat memilih salah satu build sebelumnya untuk di-redeploy ke saluran.

Cara utama untuk mengembalikan adalah melalui antarmuka pengembalian, yang terletak di tab ke-4 (Riwayat) ketika melihat saluran di Dashboard Capgo. Tab ini menyediakan tampilan komprehensif dari semua build yang tersedia untuk saluran, memungkinkan Anda untuk dengan mudah memilih dan mengembalikan ke versi sebelumnya.

Untuk mengembalikan menggunakan tab Riwayat:

1. Masuk ke halaman Capgo Dashboard.

2. Navigasikan ke bagian “Saluran”.

3. Klik nama saluran yang ingin Anda kembali.

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

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

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

7. Konfirmasi bahwa Anda ingin kembali ke build ini.

Metode Alternatif: Menggunakan Ikon Mahkota

Dengan cara lain, Anda juga dapat kembali langsung dari tab pertama dengan mengklik ikon mahkota di samping build mana pun di riwayat build saluran:

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

Catatan

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

Setelah mengembalikan, perangkat yang dikonfigurasi untuk mendengarkan saluran yang diperbarui akan menerima build sebelumnya ketika mereka memeriksa update berikutnya. Build yang dikembalikan akan dianggap sebagai update baru, sehingga alur update dan kondisi yang biasa berlaku.

Menghilangkan Hubungan Saluran

Jika Anda ingin sementara menghentikan update pada saluran saat Anda menyelidiki masalah, Anda dapat menghilangkan hubungan saluran dari build saat ini.

Untuk menghilangkan hubungan saluran:

1. Navigasikan ke saluran di Capgo Dashboard.

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

3. Pastikan Anda ingin melepaskan 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.

Hal ini berguna jika Anda telah mengidentifikasi masalah dengan update tetapi belum yakin ingin kembali ke build mana.

Menghubungkan saluran ke build lain akan memberikan waktu untuk menyelidiki tanpa memperluas update lainnya.

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

Untuk memaksa paket built-in di saluran:

1. Navigasikan ke saluran di Capgo Dashboard.

2. Klik tombol “Paket Built-in”.

3. Pastikan Anda ingin memaksa paket built-in.

Ketika Anda memaksa paket built-in, semua perangkat yang dikonfigurasi untuk saluran tersebut akan kembali ke build web asli yang dikemas pada update berikutnya. Hal ini terjadi tanpa peduli build apa yang mereka gunakan saat ini.

This is a more aggressive rollback option than reverting to a specific previous build, as it discards all live updates released since the app was last published to the app stores.

Peringatan

Hati-hati ketika memaksa bundle bawaan, karena itu 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 dari pembaruan yang bermasalah, penting untuk memiliki rencana untuk mengawasi rilis dan mengatasi masalah.

Beberapa strategi termasuk:

• Mengawasi laporan kegagalan aplikasi dan umpan balik pengguna segera setelah merilis pembaruan
• Menggunakan peluncuran fase atau sistem saluran yang dipisahkan untuk menguji pembaruan pada kelompok yang lebih kecil sebelum peluncuran luas
• Memiliki proses keputusan yang jelas untuk ketika harus mengembalikan, melepaskan, atau memaksa bundle bawaan, dan siapa yang memiliki otoritas untuk melakukannya
• Mengkomunikasikan kepada pengguna tentang masalah dan solusi, jika perlu

Dengan menggabungkan pemantauan yang hati-hati dengan kemampuan untuk segera mengelola update yang problematic, Anda dapat menyampaikan pengalaman aplikasi yang terus-menerus membaik sambil mengurangi gangguan bagi pengguna.