Pengaturan Tambahan

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

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 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 terupdate

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 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 Anda --node-modules: Tells Capgo where to find your root package.json and node_modules Jika aplikasi Anda menggunakan struktur non-standar seperti monorepo atau npm workspace. Berikan jalur ke root package.json dan --node_modules jalur:
Fenster Terminal
```
npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules
```
Capgo membutuhkan informasi ini untuk mempacking kembali dependensi aplikasi Anda dengan benar.

Anda dapat menggabungkan flag-flag ini dengan opsi lain seperti --channel sebagaimana diperlukan. Lihat Capgo CLI dokumen untuk mendapatkan 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 memicu pembaruan (misalnya, membuka kembali 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 pengunduhan dan instalasi pembaruan
- Apabila terjadi kesalahan selama proses pembaruan
Menggunakan 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 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 pada sisi native proses pembaruan.

Log Android

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

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 diinisiasi
Jika pembaruan ditemukan dan versi apa itu
When proses update dimulai dan selesai
Ketika proses 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 untuk bundle update
Gagal melakukan restart 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 output konsol, cari baris yang mencakup 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 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 dalam log termasuk:

Masalah sertifikat SSL ketika mengunduh pembaruan
App transport keamanan menghalangi pengunduhan pembaruan
Ketersediaan ruang penyimpanan yang tidak cukup untuk bundle pembaruan
Gagal mengekstrak atau menerapkan bundle pembaruan

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:servedan amati keluaran terminal untuk proses awal, periksa pembaruan, dan kesalahan jaringan.
Terbuka DevTools di jendela renderer (Lihat → Toggle Developer Tools) dan inspeksi log konsol dan permintaan jaringan yang gagal saat mereproduksi alur pembaruan.
Aplikasi terpaket, cek alat log OS untuk kegagalan atau gagal startup:
- 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

Mengatasi masalah saat debugging update, bandingkan pesan dari log proses utama dan proses renderer untuk memisahkan masalah bootstrapping Electron dari masalah siklus update Capgo.

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.

Mengatasi masalah update hidup yang sulit, ide yang baik adalah mencapai 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 saat menerapkan update
Pengaturan Tidak Berlaku

Refer to the mengupdate aplikasi secara langsung guide untuk mendapatkan informasi lebih lanjut tentang proses update. Jika Anda masih mengalami masalah, gunakan npx @capgo/cli@latest app debug perintah dan log native untuk mendapatkan visibilitas yang lebih baik tentang apa yang sedang terjadi.

Kode Gagal Update yang 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 Update Umum

Itu menjelaskan apa masing-masing kode code berarti, mengapa hal itu terjadi, dan bagaimana cara memperbaikinya.

SDK Instalasi

Jika Anda mengalami kesulitan saat memasang Capgo SDK, pastikan:

Aplikasi Anda menggunakan versi yang didukung dari Capacitor (4.0 atau lebih baru)
Anda telah mengikuti langkah-langkah cepat dalam urutan yang benar, termasuk sinkronisasi aplikasi setelah memasang __CAPGO_KEEP_0__ Integrasi CI/CD steps in order, including syncing your app after installing the SDK

Pemasangan berjudul “Integrasi CI/CD”

Periksa kembali token autentikasi Capgo yang telah Anda tetapkan dengan benar

Double check your Capgo authentication token is set up correctly
Periksa bahwa perintah unggahan menggunakan nama saluran yang tepat untuk lingkungan target Anda
__CAPGO_KEEP_0__ Pemasangan

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 Bagian Troubleshooting

Jika Anda menggunakan 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 Bantuan Policy Troubleshooting). @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, dan menggunakan @capgo/capacitor-data-storage-sqlite untuk kemampuan native di Menggunakan @capgo/capacitor-penyimpanan-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.