Windows 또는 Linux 머신에서 iOS를 테스트하는 핵심은 하나입니다: iOS 시뮬레이터와 Safari 웹 인스펙터는 macOS 전용이라는 사실입니다. 나머지는 모두 해결 가능합니다. 이 가이드는 Mac 없이 작동하는 테스트 단계를 브라우저부터 실제 iPhone까지 보여주고, 어디에서 Capgo 빌드 및 Live Update 기다림을 끝내세요.
테스트 단계별 가이드
| 단계 | 테스트 항목 | 실행 환경 | Mac 필요 여부 |
|---|---|---|---|
| 1 | 웹 레이어: 로직, 레이아웃, 반응형 디자인 | iPhone 뷰포트가 적용된 데스크톱 브라우저 | 아니요 |
| 2 | Capacitor 플러그인, 네이티브 브릿지, 권한 | Android 에뮬레이터 또는 기기 | 아니요 |
| 3 | 실제 iOS 동작: WebKit 특이사항, safe area, 키보드, 푸시, iOS 플러그인 | TestFlight를 통한 iPhone | 아니요, Capgo Build 사용 시 |
| 4 | 특정 기기용 Ad hoc QA 빌드 | Ad Hoc IPA를 통한 iPhone | 아니요, Capgo Build 사용 시 |
| 5 | Xcode에서 단계별 네이티브 디버깅 | Mac | 지원 |
대부분의 버그는 1단계와 2단계에서 발견됩니다. 3단계는 iOS에서만 나타나는 버그를 잡아줍니다. Capacitor 앱에서 5단계는 드물며, 발생하더라도 Mac을 1시간 빌리는 것이 구매하는 것보다 저렴합니다.
1단계: iPhone 뷰포트로 브라우저 테스트
Chrome 또는 Edge에서 개발 서버를 열고, 디바이스 에뮬레이션을 켜서 iPhone 프로필을 선택하세요. Capacitor은 플랫폼 정보를 노출하므로 UI를 분기할 수 있습니다:
import { Capacitor } from '@capacitor/core';
if (Capacitor.getPlatform() === 'ios') {
// iOS-only behavior
}
이 단계에서 잡히지 않는 것: WebKit 렌더링 차이, safe area insets, iOS 키보드가 뷰포트를 밀어내는 현상, 네이티브 플러그인을 사용하는 모든 경우입니다.
2단계: 웹 레이어를 공유하므로 Android 우선
Capacitor은 두 플랫폼에서 동일한 웹 번들을 실행합니다. 플러그인 연결, 권한 프롬프트, 브리지 호출은 Windows 또는 Linux에서 Chrome DevTools를 사용하여 Android에서 검증할 수 있습니다 chrome://inspect. 플러그인 호출이 Android에서 작동하면 JavaScript 쪽은 정상이며, 남은 것은 3단계에서 테스트하는 iOS 네이티브 구현입니다.
3단계: TestFlight로 실제 iPhone 테스트
Mac 없이 iOS를 테스트하는 주요 경로입니다. 흐름:
- iOS 프로젝트를 로컬에서 생성하고 동기화합니다.
- 저장된 App Store Connect 자격 증명으로 클라우드 빌드를 요청합니다.
- iPhone에서 TestFlight를 엽니다.
bun run build
bunx cap sync ios
bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
Capgo가 macOS에서 앱을 컴파일하고 서명한 뒤 App Store Connect에 업로드합니다. Apple이 빌드를 처리하면 몇 분 내에 TestFlight에서 내부 테스터에게 표시됩니다. 내부 테스터(App Store Connect 팀 멤버)는 Beta App Review를 거칠 필요가 없어 첫 설치가 빠릅니다.
자격 증명 설정은 한 번만 하면 됩니다. bunx @capgo/cli@latest build init --platform ios 가이드가 안내하며, 인증서는 Mac 없이 OpenSSL이나 iOS 인증서 생성기.
기기에서 확인할 수 있는 것: 실제 WebKit, 실제 safe area, 실제 키보드, 실제 푸시 알림, 실제 플러그인 동작. 이는 브라우저에서는 알 수 없었던 항목들입니다.
4단계: 지정된 기기용 ad hoc 빌드
테스터가 App Store Connect 팀 외부 인원이거나 Apple의 처리 과정을 건너뛰고 싶다면, 기기 UDID가 포함된 Ad Hoc 프로필을 사용하세요:
bunx @capgo/cli@latest build request com.example.app \
--platform ios \
--ios-distribution ad_hoc \
--output-upload \
--output-record build.json
CLI는 IPA에 대한 기간 한정 다운로드 링크와 QR code를 반환합니다. 보관 기간은 1시간에서 7일까지 설정할 수 있으며, --output-retention. Ad hoc 프로필에는 App Store Connect API 키가 필요 없고, 인증서와 프로필만 있으면 됩니다.
Windows나 Linux에서 테스터의 UDID를 수집하려면, 테스터에게 iPhone의 설정 > 일반 > 정보를 열어 해당 항목을 읽거나 UDID 웹 도우미를 사용하도록 요청하세요. Apple 포털에서 기기를 추가한 뒤 프로파일을 다시 생성하세요.
새 빌드 없이 반복 개발하기: Live Updates
TestFlight 빌드가 설치되었다면, 매번 다시 빌드할 필요 없습니다. 대신 웹 번들을 푸시하세요:
bun run build
bunx @capgo/cli@latest bundle upload --channel beta
테스터는 beta 채널에서 다음 실행 시 새 번들을 받습니다. Windows나 Linux를 사용하는 팀이라면 iOS 피드백 루프가 “클라우드 빌드와 Apple 처리 대기”에서 “단 몇 초”로 바뀝니다. 네이티브 재빌드는 플러그인, 권한 또는 Capacitor 버전이 바뀔 때만 필요합니다.
TestFlight 빌드가 전용 채널을 바라보게 설정해 베타 테스터가 프로덕션 번들을 가져가지 않도록 하세요. 채널 가이드에서 설정 방법을 확인하세요.
Safari Web Inspector 없이 iOS 디버깅하기
Safari 인스펙터는 macOS에서만 연결할 수 있습니다. 모든 OS에서 사용 가능한 대안은 다음과 같습니다:
- 원격 싱크로 구조화 로그 전송하기. 보내기
console.error그리고 브리지 오류를 Sentry 또는 유사한 도구로 전송하세요. 이 Firebase Crashlytics Capacitor 가이드 는 네이티브 SDK 설정을 다룹니다. - 앱 내 디버그 패널. 마지막 N개 로그 라인을 제스처로 토글되는 숨겨진 뷰에 렌더링하세요. TestFlight 빌드에서 저렴하고 효과적입니다.
- 빌드 로그. 네이티브 컴파일 문제는 터미널에 스트리밍되는 Capgo 빌드 로그에 표시됩니다. 추가하세요
--ai-analytics빌드 실패 시 자동으로 설명이 나오도록 합니다. - Android에서 재현. 공용 웹 레이어의 경우, Android의 Chrome DevTools로 전체 디버거를 사용할 수 있습니다.
Xcode 디버거가 필요한 진정한 네이티브 크래시의 경우, Mac을 1시간 빌리거나 팀원에게 도움을 요청하세요. Capacitor 앱에서는 드문 경우이며, 대부분의 문제는 웹 레이어나 플러그인 설정에 있습니다.
현실적인 주간 워크플로우
- 매일: Windows 또는 Linux에서 브라우저와 Android 기기를 사용하세요. Live Updates를
betaiPhone 테스터용 채널로 보내세요. - 네이티브 변경 사항이 반영되면: 단 한 번의 Capgo Build로 TestFlight에 올리세요. 몇 분만 기다리면 되고, Mac은 필요 없습니다.
- 릴리스: App Store 배포용 Capgo Build를 실행한 다음, 번들 채널을 승격하세요.
요약
Windows나 Linux에서 iOS를 시뮬레이션할 수는 없지만, Mac 없이 iPhone에서 테스트할 수 있습니다. Capgo Build를 사용하면 명령어 하나로 서명된 앱을 TestFlight나 ad hoc 링크로 보낼 수 있고, 설치 후에는 Live Updates로 빠르게 반복 개발할 수 있습니다. Mac은 드문 네이티브 디버깅 세션에만 사용하세요.