Catatan Log
Copy sebuah prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.
Memahami Log Aplikasi
Judul Bagian “Memahami Log Aplikasi”Halaman Log menyediakan riwayat detail peristiwa pembaruan dan informasi diagnostik untuk aplikasi Anda. Ini sangat penting untuk memantau proses pembaruan, mengatasi masalah, dan memahami bagaimana perangkat Anda berinteraksi dengan Capgo. Anda dapat mengaksesnya dengan mengklik aplikasi Anda dan kemudian mengklik tab “Log” (sebelumnya bernama “pembaruan” dalam beberapa screenshot atau dokumentasi yang lebih tua).
Dari sana Anda seharusnya melihat halaman yang mirip dengan ini, menampilkan daftar entri log:
Antarmuka halaman log mencakup:
- Tab Log - Tab navigasi untuk mengakses tampilan log
- Tombol Reload - Muat ulang daftar log dengan data terbaru
- Rentang Waktu & Pemfilteran Aksi - Filter log berdasarkan rentang tanggal dan jenis aksi (lihat bagian di bawah)
Setiap baris menampilkan:
- Tanggal Waktu (UTC)
- ID Perangkat
- Aksi code (apa yang terjadi)
- Nama Versi (bundle atau
builtin)
Klik baris untuk melompat ke halaman detail perangkat untuk riwayat lengkap.
Penggunaan Berdasarkan Rentang Waktu
Judul bagian “Penggunaan Berdasarkan Rentang Waktu”Anda dapat memfilter log menggunakan periode waktu tertentu menggunakan pilih tanggal:
- Preset Cepat - Pilih rentang waktu umum: 1 jam, 3 jam, 6 jam, atau 12 jam
- Waktu Mulai - Atur waktu mulai untuk rentang
- Waktu Akhir - Atur waktu akhir untuk rentang
- Kalender - Pilih tanggal spesifik menggunakan tampilan kalender
Klik “Pilih” untuk menerapkan rentang tanggal yang dipilih, atau “Batal” untuk menutup picker.
Penggunaan Jenis Aksi
Judul bagian “Penggunaan Jenis Aksi”Menu Aksi memungkinkan Anda memfilter log berdasarkan jenis event tertentu:
Termasuk filter aksi yang tersedia:
- Detak jantung perangkat - Periksa kesehatan periodik dari perangkat
- Penghapusan Versi Diminta - Ketika versi bundel dihapus
- Reset ke versi default - Ketika perangkat kembali ke bundel bawaan
- Versi terinstal dengan sukses - Pemasangan bundel sukses
- Versi baru dikirim ke perangkat - Ketika Capgo mengirimkan pembaruan ke perangkat
- Pemasangan versi gagal - Ketika pemasangan bundel gagal
Gunakan kotak pencarian di atas untuk mencari tindakan spesifik dengan cepat. Anda dapat memilih beberapa tindakan untuk menampilkan log yang sesuai dengan salah satu jenis yang dipilih.
Contoh snippet log (data palsu)
Judul bagian “Contoh snippet log (data palsu)”| Waktu (UTC) | ID Perangkat | Aksi | Versi | Apa yang mengatakan padamu |
|---|---|---|---|---|
| 2025-01-14 10:00:01 | A1B2C3 | get | 2.4.1 | Perangkat bertanya Capgo apakah ada pembaruan tersedia |
| 2025-01-14 10:00:03 | A1B2C3 | download_manifest_start | 2.4.1 | Manifest fetch dimulai; SDK akan mengunduh file |
| 2025-01-14 10:00:07 | A1B2C3 | download_40 | 2.4.1 | Pengunduhan bundle 40% selesai |
| 2025-01-14 10:00:12 | A1B2C3 | download_zip_complete | 2.4.1 | Zip selesai mengunduh |
| 2025-01-14 10:00:13 | A1B2C3 | set | 2.4.1 | Bundle terpasang dan ditandai sebagai berikutnya untuk dijalankan |
| 2025-01-14 10:05:00 | B9C8D7 | disableAutoUpdateToMajor | 1.9.0 | Kebijakan saluran menghalangi jump ke 2.x |
| 2025-01-14 10:05:05 | B9C8D7 | rateLimited | bawaan | Perangkat telah mencapai batas permintaan; SDK menunggu sampai restart |
Skenario Log Contoh
Bagian berjudul “Skenario Log Contoh”Untuk membantu Anda memahami apa yang dikatakan log, berikut adalah urutan contoh yang menunjukkan perjalanan update perangkat nyata:
Alur Update Sukses
Bagian berjudul “Alur Update Sukses”Inilah bagaimana update yang sehat terlihat dalam log Anda:
| Waktu | ID Perangkat | Aksi | Versi | Artinya |
|---|---|---|---|---|
| 10:00:01 | a1b2c3d4 | get | 1.2.0 | Perangkat dicek untuk update dan menerima informasi versi 1.2.0 |
| 10:00:02 | a1b2c3d4 | download_10 | 1.2.0 | Download dimulai, 10% selesai |
| 10:00:03 | a1b2c3d4 | download_50 | 1.2.0 | Download pada 50% |
| 10:00:05 | a1b2c3d4 | download_complete | 1.2.0 | Download selesai dengan sukses |
| 10:00:06 | a1b2c3d4 | set | 1.2.0 | Bundle diinstal dan diaktifkan |
Perangkat Sudah Terupdate
Judul Bagian “Perangkat Sudah Terupdate”Ketika perangkat melakukan pengecekan tetapi sudah memiliki versi terbaru:
| Waktu | ID Perangkat | Aksi | Versi | Apa itu |
|---|---|---|---|---|
| 14:30:00 | e5f6g7h8 | noNew | 1.2.0 | Perangkat sudah menggunakan versi terbaru, tidak perlu diperbarui |
Gagal Perbarui dengan Rollback
Bagian berjudul “Gagal Perbarui dengan Rollback”Ketika perbarui gagal dan perangkat kembali ke versi sebelumnya:
| Waktu | ID Perangkat | Aksi | Versi | Apa itu |
|---|---|---|---|---|
| 11:15:00 | i9j0k1l2 | get | 1.3.0 | Perangkat menerima informasi perbarui |
| 11:15:02 | i9j0k1l2 | download_complete | 1.3.0 | Download selesai |
| 11:15:03 | i9j0k1l2 | set | 1.3.0 | Paket telah diatur |
| 11:15:10 | i9j0k1l2 | update_fail | 1.3.0 | Aplikasi bermasalah atau notifyAppReady() tidak dipanggil - rollback diaktifkan |
| 11:15:11 | i9j0k1l2 | reset | bawaan | Perangkat kembali ke versi bawaan |
Tindakan diperlukan: Periksa bahwa aplikasi Anda memanggil notifyAppReady() setelah inisialisasi sukses. Lihat dokumentasi plugin untuk detail.
Gagal Download
Judul bagian “Gagal Download”Ketika masalah jaringan mencegah unduhan:
| Waktu | ID Perangkat | Aksi | Versi | Apa itu artinya |
|---|---|---|---|---|
| 09:45:00 | m3n4o5p6 | get | 1.2.0 | Perangkat menerima informasi pembaruan |
| 09:45:01 | m3n4o5p6 | download_30 | 1.2.0 | Mulai download tetapi… |
| 09:45:15 | m3n4o5p6 | download_fail | 1.2.0 | Gagal download (timeout jaringan, koneksi hilang, dll.) |
Aksi diperlukan: Perangkat akan mencoba ulang secara otomatis pada peluncuran aplikasi berikutnya. Tidak ada aksi yang diperlukan kecuali hal ini sering terjadi.
Batasan Paket Tercapai
Bagian berjudul “Mencapai Batas Limit”Ketika akun Anda mencapai batas perangkat:
| Waktu | ID Perangkat | Aksi | Versi | Apa itu |
|---|---|---|---|---|
| 16:00:00 | q7r8s9t0 | needPlanUpgrade | - | Perangkat ini tidak akan menerima update hingga Anda mengupgrade atau siklus pembayaran berulang |
Aksi yang diperlukan: Upgrade rencana Anda atau tunggu siklus pembayaran berikutnya.
Konfigurasi Saluran Menghalangi Update
Konfigurasi Saluran Menghalangi UpdateKetika pengaturan saluran mencegah update:
| Waktu | ID Perangkat | Aksi | Versi | Artinya |
|---|---|---|---|---|
| 12:00:00 | u1v2w3x4 | disableAutoUpdateToMajor | 2.0.0 | Perangkat di v1.x tidak dapat mengupdate secara otomatis ke v2.x (langkah versi besar diblokir) |
| 12:05:00 | y5z6a7b8 | disableEmulator | 1.2.0 | Deteksi emulator, dan saluran memblokir emulator |
| 12:10:00 | c9d0e1f2 | disableDevBuild | 1.2.0 | Deteksi build dev, dan saluran memblokir build dev |
Aksi yang Diperlukan: Ini adalah perlindungan sengaja. Jika Anda ingin memungkinkan update ini, ubah pengaturan Anda pengaturan saluran.
Kode Log (Capgo backend enum)
Judul Bagian “Kode Log (Capgo backend enum)”Kode-kode ini berasal dari stats_action enum yang digunakan oleh dashboard API (capgo/src/types/supabase.types.ts). Jika Anda melihat kode code baru di UI, maka kode tersebut dikeluarkan oleh SDK atau backend dan diverifikasi terhadap daftar ini.
Jalur Bahagia & Lifecycle
| Code(s) | Arti |
|---|---|
get | Perangkat meminta Capgo untuk manifest saluran saat ini |
download_manifest_start, download_manifest_complete | Pengunduhan Manifest dimulai / selesai (untuk delta atau bundle berkas multi) |
download_zip_start, download_zip_complete | Pengunduhan arsip zip dimulai / selesai |
download_10 … download_90 | Titik-titik kemajuan download |
download_complete | Seluruh bundle telah diunduh |
set | Bundle siap untuk peluncuran berikutnya |
reset | Perangkat kembali ke bundle bawaan |
delete | Bundle dihapus dari penyimpanan lokal |
uninstall | Ditemukan penghapusan aplikasi |
app_moved_to_foreground, app_moved_to_background | Acara hidup aplikasi direkam oleh SDK |
ping | Pengecekan kesehatan/heartbeat dari perangkat |
setChannel, getChannel | Saluran diatasi atau ditarik melalui SDK call |
Konfigurasi atau kebijakan menghalangi
| Code(s) | Mengapa pembaruan diblokir |
|---|---|
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative | Strategi saluran melarang lonjakan semver ini |
disablePlatformIos, disablePlatformAndroid | Saluran ini dinonaktifkan pada saluran |
disableDevBuild, disableEmulator | Pembangunan atau emulator tidak diizinkan |
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured | Pemilihan atau penggantian saluran gagal |
missingBundle, cannotGetBundle | Manifest mengacu pada paket Capgo tidak dapat menyajikan |
needPlanUpgrade | Organisasi telah mencapai batas rencana/perangkat |
rateLimited | Terlalu banyak permintaan; SDK menghambat sampai restart |
blocked_by_server_url, backend_refusal, InvalidIp | Aturan sisi server menghalangi permintaan |
Gagal download / integritas / instalasi
| Code(s) | Arti |
|---|---|
download_fail | Gagal download paket (error jaringan atau respons) |
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail | File Manifest tidak dapat diambil atau diverifikasi |
checksum_fail, checksum_required | Integritas gagal atau cek checksum hilang |
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail | Validasi sistem file atau unzip gagal |
decrypt_fail | Penguncian gagal (arsip terenkripsi) |
update_fail | Arsip terpasang tetapi aplikasi tidak pernah memanggil notifyAppReady(); rollback diaktifkan |
download_zip_* dengan tidak ada yang berikutnya set | Download selesai tetapi fase instalasi tidak pernah selesai |
➡️ Butuh panduan lebih dalam tentang per-code? Lihat Referensi dan Panduan Debugging Log Code Penuh.
Mendapatkan Detail Lebih Lanjut tentang Log
Bagian berjudul “Mendapatkan Detail Lebih Lanjut tentang Log”Jika Anda mengklik entri log tertentu, maka biasanya akan membawa Anda ke halaman perangkat. Ini memungkinkan Anda untuk melihat riwayat lengkap untuk perangkat tertentu, yang dapat sangat membantu dalam mendiagnosis masalah perangkat khusus atau memahami perjalanan pembaruan perangkat.