Mulai

Get started with Capgo Cloud Build and create your first iOS or Android native build in minutes.

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 dengan langganan aktif
• Aplikasi Anda sudah terdaftar di Capgo (jalankan bunx @capgo/cli@latest app add jika belum)
• Kredensial pembangunan yang terkonfigurasi (sertifikat, keystore) - lihat di bawah

Sebelum Pertama Anda Membangun

⚠️ Pertama-tama, Anda Harus Mengatur Kredensial

Diperlukan sebelum membangun: Anda harus mengonfigurasi kredensial pembangunan Anda (sertifikat untuk iOS, keystore untuk Android).

Mengatur Kredensial →

Mulai Cepat

1. Mengatur Kredensial Pembangunan

   Sebelum Anda dapat membangun, Anda perlu menyimpan kredensial Anda secara lokal:

   Untuk iOS:

   bunx @capgo/cli@latest build credentials save \
     --platform ios \
     --certificate ./cert.p12 \
     --p12-password "password" \
     --provisioning-profile ./profile.mobileprovision \
     --apple-key ./AuthKey.p8 \
     --apple-key-id "KEY123" \
     --apple-issuer-id "issuer-uuid" \
     --apple-team-id "team-id"

   Untuk Android:

   bunx @capgo/cli@latest build credentials save \
     --platform android \
     --keystore ./release.keystore \
     --keystore-alias "my-key" \
     --keystore-key-password "key-pass" \
     --keystore-store-password "store-pass"

   Lihat panduan kredensial lengkap untuk detail.

2. Verifikasi Pembangunan Lokal

   Pertama, pastikan aplikasi Anda dapat dibangun secara lokal tanpa ada kesalahan:

   # Build your web assets
   bun run build
   
   # Sync with Capacitor
   bunx cap sync
   
   # Test local build (optional but recommended)
   bunx cap open ios    # For iOS
   bunx cap open android # For Android

3. Autentikasi dengan Capgo

   Atur kunci Capgo API Anda (jika belum terkonfigurasi):

   bunx @capgo/cli@latest login

   Atau tetapkan variabel lingkungan:

   export CAPGO_TOKEN=your_api_key_here

4. Jalankan Proyek Pertama Anda

   Mulai dengan build debug Android (paling cepat untuk tes):

   bunx @capgo/cli@latest build com.example.app \
     --platform android \
     --build-mode debug

   Anda akan melihat log waktu nyata saat proyek Anda berjalan:

   ✔ Creating build job...
   ✔ Uploading project (15.2 MB)...
   ✔ Build started
   
   📝 Build logs:
   → Installing dependencies...
   → Running Gradle build...
   → Signing APK...
   ✔ Build succeeded in 3m 42s

5. Periksa Status Build

   Aplikasi CLI akan secara otomatis memantau dan menampilkan status build. Setelah selesai, Anda akan melihat:

   • Waktu Pembangunan
   • Status Sukses/Gagal
   • Aplikasi disubmit ke App Store/Play Store (jika kredit konfigurasi)

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 - Projek Anda dikompress (mengesampingkan node_modules dan file-file rahasia)
2. Upload - Kompress tersebut diunggah ke penyimpanan cloud yang aman (Cloudflare R2)
3. Eksekusi Pembangunan - Aplikasi Anda membangun di infrastruktur yang terdedikasi
4. Pengaliran Log - Log waktu nyata mengalir ke terminal Anda melalui Server-Sent Events
5. Pembersihan Otomatis - Artifak pembangunan dihapus (Android: instan, iOS: 24 jam)

Infrastruktur Pembangunan

Eksekusi pembangunan berjalan di Mac Mini Silicon M4 yang terdedikasi:

• CPU M4 10 inti (4 inti kinerja, 6 inti efisiensi)
• GPU 10 inti
• Mesin Otak Neural 16 inti
• 16 GB RAM
• macOS Tahoe 26.2

Gambaran gambaran pembangunan mendukung Xcode 26.2, Android Studio 2025, dan .NET 9/.NET 10 SDK beban kerja asli untuk pipa pembangunan asli.

Build Produksi Pertama Anda

Setelah Anda memastikan proses berfungsi, buatlah build produksi:

Android

bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

Anda perlu mengonfigurasi kredit tanda tangan terlebih dahulu. Lihat Konfigurasi Build Android.

iOS

bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

iOS build memerlukan sertifikat penandatanganan dan profil pengaturan. Lihat Konfigurasi Build iOS.

Apa yang Dibangun

Capgo Hanya unggah file-file yang diperlukan minimum untuk mengompilasi aplikasi native Anda. Sumber penuh __CAPGO_KEEP_0__ Anda tidak pernah meninggalkan mesin Anda. to compile your native app. Your full source code never leaves your machine.

Apa yang Dibangun

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

Diketepikan	Mengapa
node_modules/ Banyaknya	Hanya plugin native code yang termasuk, bukan dependensi JS
src/	Sumber web Anda code tetap lokal
dist/, www/, build/ Pada tingkat root	Sudah disinkronkan ke folder native melalui cap sync
.git/	Riwayat kontrol versi
.gradle/, .idea/, .swiftpm/	Kacang tumbuk pembangunan dan pengaturan IDE
.envRahasia	Tidak pernah diunggah

Catatan

Aset web yang dibangun Anda (JS, CSS, HTML) telah diunggah - tetapi sebagai bagian dari folder native. Ketika Anda menjalankan bunx cap sync, pembangunan web Anda dikopi ke ios/App/App/public/ atau android/app/src/main/assets/public/. Itulah mengapa menjalankan 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 pembangunan framework Anda)
2. Sinkronisasi 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 Menghandle

• Kompilasi iOS native (Xcode, Fastlane)
• Kompilasi Android Asli (Gradle)
• Code tanda tangan dengan kredit Anda
• Penyubahan Aplikasi Toko (jika dikonfigurasi)

Waktu Pengerjaan & Biaya

Waktu pengerjaan diukur dari awal hingga selesai:

• Android: Biasanya 3-5 menit
• iOS: Biasanya 5-10 menit
• Infrastruktur: Mesin Mac Mini Silicon M4 yang menjalankan macOS Tahoe 26.2

Hanya membayar untuk waktu pembangunan yang sebenarnya digunakan. Tidak ada biaya rahasia.

Penggunaan Umum

Integrasi CI/CD

Aktifkan Capgo Build secara otomatis dari GitHub Actions workflow — ketika push, ketika tag, atau dengan klik tombol manual. Lihat panduan Capgo Actions yang khusus GitHub Actions guide Pengembangan Lokal

Bagian berjudul “Pengembangan Lokal”

Jendela terminal

# Quick debug build for testing
bun run build && bunx cap sync
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode debug

Buat untuk kedua platform dengan menjalankan dua perintah:

Buat untuk kedua platform dengan menjalankan dua perintah:

# iOS build
bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

# Android build
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

Dalam CI/CD, Anda dapat menjalankan ini secara parallel untuk mempercepat proses pembangunan.

Langkah-Langkah Selanjutnya

Sekarang Anda telah membuat pembangunan pertama:

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

Memerlukan Bantuan?

• Periksa panduan pengaturan
• Bergabunglah dengan komunitas Discord kami
• Hubungi dukungan email di support@capgo.app