Mengatasi Masalah

Salin prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

Here are some common issues you might encounter while using Capgo and how to resolve them.

🚀 Butuh Bantuan Ahli?

Terjebak dengan masalah kompleks? Tim ahli kami ada untuk membantu! Dapatkan dukungan yang disesuaikan, 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 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

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

--tusMenggunakan __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ menyediakan beberapa flag tambahan untuk membantu dengan masalah unggah umum: : Menggunakan protokol unggah __CAPGO_KEEP_0__ yang dapat diresume 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 untuk menggunakan Jendela Terminal --tus:
Salin ke papan klip
```
npx @capgo/cli@latest bundle upload --tus
```
--package-json : Menginformasikan __CAPGO_KEEP_0__ tempat untuk mencari root --node-modules: Tells Capgo where to find your root package.json jika aplikasi Anda menggunakan struktur yang tidak standar seperti monorepo atau __CAPGO_KEEP_0__ workspace. Pasang jalur 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 translations.11 --node_modules translations.12
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 sesuai kebutuhan. Lihat dokumen Capgo CLI untuk informasi lengkap tentang opsi unggah yang tersedia.

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

Mengatasi Masalah Pembaruan

Jika Anda mengalami masalah dengan pembaruan live, perintah debug Capgo adalah alat yang sangat membantu untuk menyelesaikan masalah. Untuk menggunakan perintah ini:

Jalankan perintah berikut di direktori proyek Anda:
Jendela terminal
```
npx @capgo/cli@latest app debug
```
Luncurkan aplikasi Anda di perangkat atau emulator dan lakukan aksi yang seharusnya memicu pembaruan (misalnya, membuka kembali aplikasi setelah mengunggah bundle baru).
Amati keluaran perintah debug. Perintah ini akan mencatat informasi tentang proses pembaruan, termasuk:
- Ketika aplikasi memeriksa pembaruan
- Jika pembaruan ditemukan dan versi apa yang ditemukan
- Progress download dan instalasi pembaruan
- Apapun kesalahan yang terjadi selama proses pembaruan
Gunakan log debug untuk mengidentifikasi di mana masalah terjadi. Misalnya:
- Jika tidak ada pembaruan yang 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 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 diaplikasikan secara akhir, fokuslah pada langkah-langkah setelah download.

Menggunakan 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:

Hubungkan perangkat Anda atau mulai emulator Anda
Buka Android Studio dan pilih “Lihat > Jendela Alat > Logcat”
Ini adalah jendela Logcat, filter log untuk hanya proses aplikasi Anda dengan memilihnya dari dropdown di atas
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:

Saat pembaruan cek dilakukan
Jika pembaruan ditemukan dan versi apa saja
Saat pembaruan download dimulai dan selesai
Saat pembaruan instalasi dipicu
Apapun kesalahan yang terjadi selama langkah pembaruan native

Masalah Android spesifik yang mungkin Anda lihat di log termasuk:

Masalah koneksi jaringan yang menghalangi download update
Error hak akses file ketika menyimpan atau membaca paket update
Tidak ada ruang penyimpanan untuk paket update
Gagal memulai aplikasi setelah update terpasang

Log iOS

Untuk mengakses log iOS:

Hubungkan perangkat Anda atau mulai simulator Anda
Buka Xcode dan pergi ke “Jendela > Perangkat dan Simulator”
Pilih perangkat Anda dan klik pada “Buka Konsol”
Dalam output konsol, cari baris yang mencakup Capgo Untuk mencari log SDK

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

Sama seperti Android, Capgo SDK akan mencatat event iOS yang penting:

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 temukan di log termasuk:

Masalah sertifikat SSL ketika mendownload update
App transport security menghalangi download update
Ruangan penyimpanan tidak cukup untuk paket pembaruan
Gagal mengekstrak atau menerapkan paket pembaruan dengan benar

Log Electron

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

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, periksa pembaruan, dan kesalahan jaringan.
Buka DevTools di jendela renderer (Lihat → Aktifkan Alat Pembangun) dan inspeksi log konsol dan permintaan jaringan gagal saat mereproduksi alur pembaruan.
Untuk aplikasi terpakai, periksa alat log OS untuk kegagalan atau kegagalan startup:
- macOS: buka Console.app dan filter pada nama aplikasi Anda
- Windows: buka Pengelihatan 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 siklus hidup 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.

Perubahan tidak berlaku

Jika Anda telah mengunggah 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 didownload
Coba menutup sepenuhnya dan membuka aplikasi kembali, karena perubahan hanya diterapkan pada peluncuran baru
Cari kesalahan dalam log native yang mungkin menunjukkan masalah dalam menerapkan update

Referensi ke mengaktifkan perubahan hidup panduan untuk informasi lebih lanjut tentang proses update. Jika Anda masih mengalami masalah, gunakan npx @capgo/cli@latest app debug Perintah dan log asli untuk mendapatkan visibilitas lebih banyak tentang apa yang sedang terjadi.

Kode gagal pembaruan umum

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

Pembaruan Umum Umum

Itu menjelaskan apa yang setiap kode pembaruan umum code berarti, mengapa terjadi, dan bagaimana mengatasinya.

Pemasangan SDK

Jika Anda mengalami kesulitan memasang Capgo SDK, pastikan:

Aplikasi Anda menggunakan versi Capacitor yang didukung (4.0 atau lebih baru)
Anda telah mengikuti langkah-langkah cepat mulai 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 kembali token autentikasi Capgo Anda telah disetel dengan benar

Double check your Capgo authentication token is set up correctly
Periksa bahwa perintah unggahan menggunakan nama saluran yang benar untuk lingkungan target Anda
Lihat bagian

integrasi CI/CD dokumen untuk tips troubleshooting lebih lanjut. Anda juga dapat menggunakan 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.

Lanjutkan dari Troubleshooting

Jika Anda menggunakan Troubleshooting untuk merencanakan penyimpanan dan pengelolaan file, hubungkan 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.