Mulai

Mulai dengan Capgo Cloud Build dan buatlah 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 bunx @capgo/cli@latest app add jika tidak)
• (Tidak perlu menyiapkan kunci tanda tangan sebelumnya — kami akan mengatur mereka di langkah berikutnya.)

Konfigurasi kredit tanda tangan Anda

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

Jalankan build 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 initAnda sudah siap — proses onboarding menawarkan untuk memulai build untuk Anda di akhir, sehingga build pertama Anda mungkin sudah dalam perjalanan. 🎉

Jika tidak, mulai build sendiri dengan build request — set --platform untuk proyek mana pun yang Anda bangun:

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

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

Mengerti 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 - Proyek Anda dikompres (kecuali node_modules dan file-file rahasia)
2. Unggah - Zip dikirim ke penyimpanan cloud yang aman (Cloudflare R2)
3. Eksekusi Bangun - Aplikasi Anda dibangun di infrastruktur yang terdedikasi
4. Streaming Log - Log waktu nyata mengalir ke terminal Anda melalui Server-Sent Events
5. Pembersihan Otomatis - Bahan bangun dihapus (Android: instan, iOS: 24 jam)

Apa Yang Dibangun

Capgo Bangun hanya mengunggah file minimum yang diperlukan untuk membangun aplikasi native Anda. Sumber penuh Anda code tidak pernah meninggalkan mesin Anda.

Apa yang Dikirim

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

Apa yang TIDAK Diunggah

Dikecualikan	Mengapa
node_modules/ (hampir semua)	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/	Kotak pembangunan dan pengaturan IDE
.envRahasia	Tidak pernah diunggah

Pertahankan

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

sebelum membangun diperlukan.

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 native ada di package.json

Apa Capgo Build Handles

• Pengompilan iOS asli (Xcode, Fastlane)
• Pengompilan Android asli (Gradle)
• Code tanda tangan dengan kreditan Anda
• Pengajuan toko aplikasi (jika dikonfigurasi)

Langkah-Langkah Selanjutnya

Sekarang Anda telah membuat build pertama Anda:

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

Memerlukan Bantuan?

• Periksa panduan pemecahan masalah
• Bergabunglah dengan komunitas Discord kami
• Dukungan email di support@capgo.app