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:

• Sebuah Capacitor aplikasi yang dapat dibangun dengan sukses secara lokal
• Node.js 20 atau lebih tinggi telah terinstal
• Sebuah Capgo akun (cukup dengan 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 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

Anda harus terautentikasi dengan Capgo untuk melakukan build. 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 init, Anda sudah siap — proses onboarding menawarkan untuk memulai build untuk Anda di akhir, sehingga build pertama Anda mungkin sudah dalam perjalanan. 🎉

Lainnya, mulailah melakukan build sendiri dengan build request — set --platform ke mana pun Anda sedang membangun:

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

CLI mengunggah proyek native yang disiapkan 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.

Memahami Proses Pembangunan

Ketika Anda menjalankan perintah pembangunan, berikut ini 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 cloud yang aman untuk pembangunan.
3. Pembangunan Eksekusi - Capgo mengompilasi dan menandatangani proyek native di infrastruktur yang terdedikasi.
4. Streaming Log - Log waktu nyata mengalir ke terminal Anda melalui Server-Sent Events.
5. Membersihkan - Lingkungan pembangunan dan data proyek sementara dibersihkan setelah pembangunan; penyimpanan output bergantung pada pilihan artefak dan opsi pengiriman.

Pilih Capgo Bangun dengan Bitrise atau CI lainnya

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

Lalu panggil Pilih Capgo Bangun dengan proyek native yang disiapkan. Pilih Capgo menerima proyek yang sudah siap ios/ atau android/ context: Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `alternatives_cta_questions`). Halaman/area: Halaman perbandingan pembaruan hidup Capacitor. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman alternatives.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `alternatives_cta_questions` (Pertanyaan Tindakan Alternatif). | Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `appflow_cta_questions`). Halaman/area: Halaman perbandingan/migrasi pemasaran Appflow. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman ionic-appflow.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `appflow_cta_questions` (Pertanyaan Tindakan Appflow). | Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `capwesome_cta_questions`). Halaman/area: Halaman perbandingan Capawesome. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman capwesome.astro. Simpan istilah produk/brand dan istilah pengembang Capgo secara tepat. Kunci pesan `capwesome_cta_questions` (Pertanyaan Tindakan Capwesome). | Halaman/area: Halaman perbandingan/migrasi pemasaran Appflow. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman ionic-appflow.astro, halaman ionic-enterprise-plugins.astro, halaman solusi/ionic-enterprise-plugins.astro. Kunci pesan `appflow_plugins_or` (Appflow Plugins Atau).

proyek untuk dikompilasi dan ditandatangani, sehingga tidak memerlukan kunci Nexus pribadi, CocoaPods SSH, atau kunci pengembangan web. Aset web yang dikompilasi sudah ada di dalam proyek native yang disiapkan; aset tersebut digunakan untuk pembangunan daripada disimpan sebagai repositori sumber.

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.

Pilih __CAPGO_KEEP_0__ Bangun menerima proyek native yang disiapkan untuk dikompilasi aplikasi Anda. Sumber web Anda __CAPGO_KEEP_1__, instalasi dependensi pribadi, dan __CAPGO_KEEP_2__ sinkronisasi tetap di CI Anda.

Termasuk	Deskripsi
ios/ atau android/	context: Alternatif Tanya CTA. Halaman/Wilayah: Halaman perbandingan alternatif update hidup Capacitor. Peran: Paragraf pemasaran atau hukum panjang. Dilihat di: halaman alternatif.astro. Simpan istilah produk/merek Capgo dan istilah pengembang secara tepat. Kunci pesan `alternatives_cta_questions` (Alternatif CTA Pertanyaan). | Fragment teks HTML dari string UI Capgo yang lebih panjang (kunci induk `appflow_cta_questions`). Halaman/Wilayah: Halaman perbandingan/migrasi pemasaran Appflow. Peran: Paragraf pemasaran atau hukum panjang. Dilihat di: halaman ionic-appflow.astro. Simpan istilah produk/merek Capgo dan istilah pengembang secara tepat. Kunci pesan `appflow_cta_questions` (Appflow CTA Pertanyaan). | Fragment teks HTML dari string UI Capgo yang lebih panjang (kunci induk `capwesome_cta_questions`). Halaman/Wilayah: Halaman perbandingan Capawesome. Peran: Paragraf pemasaran atau hukum panjang. Dilihat di: halaman capwesome.astro. Simpan istilah produk/merek Capgo dan istilah pengembang secara tepat. Kunci pesan `capwesome_cta_questions` (Capwesome CTA Pertanyaan). | Fragment teks HTML dari string UI Capgo yang lebih panjang (kunci induk `consulting_faq_subtitle`). Halaman/Wilayah: Halaman layanan konsultasi. Peran: Judul bagian atau tagline. Dilihat di: halaman konsultasi.astro. Simpan istilah produk/merek Capgo dan istilah pengembang secara tepat. Kunci pesan `consulting_faq_subtitle` (Judul Bagian FAQ Konsultasi). | Halaman/Wilayah: Halaman perbandingan/migrasi pemasaran Appflow. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman ionic-appflow.astro, halaman ionic-enterprise-plugins.astro, halaman solusi/ionic-enterprise-plugins.astro. Kunci pesan `appflow_plugins_or` (Appflow Plugin Atau).
package.json, package-lock.json	Folder platform asli yang Anda bangun
capacitor.config.*	Capacitor configuration
resources/	Konfigurasi __CAPGO_KEEP_0__
Native plugin code	Plugin native __CAPGO_KEEP_0__ ios/ Hanya __CAPGO_KEEP_0__ android/ subfolder of each Capacitor plugin

Apa yang TIDAK Diunggah

Ditolak	Mengapa
node_modules/ (hampir semua hal 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/	Riwayat kontrol versi
.gradle/, .idea/, .swiftpm/	Kotak cache pembangunan dan pengaturan IDE
.envRahasia	Belum 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 Anda; proyek native yang disiapkan digunakan untuk membangun biner 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 yang disesuaikan di Bitrise atau CI Anda yang ada.
2. Bangun aset 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. Meminta pembangunan native - Kirimkan proyek yang disiapkan ios/ atau android/ project to Capgo Build.

proyek ke Capgo Bangun.

• Judul bagian ‘Apa __CAPGO_KEEP_0__ Bangun Tangani’
• Pengompilan iOS native (Xcode, Fastlane)
• Code signing 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 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 Play Store bahkan jika kredit Play disimpan; --output-upload menyediakan tautan sementara ke hasil yang ditandatangani. Distribusikan APK tersebut melalui MDM Anda.

Langkah Selanjutnya

Sekarang Anda telah membuat build pertama Anda:

• Konfigurasi Build iOS - Atur sertifikat dan profil
• Konfigurasi Build Android - Atur keystore dan Google Play Store
• 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