Mengatasi Masalah

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

🚀 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 Anda.

Dapatkan Dukungan Profesional

Gagal Unggah

Jika unggahan bundel Anda gagal, periksa kembali:

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

Opsi Unggah Lanjutan

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 pada koneksi yang tidak stabil, pertimbangkan menggunakan Jendela terminal --tus:

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

• --package-json : Menginformasikan __CAPGO_KEEP_0__ tempat root Anda --node-modules: Tells Capgo where to find your root package.json jika aplikasi Anda menggunakan struktur non-standar seperti monorepo atau __CAPGO_KEEP_0__ workspace. Pasang path ke root node_modules if your app uses a non-standard structure like a monorepo or npm workspace. Pass the path to the root package.json __CAPGO_KEEP_1__ --node_modules path:

  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 tambahan.

Mengatasi Masalah Pembaruan

Jika Anda mengalami masalah dengan update secara langsung, perintah debug Capgo adalah alat yang sangat membantu 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 update (misalnya, membuka aplikasi setelah mengunggah bundle baru).

3. Amati keluaran perintah debug. Perintah tersebut akan mencatat informasi tentang proses update, termasuk:

   • Ketika aplikasi memeriksa update
   • Jika ditemukan update dan versi apa yang ditemukan
   • Progress download dan instalasi update
   • Apapun kesalahan yang terjadi selama proses update

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

   • If tidak ada pembaruan ditemukan, pastikan bundle Anda telah diunggah dengan sukses dan aplikasi telah dikonfigurasi untuk menggunakan saluran yang benar.
   • If pembaruan diunduh tetapi tidak terinstal, pastikan Anda telah memanggil CapacitorUpdater.notifyAppReady() dan bahwa aplikasi telah ditutup sepenuhnya dan dibuka kembali.
   • If 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 diaplikasikan secara akhir, fokuslah pada langkah-langkah setelah download.

Pengembangan dengan Log Nativ

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

Log Android

Untuk mengakses log Android:

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

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

Log Capgo SDK akan mencatat event kunci selama proses pembaruan, seperti:

• Ketika pembaruan cek dilakukan
• Jika pembaruan ditemukan dan versi apa saja
• Ketika download pembaruan dimulai dan selesai
• Ketika instalasi pembaruan dipicu
• Apabila terjadi kesalahan selama langkah-langkah pembaruan native

Masalah Android umum yang mungkin Anda lihat di log termasuk:

• Masalah koneksi jaringan yang menghalangi download pembaruan
• Kesalahan hak akses file ketika menyimpan atau membaca paket pembaruan
• Kosongnya ruang penyimpanan untuk paket pembaruan
• Gagal memulai 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 termasuk Capgo untuk mencari log SDK

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

Sama seperti Android, Capgo SDK akan mencatat acara-acara penting di sisi iOS:

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

Masalah iOS yang mungkin Anda identifikasi dalam log termasuk:

• Masalah sertifikat SSL ketika mendownload update
• App transport keamanan menghalangi unduh update
• Tidak cukup ruang penyimpanan untuk paket update
• Gagal mengekstrak atau menerapkan paket update

Catatan Log Electron

Untuk aplikasi Electron, periksa baik proses utama maupun proses renderer output:

1. Jalankan aplikasi Electron dari terminal Anda menggunakan perintah peluncuran normal (misalnya bun run electron:dev atau bun run electron:serve) dan amati output terminal untuk startup, cek update, dan kesalahan jaringan.
2. Buka DevTools di jendela renderer (Lihat → Toggle Developer Tools) dan inspeksi log konsol dan permintaan jaringan gagal saat mereproduksi alur update.
3. Untuk aplikasi terpakai, periksa alat log OS untuk kegagalan atau kegagalan startup:
   • macOS: buka Console.app dan filter berdasarkan nama aplikasi Anda
   • Windows: buka Penglihatan Acara → Log Windows → Aplikasi
   • Linux: gunakan penglihatan 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 lifecycle update.

Di seluruh 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.

Ketika mengatasi masalah update hidup yang sulit, sebaiknya Anda mencatat baik log debug Capgo dan log asli untuk mendapatkan gambaran yang lebih komprehensif tentang apa yang sedang terjadi. Kedua log bersamaan akan memberikan Anda kesempatan terbaik untuk mengidentifikasi dan menyelesaikan masalah.

Pengaturan tidak berlaku

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

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

Referensi ke mengaktifkan update hidup Petunjuk untuk detail lebih lanjut tentang proses pembaruan. Jika Anda masih bingung, gunakan perintah dan log asli untuk mendapatkan visibilitas lebih tentang apa yang sedang terjadi. npx @capgo/cli@latest app debug Perintah dan log asli untuk mendapatkan visibilitas lebih tentang apa yang sedang terjadi.

Kode kesalahan pembaruan umum

Jika log Anda menampilkan kesalahan backend seperti Cloudflare, atau GitHub, gunakan panduan khusus: disable_auto_update_to_major, semver_errorMasalah Pembaruan Umum cannot_update_via_private_channelPanduan tersebut menjelaskan apa masing-masing kode __CAPGO_KEEP_0__ berarti, mengapa terjadi, dan bagaimana mengatasinya.

• __CAPGO_KEEP_0__ Pemasangan

Bagian berjudul “code Pemasangan”

Jika Anda mengalami kesulitan memasang SDK __CAPGO_KEEP_1__, pastikan:

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

• Aplikasi Anda menggunakan versi yang didukung dari Capacitor (4.0 atau lebih baru)
• Anda telah mengikuti langkah-langkah "quickstart" dalam urutan yang benar, termasuk sinkronisasi aplikasi setelah menginstal __CAPGO_KEEP_0__ quickstart steps in order, including syncing your app after installing the SDK

Bagian berjudul “Integrasi CI/CD”

Periksa ulang token autentikasi Capgo Anda telah disetel dengan benar

• Double check your Capgo authentication token is set up correctly
• Periksa bahwa perintah unggah menggunakan nama saluran yang benar untuk lingkungan target Anda
• Lihat "integrasi CI/CD"

Integrasi CI/CD Bagian berjudul “Integrasi 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 Anda diterima oleh aplikasi.

Teruskan dari Troubleshooting

Jika Anda menggunakan Troubleshooting untuk merencanakan penyimpanan dan pengelolaan file, hubungkan dengan @capgo/capacitor-penyimpanan-data-sqlite untuk detail implementasi di @capgo/capacitor-penyimpanan-data-sqlite, Menggunakan @capgo/capacitor-penyimpanan-data-sqlite untuk kemampuan asli di Menggunakan @capgo/capacitor-penyimpanan-data-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.