Capacitor CLI membantu Anda mengubah aplikasi web menjadi aplikasi native iOS dan Android dengan satu basis kode. Berikut cara mengaturnya dengan cepat:
- Persyaratan Sebelumnya: Instal Node.js (v16+), npm, dan sebuah framework web (React, Vue, Angular, dll).
- Instal Capacitor CLI: Jalankan
npm install @capacitor/cli @capacitor/coredan inisialisasi proyek Anda dengannpx cap init. - Siapkan Platform: Tambahkan dukungan untuk platform iOS (
npx cap add ios) dan Android (npx cap add android) - Build dan Sync: Gunakan
npm run builddan untuk mentransfer aset web ke proyek native.npx cap syncPerbaruan Hidup Opsional - : Gunakan alat seperti__CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ mempercepat pengembangan dan pemeliharaan aplikasi. Ikuti panduan untuk setup dan troubleshooting yang lancar.
Capacitor CLI simplifies app development and maintenance. Follow the guide for smooth setup and troubleshooting.
__CAPGO_KEEP_0__ Capacitor + DaisyUI + __CAPGO_KEEP_0__ Dokumentasi Framework

Sebelum Anda Mulai
Pastikan lingkungan Anda siap dengan mengikuti langkah-langkah berikut:
Konfigurasi Node.js dan npm

Anda memerlukan Node.js versi 16 atau lebih tinggi. Versi LTS terbaru disarankan. Untuk memeriksa pengaturan Anda, jalankan:
node --version
npm --version
Jika Anda perlu mengupdate, download Node.js (yang termasuk npm) dari situs web resmi.
Setelah memastikan Node.js siap, pastikan proyek web Anda memenuhi persyaratan Capacitor yang diperlukan.
Periksa Proyek Web Anda
Proyek web Anda harus memiliki hal-hal berikut:
- A JSON yang valid: Pastikan sudah terkonfigurasi dengan baik.
- A direktori build: Ini adalah tempat aset web Anda berada (biasanya
distatauwww). - Poin masuk: Direktori build Anda harus mencakup sebuah
index.htmlfile.
Berikut adalah penjelasan singkat tentang package.json lapangan-lapangan penting:
| Lapangan Wajib | Contoh Nilai | Tujuan |
|---|---|---|
| nama | ”my-app” | Mengidentifikasi proyek |
| versi | ”1.0.0” | Mengatur versi aplikasi |
| direktori pembangunan | ”dist” atau “www” | Mengarah ke aset web |
Setelah Node.js dan proyek web Anda siap, lanjutkan ke instalasi perangkat lunak khusus platform.
Pasang Perangkat Lunak yang Diperlukan
Untuk Pengembangan Android:
- Unduh dan instal versi terbaru dari Studio Android.
- Atur SDK Android dengan setidaknya API tingkat 22.
- Konfigurasi variabel lingkungan.
ANDROID_HOMEUntuk Pengembangan iOS (Hanya Mac):
Pasang
-
Xcode atau versi yang lebih baru. 14 Pasang Alat Perintah Baris.
-
Gunakan
-
Homebrew __CAPGO_KEEP_0__ untuk menginstal CocoaPods:
brew install cocoapods -
Terima lisensi Xcode:
sudo xcodebuild -license accept
Saat mengintegrasikan Capgo nanti, pastikan Anda memiliki koneksi internet stabil dan sertifikat SSL yang valid.
Dengan langkah-langkah ini selesai, Anda sudah siap untuk proses pengembangan Capacitor yang lancar. Selanjutnya, Anda akan menginstal Capacitor CLI.
Menginstal Capacitor CLI
Dengan lingkungan Anda sudah siap, saatnya untuk menginstal dan mengkonfigurasi Capacitor CLI.
Tambahkan Paket Capacitor
Mulai dengan menginstal paket Capacitor CLI dan paket Core menggunakan npm:
npm install @capacitor/cli @capacitor/core
Setelah terinstal, konfirmasikan pengaturan dengan memeriksa Versi Capacitor CLI:
npx cap --version
Konfigurasi Proyek Anda
Inisialisasi Capacitor di proyek Anda dengan perintah berikut:
npx cap init
Selama inisialisasi, Anda akan diminta untuk memberikan detail-detail berikut:
| Pengaturan | Deskripsi | Contoh |
|---|---|---|
| Nama Aplikasi | Nama yang ditampilkan di toko aplikasi | ”My Awesome App” |
| Nama Aplikasi ID | Identifikasi unik untuk aplikasi Anda | ”com.mycompany.myapp” |
| Direktori Web | Jalur ke aset web Anda | dist |
Selanjutnya, update file konfigurasi Anda (capacitor.config.ts atau capacitor.config.json) dengan pengaturan yang relevan:
import { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = {
appId: 'com.mycompany.myapp',
appName: 'My Awesome App',
webDir: 'dist',
bundledWebRuntime: false
};
export default config;
Set Up iOS dan Android
Tambahkan dukungan untuk platform iOS dan Android dengan perintah-perintah ini:
npx cap add ios
npx cap add android
Ini akan menghasilkan proyek native:
- iOS: Membuat folder yang berisi proyek Xcode.
iosAndroid - : Membuat folder yang berisi proyek Android.Membuat folder untuk proyek Android Studio.
androidSetelah membuat perubahan pada aset web Anda, jalankan perintah-perintah berikut untuk membangun dan menyinkronkan:
Proses ini mengompilasi aset web Anda dan mentransfer mereka ke proyek native, termasuk plugin yang diinstal.
npm run build
npx cap sync
Untuk membuka proyek native untuk pengaturan lanjutan: Capacitor plugins.
Perbaiki Masalah Umum
npx cap open ios # Opens Xcode
npx cap open android # Opens Android Studio
Ketika mengatur __CAPGO_KEEP_0__ __CAPGO_KEEP_1__, Anda mungkin mengalami beberapa masalah umum. Berikut cara menanganinya:
Issues Gradle Android
When setting up Capacitor CLI, you might run into a few common hiccups. Here’s how to tackle them:
Navigasikan ke direktori Android dan hapus cache pembangunan:
Buka direktori Android dan hapus cache pembangunan:
-
Perbaiki Masalah Umum
cd android ./gradlew cleanBuildCache -
Update versi Gradle di
android/build.gradle:buildscript { ext { gradleVersion = '8.1.0' } } -
Tambahkan baris-baris berikut ke
android/gradle.propertiesuntuk kinerja yang lebih baik:org.gradle.jvmargs=-Xmx4608m org.gradle.parallel=true
Jika masalah tetap berlanjut, ulangi pengaturan Anda atau konsultasikan sumber daya troubleshooting tambahan.
Aplikasi Menampilkan Layar Kosong
Layar kosong biasanya menunjukkan masalah konfigurasi. Berikut cara menangani masalah ini:
-
Periksa Jalur Direktori Web: Pastikan
webDirsama dengan hasil output build.const config: CapacitorConfig = { webDir: 'dist', // Adjust if necessary }; -
Periksa Konfigurasi Server: Pastikan pengaturan server sudah benar.
server: { url: 'http://localhost:3000', cleartext: true } -
Perbarui Policy Keamanan Konten: Tambahkan tag meta ini ke HTML Anda untuk penggunaan sumber daya yang tepat.
<meta http-equiv="Content-Security-Policy" content="default-src 'self' 'unsafe-inline' 'unsafe-eval' data: *">
Plugin Tidak Berfungsi
Jika plugin tidak berperilaku seperti yang diharapkan, ikuti langkah-langkah berikut:
-
Lakukan instalasi bersih terhadap dependensi:
rm -rf node_modules npm cache clean --force npm install -
Periksa pengaturan plugin di
capacitor.config.tsuntuk memastikan mereka telah dikonfigurasi dengan benar:plugins: { PluginName: { option: 'value' } }
Bagi mereka yang menggunakan Capgo’s plugin native, maka secara otomatis akan menyinkronkan plugin dan mempertahankan konsistensi selama update.
Setelah menerapkan perbaikan-perbaikan ini, bangun kembali proyek Anda untuk memverifikasi perubahan:
npm run build && npx cap copy && npx cap sync
Setelah semuanya berjalan lancar, Anda dapat melanjutkan dengan menjelajahi opsi update hidup dengan Capgo.
Update Hidup dengan Capgo

Sederhanakan Pembaruan Aplikasi dengan menggunakan Capgo . Ini memungkinkan Anda untuk memasang pembaruan langsung ke pengguna, menghindari kebutuhan ulasan toko aplikasi.
Mulai dengan mudah. Pertama, instal paket yang diperlukan:
npm install @capgo/cli @capgo/capacitor-updater
npx cap sync
Kemudian, inisialisasi Capgo di proyek Anda:
npx @capgo/cli init
Rencana Harga
Capgo menawarkan beberapa tingkat rencana untuk memenuhi kebutuhan yang berbeda:
| Rencana | Pengguna Aktif Bulanan | Bandwith | Penyimpanan | Harga (Tahunan) |
|---|---|---|---|---|
| SOLO | 1,000 | 50 GB | 2 GB | $12/bulan |
| MAKER | 10,000 | 500 GB | 5 GB | $33/bulan |
| TEAM | 100,000 | 2,000 GB | 10 GB | $83/bulan |
Untuk pengguna bisnis, rencana PAYG dimulai dari $249/bulan dan termasuk kelebihan seperti akses API, domain kustom, dan dukungan dedikasi.
Konfigurasi untuk Update Langsung
Untuk mengaktifkan update langsung, tambahkan baris berikut ke file: capacitor.config.ts file:
{
plugins: {
CapacitorUpdater: {
autoUpdate: true,
updateUrl: 'https://api.capgo.app/updates'
}
}
}
Fitur Utama
Capgo menyediakan beberapa fitur unggulan:
- Pembaruan yang aman dengan enkripsi ujung-ke-ujung
- Pengembangan Otomatis melalui integrasi CI/CD
- Pembaruan yang Ditargetkan melalui pengasasan pengguna
- Rollback Instan dengan pengawasan versi
- Analitis Sempit Waktu untuk mengikuti pembaruan
Perintah Pengembangan
Uji pembaruan dalam pengembangan sebelum mengembangkannya secara langsung. Gunakan perintah berikut:
-
Kembangkan ke tahap uji:
npx @capgo/cli deploy --channel staging -
Kembangkan ke produksi:
npx @capgo/cli deploy --channel production
Capgo memastikan kinerja sesuai dengan pedoman Apple dan Android, sehingga pembaruan live Anda tidak akan mengancam pelanggaran toko aplikasi. Ini adalah cara yang efisien untuk mengelola Capacitor setelah instalasi.
Kesimpulan
Mengatur Capacitor CLI sangatlah mudah ketika Anda memiliki prasyarat yang tepat. Pengaturan ini memastikan pembaruan aplikasi yang lebih lancar dan alur kerja pengembangan yang lebih efisien.
Alat-alat modern membuat perawatan aplikasi lebih mudah daripada sebelumnya. Misalnya, Capgo sekarang menyediakan pembaruan waktu nyata, menggantikan metode yang lebih tua. Integrasi Capgo dengan instalasi CLI membuatnya menjadi pilihan yang bagus bagi para pengembang yang bekerja dengan aplikasi Capacitor.
Kesatu Ekosistem Capacitor selalu berkembang dengan alat-alat dan fitur baru. Menginstal CLI hanya merupakan titik awal untuk membangun aplikasi mobile, dan Anda akan mendapatkan dokumentasi yang rinci dan komunitas pengembang yang aktif.
Pastikan untuk menjaga Capacitor CLI dan paketnya tetap update untuk menghindari masalah kompatibilitas.
Teruskan dari Menginstal Capacitor CLI: Panduan Langkah-demi-Langkah
Jika Anda menggunakan Menginstal Capacitor CLI: Panduan Langkah-demi-Langkah untuk merencanakan dashboard dan API operasi, hubungkannya dengan API Ringkasan untuk detail implementasi di API Ringkasan, Pendahuluan untuk detail implementasi di Pendahuluan, API Kunci untuk detail implementasi di API Kunci, Perangkat untuk detail implementasi di Perangkat, dan Paket untuk detail implementasi di Paket.