Mengatasi Masalah

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

Berikut beberapa masalah 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 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 terkini

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 untuk 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 clipboard
```
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 yang tidak 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_0__ --node_modules path:
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 masalah dengan unggah, hubungi Capgo dukungan untuk bantuan lebih lanjut.

Mengatasi Masalah Pembaruan

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

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 update (misalnya, membuka kembali aplikasi setelah mengunggah bundle baru).
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
Gunakan log debug untuk mengidentifikasi di mana masalah terjadi. Misalnya:
- Jika tidak ada update yang ditemukan, pastikan bundle Anda telah diunggah dengan sukses dan aplikasi telah dikonfigurasi untuk menggunakan saluran yang benar.
- Jika update 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 tersebut di dokumen Capgo atau hubungi dukungan untuk bantuan.

Perintah debug sangat berguna untuk mengidentifikasi masalah dengan proses download dan instalasi update. Jika log menunjukkan versi update yang diharapkan ditemukan tetapi tidak diaplikasikan secara akhir, fokuslah pada langkah-langkah setelah download.

Menggunakan 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 update.

Log Android

Untuk mengakses log Android:

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

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

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

Ketika pembaruan diinisiasi
Jika pembaruan ditemukan dan versi apa yang digunakan
Ketika proses download pembaruan dimulai dan selesai
Ketika proses instalasi pembaruan diaktifkan
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:

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

Anda juga dapat menggunakan log stream perintah di terminal dan gunakan grep untuk Capgo untuk memfilter log.

Mirip dengan Android, Capgo SDK akan mencatat acara-acara penting di sisi iOS:

Pengecekan update dimulai dan hasilnya
Mulai, kemajuan, dan selesai download
Trigger 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 keamanan menghalangi unduh update
Ruangan penyimpanan tidak cukup untuk paket update
Gagal mengekstrak atau menerapkan paket update dengan benar

Log Electron

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

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.
Buka DevTools di jendela renderer (Lihat → Toggle Developer Tools) dan inspeksi log konsol dan permintaan jaringan gagal saat mereproduksi alur update.
Untuk aplikasi terpakai, periksa alat log OS untuk kegagalan atau kegagalan startup:
- macOSMembuka : Console.app dan filter berdasarkan nama aplikasi Anda
- WindowsMembuka : 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, baiknya 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.

Tidak ada aplikasi update

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

Pastikan Anda telah memanggil CapacitorUpdater.notifyAppReady() dalam aplikasi code seperti yang ditunjukkan pada quickstart
Periksa apakah perangkat Anda terhubung ke internet dan log debug Capgo menunjukkan bahwa update telah diunduh
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 informasi lebih lanjut tentang proses pembaruan. Jika Anda masih bingung, gunakan perintah dan log native untuk mendapatkan visibilitas lebih tentang apa yang terjadi. npx @capgo/cli@latest app debug Kode Gagal Pembaruan Umum

Bab berjudul “Kode Gagal Pembaruan Umum”

atau disable_auto_update_to_major, semver_errorguna petunjuk khusus: cannot_update_via_private_channelMasalah Pembaruan Umum

Itu menjelaskan apa masing-masing __CAPGO_KEEP_0__ berarti, mengapa terjadi, dan bagaimana mengatasinya.

code Pemasangan

Bab berjudul “SDK Pemasangan”

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

Aplikasi Anda menggunakan versi yang didukung dari Capacitor (4.0 atau lebih baru)
Kamu telah mengikuti langkah-langkah quickstart untuk memastikan aplikasi Anda berjalan dengan baik, 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 unggahan setelah aset web Anda telah dibangun
Periksa apakah perintah unggahan menggunakan nama saluran yang benar untuk lingkungan target Anda

Lihatlah 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 Anda diterima oleh aplikasi.

Lanjutkan 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 native 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.