Capacitor CLI: Panduan Pengaturan Proyek

Ingin membuat aplikasi iOS dan Android dengan satu basis kode? Capacitor CLI simplifies the process, letting you create native apps using web technologies. Here’s what you’ll learn:

Penyiapan Cepat: Pasang Capacitor CLI dan inisialisasi proyek Anda dalam beberapa menit.
Pengintegrasian Platform: Tambahkan dukungan iOS dan Android dengan perintah sederhana.
Update Langsungcontext: Halaman/area: Bagian utama halaman masalah/solusi. Peran: Judul bagian atau halaman. Dilihat di: halaman premium-support.astro. Pesan kunci `ps_help_updates_title` (Ps Bantuan Update Judul). Capgo Sistem __CAPGO_KEEP_0__
context: Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `submitting_a_pr_to_capgo`). Halaman/area: Situs web pemasaran Capgo. Peran: Kalimat teks situs web. Dilihat di: halaman berkontribusi. Astro. Simpanlah istilah produk/merek dan istilah pengembang secara tepat. Kunci pesan `submitting_a_pr_to_capgo` (Mengirimkan PR ke Capgo).untuk mendapatkan update secara langsung melalui udara.

Pemecahan Masalah Umum (Common Fixes) : Atasi masalah seperti kesalahan sinkronisasi atau gagal bangun proyek.

Instal Pembaruan Node.js, npm, JDK, Xcode, dan Studio Android.
Jalankan npm install @capacitor/core @capacitor/cli dan inisialisasi proyek Anda.
Tambahkan platform iOS dan Android menggunakan npx cap add ios dan npx cap add android.
Pilihan: Atur Capgo untuk pembaruan aplikasi hidup app updates.

Petunjuk ini mencakup semua yang Anda perlukan untuk mengatur Capacitor CLI, mengonfigurasi platform, dan mengirimkan aplikasi Anda. Mari kita mulai!

Menyambut Capacitor Konfigurasi

Capacitor Dokumentasi Framework Website

Persyaratan Pengaturan

Untuk memulai, pastikan Anda telah menginstal alat-alat berikut:

Node.js (versi 14 atau lebih baru) dan npm
Paket JDK Java atau lebih baru
Xcode atau lebih baru untuk pembangunan iOS
Android Studio untuk pembangunan Android
Capacitor CLI atau versi 6 atau 7

Opsional: Jika Anda ingin mengaktifkan pembaruan secara langsung, lihat "Capgo Panduan Pengaturan""

CLI Langkah Pemasangan

Sebelum memulai, pastikan Anda memiliki Node.js, npm, JDK, Xcode, dan Android Studio sudah terinstal. Setelah siap, Anda dapat menginstal Capacitor CLI dengan menjalankan:

npm install --save @capacitor/core @capacitor/cli
npx cap init

Perintah ini menginstal Capacitor dan mengatur komponen inti.

Setelah menyelesaikan langkah ini, lanjutkan ke Membuat Proyek Baru untuk mengatur aplikasi Anda.

Membuat Projek Baru

Untuk memulai dengan projek Anda menggunakan Capacitor CLI, ikuti langkah-langkah berikut:

mkdir my-app && cd my-app
npm init -y
npx cap init my-app com.company.app --web-dir dist

Mengupdate File Konfigurasi

Edit file untuk mencakup pengaturan berikut: capacitor.config.json Setelah diperbarui, gunakan konfigurasi ini untuk mengatur __CAPGO_KEEP_0__ untuk projek Anda.

{
  "appId": "com.company.app",
  "appName": "My App",
  "webDir": "dist",
  "bundledWebRuntime": false,
  "server": {
    "hostname": "app.example.com",
    "androidScheme": "https"
  }
}

Once updated, use this configuration to set up Capacitor for your project.

Sekarang bahwa kerangka projek sudah selesai, saatnya untuk mengatur target iOS dan Android.

Mengambahkan iOS dan Android

Mulai dengan menginstal paket spesifik platform menggunakan __CAPGO_KEEP_0 CAPGO_KEEP_1__:

Start by installing the necessary platform-specific packages using the Capacitor CLI:

npm install @capacitor/ios @capacitor/android
npx cap add ios
npx cap add android

Untuk iOS, pastikan Anda memiliki Xcode 14 atau lebih baru, CocoaPods 1.11 atau lebih baru, dan macOS 12 atau lebih tinggi. Untuk Android, Anda memerlukan Android Studio Giraffe (2022.3.1+), JDK 17 atau lebih baru, dan Gradle 7.5 atau di atas.

Setelah terinstal, Anda perlu memastikan target native Anda diperbarui dengan perubahan pada aplikasi web Anda.

Pembaruan Platform

Untuk sinkronkan platform Anda dengan perubahan web terbaru, ikuti langkah-langkah berikut setelah memperbarui aplikasi web Anda:

npm run build
npx cap sync

Perintah ini mengelola dua tugas: cap sync Mengcopy aset web yang diperbarui ke platform native

Mengupdate konfigurasi dan plugin native untuk menyesuaikan perubahan terbaru
Mengupdate konfigurasi dan plugin native untuk menyesuaikan perubahan terbaru

Konfigurasi IDE

Terbuka proyek platform khusus di IDE yang sesuai:

npx cap open ios     # Opens Xcode
npx cap open android # Opens Android Studio

In Xcode:

Pilih tim pengembangan Anda.
Konfigurasi sertifikat tanda tangan.
Perbarui identifikasi paket Anda.

In Android Studio:

Ubah ID aplikasi. build.gradle.
Konfigurasi keystore untuk tanda tangan.
Konfigurasi varian pembangunan debug dan release.

Setelah semua dikonfigurasi, bangun proyek menggunakan npx cap build ios atau npx cap build androidJangan lupa menjalankan npx cap sync lagi untuk memastikan semua aset sudah terkini.

Capgo Panduan Pengaturan

Capgo Dashboard Update Langsung

Set up Capgo untuk memungkinkan pembaruan instan secara daring untuk aplikasi Anda.

Fitur Utama Capgo

Capgo menawarkan beberapa alat untuk mempercepat pembaruan aplikasi:

Enkripsi Akhir ke Akhir menggunakan pengiriman pembaruan yang aman.
Pembaruan berjalan di latar belakang ketika aplikasi diluncurkan.
Alat analitik membantu mengukur tingkat kesuksesan pembaruan dan partisipasi pengguna.
A mengembalikan ke versi sebelumnya menggunakan opsi ini dapat memungkinkan Anda untuk segera mengembalikan ke versi sebelumnya dari pembaruan yang bermasalah.
Gunakan sistem saluran untuk peluncuran perangkat lunak dan pengujian beta. Menginstal __CAPGO_KEEP_0__

Ikuti langkah-langkah ini untuk memulai dengan Capgo:

Instal Capgo __CAPGO_KEEP_1__

Install the Capgo CLI:
```
npm install --save @capgo/cli
```
Mulai Capgo dalam proyek Anda:
```
npx capgo init
```
Bangun dan rilis pembaruan:
```
npm run build
npx capgo release
```
Buka aplikasi untuk mengaktifkan proses pembaruan latar belakang.

Praktik Terbaik

Pakai saluran untuk menguji pembaruan sebelum mengeluarkannya kepada semua pengguna.
Pantau analitis untuk memastikan pembaruan disampaikan dengan sukses dan pengguna tetap terlibat.
Aktifkan pelacakan kesalahan untuk menangkap dan memperbaiki masalah-masalah awal.
Siapkan fitur rollback untuk segera menangani masalah-masalah.

Capgo kompatibel dengan Capacitor 8, terintegrasi dengan baik dengan pipeline CI/CD, dan memenuhi persyaratan toko Apple dan Google.

Masalah Umum dan Tips

Saat Anda telah menyelesaikan pengaturan platform dan Capgo, Anda mungkin menghadapi beberapa kesalahan umum. Berikut cara menangani mereka dengan cepat.

Masalah Pengaturan Lingkungan

CLI Tidak Ditemukan Kesalahan: Perintah npx cap gagal. Pemecahan Masalah: Jalankan npm install --save @capacitor/cli @capacitor/core dan coba lagi.
Perbedaan Versi Node Kesalahan: Perintah CLI gagal karena kesalahan versi Node.js. Pemecahan MasalahInstal Node.js versi 14 atau lebih tinggi seperti yang dijelaskan dalam persyaratan pengaturan.

Masalah Pengaturan

Kesalahan Konfigurasi KesalahanPerubahan tidak efektif. capacitor.config.json Perbaiki Pastikan Anda telah mengaturdan appId Nilai harus sesuai dengan proyek Anda webDir dan folder keluaran web build. package.json Masalah Sinkronisasi Platform
Perubahan tidak efektif. Error: Berjalan npx cap sync results in plugin version conflicts. Fix: Perbarui @capacitor/android and @capacitor/ios context

Build and Deployment

Build Signing Failures Error: iOS atau Android build gagal karena sertifikat atau keystore hilang. Fix: Ikuti instruksi pengaturan IDE. Untuk iOS, tambahkan tim pengembangan Anda di Xcode. Untuk Android, konfigurasi keystore di build.gradle.
Direktori Web Tidak Ditemukan Error: npx cap sync tidak dapat menemukan aset web. Fix: Jalankan perintah build web Anda (misalnya, npm run build) sebelum sinkronisasi platform.

Issue Sinyal Hidup

Gagal Capgo Perbarui Error: Perbarui tidak muncul di aplikasi produksi. Fix: Periksa kembali __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ Anda. Capgo API kunci Anda di capacitor.config.json dan pastikan Anda mengarahkan ke saluran yang benar.

Untuk informasi lebih lanjut tentang pengaturan platform khusus, kunjungi bagian Pengaturan Platform. Jika Anda bekerja dengan pembaruan hidup, kunjungi Capgo Panduan Pengaturan untuk mendapatkan tips tambahan untuk memecahkan masalah.

Ringkasan

Ulasan Pengaturan

Mulai aplikasi web Anda dengan Capacitor CLI, atur platform iOS dan Android, dan secara opsional termasuk Capgo untuk pembaruan hidup.

Ini cara Anda untuk memulai:

Pakai Capacitor CLI untuk menginisialisasi proyek Anda.
Atur ID paket aplikasi Anda dan definisikan direktori keluaran web.
Tambahkan dukungan untuk platform iOS dan Android.
Instal dan atur Capgo dengan perintah berikut: npm install --save @capgo/cli && npx capgo init

Untuk instruksi pengaturan rinci atau troubleshooting, cek dokumentasi resmi Capacitor dan Capgo.

Teruskan dari Capacitor CLI: Panduan Pengaturan Proyek

Jika Anda menggunakan Capacitor CLI: Panduan Pengaturan Proyek untuk merencanakan dashboard dan operasi API, hubungkan dengan API Ringkasan untuk detail implementasi di API Ringkasan, __CAPGO_KEEP_2__ untuk detail implementasi di __CAPGO_KEEP_2__, API Keys for the implementation detail in API Keys, Perangkat untuk detail implementasi di Perangkat, dan Paket untuk detail implementasi di Paket.