Buat Aplikasi iOS dari Windows dengan Capacitor dan Capgo Build

Membangun aplikasi iOS secara tradisional berarti satu hal: Anda membutuhkan Xcode, dan Xcode berarti macOS. Batasan itu mengganggu jika tim Anda seluruhnya berada di Windows atau Linux, atau jika Anda hanya tidak ingin menjaga mesin pembangun Mac.

Kombinasi dari Capacitor (untuk menghasilkan proyek iOS native) dan Membangun Capgo (untuk mengompilasi dan menandatanganinya di cloud) memungkinkan Anda melakukan build iOS dan pengiriman TestFlight dari sebuah workstation Windows.

Petunjuk ini menunjukkan alur kerja yang praktis yang berfungsi dengan baik dalam tim:

• Membangun di Windows seperti proyek web normal.
• Simpan ios/ dalam repositori Anda (agar keadaan asli dapat direproduksi).
• Jalankan cap sync secara lokal (agar build web Anda dicopy ke proyek iOS).
• Trigger build iOS cloud dengan Capgo Build.

Apakah yang Anda Bangun Dimana

There are two separate “builds” in a Capacitor app:

• build (JS/HTML/CSS Anda): Anda melakukan ini secara lokal di Windows.
• Pembangunan Nativ (Arsip Xcode, tanda tangan, unggah): Capgo Pembangunan melakukan ini di perangkat Mac di cloud.

Pemisahan ini adalah kunci: Capgo Pembangunan mengompilasi proyek native, tetapi ia mengharapkan aset web Anda sudah disinkronkan ke ios/.

Prasyarat

• A working Capacitor app (any framework is fine).
• Akses ke App Store Connect untuk aplikasi yang Anda ingin unggah (untuk TestFlight/Pengiriman ke App Store).
• Akun dan token __CAPGO_KEEP_1__ Anda.
• Your Capgo account and API token (CAPGO_TOKEN).

Jika Anda sudah memiliki aplikasi web, lewati ke langkah-langkah Capacitor.

If you already have a web app, skip to the Capacitor steps.

1) Buat atau Siapkan Aplikasi __CAPGO_KEEP_0__ Anda (Windows)

bun create vite@latest my-app
cd my-app
bun install

Build harus menghasilkan asset statis (untuk Vite ini adalah dist/ oleh default):

bun run build

2) Tambahkan Capacitor dan Platform iOS

Pasang Capacitor:

bun add @capacitor/core @capacitor/ios
bun add -d @capacitor/cli

Mulai dan buat folder platform iOS:

bunx cap init
bunx cap add ios

Pada titik ini Anda akan memiliki ios/ direktori. Kirimkannya ke git. Capgo Build mengompilasi apa yang ada ios/, sehingga Anda inginnya versi dan dapat direproduksi.

3) Selalu Sinkronkan Asset Web ke iOS Sebelum Membangun

Setiap kali Anda mengubah aplikasi web, lakukan urutan ini pada Windows:

bun run build
bunx cap sync ios

cap sync adalah yang menyalin asset web yang dibangun ke proyek iOS native (file-file Capgo Build yang akan sebenarnya dikompilasi).

4) Pasang dan Autentikasi Capgo CLI

Capgo Pembangunan diaktifkan melalui Capgo CLI. Dengan bun, gunakan bunx:

bunx @capgo/cli@latest login

Atau atur token Anda melalui variabel lingkungan di shell/CI:

export CAPGO_TOKEN="your_api_key_here"

5) Konfigurasi Tanda Tangan iOS untuk Bangun di Cloud

Untuk membangun iOS Anda memerlukan materi tanda tangan:

• Sertifikat Distribusi Apple (.p12) dan kata sandi
• Profil Pengaturan (.mobileprovision)
• Sertifikat App Store Connect API kunci (AuthKey_XXXXXX.p8) dan metadata (ID Kunci, ID Pengirim, ID Tim)

Jika Anda masih perlu menghasilkan file-file ini, ikuti Capgo dokumentasi:

• Pengelolaan Kredensial (apa yang harus disimpan dan bagaimana)
• Cara Mendapatkan Sertifikat dan Profil Pengaturan iOS

Jalan yang paling mudah adalah: buat/ekspor file-file ini sekali (sering menggunakan Mac apa pun, rekan kerja, atau sewa satu kali), lalu gunakan kembali dari Windows untuk setiap build berikutnya.

Setelah Anda memiliki file-file tersebut secara lokal, simpan mereka untuk Capgo Build:

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"

Tip: di CI, simpan file-file kunci berbasis 64 dalam bentuk rahasia, dekod mereka pada waktu runtime, lalu jalankan perintah yang sama. build credentials save 6) Jalankan Build iOS dari Windows

Dari folder aplikasi Anda:

Anda akan melihat log waktu nyata di terminal. Jika kunci App Store Connect Anda sudah terkonfigurasi, __CAPGO_KEEP_0__ Build dapat mengirimkan build hasilnya ke TestFlight secara otomatis.

bun run build
bunx cap sync ios
bunx @capgo/cli@latest build com.example.app --platform ios --build-mode release

You will see real-time logs in your terminal. If your App Store Connect key is configured, Capgo Build can submit the resulting build to TestFlight automatically.

__CAPGO_KEEP_0__ Build adalah untuk perubahan native:

menambahkan/menghapus Capgo plugin

• adding/removing Capacitor plugins
• __CAPGO_KEEP_0__ Build adalah untuk perubahan native: menambahkan/menghapus plugin Capgo
• mengubah ikon/splash
• mengupdate Capacitor
• perubahan-perubahan Swift/Objective-C

Untuk perubahan UI sehari-hari dan perbaikan JavaScript, Anda biasanya ingin Live Updates context: Halaman/area: Bagian masalah/penyelesaian. Peran: Judul bagian atau halaman. Dilihat di: halaman premium-support.astro. Kunci pesan `ps_help_updates_title` (Ps Help Updates Title).

(OTA), sehingga Anda tidak perlu membangun biner native setiap kali.

• Alur kerja tim yang baik adalah:
• Use Capgo Build occasionally when native changes are needed.

Pakai __CAPGO_KEEP_0__ Build secara berkala ketika perubahan native diperlukan.

• Kesulitan Windows yang Umum (dan Solusinya) cap syncLupa mengupdate __CAPGO_KEEP_0__ Build jika perubahan UI Anda tidak muncul di build iOS, kemungkinan besar Anda telah membangun aplikasi web tetapi tidak menyinkronkannya ke ios/.
• Not mengkomitkan ios/: Capgo Build mengompilasi proyek native. Jika folder tidak ada di git (atau tidak ada di konteks pembangunan Anda), maka pembangunan tidak dapat mereproduksi aplikasi Anda.
• Perubahan plugin tanpa rebuild native: menambahkan plugin adalah perubahan native; rencanakan Capgo Build run (dan pengiriman toko) setelahnya.

Ringkasan

Anda tidak dapat menjalankan Xcode di Windows, tetapi Anda dapat mengirimkan aplikasi iOS dari Windows:

1. Pasang aplikasi web Anda dengan Capacitor (ios/ dalam repositori Anda).
2. Membangun asset web secara lokal, kemudian cap sync.
3. Gunakan Capgo Build untuk mengompilasi, menandatangani, dan mengirimkan binary iOS Anda dari CLI.

Teruskan dari Build Aplikasi iOS dari Windows dengan Capacitor dan Capgo Build

Jika Anda menggunakan Build Aplikasi iOS dari Windows dengan Capacitor dan Capgo Build untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo Otomatisasi CI/CD untuk alur kerja produk di Capgo Otomatisasi CI/CD, Capgo Pembangunan Asli untuk alur kerja produk di Capgo Pembangunan Asli, Capgo Integrasi untuk alur kerja produk di Capgo Integrasi, Pengintegrasian CI/CD konteks: Halaman/area: Bagian Integrasi pemasaran. Peran: Judul bagian atau halaman. Dilihat di: halaman integrations.astro. Simpan Capgo produk/merek dan istilah pengembang secara tepat. Kunci pesan `integrations_title` (Judul Integrasi). Aksi Integrasi GitHub untuk detail implementasi di Aksi Integrasi GitHub.