Mulai

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

Apa yang Anda Butuhkan

Sebelum Anda memulai, pastikan Anda memiliki:

• Aplikasi Capacitor yang dapat dibangun dengan sukses secara lokal
• Node.js 20 atau lebih tinggi terinstal
• Akun Capgo (cukup uji coba gratis untuk memulai)
• Aplikasi Anda sudah terdaftar di Capgo (jalankan npx @capgo/cli@latest app add jika tidak)
• Tidak perlu mempersiapkan kunci tanda tangan secara manual — kami akan mengatur mereka di langkah berikutnya.

Konfigurasi kunci tanda tangan Anda

Capgo membutuhkan kunci tanda tangan untuk membangun dan mengirimkan aplikasi Anda — tetapi Anda tidak perlu mengelola mereka secara manual. Jawab beberapa pertanyaan dan kami akan menunjukkan perintah yang tepat untuk dijalankan:

Jalankan build pertama Anda

You need to be authenticated with Capgo to build. If you haven’t already:

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

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

Jika tidak, mulailah build sendiri dengan build request — set --platform ke proyek yang Anda bangun:

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

The CLI uploads the prepared native project and streams build logs live in your terminal. Capgo Build can return a signed artifact or submit it to App Store Connect or Google Play when you configure the appropriate release flow.

Memahami Proses Pembangunan

Ketika Anda menjalankan perintah pembangunan, ini adalah apa 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. Siapkan di CI Anda - Bangun layer web, resolusi ketergantungan privat, dan sinkronkan aset yang selesai ke proyek native.
2. Unggah - Proyek native yang disiapkan diunggah ke penyimpanan cloud yang aman untuk pembangunan.
3. Pembangunan Eksekusi - Capgo mengompilasi dan menandatangani proyek native di infrastruktur dedikasi.
4. Streaming Log - Log waktu nyata mengalir ke terminal Anda melalui Server-Sent Events.
5. Pembersihan - Lingkungan bangun dan data proyek sementara dibersihkan setelah pembangunan; penyimpanan output bergantung pada pilihan artefak dan opsi pengiriman.

Gunakan Capgo Bangun dengan Bitrise atau CI lainnya

Capgo Bangun tidak menggantikan CI yang ada. Simpan langkah-langkah yang memerlukan akses pribadi di Bitrise atau sistem CI lain: instal dari registri pribadi, resolusi CocoaPods pribadi melalui SSH, jalankan pengaturan native kustom, bangun layer web, dan jalankan npx cap sync.

Lalu panggil Capgo Bangun dengan proyek native yang disiapkan. Capgo menerima proyek yang sudah siap ios/ atau android/ atau

Lalu panggil __CAPGO_KEEP_0__ Bangun dengan proyek native yang disiapkan. __CAPGO_KEEP_1__ menerima proyek yang sudah siap

Capgo Build receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.

Bagian berjudul “Apa yang Dibangun”

Termasuk	Deskripsi
ios/ atau android/	Deskripsi tentang apa yang diunggah
package.json, package-lock.json	Folder platform native yang Anda bangun
capacitor.config.*	Capacitor configuration
resources/	__CAPGO_KEEP_0__ konfigurasi
Native plugin code	Plugin native __CAPGO_KEEP_0__ ios/ Hanya android/ subfolder of each Capacitor plugin

Apa yang TIDAK Diunggah

Diketepikan	Mengapa
node_modules/ (banyak di antaranya)	Hanya plugin native code yang termasuk, bukan dependensi JS
src/	Sumber web Anda code tetap lokal
dist/, www/, build/ (tingkat root)	Sudah disinkronkan ke folder native melalui cap sync
.git/	Riwayat kontrol versi
.gradle/, .idea/, .swiftpm/	Caches pembangunan dan pengaturan IDE
.envRahasia	Never diunggah

Catatan

Asset web yang dibangun (JS, CSS, dan HTML) Anda hanya diunggah karena npx cap sync telah menyalin mereka ke proyek native. Langkah-langkah sumber web dan instalasi dependensi tetap berada di CI Anda; proyek native yang disiapkan digunakan untuk membangun binary dan kemudian dibersihkan.

Kewajiban Anda

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

1. Siapkan di CI Anda - Selesaikan registri paket pribadi, CocoaPods berbasis SSH, SDK perangkat, ekstensi, dan persiapan native kustom di Bitrise atau CI Anda yang sudah ada.
2. Bangun asset web Anda - Jalankan npm run build atau perintah pembangunan framework Anda.
3. Sinkron ke native - Jalankan npx cap sync untuk menyalin aset web yang dikompilasi ke proyek native yang disiapkan.
4. Meminta pembangunan native - Kirimkan proyek yang disiapkan ios/ atau android/ project to Capgo Build.

proyek ke Capgo Pembangunan.

• Judul bagian ‘Apa yang __CAPGO_KEEP_0__ Pembangunan Tangani’
• Pengompilan iOS native (Xcode, Fastlane)
• Code pengenalan tanda tangan dengan kredit Anda
• Penyerahan Aplikasi App Store Connect atau Google Play (opsional)
• Konfigurasi pembangunan native yang didukung dan nilai kredit yang dikirim sebagai variabel lingkungan

Capgo Pembangunan tidak memerlukan akses ke registry Nexus pribadi Anda atau kredit SSH setelah CI Anda telah mempersiapkan proyek native. Lihat Pengaturan Pembangunan untuk variabel lingkungan yang didukung dan pilihan penyimpanan.

Untuk rasa kiosk yang didistribusikan melalui MDM, atur proyek Android/bangun untuk menghasilkan APK. Ketika meminta pembangunan, gunakan baik flag untuk mengabaikan Google Play dan menerima hasil yang ditandatangani:

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

--no-playstore-upload mencegah unggah ke Toko Play bahkan jika kredit Play disimpan; --output-upload menyediakan tautan sementara ke hasil yang ditandatangani. Distribusikan APK tersebut melalui MDM Anda.

Langkah-Langkah Selanjutnya

Sekarang Anda telah membuat build pertama Anda:

• Konfigurasi Build iOS - Atur sertifikat dan profil
• Konfigurasi Build Android - Atur keystore dan Toko Play
• Pengaturan - Masalah umum dan solusi
• CLI Referensi - Dokumentasi perintah lengkap

Membutuhkan Bantuan?

• Periksa panduan pemecahan masalah Baca panduan pemecahan masalah
• Bergabunglah dengan komunitas Discord kami Hubungi dukungan email kami di
• support@__CAPGO_KEEP_0__.app support@capgo.app