Build aplikasi iOS Capacitor saat Anda bekerja di Windows

Yang berfungsi di Windows

Kami menjalankan langkah ini di runner Windows Server 2025 milik GitHub dengan Node 22. Dokumentasi Capacitor meminta Node 22 atau lebih baru. Setiap langkah berhasil.

npm init @capacitor/app@latest capdemo -- --name CapDemo --app-id com.example.capdemo
cd capdemo
npm install
npm run build
npm i @capacitor/android @capacitor/ios
npx cap add android
npx cap add ios
npx cap sync ios

Build debug Android juga berhasil di sana dengan JDK 21. gradlew.bat assembleDebug memakan waktu 6 menit 33 detik di runner yang masih dingin. Hasilnya app-debug.apk sebesar 8.2 MB.

Kejutannya adalah npx cap add ios. Perintah ini jalan di Windows dalam waktu kurang dari satu detik dan menulis proyek Xcode yang lengkap. Ini yang dicetaknya:

√ Adding native Xcode project in ios in 47.04ms
[info] All Capacitor plugins have a Package.swift file and will be included in Package.swift
[info] Writing Package.swift
[success] ios platform added!

Swift Package Manager, bukan CocoaPods

Proyek Capacitor 8 memakai Swift Package Manager secara default. Dokumentasinya menyarankannya dan bilang CocoaPods adalah default sebelum Capacitor 8. Proyek baru kami tidak punya Podfile. Proyek itu punya ios/App/App.xcodeproj dan package CapApp-SPM yang menunjuk ke plugin Anda di node_modules.

Itulah kenapa langkah iOS sekarang bisa jalan di Windows. Tidak ada pod install yang perlu dijalankan. Jika proyek Anda masih memakai CocoaPods, pod install butuh macOS. Kami tidak menguji proyek CocoaPods di Windows. Untuk pindah ke SPM, dokumentasinya menawarkan npx cap spm-migration-assistant.

Yang masih butuh Mac

• xcodebuild dan Xcode. Capacitor 8 butuh Xcode 26.0 atau lebih baru, dan Xcode hanya jalan di macOS.
• npx cap open ios dan npx cap run ios. Keduanya menyerahkan proyek ke Xcode atau Simulator.
• iOS Simulator. Simulator ada di dalam Xcode.
• Signing, archive dan upload. Lihat publish tanpa Mac untuk bagian itu.

Serah terima Windows ke Mac yang kami uji

Kami commit proyek dari Windows ke git dan memindahkannya ke runner Mac. File .gitignore milik folder ios tidak menyertakan file web yang disalin dan config yang dihasilkan. Jadi Mac membuatnya ulang sebelum Xcode berjalan:

npm ci
npm run build
npx cap sync ios
xcodebuild -project ios/App/App.xcodeproj -scheme App \
  -configuration Debug -sdk iphonesimulator \
  -destination 'generic/platform=iOS Simulator' \
  -derivedDataPath build build

Build memakan waktu 36 detik dengan Xcode 26.6. Pada run pertama, Xcode mengambil capacitor-swift-pm 8.5.3 dari GitHub. Lalu kami memasang aplikasi di simulator iPhone 17 Pro dan membukanya. Layar sambutan Capacitor muncul.

xcrun simctl install booted build/Build/Products/Debug-iphonesimulator/App.app
xcrun simctl launch booted com.example.capdemo

Halaman iOS Capacitor masih menyuruh membuka App.xcworkspace. Proyek SPM tidak punya file itu, jadi buka ios/App/App.xcodeproj sebagai gantinya.

Build perangkat dengan signing dimatikan juga berhasil dalam 17 detik. Tambahkan CODE_SIGNING_ALLOWED=NO dan pakai -sdk iphoneos. Untuk rilis, buka proyek di Xcode, pilih tim Anda di Signing and Capabilities, lalu pilih Product, lalu Archive.

Bagaimana dengan Ionic Appflow?

Appflow build aplikasi iOS di cloud Ionic, dan halamannya masih menyebut begitu. Pada 11 Februari 2025, Ionic menghentikan penjualan baru Appflow. Pengguna yang sudah ada tetap punya akses sampai 31 Desember 2027. Jika Anda belum menjadi pelanggan, rencanakan jalur lain.

Menyewa Mac untuk satu langkah

Pass harian MacRun adalah Mac mini M6 khusus seharga $15, atau $59 untuk seminggu. Xcode 27.1 dan simulator iOS 27.1 sudah terpasang. Node belum. Anda punya hak admin dan Homebrew, jadi Anda memasang versi Node yang Anda pakai. Anda terhubung lewat SSH dan berbagi layar dari Windows. Mac dihapus saat pass berakhir. Panduan Simulator di Windows kami menunjukkan seperti apa layar jarak jauhnya.

Siapa yang sebaiknya tidak menyewa Mac untuk ini

Jika Anda hanya sesekali butuh build, runner macOS hosted bisa melakukannya. Perintah di atas jalan di GitHub Actions tanpa Mac milik kami sendiri. Codemagic mencantumkan dukungan Ionic dan memberi individu 500 menit macOS M2 gratis per bulan. Itu menurut halaman harganya pada 19 Oktober 2026. Jika Anda merilis setiap minggu, Mac bekas mungkin lebih murah dalam jangka panjang. Mac sewaan cocok saat Anda butuh Xcode terbuka, untuk masalah signing atau bug plugin native.