Mulai Menggunakan

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 menyiapkan kunci tanda tangan sebelumnya — kami akan mengatur mereka di langkah berikutnya.)

Konfigurasi kunci tanda tangan Anda

Capgo memerlukan 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 bangun pertama Anda

Anda perlu terautentikasi dengan Capgo untuk membangun. Jika Anda 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 — proses onboarding menawarkan untuk memulai bangun untuk Anda di akhir, sehingga bangun pertama Anda mungkin sudah dalam perjalanan. 🎉

Lainnya, mulai bangun sendiri dengan build request — atur --platform ke mana pun Anda sedang membangun:

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.

Pengertian Proses Pembangunan

Jika Anda menjalankan perintah pembangunan, berikut 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. Penggunaan Pembangunan - Capgo mengompilasi dan menandatangani proyek native di infrastruktur yang khusus.
4. Pengaliran Log - Log streaming secara real-time ke terminal Anda melalui Server-Sent Events.
5. Cleanup - Lingkungan pembangunan dan data proyek sementara dibersihkan setelah pembangunan; penahanan output bergantung pada opsi artefak yang dipilih dan penyimpanan pengiriman.

Gunakan Capgo Bangun dengan Bitrise atau CI lainnya

Capgo Bangun tidak menggantikan CI Anda yang ada. Simpan langkah-langkah yang memerlukan akses pribadi di Bitrise atau sistem CI lainnya: menginstal dari registry pribadi, menyelesaikan CocoaPods pribadi melalui SSH, menjalankan pengaturan native kustom, membangun layer web, dan menjalankan npx cap sync.

Kemudian panggil Capgo Bangun dengan proyek native yang disiapkan. Capgo menerima proyek yang sudah siap ios/ atau android/ project to compile and sign, so it does not need your private Nexus, CocoaPods SSH, or web-build credentials. The compiled web assets are already inside that prepared native project; they are used for the build rather than retained as a source repository.

Apa yang Dibangun

Capgo Pembangunan menerima proyek native yang disiapkan untuk memasak aplikasi Anda. Sumber web Anda code, instalasi ketergantungan pribadi, dan Capacitor sinkronisasi tetap di CI Anda.

What Gets Diunggah

Termasuk	Deskripsi
ios/ atau android/	The native platform folder you’re building
package.json, package-lock.json	Daftar Ketergantungan Manifest
capacitor.config.*	Konfigurasi Capacitor
resources/	__CAPGO_KEEP_0__ konfigurasi
Native plugin code	Hanya yang ios/ atau android/ subfolder dari setiap plugin Capacitor

Apa yang TIDAK Diunggah

Dikecualikan	Mengapa
node_modules/ (banyak dari itu)	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/	Sejarah kontrol versi
.gradle/, .idea/, .swiftpm/	Memperbarui cache dan pengaturan IDE
.env, rahasia	Tidak pernah diunggah

Catatan

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

Tanggung Jawab Anda

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

1. Siapkan di CI - Selesaikan registri paket pribadi, CocoaPods berbasis SSH, SDK perangkat, ekstensi, dan persiapan native yang disesuaikan di Bitrise atau CI yang ada.
2. Membangun aset web Anda - Jalankan npm run build (atau perintah pembangunan framework Anda).
3. Sinkronkan ke native - Jalankan npx cap sync untuk menyalin aset web yang telah dikompilasi ke proyek native yang telah disiapkan.
4. Minta pembangunan native - Kirimkan proyek yang telah disiapkan ios/ atau android/ projek ke Capgo untuk dibangun.

proyek ke Capgo Build.

• Kompileasi iOS Asli (Xcode, Fastlane)
• Kompileasi Android Asli (Gradle)
• Penandatanganan Code dengan kredit Anda
• Penyajian Opsi App Store Connect atau Google Play (opsional)
• Nilai konfigurasi dan kredit build native yang didukung dan nilai variabel lingkungan yang dikirimkan

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 toko.

Untuk rasa kiosk yang didistribusikan melalui MDM, atur proyek Android/bangun untuk menghasilkan APK. Ketika meminta pembangunan, gunakan kedua flag untuk melompat 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 aplikasi ke Play Store bahkan jika kredit Play sudah disimpan; --output-upload menyediakan tautan sementara ke output yang ditandatangani. Distribusikan APK tersebut melalui MDM Anda.

Next Steps

Sekarang Anda telah membuat build pertama Anda:

• Konfigurasi Build iOS - Tambahkan sertifikat dan profil
• Konfigurasi Build Android - Tambahkan keystore dan Play Store
• Troubleshooting - Masalah umum dan solusi
• CLI Reference - Dokumentasi perintah lengkap

Butuh Bantuan?

• Periksa Join komunitas Discord kami
• Join our support@__CAPGO_KEEP_0__.app
• Mulai dengan __CAPGO_KEEP_0__ Kirimkan aplikasi capgo