Panduan Memulai

Mulai dengan Capgo Cloud Build dan buat native build iOS atau Android pertama Anda dalam hitungan menit.

Yang Anda Butuhkan

Sebelum memulai, pastikan Anda sudah memiliki:

• Aplikasi Capacitor yang berhasil di-build secara lokal
• Node.js 20 atau lebih tinggi sudah terinstal
• Akun Capgo (free trial sudah cukup untuk memulai)
• Aplikasi Anda sudah terdaftar di Capgo (jalankan npx @capgo/cli@latest app add jika belum)
• (Tidak perlu menyiapkan kredensial penandatanganan terlebih dahulu — kami akan mengaturnya di langkah berikutnya.)

Konfigurasikan kredensial penandatanganan Anda

Capgo membutuhkan kredensial penandatanganan untuk build dan submit aplikasi Anda — tetapi Anda tidak perlu mengurusnya secara manual. Jawab beberapa pertanyaan dan kami akan mengarahkan Anda ke perintah yang tepat untuk dijalankan:

Jalankan build pertama Anda

Anda harus terautentikasi dengan Capgo untuk melakukan build. Jika belum:

npx @capgo/cli@latest login
# or, in CI, set the token directly:
export CAPGO_TOKEN=your_api_key

Jika Anda baru saja menjalankan build init, Anda sudah siap — onboarding menawarkan untuk memulai build untuk Anda di akhir, jadi build pertama Anda mungkin sudah dalam proses. 🎉

Kalau tidak, mulai build sendiri dengan build request — atur --platform ke platform yang Anda build:

npx @capgo/cli@latest build request com.example.app --platform <android|ios> --build-mode debug

CLI mengunggah proyek native yang telah disiapkan dan menampilkan build logs secara live di terminal Anda. Capgo Build dapat menghasilkan signed artifact atau mengirimkannya ke App Store Connect atau Google Play saat Anda mengonfigurasi release flow yang sesuai.

Understanding the Build Process

Saat Anda menjalankan perintah build, inilah yang terjadi:

flowchart LR
    A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
    B -->|2. Upload| C[Capgo Build]
    C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
    D -->|4. Stream Logs| E[Your Terminal]
    D -->|Return Signed Artifact or Store Delivery| F[Output]
    D -->|5. Clean Temporary Project Data| G[Cleanup]

1. Persiapan di CI Anda - Build lapisan web, resolve private dependencies, dan sinkronkan aset hasil build ke dalam proyek native.
2. Unggah - Proyek native yang sudah disiapkan diunggah ke penyimpanan cloud aman untuk build.
3. Eksekusi Build - Capgo mengompilasi dan menandatangani proyek native di infrastruktur khusus.
4. Streaming Log - Log real-time dialirkan ke terminal Anda melalui Server-Sent Events.
5. Pembersihan - Lingkungan build dan data proyek sementara dibersihkan setelah build selesai; retensi output bergantung pada opsi artifact dan pengiriman ke store yang dipilih.

Gunakan Capgo Build dengan Bitrise atau CI lain

Capgo Build tidak menggantikan CI Anda yang sudah ada. Pertahankan langkah-langkah yang memerlukan akses privat di Bitrise atau sistem CI lain: instal dari registry privat, resolve CocoaPods privat via SSH, jalankan setup native kustom, build lapisan web, dan jalankan npx cap sync.

Lalu panggil Capgo Build dengan proyek native yang sudah disiapkan. Capgo menerima yang siap ios/ atau android/ proyek untuk dikompilasi dan ditandatangani, jadi tidak perlu kredensial Nexus pribadi, CocoaPods SSH, atau web-build Anda. Aset web yang sudah dikompilasi sudah ada di dalam proyek native yang telah disiapkan itu; aset tersebut dipakai untuk build, bukan disimpan sebagai repositori sumber.

Apa yang di-build

Capgo Build menerima proyek native yang telah disiapkan untuk mengompilasi aplikasi Anda. Sumber web code Anda, instalasi dependensi privat, dan sinkronisasi Capacitor tetap berada di CI Anda.

Apa yang di-upload

Termasuk	Deskripsi
ios/ atau android/	Folder platform native yang sedang Anda build
package.json, package-lock.json	Manifest dependensi
capacitor.config.*	Konfigurasi Capacitor
resources/	Ikon aplikasi, splash screen
Plugin native code	Hanya ios/ atau android/ subfolder dari setiap plugin Capacitor

Apa yang TIDAK di-upload

Dikecualikan	Mengapa
node_modules/ (sebagian besar)	Hanya plugin native code yang disertakan, bukan dependensi JS
src/	Sumber web Anda code tetap lokal
dist/, www/, build/ (level root)	Sudah disinkronkan ke folder native melalui cap sync
.git/	Riwayat version control
.gradle/, .idea/, .swiftpm/	Cache build dan pengaturan IDE
.env, secrets	Tidak pernah di-upload

Catatan

Aset web yang sudah di-build (JS, CSS, dan HTML) Anda di-upload hanya karena npx cap sync sudah menyalinnya ke proyek native. Langkah sumber web dan instalasi dependensi tetap ada di CI Anda; proyek native yang sudah disiapkan digunakan untuk membangun binary, lalu dibersihkan.

Tanggung Jawab Anda

Sebelum menjalankan npx @capgo/cli@latest build request:

1. Persiapan di CI Anda - Selesaikan private package registries, SSH-based CocoaPods, device SDKs, ekstensi, dan persiapan native kustom lainnya di Bitrise atau CI Anda yang sudah ada.
2. Build aset web Anda - Jalankan npm run build (atau perintah build framework Anda).
3. Sync ke native - Jalankan npx cap sync untuk menyalin web assets yang sudah dikompilasi ke dalam native project yang telah disiapkan.
4. Minta native build - Kirimkan yang sudah disiapkan ios/ atau android/ proyek ke Capgo Build.

Yang Ditangani Capgo Build

• Kompilasi native iOS (Xcode, Fastlane)
• Kompilasi native Android (Gradle)
• Penandatanganan Code dengan kredensial Anda
• Pengiriman opsional ke App Store Connect atau Google Play
• Konfigurasi build native yang didukung dan nilai kredensial yang diteruskan sebagai variabel lingkungan

Capgo Build tidak memerlukan akses ke registry Nexus privat atau kredensial SSH Anda setelah CI menyiapkan proyek native. Lihat Konfigurasi Build untuk variabel lingkungan dan opsi penyimpanan yang didukung.

Untuk varian kiosk yang didistribusikan melalui MDM, konfigurasikan proyek/build Android untuk menghasilkan APK. Saat meminta build, gunakan kedua flag untuk melewati Google Play dan mengambil output yang ditandatangani:

npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload mencegah upload ke Play Store meskipun kredensial Play disimpan; --output-upload menyediakan tautan berbatas waktu ke output yang ditandatangani. Distribusikan APK tersebut melalui MDM Anda.

Langkah Berikutnya

Sekarang setelah Anda membuat build pertama Anda:

• Konfigurasikan build iOS - Atur sertifikat dan profil
• Konfigurasi build Android - Siapkan keystore dan Play Store
• Pemecahan Masalah - Masalah umum dan solusinya
• Referensi CLI - Dokumentasi perintah lengkap

Butuh bantuan?

• Cek panduan troubleshooting
• Gabung dengan komunitas Discord kami
• Email support di support@capgo.app