Mulai

Mulai dengan Capgo Cloud Build dan buat aplikasi iOS atau Android native 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 (run bunx @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 — tetapi Anda tidak perlu mengelola mereka secara manual. Jawab beberapa pertanyaan dan kami akan menunjukkan Anda ke perintah yang tepat untuk menjalankan:

Jalankan bangun pertama Anda

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

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

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

Jika tidak, mulai pembangunan sendiri dengan build request — set --platform ke mana pun Anda sedang membangun:

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

Proyek CLI mengunggah proyek Anda, mengalirkan log pembangunan secara langsung di terminal Anda, dan — setelah kredensial Anda dikonfigurasi — mengirim hasilnya ke toko secara otomatis.

Pengertian Proses Pembangunan

Ketika Anda menjalankan perintah pembangunan, ini yang terjadi:

flowchart LR
    A[Your Machine] -->|1. Zip Project| B[Local Temp]
    B -->|2. Upload| C[Capgo Cloud]
    C -->|3. Build| D[Mac Mini Silicon M4 Build Server]
    D -->|4. Logs Stream| A
    D -->|5. Cleanup| E[Auto Delete]

1. Persiapan Lokal - Projek Anda dikompresi (kecuali node_modules dan file konfigurasi
2. Upload - Zip dikirim ke penyimpanan cloud yang aman (Cloudflare R2)
3. Pengolahan Build - Aplikasi Anda dibangun di infrastruktur dedikasi
4. Streaming Log - Log waktu nyata mengalir ke terminal Anda melalui Server-Sent Events
5. Pembersihan Otomatis - Artifak build dihapus (Android: instan, iOS: 24 jam)

Apa yang Dibangun

Capgo Bangunlah hanya mengunggah file-file yang dibutuhkan untuk mengompilasi aplikasi native Anda. Sumber daya penuh Anda Capgo tidak akan pernah meninggalkan mesin Anda. minimum file yang dibutuhkan to compile your native app. Your full source code never leaves your machine.

Apa yang Dikirim

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

Apa yang TIDAK Diunggah

Diketepikan	Mengapa
node_modules/ (banyaknya itu)	Hanya plugin asli code yang termasuk, bukan dependensi JS
src/	Sumber web Anda code tetap lokal
dist/, www/, build/ (tingkat root)	Telah disinkronkan ke folder native melalui cap sync
.git/	Sejarah pengendalian versi
.gradle/, .idea/, .swiftpm/	Cache pembangunan dan pengaturan IDE
.env, rahasia	Tidak pernah diunggah

Catatan

Aset web yang dibangun (JS, CSS, HTML) telah diunggah - tetapi sebagai bagian dari folder native. Ketika Anda menjalankan bunx cap sync, pembangunan web Anda disalin ke ios/App/App/public/ atau android/app/src/main/assets/public/Alasan itu menjalankan cap sync sebelum membangun diperlukan.

Mengapa Anda Bertanggung Jawab

Sebelum menjalankan bunx @capgo/cli@latest build:

1. Bangun aset web Anda - Jalankan bun run build (atau perintah bangun framework Anda)
2. Sinkron ke native - Jalankan bunx cap sync untuk menyalin aset web ke proyek native
3. Komit dependensi - Pastikan semua plugin asli berada di package.json

Apa Capgo Build Menghandle

• Pengompilan iOS asli (Xcode, Fastlane)
• Pengompilan Android asli (Gradle)
• Code menandatangani dengan kreditan Anda
• Pengiriman aplikasi ke toko (jika dikonfigurasi)

Langkah-Langkah Selanjutnya

Sekarang Anda telah membuat build pertama Anda:

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

Memerlukan Bantuan?

• Periksa petunjuk troubleshooting
• Bergabunglah dengan komunitas Discord kami
• Dukungan email di support@capgo.app