Ingin membangun aplikasi mobile dengan kode dasar tunggal? Capacitor membuatnya mudah untuk membuat aplikasi iOS, Android, dan web menggunakan kerangka seperti React, Angular, atau Vue. Panduan ini menjelaskan cara mengatur Capacitor, mengonfigurasi platform, dan mengirimkan pembaruan secara efisien.
Langkah Utama untuk Memulai:
- Instalasi Tools: Node.js, npm, Git, dan sebuah code editor seperti VS Code.
- Set Up Capacitor: Pasang Capacitor CLI dan inisialisasi proyek Anda.
- Konfigurasi Platform: Tambahkan dukungan iOS dan Android, atur pengaturan, dan sinkronkan code Anda.
- Test dan Deploy: Bangun, jalankan pada perangkat, dan gunakan alat update hidup seperti Capgo untuk pembaruan yang halus.
Capacitor menghubungkan aplikasi web dengan fitur perangkat asli, memastikan kinerja yang halus di semua platform. Ikuti panduan ini untuk memudahkan proses pengembangan aplikasi Anda!
5 Langkah untuk APLIKASI NATIF dengan CAPACITOR | Panduan Rilis Ionic

Alat-Alat yang Diperlukan dan Pengaturan
Berikut cara mengatur lingkungan pengembangan Anda dengan alat-alat yang penting.
Penginstalan Alat-Alat Pengembangan
Untuk bekerja dengan Capacitor, Anda memerlukan alat-alat berikut:
| Alat | Tujuan | Versi Minimum |
|---|---|---|
| Node.js | lingkungan runtime JavaScript | 14.0.0 atau lebih tinggi |
| npm | Pengelola Paket | 6.0.0 atau lebih tinggi |
| IDE/Code Editor | Lingkungan Pengembangan | Versi stabil terbaru |
| Git | Pengendalian Versi | 2.0.0 atau lebih tinggi |
Ikuti langkah-langkah ini untuk menginstalnya:
- Node.js dan npm: Unduh dan instal kedua-duanya dari situs resmi Node.js website.
- Code Editor: Pilih editor seperti VS Code WebStorm, atau Sublime Text dan instal versi stabil terbaru.
- Git: Dapatkan dari git-scm.com.
- Alat-alat khusus platform: Instalasi alat-alat yang spesifik untuk platform Anda, seperti Xcode untuk pengembangan macOS atau Android Studio untuk pengembangan Android.
Setelah alat-alat tersebut terinstal, Anda siap untuk melanjutkan ke pengaturan Capacitor CLI.
Capacitor CLI Pengaturan
Dapatkan Capacitor CLI berjalan dengan langkah-langkah ini:
-
Instalasi Capacitor CLI secara global
Buka terminal Anda dan jalankan perintah berikut:
npm install -g @capacitor/cli -
Inisialisasi Capgo plugin
Jika Anda belum melakukannya, jalankan:
npx @capgo/cli initIni akan mengatur pengaturan yang diperlukan untuk menangani pembaruan dengan efektif [1]. Ini memudahkan proses untuk membuat, menguji, dan mengirimkan aplikasi Anda.
Membuat Proyek Baru Capacitor
Setelah Anda telah menginstal alat yang diperlukan, Anda siap untuk mengatur proyek Capacitor pertama Anda. Berikut cara untuk memulai.
Membuat Proyek
Untuk membuat proyek baru Capacitor, buka terminal Anda dan gunakan perintah ini:
npx @capacitor/cli create [projectDirectory] [appId] [appDisplayName]
Contoh:
npx @capacitor/cli create my-cap-app com.example.app "My Capacitor App"
Berikut adalah penjelasan dari setiap parameter:
- projectDirectory: Nama folder proyek Anda (misal,
my-cap-app). - ID Aplikasi:: Nama yang ditampilkan untuk aplikasi Anda (misalnya
com.example.app). - Setelah menjalankan perintah ini, Anda perlu menyesuaikan pengaturan proyek Anda di file.
My Capacitor App).
Mengonfigurasi __CAPGO_KEEP_0__.config.json capacitor.config.json File ini adalah tempat Anda menentukan pengaturan kunci untuk proyek Anda. Berikut adalah contoh konfigurasi dasar:
Configuring capacitor.config.json
Pilihan capacitor.config.json Tujuan
{
"appId": "com.example.app",
"appName": "My Capacitor App",
"webDir": "dist",
"bundledWebRuntime": false,
"server": {
"hostname": "app.example.com",
"androidScheme": "https",
"iosScheme": "https"
}
}
Tujuan
| Tujuan | Tujuan | Contoh Nilai |
|---|---|---|
| appId | Identifikasi unik untuk aplikasi Anda | com.example.app |
| appName | Nama aplikasi yang ditampilkan | My Capacitor App |
| webDir | Direktori untuk output pembangunan | dist |
| bundledWebRuntime | Apakah untuk termasuk runtime Capacitor | false |
| server.hostname | Nama host untuk server pengembang | app.example.com |
| server.androidScheme | Skema URL untuk Android | https |
| server.iosScheme | Skema URL untuk iOS | https |
Menginstal Dependensi
Untuk menyelesaikan pengaturan, instal dependensi yang diperlukan dan inisialisasi proyek Anda dengan perintah-perintah berikut:
npm install @capacitor/core
npm install @capacitor/cli --save-dev
npx cap init
Dengan langkah-langkah ini selesai, proyek Anda sudah siap untuk pengaturan dan pengembangan platform khusus.
Mengatur Platform Mobile
Setelah proyek Capacitor Anda diinisialisasi, langkah berikutnya adalah menambahkan dan mengonfigurasi platform iOS dan Android agar aplikasi Anda dapat berjalan secara native pada perangkat mobile.
Pengaturan iOS dan Android
Mulai dengan menambahkan dukungan platform menggunakan perintah-perintah berikut:
npx cap add ios
npx cap add android
Setelah menambahkan platform, sinkronkan web code Anda dengan:
npx cap sync
Sebelum menjalankan perintah-perintah ini, pastikan aplikasi web Anda sudah dibangun dan bahwa webDir di capacitor.config.json benar sudah ditetapkan. Setelah itu, atur pengaturan masing-masing platform untuk sesuai dengan kebutuhan aplikasi Anda.
Pengaturan Platform Khusus
iOS
Buka proyek iOS dengan:
npx cap open ios
Kemudian, atur pengaturan berikut:
- Identifikasi Paket: Pastikan sesuai dengan appId Anda.
- Tim Pengembang: Tugaskan tim yang tepat untuk code signing.
- Target Pengiriman: Atur versi iOS minimum.
- Orientasi Perangkat: Sesuaikan jika perlu.
- Deskripsi Privasi: Tambahkan deskripsi yang diperlukan di
Info.plist.
Andoid
Buka proyek Android dengan:
npx cap open android
Lalu, update pengaturan ini:
- Nama Paket: Pastikan sesuai dengan appId Anda.
- Izin: Tentukan izin yang diperlukan di
AndroidManifest.xml. - Orientasi Layar: Konfigurasi ini dapat disesuaikan di
AndroidManifest.xml. - Target SDK: Tentukan versi yang tepat di
android/app/build.gradle.
Lokasi Asset dan Konfigurasi
Berikut adalah tempat Anda akan menemukan file penting untuk ikon aplikasi, layar splash, tautan dalam, dan izin:
| Konfigurasi | Lokasi iOS | Lokasi Android |
|---|---|---|
| Ikon Aplikasi | ios/App/App/Assets.xcassets |
android/app/src/main/res |
| Layar Splash | ios/App/App/Assets.xcassets |
android/app/src/main/res |
| Tautan Dalam | ios/App/App/Info.plist |
AndroidManifest.xml |
| Izin | Info.plist |
AndroidManifest.xml |
Menggunakan konfigurasi ini, Anda sudah siap untuk membangun dan menguji aplikasi di perangkat mobile.
Membangun dan Menguji
Menggunakan setup yang telah dijelaskan sebelumnya, Anda dapat membangun dan menguji aplikasi Capacitor untuk memastikan bahwa aplikasi berfungsi dengan benar di berbagai perangkat.
Pengaturan Perintah Pembangun dan Peluncuran
Saat aplikasi sudah dikonfigurasi untuk platform mobile, saatnya untuk membangun dan menguji tes. Mulai dengan memperbarui aset web:
npm run build
npx cap sync
Selanjutnya, gunakan perintah yang sesuai untuk platform target:
Untuk iOS:
npx cap run ios
Untuk Android:
npx cap run android
Perintah-perintah ini akan membangun dan meluncurkan aplikasi di simulator atau perangkat terhubung. Pengujian di perangkat nyata dan simulator sangat penting untuk mengidentifikasi masalah spesifik platform.
Menggunakan Plugin Capacitor
Capacitor plugin-plugin memungkinkan Anda menambahkan fitur asli ke aplikasi Anda. Misalnya, untuk mencakup kemampuan kamera, lokasi, dan penyimpanan, jalankan:
npm install @capacitor/camera @capacitor/geolocation @capacitor/storage
npx cap sync
Setelah instalasi, konfigurasi plugin di proyek native Anda. Berikut adalah ringkasan singkat dari persyaratan pengaturan:
| Plugin | Konfigurasi iOS | Konfigurasi Android |
|---|---|---|
| Kamera | Tambahkan Deskripsi Privasi | Tambahkan Izin ke Manifest |
| Lokasi | Tambahkan Penggunaan Lokasi | Tambah Izin Lokasi |
| Penyimpanan | Tidak perlu pengaturan tambahan | Tidak perlu pengaturan tambahan |
Pembaruan Hidup dengan Capgo

Untuk memudahkan pengembangan dan pengujian, Anda dapat mengintegrasikan alat pembaruan hidup seperti Capgo. Layanan ini telah mengirimkan lebih dari 23,5 juta pembaruan, dengan 95% pengguna menerima pembaruan dalam waktu 24 jam dan tingkat kesuksesan global 82% [1].
Untuk menambahkan Capgo ke aplikasi Anda:
npm install @capgo/capacitor-updater
npx cap sync
Capgo menawarkan beberapa manfaat selama pengujian:
- Buat saluran terpisah untuk lingkungan pengembangan, pengujian, dan produksi.
- Sampaikan perbaikan bug segera selama pengujian.
- Melacak tingkat kesuksesan pembaruan dengan analitis bawaan.
- Kembali ke pembaruan sebelumnya dengan cepat jika masalah muncul.
Capgo juga memastikan pengiriman pembaruan yang aman dengan enkripsi ujung ke ujung. Sistem saluran Capgo memungkinkan Anda untuk menguji pembaruan dengan kelompok pengguna tertentu sebelum mengeluarkannya untuk semua.
Ringkasan
Petunjuk ini telah menjelajahi setiap fase pengaturan dan pengembangan aplikasi Capacitor, menutupi semua langkah penting yang diperlukan untuk memulai dan memastikan operasi yang lancar.
Poin Utama
Membuat aplikasi Capacitor memerlukan perhatian yang hati-hati terhadap pengaturan, pengaturan, dan penyesuaian platform khusus. Mengatur lingkungan pengembangan Anda - termasuk alat seperti Node.js dan __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ Capacitor CLI Menggunakan sistem pembaruan seperti __CAPGO_KEEP_0__
__CAPGO_KEEP_0__ Capgo Dapat memudahkan manajemen rilis dan membantu menjaga stabilitas aplikasi [1].
Berikut adalah penjelasan tentang fase-fase utama:
| Fase | Langkah | Saran |
|---|---|---|
| Pengaturan Awal | Instal perangkat lunak, CLI pengaturan | Gunakan versi stabil terbaru |
| Pengaturan | Ubah pengaturan platform, tambahkan plugin | Ikuti pedoman spesifik platform |
| Menguji | Membangun dan menguji di perangkat | Prioritaskan pengujian di perangkat nyata |
| Pengembangan | Kelola pembaruan, pengendalian versi | Gunakan aliran pipa otomatis untuk efisiensi |
Teruskan dari Panduan Langkah demi Langkah Inisialisasi Aplikasi Capacitor
Jika Anda menggunakan Panduan Langkah demi Langkah Inisialisasi Aplikasi Capacitor untuk merencanakan otomatisasi CI/CD, hubungkannya dengan CI/CD Capgo untuk alur kerja produk di CI/CD Capgo Capgo Pembangunan Natively untuk alur kerja produk di Capgo Pembangunan Natively, Capgo Integrasi untuk alur kerja produk di Capgo Integrasi, Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan GitHub Integrasi Aksi untuk detail implementasi di GitHub Integrasi Aksi.