Pengaturan Bantuan

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

Ini adalah 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 lagi:

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 diulang (tus resumable upload protocol) untuk unggah yang lebih dapat diandalkan untuk bundle besar atau koneksi jaringan yang buruk. Jika bundle Anda melebihi 10MB atau Anda sedang mengalami koneksi yang tidak stabil, pertimbangkan menggunakan Jendela terminal --tus:
Salin ke clipboard
```
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 context node_modules Jika aplikasi Anda menggunakan struktur non-standar seperti monorepo atau npm workspace. Berikan jalur ke root package.json dan --node_modules jalur:
Fenester 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 koreksi 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.

Pengembangan Pembaruan

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

Jalankan perintah berikut di direktori proyek Anda:
Tampilan jendela terminal
```
npx @capgo/cli@latest app debug
```
Luncurkan aplikasi Anda di perangkat atau emulator dan lakukan aksi yang seharusnya mengaktifkan pembaruan (misalnya, membuka aplikasi setelah mengunggah bundle baru).
Amati keluaran perintah debug. Perintah tersebut akan mencatat 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
Pergunakan 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 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 spesifik 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 natively pada Android, iOS, dan Electron dapat memberikan informasi troubleshooting yang berharga, terutama untuk masalah pada sisi native proses pembaruan.

Log Android

Untuk mengakses log Android:

Hubungkan perangkat Anda atau mulai emulator Anda
Buka Android Studio dan pilih "View > Tool Windows > 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

Atau, 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 cek dilakukan
Jika pembaruan ditemukan dan versi apa
When proses update dimulai dan selesai
When instalasi update diaktifkan
Apapun kesalahan yang terjadi selama proses 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
Tidak ada ruang penyimpanan yang cukup untuk bundle update
Gagal memulai aplikasi setelah update terpasang

Log iOS

Untuk mengakses log iOS:

Hubungkan perangkat Anda atau mulai simulator Anda
Terbuka Xcode dan pergi ke ‘Jendela > Perangkat dan Simulator’
Pilih perangkat Anda dan klik pada ‘Buka Konsol’
Pada keluaran konsol, cari baris-baris yang termasuk Capgo untuk menemukan log SDK

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

Mirip dengan Android, Capgo SDK akan mencatat acara utama 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 dalam log termasuk:

Masalah sertifikat SSL ketika mengunduh update
App transport keamanan menghalangi pengunduhan update
Tidak ada ruang penyimpanan yang cukup untuk bundle update
Gagal mengekstrak atau menerapkan bundle update

Log Electron

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

Jalankan aplikasi Electron dari terminal Anda menggunakan perintah peluncuran normal Anda (misalnya bun run electron:dev atau bun run electron:serveUntuk aplikasi-aplikasi Electron, periksa keluaran proses utama dan proses renderer:
Jalankan aplikasi Electron dari terminal Anda menggunakan perintah peluncuran normal Anda (misalnya
Aplikasi terpaket, periksa alat log OS untuk kegagalan atau gagal memulai:
- macOS: buka Console.app dan filter pada 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

Ketika 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 layer JavaScript Capgo.

Ketika troubleshooting 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. Kedua log bersamaan akan memberikan Anda kesempatan terbaik untuk mengidentifikasi dan menyelesaikan masalah.

Pengaturan Tidak Berlaku

Pastikan Anda telah memanggil

di aplikasi Anda __CAPGO_KEEP_0__ seperti yang ditunjukkan di CapacitorUpdater.notifyAppReady() in your app code as shown in the Periksa apakah perangkat Anda terhubung ke internet dan log debug __CAPGO_KEEP_0__ menunjukkan bahwa update telah didownload
Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
Cari kesalahan di log native yang mungkin menunjukkan masalah dalam menerapkan update
Pengaturan Tidak Berlaku

Referensi ke mengupdate live untuk informasi lebih lanjut tentang proses pembaruan. Jika Anda masih mengalami masalah, gunakan npx @capgo/cli@latest app debug perintah 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_error, atau cannot_update_via_private_channel, gunakan panduan khusus:

Masalah Pembaruan Umum

Itu menjelaskan apa yang setiap code umum berarti, mengapa hal itu terjadi, dan bagaimana mengatasinya.

SDK Instalasi

Jika Anda mengalami masalah saat menginstal Capgo SDK, pastikan:

Apakah aplikasi Anda menggunakan versi Capacitor yang didukung (4.0 atau lebih baru)?
Apakah Anda telah mengikuti langkah-langkah __CAPGO_KEEP_2__ dengan benar, termasuk sinkronisasi aplikasi setelah menginstal __CAPGO_KEEP_0__ Pengintegrasian CI/CD steps in order, including syncing your app after installing the SDK

Untuk masalah terkait pengaktifan unggahan __CAPGO_KEEP_0__ dari pipeline CI/CD Anda:

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

Double check your Capgo authentication token is set up correctly
Integrasi CI/CD
Pengintegrasian CI/CD

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