Test iOS dari mesin Windows atau Linux berujung pada satu fakta: iOS Simulator dan Safari Web Inspector hanya tersedia di macOS. Sisanya bisa diakali. Panduan ini menyusun alur testing bertahap yang bisa dijalankan tanpa Mac, dari browser sampai iPhone asli, dan menunjukkan di mana Build Capgo dan Live Update hilangkan waktu tunggu.
Tingkatan pengujian
| Level | Yang diuji | Di mana dijalankan | Butuh Mac |
|---|---|---|---|
| 1 | Lapisan web: logika, layout, desain responsif | Browser desktop dengan viewport iPhone | Tidak |
| 2 | Plugin Capacitor, native bridge, izin | Emulator atau perangkat Android | Tidak |
| 3 | Perilaku iOS asli: keanehan WebKit, safe area, keyboard, push, plugin iOS | iPhone via TestFlight | Tidak, dengan Capgo Build |
| 4 | Build QA ad hoc untuk perangkat tertentu | iPhone via Ad Hoc IPA | Tidak, dengan Capgo Build |
| 5 | Debugging native step-through di Xcode | Mac | Ya |
Sebagian besar bug tertangkap di level 1 dan 2. Level 3 menangkap bug khusus iOS. Level 5 jarang terjadi pada aplikasi Capacitor, dan jika terjadi, menyewa Mac selama satu jam lebih murah daripada memilikinya.
Level 1: browser dengan viewport iPhone
Buka dev server Anda di Chrome atau Edge, aktifkan device emulation dan pilih profil iPhone. Capacitor mengekspos info platform sehingga Anda bisa melakukan branching UI:
import { Capacitor } from '@capacitor/core';
if (Capacitor.getPlatform() === 'ios') {
// iOS-only behavior
}
Yang tidak tertangkap: perbedaan rendering WebKit, safe area insets, keyboard iOS yang mendorong viewport, dan apa pun yang menyentuh native plugin.
Level 2: Android dulu, karena web layer-nya sama
Capacitor menjalankan web bundle yang sama di kedua platform. Plugin wiring, permission prompts, dan bridge calls bisa divalidasi di Android dari Windows atau Linux menggunakan Chrome DevTools di chrome://inspect. Jika pemanggilan plugin berhasil di Android, sisi JavaScript sudah benar; yang tersisa adalah implementasi native iOS, yang Anda tes di level 3.
Panduan setup: Windows dan Linux.
Level 3: iPhone asli melalui TestFlight
Ini adalah jalur pengujian iOS utama tanpa Mac. Alurnya:
- Generate dan sync project iOS secara lokal.
- Ajukan cloud build dengan kredensial App Store Connect yang tersimpan.
- Buka TestFlight di iPhone.
bun run build
bunx cap sync ios
bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
Capgo mengompilasi dan menandatangani aplikasi di macOS, lalu mengunggahnya ke App Store Connect. Apple memproses build dan TestFlight menampilkannya kepada tester internal dalam hitungan menit. Tester internal (anggota tim App Store Connect Anda) tidak memerlukan Beta App Review, sehingga instalasi pertama cepat.
Setup kredensial cukup dilakukan sekali; bunx @capgo/cli@latest build init --platform ios panduan ini, dan sertifikat dapat dibuat tanpa Mac menggunakan OpenSSL atau iOS certificate generator kami.
Yang Anda dapatkan di perangkat: WebKit asli, safe area asli, keyboard asli, push notification asli, perilaku plugin asli. Itulah daftar hal yang tidak bisa diberitahu browser.
Level 4: build ad hoc untuk perangkat tertentu
Kalau tester berada di luar tim App Store Connect Anda, atau Anda ingin melewati pemrosesan Apple, gunakan profil Ad Hoc yang mencantumkan UDID perangkat:
bunx @capgo/cli@latest build request com.example.app \
--platform ios \
--ios-distribution ad_hoc \
--output-upload \
--output-record build.json
CLI mengembalikan tautan download berbatas waktu dan QR code untuk IPA. Masa retensi bisa diatur dari 1 jam sampai 7 hari dengan --output-retention. Profil ad hoc tidak butuh key API App Store Connect, hanya sertifikat dan profil.
Untuk mengambil UDID tester dari Windows atau Linux, minta mereka buka Settings > General > About di iPhone dan baca field tersebut, atau gunakan UDID web helper. Tambahkan perangkat di portal Apple dan buat ulang profilnya.
Iterasi tanpa build baru: Live Updates
Setelah build TestFlight terinstal, jangan rebuild setiap ada perubahan. Cukup push web bundle saja:
bun run build
bunx @capgo/cli@latest bundle upload --channel beta
Testers on the beta channel akan menerima bundle baru saat aplikasi dibuka berikutnya. Bagi tim di Windows atau Linux, ini mengubah feedback loop iOS dari “menunggu cloud build dan proses Apple” menjadi “hitungan detik”. Native rebuild hanya diperlukan saat ada perubahan plugin, permission, atau versi Capacitor.
Arahkan build TestFlight Anda ke channel khusus agar beta tester tidak menarik bundle produksi. Bagian panduan channels menjelaskan cara setup-nya.
Debugging iOS tanpa Safari Web Inspector
Inspector Safari hanya bisa terhubung dari macOS. Alternatif yang bisa dipakai dari OS apa pun:
- Structured logging ke remote sink. Kirim
console.errordan error bridge ke Sentry atau alat serupa. The Panduan Firebase Crashlytics untuk Capacitor mencakup setup native SDK. - Panel debug di dalam aplikasi. Tampilkan N baris log terakhir di view tersembunyi yang di-toggle lewat gesture. Murah dan efektif di build TestFlight.
- Log build. Masalah compile native muncul di log build Capgo yang di-stream ke terminal Anda. Tambahkan
--ai-analyticsagar build yang gagal dijelaskan otomatis. - Reproduksi di Android. Untuk apa pun di shared web layer, Chrome DevTools di Android memberi debugger lengkap.
Untuk crash native sungguhan yang butuh debugger Xcode, sewa Mac sejam atau tanya rekan tim. Kasus ini jarang di aplikasi Capacitor; sebagian besar masalah ada di web layer atau konfigurasi plugin.
Workflow mingguan yang realistis
- Harian: browser plus perangkat Android dari Windows atau Linux. Live Updates ke
betachannel untuk tester iPhone. - Saat ada perubahan native: satu Capgo Build ke TestFlight. Tunggu beberapa menit, tanpa Mac.
- Rilis: Capgo Build dengan distribusi App Store, lalu promosikan bundle channel.
Ringkasan
Anda tidak bisa menyimulasikan iOS di Windows atau Linux, tetapi bisa mengujinya di iPhone tanpa Mac. Capgo Build mengirim app yang sudah di-sign ke TestFlight atau link ad hoc dengan satu command, dan Live Updates membuat iterasi tetap cepat setelah terinstal. Simpan Mac untuk sesi debugging native yang jarang.