Log
Salin prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.
Mengerti Log Aplikasi
Bagian berjudul “Mengerti Log Aplikasi”Halaman Log memberikan 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
- Button Reload - Perbarui daftar log dengan data terbaru
- Jangkau Waktu & Pemfilteran Aksi - Filter log berdasarkan rentang tanggal dan jenis aksi (lihat bagian di bawah)
Setiap baris menampilkan:
- Waktu (UTC)
- ID Perangkat
- Aksi code (apa yang terjadi)
- Nama Versi (bundle atau
builtin)
Klik baris untuk melompat ke halaman detail perangkat untuk melihat riwayat lengkap.
Filtering oleh Rentang Waktu
Judul Bagian “Filtering oleh Rentang Waktu”Anda dapat menyaring log dengan jangka waktu tertentu menggunakan pilih tanggal:
- Preset Cepat - Pilih rentang waktu umum: 1 jam terakhir, 3 jam terakhir, 6 jam terakhir, atau 12 jam terakhir
- Waktu Mulai - Atur waktu mulai untuk rentang waktu
- Waktu Akhir - Atur waktu akhir untuk rentang waktu
- Kalender - Pilih tanggal spesifik menggunakan tampilan kalender
Klik “Pilih” untuk menerapkan rentang tanggal yang dipilih, atau “Batal” untuk menutup picker.
Pengurangan berdasarkan Tipe Aksi
Judul bagian “Pengurangan berdasarkan Tipe Aksi”Menu dropdown Aksi memungkinkan Anda mengurangi log berdasarkan jenis event tertentu:
Tersedia filter aksi yang termasuk:
- Detak jantung perangkat - Periksa kesehatan periodik dari perangkat
- Penghapusan versi diminta - Ketika versi bundel dihapus
- Kembalikan ke versi default - Ketika perangkat kembali ke bundle bawaan
- Versi terpasang dengan sukses - Instalasi bundle sukses
- Versi baru dikirim ke perangkat - Ketika Capgo mengirimkan update ke perangkat
- Penginstalan versi gagal - Ketika instalasi bundle 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 |
|---|---|---|---|---|
| 2025-01-14 10:00:01 | A1B2C3 | get | 2.4.1 | Perangkat bertanya Capgo apakah ada pembaruan |
| 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 lonjakan ke 2.x |
| 2025-01-14 10:05:05 | B9C8D7 | rateLimited | bawaan | Perangkat mencapai batas permintaan; SDK mundur hingga restart |
Contoh Skenario Log
Judul Bagian “Contoh Skenario Log”Untuk membantu Anda memahami apa yang dikatakan log, berikut adalah urutan contoh yang menunjukkan perjalanan update perangkat nyata:
Alur Update Sukses
Judul Bagian “Alur Update Sukses”Ini adalah bagaimana update yang sehat terlihat dalam log Anda:
| Waktu | ID Perangkat | Aksi | Versi | Artinya |
|---|---|---|---|---|
| 10:00:01 | a1b2c3d4 | get | 1.2.0 | Perangkat memeriksa update dan menerima informasi versi 1.2.0 |
| 10:00:02 | a1b2c3d4 | download_10 | 1.2.0 | Mulai download, 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 | Paket terinstal dan diaktifkan |
Perangkat Sudah Terupdate
Judul Bagian “Perangkat Sudah Terupdate”Ketika perangkat memeriksa tapi sudah memiliki versi terbaru:
| Waktu | ID Perangkat | Aksi | Versi | Artinya |
|---|---|---|---|---|
| 14:30:00 | e5f6g7h8 | noNew | 1.2.0 | Perangkat sudah memiliki versi terbaru, tidak perlu diperbarui |
Gagal Perbarui dengan Rollback
Judul Bagian “Gagal Perbarui dengan Rollback”Ketika perbarui gagal dan perangkat kembali ke versi sebelumnya:
| Waktu | ID Perangkat | Aksi | Versi | Artinya |
|---|---|---|---|---|
| 11:15:00 | i9j0k1l2 | get | 1.3.0 | Perangkat menerima informasi perbarui |
| 11:15:02 | i9j0k1l2 | download_complete | 1.3.0 | Unduh selesai |
| 11:15:03 | i9j0k1l2 | set | 1.3.0 | Bundle telah ditetapkan |
| 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 detailnya.
Gagal Download
Judul bagian “Gagal Download”Ketika masalah jaringan mencegah download:
| Waktu | ID Perangkat | Aksi | Versi | Apa itu |
|---|---|---|---|---|
| 09:45:00 | m3n4o5p6 | get | 1.2.0 | Perangkat menerima informasi update |
| 09:45:01 | m3n4o5p6 | download_30 | 1.2.0 | Download dimulai tapi… |
| 09:45:15 | m3n4o5p6 | download_fail | 1.2.0 | Gagal Download (timeout jaringan, koneksi hilang, dll.) |
Aksi dibutuhkan: Perangkat akan mencoba ulang secara otomatis pada aplikasi berikutnya. Tidak ada aksi yang diperlukan kecuali hal ini sering terjadi.
Batasan Paket Terpenuhi
Judul bagian “Batasan Paket Terpenuhi”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 reset |
Aksi yang diperlukan: Upgrade rencana Anda atau tunggu siklus pembayaran berikutnya.
Konfigurasi Saluran Menghalangi Update
Judul bagian “Konfigurasi Saluran Menghalangi Update”When channel pengaturan mencegah pembaruan:
| Waktu | ID Perangkat | Aksi | Versi | Apa itu berarti |
|---|---|---|---|---|
| 12:00:00 | u1v2w3x4 | disableAutoUpdateToMajor | 2.0.0 | Perangkat di v1.x tidak dapat memperbarui secara otomatis ke v2.x (langkah versi utama diblokir) |
| 12:05:00 | y5z6a7b8 | disableEmulator | 1.2.0 | Diteliti emulator, dan saluran memblokir emulator |
| 12:10:00 | c9d0e1f2 | disableDevBuild | 1.2.0 | Diteliti build dev, dan saluran memblokir build dev |
Aksi yang diperlukan: Ini adalah perlindungan sengaja. Jika Anda ingin memungkinkan pembaruan ini, ubah pengaturan saluran Anda __CAPGO_KEEP_0__.
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 | Manifest download dimulai / selesai (untuk delta atau bundle multi-file) |
download_zip_start, download_zip_complete | Download arsip zip dimulai / selesai |
download_10 … download_90 | Milestones kemajuan download |
download_complete | Seluruh bundle diunduh |
set | Bundle disiapkan untuk peluncuran berikutnya |
reset | Perangkat dikembalikan ke bundle bawaan |
delete | Bundle dihapus dari penyimpanan lokal |
uninstall | Penghapusan aplikasi terdeteksi |
app_moved_to_foreground, app_moved_to_background | Event siklus aplikasi direkam oleh SDK |
ping | Pengecekan kesehatan/heartbeat dari perangkat |
setChannel, getChannel | Saluran diubah atau diambil melalui SDK panggilan |
Konfigurasi atau kebijakan menghalangi
| Code(s) | Mengapa pembaruan diblokir |
|---|---|
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative | Strategi saluran melarang hal ini versi semver |
disablePlatformIos, disablePlatformAndroid | Platform diaktifkan di saluran ini |
disableDevBuild, disableEmulator | Dev build atau emulator tidak diizinkan |
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured | Pemilihan atau penggantian saluran gagal |
missingBundle, cannotGetBundle | Manifest mengacu pada bundle Capgo tidak dapat disajikan |
needPlanUpgrade | Organisasi telah mencapai batas rencana/perangkat |
rateLimited | Terlalu banyak permintaan; SDK menghambat hingga restart |
blocked_by_server_url, backend_refusal, InvalidIp | Aturan sisi server menghalangi permintaan |
Gagal download / integritas / instalasi
| Code(s) | Arti |
|---|---|
download_fail | Gagal download bundle (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 | Kripsi gagal (arsip terenkripsi) |
update_fail | Aplikasi terpasang tetapi aplikasi tidak pernah dipanggil notifyAppReady(); rollback diaktifkan |
download_zip_* tanpa langkah berikutnya set | Pengunduhan selesai tetapi fase instalasi tidak pernah selesai |
➡️ Butuh panduan lebih lanjut tentang per-code? Lihat Referensi dan Panduan Debugging Log Lengkap Code.
Mendapatkan Detail Lebih Lanjut Tentang Log
Bab berjudul “Mendapatkan Detail Lebih Lanjut Tentang Log”Jika Anda mengklik pada entri log tertentu, maka biasanya akan membawa Anda ke halaman perangkat. Ini memungkinkan Anda untuk melihat riwayat lengkap untuk perangkat tersebut, yang dapat sangat membantu dalam mendiagnosis masalah perangkat khusus atau memahami perjalanan pembaruan perangkat.
Lanjutkan dari Log
Judul bagian “Lanjutkan dari Log”Jika Anda menggunakan Log untuk merencanakan dashboard dan operasi API lainnya, hubungkan dengan API Ringkasan untuk detail implementasi di API Ringkasan, Pendahuluan untuk detail implementasi di Pendahuluan, API Kunci untuk detail implementasi di API Kunci, Perangkat untuk detail implementasi di Perangkat, dan Paket untuk detail implementasi di Paket.