Pengaturan Bantuan

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

🚀 Butuh Bantuan Ahli?

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

Dapatkan Dukungan Profesional

Gagal Unggah

Jika unggahan bundle gagal, periksa kembali:

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

Opsi unggah lanjutan

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

• --tus: Menggunakan protokol unggah __CAPGO_KEEP_0__ yang dapat diresume : Untuk unggah yang lebih andal 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 : Menunjukkan ke __CAPGO_KEEP_0__ tempat root --node-modules: Tells Capgo where to find your root package.json dan node_modules Jika aplikasi Anda menggunakan struktur non-standar seperti monorepo atau npm workspace. Berikan jalur ke root package.json dan --node_modules jalur:

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

  Capgo membutuhkan informasi ini untuk memperbaiki pengemasan dependensi aplikasi Anda.

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

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

Debugging Pembaruan

Jika Anda mengalami masalah dengan pembaruan live, perintah debug Capgo adalah alat yang berguna untuk menyelesaikan 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 mengaktifkan pembaruan (misalnya, membuka kembali aplikasi setelah mengunggah bundle baru).

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

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

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

   • Jika tidak ada pembaruan yang ditemukan, pastikan bundel Anda telah diunggah dengan sukses dan aplikasi telah dikonfigurasi untuk menggunakan saluran yang benar.
   • Jika pembaruan berhasil diunduh tetapi tidak terinstal, pastikan Anda telah memanggil CapacitorUpdater.notifyAppReady() dan aplikasi telah ditutup sepenuhnya dan dibuka kembali.
   • Jika Anda melihat pesan kesalahan, cari informasi tentang kesalahan tersebut di dokumen Capgo 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.

Penggunaan Log Natively

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

Log Android

To akses 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-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:

• Saat pembaruan cek dilakukan
• Jika pembaruan ditemukan dan versi apa yang itu
• Ketika proses download update dimulai dan selesai
• Ketika proses instalasi update diaktifkan
• Semua kesalahan yang terjadi selama langkah-langkah update native

Masalah umum Android yang mungkin Anda lihat di log termasuk:

• Masalah koneksi jaringan yang menghalangi proses download update
• Kesalahan hak akses file ketika menyimpan atau membaca bundle update
• Kurangnya ruang penyimpanan untuk bundle update
• Gagal memulai aplikasi setelah update terpasang

Log iOS

Untuk mengakses log iOS:

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

Anda juga dapat menggunakan log stream perintah di terminal dan cari untuk memfilter log. Capgo Mirip dengan Android, __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ akan mencatat acara utama iOS:

Similar to Android, the Capgo SDK will log key iOS-side events:

• Mulai download, kemajuan, dan selesai
• Trigger instalasi dan hasilnya
• Apapun kesalahan selama proses update native
• Pilih perangkat Anda dan klik pada ‘Buka Konsol’

Masalah iOS yang mungkin Anda temukan dalam log termasuk:

• Masalah sertifikat SSL ketika mengunduh pembaruan
• App transport keamanan menghalangi pengunduhan pembaruan
• Tidak ada ruang penyimpanan yang cukup 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 Anda (misalnya bun run electron:dev atau bun run electron:serveUntuk aplikasi Electron, periksa keluaran proses utama dan proses renderer:
2. Jalankan aplikasi Electron dari terminal Anda menggunakan perintah peluncuran normal Anda (misalnya
3. Aplikasi terpakai, periksa alat log sistem operasi untuk kegagalan atau kegagalan saat startup:
   • macOS: buka Console.app dan filter berdasarkan nama aplikasi Anda
   • Windows: buka Penglihatan Acara → Log Windows → Aplikasi
   • context: Definisi Aplikasi (parent key `application_definition`). Halaman/area: Situs web pemasaran Capgo. Peran: Kalimat deskripsi situs web. Dilihat di: halaman disclaimer.astro. Kunci pesan `application_definition` (Definisi Aplikasi).Linux journalctl : gunakan penglihatan log desktop Anda atau

When debugging updates, compare messages from both main-process and renderer-process logs to separate Electron bootstrap issues from Capgo update lifecycle issues.

Across platforms, the native logs provide a lower-level view into the update process, with more details on the native implementation. They are especially useful for identifying issues that occur outside of the Capgo JavaScript layer.

When troubleshooting a tricky live update problem, it’s a good idea to capture both the Capgo debug logs and the native logs for a comprehensive picture of what’s happening. The two logs together will give you the best chance of identifying and resolving the issue.

Mastikan Anda telah memanggil

seperti yang ditunjukkan dalam

• quickstart CapacitorUpdater.notifyAppReady() in your app code as shown in the menunjukkan pembaruan telah diunduh
• Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
• Cari kesalahan dalam log native yang mungkin menunjukkan masalah dalam menerapkan pembaruan
• Mengapa pembaruan tidak berjalan?

Referensi ke deploying live updates guide untuk informasi lebih lanjut tentang proses pembaruan. Jika Anda masih mengalami masalah, gunakan npx @capgo/cli@latest app debug command dan log native untuk mendapatkan visibilitas lebih lanjut tentang apa yang sedang terjadi.

Kode Gagal Pembaruan Umum

Jika log Anda menampilkan kesalahan backend seperti disable_auto_update_to_major, semver_erroratau cannot_update_via_private_channelgunakan panduan khusus:

• Masalah Pembaruan Umum

Itu menjelaskan apa masing-masing kode umum code berarti, mengapa terjadi, dan bagaimana mengatasinya.

SDK Pemasangan

Jika Anda mengalami kesulitan saat menginstal Capgo SDK, pastikan:

• Apakah aplikasi Anda menggunakan versi Capacitor yang didukung (4.0 atau lebih baru)
• Apakah Anda telah mengikuti langkah-langkah quickstart steps in order, including syncing your app after installing the SDK

termasuk sinkronisasi aplikasi setelah menginstal __CAPGO_KEEP_0__

For issues with triggering Capgo uploads from your CI/CD pipeline:

• Double check your Capgo authentication token is set up correctly
• Untuk masalah dengan mengaktifkan __CAPGO_KEEP_0__ unggahan ke pipeline CI/CD Anda:
• Periksa kembali token autentikasi __CAPGO_KEEP_0__ Anda telah terkonfigurasi dengan benar

Melihatlah 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 telah diterima oleh aplikasi.

Teruskan dari Troubleshooting

Jika Anda menggunakan Pengaturan Troubleshooting context: Halaman/area: Bantuan / halaman bantuan premium atau bagian bantuan di footer. Peran: Judul bagian atau halaman. Dilihat di: halaman support-policy.astro. Kunci pesan `support_policy_troubleshooting_title` (Judul Pengaturan Bantuan) @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, untuk kemampuan native di Menggunakan @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file untuk detail implementasi di @capgo/capacitor-file, Menggunakan @capgo/capacitor-file untuk kemampuan native di Menggunakan @capgo/capacitor-file, dan @capgo/capacitor-uploader untuk detail implementasi di @capgo/capacitor-uploader.