Log
Salin prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.
Pengertian Log Aplikasi
Bab berjudul “Pengertian Log Aplikasi”Halaman Log memberikan riwayat detail peristiwa pembaruan dan informasi diagnostik untuk aplikasi Anda. Ini sangat penting untuk memantau proses pembaruan, menyelesaikan 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 Muat Ulang - Muat ulang daftar log dengan data terbaru
- Filter Waktu dan Aksi - Tampilkan log berdasarkan rentang waktu 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 riwayat lengkap.
Penggunaan Pencarian Berdasarkan Rentang Waktu
Anda dapat memfilter log dengan periode waktu tertentu menggunakan pilih tanggal:Pilih Tanggal untuk Memfilter Log
- Preset Cepat - Pilih rentang waktu umum: 1h terakhir, 3h, 6h, atau 12h
- Waktu Mulai - Atur waktu mulai kustom untuk rentang
- Waktu Akhir - Atur waktu akhir kustom untuk rentang
- Kalender - Pilih tanggal spesifik menggunakan tampilan kalender
Klik “Pilih” untuk menerapkan rentang tanggal yang dipilih, atau “Batal” untuk menutup pilih tanggal.
Pengurutan Berdasarkan Tipe Aksi
Judul bagian “Pengurutan Berdasarkan Tipe Aksi”Menu dropdown Aksi memungkinkan Anda mengurutkan log berdasarkan jenis event tertentu:
Term filter tersedia termasuk:
- Jantung perangkat - Pemeriksaan kesehatan berkala dari perangkat
- Penghapusan versi diminta - Ketika sebuah versi bundel dihapus
- Kembali ke versi default - Ketika perangkat kembali ke bundel bawaan
- Pemasangan versi sukses - Pemasangan bundel sukses
- Versi baru dikirim ke perangkat - Ketika Capgo mengirimkan pembaruan ke perangkat
- Pemasangan versi gagal - Ketika instalasi bundle gagal
Gunakan kotak pencarian di atas untuk menemukan jenis aksi tertentu dengan cepat. Anda dapat memilih beberapa aksi untuk menampilkan log yang sesuai dengan salah satu jenis yang dipilih.
Contoh snippet log (data palsu)
Bagian berjudul “Contoh snippet log (data palsu)”| Waktu (UTC) | ID Perangkat | Aksi | Versi | Apa yang dikatakan olehnya |
|---|---|---|---|---|
| 2025-01-14 10:00:01 | A1B2C3 | get | 2.4.1 | Perangkat bertanya Capgo apakah ada update yang tersedia |
| 2025-01-14 10:00:03 | A1B2C3 | download_manifest_start | 2.4.1 | Pengunduhan manifest dimulai; SDK akan mengunduh file-file |
| 2025-01-14 10:00:07 | A1B2C3 | download_40 | 2.4.1 | Pengunduhan bundle sudah 40% selesai |
| 2025-01-14 10:00:12 | A1B2C3 | download_zip_complete | 2.4.1 | Zip selesai diunduh |
| 2025-01-14 10:00:13 | A1B2C3 | set | 2.4.1 | Paket 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 mencapai batas permintaan; SDK mundur hingga restart |
Skenario Log Contoh
Untuk membantu Anda memahami apa yang dikatakan log, berikut adalah urutan contoh yang menunjukkan perjalanan update perangkat nyata:Aliran Update Sukses
Judul Bagian “Aliran Update Sukses”
Ini adalah apa yang terlihat seperti update yang sehat dalam log Anda:Waktu
| Waktu | ID Perangkat | Aksi | Versi | Apa itu |
|---|---|---|---|---|
| 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 update |
| 11:15:02 | i9j0k1l2 | download_complete | 1.3.0 | Download selesai |
| 11:15:03 | i9j0k1l2 | set | 1.3.0 | Paket 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: Pastikan aplikasi Anda memanggil notifyAppReady() setelah inisialisasi sukses. Lihat dokumentasi plugin untuk informasi lebih lanjut.
Gagal Download
Judul bagian “Gagal Download”Ketika masalah jaringan mencegah download:
| Waktu | ID Perangkat | Aksi | Versi | Apa itu berarti |
|---|---|---|---|---|
| 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 | Download gagal (timeout jaringan, koneksi hilang, dll.) |
Tindakan diperlukan: Perangkat akan mencoba ulang secara otomatis pada peluncuran aplikasi berikutnya. Tidak ada tindakan yang diperlukan kecuali hal ini sering terjadi.
Mencapai Batas Paket
Judul Bagian “Mencapai Batas Paket”Ketika akun Anda mencapai batas perangkat:
| Waktu | ID Perangkat | Tindakan | Versi | Apa itu |
|---|---|---|---|---|
| 16:00:00 | q7r8s9t0 | needPlanUpgrade | - | Perangkat ini tidak akan menerima update hingga Anda mengupgrade atau siklus pembayaran reset |
Aksi diperlukan: Perbarui rencana Anda atau tunggu siklus tagihan berikutnya.
Konfigurasi Saluran Menghalangi Perbaruan
Judul bagian “Konfigurasi Saluran Menghalangi Perbaruan”Ketika pengaturan saluran mencegah perbaruan:
| Waktu | ID Perangkat | Aksi | Versi | Apa itu artinya |
|---|---|---|---|---|
| 12:00:00 | u1v2w3x4 | disableAutoUpdateToMajor | 2.0.0 | Perangkat pada v1.x tidak dapat memperbarui secara otomatis ke v2.x (langkah versi utama 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 |
Tindakan diperlukan : Ini adalah perlindungan sengaja. Jika Anda ingin memungkinkan pembaruan ini, ubah pengaturan saluran Anda.
Kode log (Capgo enum backend)
Judul bagian “Kode log (Capgo enum backend)”Kode-kode ini berasal dari stats_action enum yang digunakan oleh dashboard API (capgo/src/types/supabase.types.ts). Jika Anda melihat kode log baru code di UI, 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 | Pembuatan manifest dimulai / selesai (untuk delta atau bundle berkas multi) |
download_zip_start, download_zip_complete | Pembuatan arsip zip dimulai / selesai |
download_10 … download_90 | Milestones kemajuan download |
download_complete | Bundel seluruhnya telah didownload |
set | Bundel dipersiapkan untuk peluncuran berikutnya |
reset | Perangkat kembali ke bundel bawaan |
delete | Bundel dihapus dari penyimpanan lokal |
uninstall | Deteksi penghapusan aplikasi |
app_moved_to_foreground, app_moved_to_background | Event siklus aplikasi direkam oleh SDK |
ping | Pengecekan kesehatan / detak jantung dari perangkat |
setChannel, getChannel | Saluran di atas ditetapkan atau diambil melalui panggilan SDK |
Blok konfigurasi atau kebijakan
| Code(s) | Mengapa pembaruan dihalangi |
|---|---|
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative | Strategi saluran melarang lonjakan semver ini |
disablePlatformIos, disablePlatformAndroid | Platform diaktifkan pada saluran |
disableDevBuild, disableEmulator | Pembangunan atau emulator tidak diizinkan |
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured | Pemilihan atau penggantian saluran gagal |
missingBundle, cannotGetBundle | Manifest mengacu pada bundle Capgo yang 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 server sisi menghalangi permintaan |
Gagal download / integritas / instal
| Code(s) | Arti |
|---|---|
download_fail | Gagal mengunduh bundle (error jaringan atau respons) |
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail | File manifest tidak dapat diakses atau diverifikasi |
checksum_fail, checksum_required | Periksa integritas gagal atau checksum hilang |
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail | Validasi sistem file atau unzip gagal |
decrypt_fail | Decripsi gagal (bundle terenkripsi) |
update_fail | Bundle terinstal 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 yang lebih mendalam tentang code? Lihat Panduan Referensi dan Pengembangan Log Code yang Lengkap.
Mendapatkan Informasi Lebih Lanjut tentang Log
Bagian berjudul “Mendapatkan Informasi Lebih Lanjut tentang Log”Jika Anda mengklik entri log tertentu, 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.
Teruskan dari Log
Bagian berjudul “Teruskan dari Log”Jika Anda menggunakan Log untuk merencanakan dashboard dan operasi API lainnya, hubungkan dengan Ringkasan API untuk detail implementasi di Ringkasan API Pendahuluan untuk detail implementasi di Pendahuluan Kunci API untuk detail implementasi di Kunci API Perangkat untuk detail implementasi di Perangkat, dan Paket untuk detail implementasi di Paket.