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:

• Aplikasi Capacitor yang dapat dibangun dengan sukses secara lokal
• Node.js 20 atau lebih tinggi terinstal
• Akun Capgo Anda (cukup dengan 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 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 Anda ke perintah yang tepat untuk menjalankan:

Jalankan bangun pertama Anda

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

bunx @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 pembangunan untuk Anda di akhir, sehingga 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

Proses 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 dikompres (kecuali node_modules dan file-file rahasia)
2. Upload - Kompresi zip diunggah ke penyimpanan awan yang aman (Cloudflare R2)
3. Eksekusi Pembangunan - Aplikasi Anda dibangun di infrastruktur dedikasi
4. Streaming Log - Log waktu nyata mengalir ke terminal Anda melalui Server-Sent Events
5. Pembersihan Otomatis - Bahan-bahan pembangunan dihapus (Android: instan, iOS: 24 jam)

Apa yang Dibangun

Capgo Hanya mengunggah file-file yang dibutuhkan minimum file yang dibutuhkan to compile your native app. Your full source code never leaves your machine.

Apa yang Diunggah

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 native code	Hanya plugin ios/ atau android/ subfolder dari setiap plugin Capacitor

Apa yang TIDAK Diunggah

Dikecualikan	Mengapa
node_modules/ (banyaknya 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 pengendalian versi
.gradle/, .idea/, .swiftpm/	Pengaturan 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/. Itulah mengapa harus dijalankan cap sync sebelum membangun diperlukan.

Tanggung Jawab Anda

Sebelum menjalankan bunx @capgo/cli@latest build:

1. Buat 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. Tetapkan dependensi - Pastikan semua plugin native ada di package.json

Apa Capgo Build Menghandle

• Pengompilan iOS native (Xcode, Fastlane)
• Pengompilan Android native (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 pembangunan Android - Atur keystore dan Play Store
• Pengaturan Masalah - Masalah umum dan solusi
• CLI Referensi - Dokumentasi perintah lengkap

Memerlukan Bantuan?

• Periksa petunjuk troubleshooting
• Bergabunglah dengan Komunitas Discord
• Hubungi dukungan melalui email di support@capgo.app