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
• Aplikasi Capgo (cukup dengan 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 sebelumnya — 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

Anda perlu terautentikasi dengan Capgo untuk membangun. Jika Anda belum melakukannya:

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

Jika tidak, mulai pembangunan 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

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

Mengerti Proses Pembangunan

Ketika Anda menjalankan perintah pembangunan, berikutlah 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. Persiapan di CI Anda - Membangun layer web, menyelesaikan ketergantungan pribadi, dan menyinkronkan aset yang selesai ke proyek native.
2. Upload - Proyek native yang dipersiapkan diunggah ke penyimpanan cloud yang aman untuk pembangunan.
3. Pembangunan Eksekusi - Capgo mengompilasi dan menandatangani proyek native di infrastruktur yang khusus.
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; 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 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/ 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 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.

Apa yang Dibangun

Included	Deskripsi
ios/ atau android/	Alternatif apa yang harus dipilih?
package.json, package-lock.json	Daftar Ketergantungan Manifest
capacitor.config.*	Konfigurasi Capacitor
resources/	Konfigurasi __CAPGO_KEEP_0__
Native plugin code	Hanya yang ios/ atau android/ subfolder masing-masing plugin Capacitor

Subfolder dari setiap plugin __CAPGO_KEEP_0__

Ditolak	Mengapa
node_modules/ (hampir semua)	Hanya plugin asli 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/	Sejarah kontrol versi
.gradle/, .idea/, .swiftpm/	Kotak kunci dan pengaturan IDE
.env, rahasia	Tidak pernah diunggah

Catatan

Asset 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 Anda; 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 Anda - Selesaikan registri paket pribadi, CocoaPods berbasis SSH, SDK perangkat, ekstensi, dan persiapan native yang disesuaikan di Bitrise atau CI Anda yang ada.
2. Bangun asset web - 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. Minta bangun native - Kirimkan proyek yang disiapkan ios/ atau android/ projek ke Capgo untuk membangun.

proyek ke Capgo Bangun.

• Pengompilan iOS Asli (Xcode, Fastlane)
• Pengompilan native iOS (Xcode, Fastlane)
• Code signing with your credentials
• __CAPGO_KEEP_0__ tanda tangan dengan kreditan Anda sendiri
• Konfigurasi dan nilai kunci otentikasi native yang didukung dapat dipasang sebagai variabel lingkungan.

Capgo Pembangunan tidak memerlukan akses ke registry Nexus pribadi atau kunci SSH Anda 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, 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 ke Toko Play bahkan jika kredit Play disimpan; --output-upload menyediakan tautan sementara ke hasil yang ditandatangani. Distribusikan APK tersebut melalui MDM Anda.

Next Steps

Sekarang Anda telah membuat pembangunan pertama Anda:

• Konfigurasi Build iOS - Konfigurasi sertifikat dan profil
• Konfigurasi Build Android - Konfigurasi keystore dan Play Store
• Pengaturan Masalah Masalah Umum dan Solusinya
• CLI Reference __CAPGO_KEEP_0__ Referensi

Bantuan?

• Periksa Petunjuk Perbaikan Masalah
• Join our Komunitas Discord kami
• Hubungi dukungan melalui email di Bantuan@capgo.app