간단하게 윈도우에서 iOS 빌드하고 아이폰 앱 설치하는 방법 / Github Actions, Sideloadly, iTunes
아이폰에서 테스트가 필요한 개발중인 앱이 있는데, 출시전에 간단하게 내 아이폰에서 설치 후 테스트가 필요해서 방법을 찾아보던중 무료 + 간단하게 설치 후 테스트할 수 있는 방법이 있어서 정리했다.
1단계 - 워크플로를 GitHub에 올리기
파일을 커밋 → main에 push
2단계 - 클라우드 빌드 실행 (GitHub 웹)
GitHub → Actions 탭 → "iOS unsigned IPA" → Run workflow 클릭 → 완료
→ 완료된 실행 페이지 하단 Artifacts에서 ios-unsigned-ipa 다운로드 (zip 안에 app-unsigned.ipa).
3단계 - Windows에서 아이폰에 설치
- iTunes 설치 (Apple 공식 - Windows가 아이폰을 인식하려면 필요)
- Sideloadly 설치 (sideloadly.io)
- 아이폰 USB 연결 → "이 컴퓨터를 신뢰" 허용
- Sideloadly 열기 → 기기 선택 → IPA 드래그 → Apple ID 입력
- Bundle ID를 본인 것으로 (예: com.minsu.kiwitest)
- 2단계 인증 계정이면 앱 암호(app-specific password) 필요
- Start → 재서명 후 설치됨
- 아이폰 : 설정 → 일반 → VPN 및 기기 관리 → 본인 개발자 신뢰
- 앱 실행 → "로컬 네트워크 허용" 반드시 허용
꼭 알아둘 것
- 무료지만, 개인 혼자서 간단한 앱 단기간 테스트에 적합
- 7일마다 재설치 (무료 인증서 만료) - 3단계를 주마다 반복해야하는 단점
- 개선 가능한 대체 도구
- AltStore : PC에 AltServer 상주 → 같은 WiFi에 있으면 백그라운드 자동 갱신
- SideStore : 초기 세팅 후 PC 없이 아이폰 자체에서 갱신
- 개선 가능한 대체 도구
- 다른 사람에게 배포 사실상 불가, 푸쉬 알림 불가
- 심사 없음, 셋업 난이도 EASY
- 무료 계정 : 사이드로드 앱 최대 3개, 앱 ID 주 10개 제한
- GitHub Actions 무료 한도 : 리포가 공개면 무제한, 비공개면 macOS 분이 10배로 계산돼 월 ~10회 빌드 정도. 부족하면 Codemagic(월 500분 무료)이 대안
- 서명은 Sideloadly가 설치 시점에 처리하므로 pbxproj 번들ID는 안 건드려도 됩니다.
