Mulai

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

Apa yang Anda Butuhkan

Sebelum Anda memulai, pastikan Anda memiliki:

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

Konfigurasi kunci tanda tangan Anda

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

Jalankan build 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 build untuk Anda di akhir, sehingga build pertama Anda mungkin sudah dalam perjalanan. 🎉

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

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

Proyek native yang dipersiapkan CLI mengunggah dan mengalirkan log build secara langsung di terminal Anda. Capgo Build dapat mengembalikan artefak yang ditandatangani atau mengirimkannya ke App Store Connect atau Google Play ketika Anda mengonfigurasi aliran rilis yang tepat.

Mengerti Proses Build

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 pribadi, dan sinkronkan aset yang selesai ke proyek native.
2. Upload - Proyek native yang disiapkan diunggah ke penyimpanan awan yang aman untuk pembangunan.
3. Eksekusi Pembangunan - 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 pembangunan dan data proyek sementara dibersihkan setelah pembangunan; retensi output bergantung pada pilihan artefak dan opsi penyimpanan.

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 CI sistem lainnya: 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/ proyek untuk dikompilasi dan ditandatangani, sehingga tidak memerlukan kunci Nexus pribadi, CocoaPods SSH, atau kunci web-build. Aset web yang dikompilasi sudah ada di dalam proyek native yang disiapkan; mereka digunakan untuk bangun daripada disimpan sebagai repositori sumber.

Apa yang Dibangun

Capgo Bangun menerima proyek native yang disiapkan yang diperlukan untuk mengompilasi aplikasi Anda. Sumber web code, instalasi dependensi pribadi, dan sinkronisasi Capacitor tetap ada di CI Anda.

Apa yang Dikirim

Termasuk	Deskripsi
ios/ atau android/	Folder platform asli yang kamu sedang bangun
package.json, package-lock.json	Manifest dependensi
capacitor.config.*	Konfigurasi Capacitor
resources/	Ikon aplikasi, layar splash
Plugin native code	Hanya __CAPGO_KEEP_0__ ios/ atau android/ Subfolder dari setiap plugin Capacitor

Apa yang TIDAK Diunggah

Ditolak	Mengapa
node_modules/ (hampir semua itu)	Hanya plugin asli native code yang termasuk, bukan dependensi JS
src/	Sumber web Anda code tetap lokal
dist/, www/, build/ (tingkat root)	Sudah disinkronkan ke folder native via cap sync
.git/	Riwayat pengendalian versi
.gradle/, .idea/, .swiftpm/	Caches pembangunan dan pengaturan IDE
.env(dan rahasia)	Tidak pernah diunggah

Catatan

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

Tanggung Jawab 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 yang disesuaikan di Bitrise atau CI Anda yang sudah ada.
2. Bangun aset web - Jalankan npm run build (atau perintah bangun framework Anda).
3. Sinkron ke native - Jalankan npx cap sync untuk menyalin aset web yang dikompilasi ke proyek native yang disiapkan.
4. Minta pembangunan native - Kirimkan proyek yang disiapkan ios/ atau android/ ke Capgo Build.

Apa yang Dapat Dilakukan oleh Capgo Build

• Pengompilan native iOS (Xcode, Fastlane)
• Pengompilan native Android (Gradle)
• Code tanda tangan dengan kreditan Anda
• Penyampaian App Store Connect atau Google Play (opsional)
• Konfigurasi pembangunan asli native dan nilai kredensial yang dikirim sebagai variabel lingkungan yang didukung

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

Untuk rasa kiosk yang didistribusikan melalui MDM, konfigurasi proyek Android/bangun untuk menghasilkan APK. Ketika meminta pembangunan, gunakan baik 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 ke Toko Play bahkan jika kredensial Play disimpan; --output-upload menyediakan tautan sementara ke hasil yang ditandatangani. Distribusikan APK tersebut melalui MDM Anda.

Langkah-Langkah Selanjutnya

Sekarang Anda telah membuat pembangunan pertama Anda:

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

Memerlukan Bantuan?

• Periksa petunjuk pemecahan masalah
• Joinlah komunitas Komunitas Discord kami
• Hubungi dukungan email di dukungan@capgo.app