Mengatasi Masalah

Berikut beberapa masalah umum yang mungkin Anda temui saat menggunakan Capgo dan cara menyelesaikannya.

🚀 Butuh Bantuan Ahli?

Terjebak dengan masalah kompleks? Tim ahli kami ada untuk membantu! Dapatkan dukungan personal, code ulasan, dan solusi khusus yang disesuaikan dengan kebutuhan spesifik Anda.

Dapatkan Dukungan Profesional

Gagal Unggah

Jika unggahan bundle gagal, periksa kembali:

• ID aplikasi Anda di capacitor.config.ts cocok dengan aplikasi Anda di dashboard Capgo
• Anda menjalankan perintah unggah dari root project Capacitor Anda
• Aset web Anda dibangun dan sudah terkini

Opsi unggah lanjutan

Dokumentasi Capgo CLI menyediakan beberapa flag tambahan untuk membantu dengan masalah unggah umum:

• --tus: Menggunakan protokol unggah resumable tus untuk unggah yang lebih dapat diandalkan dari bundle besar atau pada koneksi jaringan yang buruk. Jika bundle Anda melebihi 10MB atau Anda berada di koneksi yang tidak stabil, pertimbangkan menggunakan Jendela terminal --tus:

  npx @capgo/cli@latest bundle upload --tus

• --package-json dan --node-modules: Menginformasikan Capgo tentang lokasi root Anda package.json dan node_modules jika aplikasi Anda menggunakan struktur non-standar seperti monorepo atau npm workspace. Berikan path ke root package.json dan path: --node_modules Jendela Terminal

  npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules

  Capgo needs this information to correctly bundle your app’s dependencies.

sebagaimana diperlukan. Lihat --channel __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ dokumentasi Capgo CLI docs untuk informasi lebih lanjut tentang opsi unggah yang tersedia.

Jika Anda masih mengalami masalah dengan unggah, hubungi Capgo dukungan untuk bantuan tambahan.

Mengatasi Perbaruan

Jika Anda mengalami masalah dengan perbaruan hidup, perintah debug Capgo adalah alat yang berguna untuk mengatasi masalah. Untuk menggunakan perintah tersebut:

1. Jalankan perintah berikut di direktori proyek Anda:

   npx @capgo/cli@latest app debug

2. Luncurkan aplikasi Anda di perangkat atau emulator dan lakukan aksi yang seharusnya memicu perbaruan (misalnya, membuka kembali aplikasi setelah mengunggah bundle baru).

3. Amati keluaran perintah debug. Perintah tersebut akan mencetak informasi tentang proses perbaruan, termasuk:

   • When aplikasi memeriksa pembaruan
   • Jika ditemukan pembaruan dan versi apa itu
   • Progress download dan instalasi pembaruan
   • Apapun kesalahan yang terjadi selama proses pembaruan

4. Pakai log debug untuk mengidentifikasi di mana masalah terjadi. Misalnya:

   • Jika tidak ditemukan pembaruan, periksa lagi apakah bundel Anda telah diunggah dengan sukses dan aplikasi telah dikonfigurasi untuk menggunakan saluran yang benar.
   • Jika pembaruan didownload tetapi tidak terinstal, pastikan Anda telah memanggil CapacitorUpdater.notifyAppReady() dan bahwa aplikasi telah ditutup sepenuhnya dan dibuka kembali.
   • Jika Anda melihat pesan kesalahan, cari informasi tentang kesalahan spesifik di Capgo dokumen atau hubungi dukungan untuk bantuan.

Perintah debug sangat berguna untuk mengidentifikasi masalah dengan proses download dan instalasi pembaruan. Jika log menunjukkan versi pembaruan yang diharapkan ditemukan tetapi tidak akhirnya diterapkan, fokuskan perbaikan masalah pada langkah-langkah setelah download.

Pengembangan dengan Log Nativ

Selain perintah debug Capgo, log-log asli pada Android, iOS, dan Electron dapat memberikan informasi troubleshooting yang berharga, terutama untuk masalah pada sisi native proses pembaruan.

Log Android

Untuk mengakses log Android:

1. Hubungkan perangkat Anda atau mulai emulator Anda
2. Buka Android Studio dan pilih “Lihat > Jendela Alat > Logcat”
3. Dalam jendela Logcat, filter log untuk hanya proses aplikasi Anda dengan memilihnya dari dropdown di atas
4. Cari baris yang mencakup Capgo untuk menemukan log SDK

Alternatifnya, Anda dapat menggunakan adb logcat perintah dan cari dengan Capgo untuk memfilter log.

Penggunaan Capgo SDK akan merekam peristiwa kunci selama proses pembaruan, seperti:

• Ketika proses periksa pembaruan dimulai
• Jika pembaruan ditemukan dan versi apa yang ditemukan
• Ketika proses download pembaruan dimulai dan selesai
• Ketika proses instalasi pembaruan diaktifkan
• Semua kesalahan yang terjadi selama langkah-langkah pembaruan native

Masalah umum Android yang mungkin Anda lihat dalam log termasuk:

• Masalah koneksi jaringan yang menghalangi download pembaruan
• Kesalahan hak akses file ketika menyimpan atau membaca paket pembaruan
• Kurangnya ruang penyimpanan untuk paket pembaruan
• Gagal memulai aplikasi setelah pembaruan diinstal

Log iOS

Untuk mengakses log iOS:

1. Hubungkan perangkat Anda atau mulai simulator Anda
2. Buka Xcode dan pergi ke “Jendela > Perangkat dan Simulator”
3. Pilih perangkat Anda dan klik pada “Buka Konsol”
4. Dalam output konsol, cari baris yang mencakup Capgo untuk menemukan log SDK

Anda juga dapat menggunakan log stream perintah di terminal dan cari dengan Capgo untuk menyaring log.

Sama seperti Android, Capgo SDK akan mencatat acara utama iOS:

• Inisiasi dan hasil periksa update
• Mulai, kemajuan, dan selesai download
• Pemicu dan hasil instalasi
• Apapun kesalahan selama proses pembaruan native

Masalah iOS yang mungkin Anda temukan di log termasuk:

• Masalah sertifikat SSL ketika mendownload pembaruan
• App transport keamanan menghalangi download pembaruan
• Tidak cukup ruang penyimpanan untuk bundle pembaruan
• Gagal mengekstrak atau menerapkan bundle pembaruan

Log Electron

Untuk aplikasi Electron, periksa keluaran proses utama dan proses renderer:

1. Jalankan aplikasi Electron dari terminal Anda menggunakan perintah peluncuran normal (misalnya bun run electron:dev atau bun run electron:serve) dan lihat keluaran terminal untuk proses startup, pengecekan update, dan kesalahan jaringan.
2. Buka DevTools di jendela renderer (Lihat → Aktifkan Alat Pengembang) dan inspeksi log konsol dan permintaan jaringan gagal saat mereproduksi alur update.
3. Untuk aplikasi yang dikemas, periksa alat log OS untuk kegagalan atau gagal startup:
   • macOS: buka Console.app dan filter pada nama aplikasi Anda
   • Windows: buka Pengawas Acara → Log Windows → Aplikasi
   • Linux: gunakan viewer log desktop Anda atau journalctl untuk proses aplikasi Anda

Saat debugging update, bandingkan pesan dari log proses utama dan proses renderer untuk memisahkan masalah Electron bootstrap dari masalah siklus hidup update Capgo.

Di semua platform, log native memberikan pandangan level lebih rendah ke proses update, dengan detail lebih banyak tentang implementasi native. Mereka sangat berguna untuk mengidentifikasi masalah yang terjadi di luar lapisan JavaScript Capgo.

Saat mengatasi masalah update hidup yang sulit, ide yang baik adalah untuk merekam baik log debug Capgo dan log native untuk mendapatkan gambaran yang komprehensif tentang apa yang terjadi. Kedua log bersama-sama akan memberikan Anda kesempatan terbaik untuk mengidentifikasi dan menyelesaikan masalah.

Tidak berlaku update

Jika Anda telah mengunggah bundle tetapi tidak melihat perubahan di perangkat Anda:

• Pastikan Anda telah memanggil CapacitorUpdater.notifyAppReady() dalam aplikasi Anda code seperti yang ditunjukkan dalam quickstart
• Pastikan perangkat Anda terhubung ke internet dan log debug Capgo menampilkan bahwa update telah didownload
• Coba tutup sepenuhnya dan buka aplikasi lagi, karena update hanya diterapkan pada peluncuran segar
• Cari kesalahan di log native yang mungkin menunjukkan masalah saat menerapkan update

Refer ke panduan mengupdate aplikasi secara langsung untuk informasi lebih lanjut tentang proses update. Jika Anda masih bingung, gunakan npx @capgo/cli@latest app debug perintah dan log native untuk mendapatkan visibilitas lebih lanjut tentang apa yang sedang terjadi

Kode gagal update yang umum

, atau disable_auto_update_to_major, semver_error, gunakan panduan khusus: cannot_update_via_private_channelKode Gagal Update yang Umum

• Masalah Pembaruan Umum

Halaman ini menjelaskan apa saja masalah umum code yang sering terjadi, mengapa hal itu terjadi, dan bagaimana cara mengatasinya.

SDK Pemasangan

Jika Anda mengalami kesulitan saat memasang Capgo SDK, pastikan:

• Aplikasi Anda menggunakan versi Capacitor yang didukung (4.0 atau lebih baru)
• Anda telah mengikuti langkah-langkah ‘quickstart’ secara berurutan, termasuk sinkronisasi aplikasi setelah memasang __CAPGO_KEEP_0__ Integrasi CI/CD steps in order, including syncing your app after installing the SDK

Untuk masalah terkait pengaktifan unggah __CAPGO_KEEP_0__ dari pipeline CI/CD Anda:

Halaman ini menjelaskan apa saja masalah umum Capgo yang sering terjadi, mengapa hal itu terjadi, dan bagaimana cara mengatasinya.

• Periksa ulang token autentikasi Capgo Anda telah terkonfigurasi dengan benar
• Pastikan Anda menjalankan perintah unggah setelah aset web Anda telah dibangun
• Periksa bahwa perintah unggah menggunakan nama saluran yang benar untuk lingkungan target Anda

Lihat integrasi CI/CD dokumen untuk tips troubleshooting lebih lanjut. Anda juga dapat menggunakan npx @capgo/cli@latest app debug perintah untuk memastikan apakah pembaruan yang diaktifkan oleh CI/CD telah diterima oleh aplikasi.