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 siap membantu! Dapatkan dukungan personal, code ulasan, dan solusi kustom yang disesuaikan dengan kebutuhan spesifik Anda.

Dapatkan Bantuan Profesional

Gagal Mengunggah

Jika unggahan bundle Anda gagal, periksa kembali:

• ID Aplikasi Anda di capacitor.config.ts matches your app in the Capgo dashboard
• You’re running the upload command from the root of your Capacitor project
• Sumber daya web Anda dibangun dan sudah terkini

Opsi Unggahan Lanjutan

The Capgo CLI provides some additional flags to help with common upload issues:

• --tusMenggunakan protokol unggah sambung __CAPGO_KEEP_0__ untuk unggah yang lebih dapat diandalkan dari bundle besar atau pada koneksi jaringan yang buruk. Jika bundle Anda melebihi 10MB atau Anda berada pada koneksi yang tidak stabil, pertimbangkan menggunakan --tus:

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

• --package-json dan --node-modules: Menunjukkan Capgo tempat mencari root package.json dan node_modules jika aplikasi Anda menggunakan struktur yang tidak 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 memerlukan informasi ini untuk mengemas kembali dependensi aplikasi Anda dengan benar.

Anda dapat menggabungkan flag-flag ini dengan opsi lain seperti --channel sebagaimana diperlukan. Lihat Capgo CLI dokumentasi untuk mendapatkan informasi lengkap tentang opsi unggah yang tersedia.

Jika Anda masih mengalami kesulitan dengan unggah, hubungi Capgo dukungan untuk bantuan lebih lanjut.

Mengatasi Perbaruan

If you’re encountering issues with live updates, the Capgo debug command is a helpful tool for troubleshooting. To use it:

1. __CAPGO_KEEP_0__ debug dapat membantu Anda mengatasi masalah tersebut. Untuk menggunakan perintah ini:

   npx @capgo/cli@latest app debug

2. Luncurkan aplikasi Anda pada perangkat atau emulator dan lakukan aksi yang seharusnya mengaktifkan pembaruan (misalnya, membuka kembali aplikasi setelah mengunggah bundle baru).

3. Amati hasil perintah debug. Ia akan mencatat informasi tentang proses pembaruan, termasuk:

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

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

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

The debug command is especially useful for identifying issues with the update download and installation process. If the logs show the expected update version was found but not ultimately applied, focus your troubleshooting on the steps after the download.

Pengembangan dengan Log Nativ

In addition to the Capgo debug command, the native logs on Android, iOS, dan Electron can provide valuable troubleshooting information, especially for issues on the native side of the update process.

Log Android

Untuk mengakses log Android:

1. Hubungkan perangkat Anda atau mulai emulator Anda
2. Buka Android Studio dan pilih “View > Tool Windows > Logcat”
3. Dalam jendela Logcat, filter log untuk hanya proses aplikasi Anda dengan memilihnya dari dropdown di atas
4. Cari baris apa pun yang termasuk Capgo untuk mencari log SDK

Alternatifnya, Anda dapat menggunakan adb logcat perintah dan mencari dengan grep untuk Capgo untuk menyaring log.

Log Capgo SDK akan mencatat 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 dipicu
• 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
• Masalah hak akses file ketika menyimpan atau membaca paket pembaruan
• Tidak ada ruang penyimpanan untuk paket pembaruan
• Gagal merestart aplikasi setelah pembaruan terpasang

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 event iOS yang penting:

• Pengecekan update dimulai dan hasilnya
• Mulai, kemajuan, dan selesai download
• Pemicu instalasi dan hasilnya
• Apapun kesalahan selama proses update native

Masalah iOS yang mungkin Anda temukan di log termasuk:

• Masalah sertifikat SSL ketika mendownload update
• App transport security menghalangi download update
• Ketersediaan ruang penyimpanan yang tidak cukup untuk bundle update
• Gagal mengekstrak atau menerapkan bundle update

Catatan 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 amati keluaran terminal untuk startup, pengecekan pembaruan, dan kesalahan jaringan.
2. Buka DevTools di jendela renderer (Lihat → Aktifkan Alat Pembangun) dan inspeksi log konsol dan permintaan jaringan gagal saat mereproduksi alur pembaruan.
3. Untuk aplikasi yang dikemas, periksa alat log OS untuk kegagalan atau kegagalan startup:
   • macOS: buka Console.app dan filter pada nama aplikasi Anda
   • dan: buka Event Viewer → Windows Logs → 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 Capgo masalah siklus update.

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. Dua log bersama akan memberikan Anda kesempatan terbaik untuk mengidentifikasi dan menyelesaikan masalah.

Update tidak berlaku

If Anda telah mengunggah sebuah bundle tetapi tidak melihat perubahan pada perangkat Anda:

• Pastikan Anda telah memanggil CapacitorUpdater.notifyAppReady() dalam aplikasi Anda code seperti yang ditunjukkan dalam quickstart
• Periksa apakah perangkat Anda terhubung ke internet dan log debug Capgo menampilkan bahwa update telah diunduh
• Coba menutup sepenuhnya dan membuka aplikasi lagi, karena update hanya diterapkan pada peluncuran baru
• Cari kesalahan dalam log native yang mungkin menunjukkan masalah dalam menerapkan update

Refer ke mengupdate live panduan 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 terjadi.

Kode gagal update umum

Jika log Anda menampilkan kesalahan backend seperti disable_auto_update_to_major, semver_error, atau cannot_update_via_private_channel, gunakan panduan khusus:

• Masalah Pembaruan Umum

Panduan tersebut menjelaskan apa itu kode kesalahan umum code, mengapa terjadi, dan bagaimana mengatasinya.

SDK Installation

If you’re having trouble installing the Capgo SDK, make sure:

• Your app is using a supported version of Capacitor (4.0 or newer)
• quickstart panduan cepat langkah-langkah dalam urutan, termasuk sinkronisasi aplikasi setelah menginstal SDK

Pengintegrasian CI/CD

Untuk masalah dengan mengaktifkan unggahan Capgo dari pipeline CI/CD Anda:

• Periksa kembali 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 Pengintegrasian CI/CD docs 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.

Teruskan dari Pengaturan

Jika Anda menggunakan Troubleshooting untuk merencanakan penyimpanan dan pengelolaan file, hubungkannya dengan @capgo/capacitor-data-storage-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, Menggunakan @capgo/capacitor-data-storage-sqlite untuk kemampuan asli di Menggunakan @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file untuk detail implementasi di @capgo/capacitor-file, Menggunakan @capgo/capacitor-file untuk kemampuan asli di Menggunakan @capgo/capacitor-file, dan @capgo/capacitor-uploader untuk detail implementasi di @capgo/capacitor-uploader.