Bangun Aplikasi iOS dari Windows dengan Capacitor dan Capgo Pembangunan

Membangun aplikasi iOS secara tradisional berarti satu hal: Anda memerlukan 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 Konteks: Halaman/area: Halaman live update produk. Peran: Judul bagian atau halaman. Dilihat di: halaman live-update.astro. Simpan Capgo produk/merek dan istilah pengembang secara tepat. Pesan kunci `live_update_platform_capacitor_title` (Judul Platform Live Update Capacitor). Capgo Build __CAPGO_KEEP_0__ Build

(untuk mengompilasi dan menandatanganinya di cloud) memungkinkan Anda melakukan pembangunan iOS dan pengiriman ke TestFlight dari workstation Windows.

Guid ini menunjukkan alur kerja yang praktis yang berfungsi baik dalam tim:
Membangun di Windows seperti proyek web normal. ios/ Tetapkan di repositori Anda (agar keadaan asli dapat direproduksi).
Jalankan cap sync secara lokal (sehingga pembangunan web Anda disalin ke proyek iOS).
Triggerlah pembangunan iOS di awan dengan Capgo Build.

Apa yang Anda Bangun Dimana

Ada dua pembangunan terpisah dalam aplikasi Capacitor:

Pembangunan Web (JS/HTML/CSS Anda): Anda melakukannya secara lokal di Windows.
Pembangunan Nativ (arsip Xcode, tanda tangan, unggah): Capgo Build melakukan hal ini di Mac hardware di awan.

Perbedaan ini adalah kunci: Capgo Build mengompilasi proyek natif, tetapi ia mengharapkan aset web Anda sudah disinkronkan ke ios/.

Persyaratan

Aplikasi Capacitor yang berfungsi (apapun frameworknya).
Rekening Pengembang Apple.
Koneksi App Store Connect untuk aplikasi yang ingin Anda unggah (untuk TestFlight/App Store submission).
Rekening dan token Capgo Anda serta 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 install

Pembangunan harus menghasilkan aset statis (untuk Vite ini adalah): dist/ 2) Tambahkan __CAPGO_KEEP_0__ dan Platform iOS

bun run build

Pasang Capacitor:

Install Capacitor:

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

Pada titik ini Anda akan memiliki

bunx cap init
bunx cap add ios

2) Tambahkan __CAPGO_KEEP_0__ dan Platform iOS ios/ directory. Kirimkan ke git. Capgo Build mengompilasi apa yang ada di dalamnya ios/, sehingga Anda ingin 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 ios

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

4) Pasang dan Autentikasi Capgo CLI

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

bunx @capgo/cli@latest login

atau atur token melalui variabel lingkungan di shell/CI:

export CAPGO_TOKEN="your_api_key_here"

5) Konfigurasi Tanda Tangan iOS untuk Build di Awang

Untuk membangun iOS Anda membutuhkan materi tanda tangan:

Sertifikat Distribusi Apple (.p12) dan kata sandi
Profil pengaturan (.mobileprovision)
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 berikut:

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

Jalan tercepat adalah: buat/export file-file ini sekali (sering menggunakan Mac apa pun, rekan tim, atau sewaan satu kali), kemudian 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"

Trik: di CI, simpan file-file kredit base64-encoding sebagai rahasia, dekod mereka pada waktu runtime, kemudian jalankan perintah yang sama. build credentials save 6) Jalankan Build iOS dari Windows

6) Jalankan Build iOS dari Windows

Dari folder aplikasi Anda:

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

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

7) Iterasi Cepat: Perbarui Hidup untuk Perubahan Web-Only

Capgo Build untuk perubahan native:

menambahkan/menghapus Capacitor plugin
mengubah izin native
mengubah ikon/splash
mengupdate Capacitor
mengubah perubahan Swift/Objective-C

Untuk perubahan UI sehari-hari dan perbaikan JavaScript, Anda biasanya ingin Perbarui Hidup sehingga Anda tidak perlu membangun biner native setiap kali.

A workflow timbal timbal timbal yang baik adalah:

Menggunakan Live Updates untuk perubahan web yang sering.
Menggunakan Capgo Build secara berkala ketika perubahan native diperlukan.

Kesalahan Umum Windows (dan Solusi)

Lupa cap sync: jika perubahan UI Anda hilang dalam pembangunan iOS, Anda mungkin telah membangun aplikasi web tetapi tidak menyinkronkannya ke ios/.
Tidak mengkomit ios/: Capgo Build mengompilasi proyek native. Jika folder tidak ada di git (atau tidak ada di konteks pembangunan Anda), pembangunan tidak dapat mengulangi aplikasi Anda.
Perubahan plugin tanpa rebuild native: menambahkan plugin adalah perubahan native; rencanakan Capgo Build (dan pengiriman ke toko) setelahnya.

Ringkasan

Anda tidak dapat menjalankan Xcode di Windows, tetapi Anda Membuat aplikasi iOS dari Windows: Wrap aplikasi web Anda dengan __CAPGO_KEEP_0__ (

Wrap your web app with Capacitor (ios/ Membangun aset web secara lokal, kemudian
Menggunakan __CAPGO_KEEP_0__ Build untuk mengompilasi, menandatangani, dan mengirimkan biner iOS Anda dari __CAPGO_KEEP_1__. cap sync.
Teruskan dari Membuat Aplikasi iOS dari Windows dengan Capgo dan CLI Build

Keep going from Build an iOS App from Windows with Capacitor and Capgo Build

Membuat Aplikasi iOS dari Windows dengan __CAPGO_KEEP_0__ dan __CAPGO_KEEP_1__ Build Build an iOS App from Windows with Capacitor and Capgo Build __CAPGO_KEEP_0__ CI/CD untuk alur kerja produk di Capgo CI/CD, for the product workflow in Capgo 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 GitHub Integrasi Aksi untuk detail implementasi di GitHub Integrasi Aksi