Membangun aplikasi iOS secara tradisional berarti satu hal: Anda membutuhkan Xcode, dan Xcode berarti macOS. Konstrain ini mengganggu jika tim Anda seluruhnya berada di Windows atau Linux, atau jika Anda hanya tidak ingin menjaga mesin pembangunan Mac.
Kombinasi dari Capacitor (untuk menghasilkan proyek iOS asli) dan Membangun Capgo (untuk mengompilasi dan menandatanganinya di cloud) memungkinkan Anda melakukan pembangunan iOS dan pengiriman TestFlight dari sebuah workstation Windows.
Guida ini menunjukkan alur kerja yang praktis yang berfungsi dengan baik dalam tim:
- Membangun pada Windows seperti proyek web normal.
- Simpan
ios/di repositori Anda (agar keadaan asli dapat direproduksi). - Jalankan
cap syncsecara lokal (agar pembangunan web Anda dicopy ke proyek iOS). - Trigger pembangunan iOS di cloud dengan Capgo Build.
Apa yang Anda Bangun Dimana
Ada dua pembangunan terpisah dalam sebuah aplikasi Capacitor:
- Pembangunan Web Aplikasi JS/HTML/CSS Anda: Anda melakukan ini secara lokal di Windows.
- Build Nativ (Arsip Xcode, tanda tangan, unggah): Build Capgo melakukan hal ini pada perangkat Mac di awan.
Penyebutan ini adalah kunci: Build Capgo mengompilasi proyek native, tetapi ia mengharapkan aset web Anda sudah disinkronkan ke ios/.
Prasyarat
- Aplikasi Capacitor yang berfungsi (apapun frameworknya).
- Akun Pengembang Apple.
- Akses ke App Store Connect untuk aplikasi yang Anda ingin unggah (untuk TestFlight/App Store submission).
- Akun dan token Capgo Anda dan API (
CAPGO_TOKEN).
1) Buat atau Siapkan Aplikasi Capacitor Anda (Windows)
Jika Anda sudah memiliki aplikasi web, lewati ke langkah-langkah Capacitor.
Contoh dengan Vite:
bun create vite@latest my-app
cd my-app
bun installHarus menghasilkan asset statis (untuk Vite ini adalah dist/ oleh default):
bun run build2) Tambahkan Capacitor dan Platform iOS
Pasang Capacitor:
bun add @capacitor/core @capacitor/ios
bun add -d @capacitor/cliMulai dan buat folder platform iOS:
bunx cap init
bunx cap add iosPada titik ini Anda akan memiliki ios/ folder. Kirimkannya ke git. Capgo Build mengompilasi apa yang ada ios/di dalamnya, jadi Anda inginnya versi dan dapat direproduksi.
3) Selalu Sinkronkan Asset Web ke iOS Sebelum Membangun
Setiap kali Anda mengubah aplikasi web, lakukan urutan ini di Windows:
bun run build
bunx cap sync ioscap sync ini yang mengcopy asset web yang dibangun ke proyek iOS native (file-file Capgo Build yang akan sebenarnya dikompilasi).
4) Pasang dan Autentikasi Capgo CLI
Capgo Pembangunan diluncurkan melalui Capgo CLI. Dengan bun, gunakan bunx:
bunx @capgo/cli@latest loginatau 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 bahan 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 Penerbit, ID Tim)
Jika Anda masih perlu menghasilkan file-file ini, ikuti dokumentasi Capgo:
- Pengelolaan Kredensial (apa yang harus disimpan dan bagaimana)
- How to Get iOS Certificate dan Profile Pengaturan
The easiest path is: create/export these once (often using any available Mac, a teammate, atau a one-time rental), then reuse them from Windows for every subsequent build.
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 base64-encoded sebagai rahasia, dekod mereka pada waktu runtime, lalu jalankan perintah yang sama. build credentials save 6) Trigger an iOS Build dari Windows
Dari folder aplikasi Anda:
Anda akan melihat log waktu nyata di terminal Anda. 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 releaseYou 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
- HTML text fragment from a longer Capgo UI string (parent key `capwesome_diff_plugins_capgo`). Page/area: Capawesome comparison page. Role: Long marketing or legal paragraph. Seen in: page capwesome.astro. Preserve Capgo product/brand and developer terms exactly. Message key `capwesome_diff_plugins_capgo` (Capwesome Diff Plugins Capgo).
- mengubah ikon/splash
- mengupdate Capacitor
- perubahan-perubahan Swift/Objective-C
Untuk perubahan-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, sehingga perubahan UI Anda tidak muncul di build iOS, Anda mungkin telah membangun aplikasi web tetapi tidak menyinkronkannya keios/. - Not mengkomitkan
ios/: Capgo Build mengompilasi proyek native. Jika folder tidak ada di git (atau tidak ada di konteks build Anda), maka build tidak dapat mereproduksi aplikasi Anda. - Perubahan plugin tanpa rebuild native: menambahkan plugin adalah perubahan native; rencanakan Capgo Build run (dan pengiriman ke toko) setelahnya.
Ringkasan
Anda tidak dapat menjalankan Xcode di Windows, tetapi Anda dapat mengirimkan aplikasi iOS dari Windows:
- Kemas aplikasi web Anda dengan Capacitor (
ios/dalam repositori Anda). - Membangun asset web secara lokal, kemudian
cap sync. - Menggunakan 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 Nativ untuk alur kerja produk di Capgo Pembangunan Nativ, Capgo Integrasi untuk alur kerja produk di Capgo Integrasi, Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan Aksi Integrasi GitHub untuk detail implementasi di Aksi Integrasi GitHub.
