홈 › 아이폰·애플워치 앱 설치

아이폰·애플워치 앱 설치

FootAIRun iOS 앱(아이폰)과 Apple Watch 앱은 App Store 정식 출시 전까지 TestFlight 또는 ad-hoc 설치로 미리 쓸 수 있습니다. 아이폰 앱을 설치하면 페어링된 Apple Watch 앱도 함께 설치됩니다.

iOS 17.4+ (아이폰) watchOS 10+ (Apple Watch) App Store 출시 전 베타

왜 APK처럼 바로 다운로드가 안 되나요?

아이폰은 보안 정책상 안드로이드 APK처럼 웹에서 받은 설치 파일을 그냥 열어 설치할 수 없습니다. App Store 출시 전에는 아래 두 가지 중 하나로 설치합니다.

1TestFlight (권장)가장 쉬움 · 기기 등록 불필요
2Ad-hoc 설치(.ipa)기기 UDID를 미리 등록한 테스터용
3맥북 Xcode 직접 설치무료 Apple ID 로 지금 바로 가능
지금 TestFlight·ad-hoc 링크가 없다면, 아래 방법 3(맥북 Xcode 직접 설치)으로 바로 설치할 수 있습니다.

방법 1. TestFlight 로 설치 (권장)

  1. 아이폰 App Store 에서 TestFlight 앱을 설치합니다.
  2. 아래 TestFlight 초대 링크를 아이폰 Safari 에서 엽니다. (관리자가 App Store Connect 에서 테스터를 초대하거나 공개 링크를 만든 뒤 이 자리에 링크가 표시됩니다.)
  3. TestFlight 가 열리면 설치(또는 업데이트)를 눌러 FootAIRun 을 받습니다.
  4. 아이폰 앱을 설치하면 페어링된 Apple Watch 의 Watch 앱에서 FootAIRun 워치 앱을 설치할 수 있습니다(자동 설치되지 않으면 Watch 앱 → 사용 가능한 앱에서 설치).
TestFlight 초대 링크가 아직 등록되지 않았습니다. 관리자가 App Store Connect 에서 빌드를 TestFlight 에 올리고 공개 링크를 config.js 의 IOS_TESTFLIGHT_URL 에 넣으면 여기에 버튼이 표시됩니다.

방법 2. Ad-hoc(.ipa) 설치 — 등록된 기기만

ad-hoc 설치는 기기의 UDID 가 프로비저닝 프로필에 미리 등록된 아이폰에서만 동작합니다. 등록되지 않은 기기에서는 "앱을 설치할 수 없습니다" 오류가 납니다. 일반 사용자는 위 TestFlight 를 쓰세요.

  1. 관리자에게 아이폰 UDID 를 전달해 프로비저닝 프로필에 등록합니다(설정 → 일반 → 정보, 또는 Apple Configurator).
  2. 아이폰 Safari 에서 아래 설치 버튼을 누릅니다(다른 브라우저는 itms-services 설치 링크를 열지 못합니다).
  3. "‘footairun.com’이(가) ‘FootAIRun’을(를) 설치하려고 합니다"에서 설치를 누르고 홈 화면에서 완료를 기다립니다.
  4. 설정 → 일반 → VPN 및 기기 관리에서 개발자/배포 인증서를 신뢰 처리합니다.
  5. 아이폰 앱 설치 후 Apple Watch 의 Watch 앱에서 FootAIRun 워치 앱을 설치합니다.
ad-hoc 빌드가 아직 게시되지 않았습니다. 관리자가 맥북에서 ad-hoc .ipa 와 manifest.plist 를 /downloads/ 에 올리고 config.js 의 IOS_IPA_INSTALL_URL(itms-services 링크)을 설정하면 여기에 버튼이 표시됩니다.

방법 3. 맥북 Xcode 로 내 아이폰에 직접 설치 (무료 계정 가능)

TestFlight·ad-hoc 링크가 아직 없어도, 맥북과 USB 케이블이 있으면 지금 바로 내 아이폰에 설치할 수 있습니다. 무료 Apple ID 로도 됩니다(이 경우 서명이 7일마다 만료되어 재설치가 필요합니다). 홈페이지에서 파일을 받는 방식이 아니라, 맥북에서 아이폰으로 바로 설치하는 방식입니다.

  1. 맥북에 Xcode(App Store 무료)를 설치합니다. 저장소를 내려받아 cd ios && brew install xcodegen && xcodegen 으로 FootAIRun.xcodeproj 를 만듭니다.
  2. 아이폰을 USB 로 맥북에 연결하고, 아이폰에서 "이 컴퓨터를 신뢰" 를 누릅니다. 아이폰 설정 → 개인정보 보호 및 보안 → 개발자 모드를 켭니다.
  3. Xcode 에서 FootAIRun.xcodeproj 를 열고, 상단 기기 선택에서 연결한 내 아이폰을 고릅니다. 두 타깃(FootAIRun, FootAIRunWatch)의 Signing & Capabilities 에서 본인 Apple ID 로 Team 을 지정합니다(무료 계정 가능).
  4. ▶︎ 실행(Run)을 누르면 아이폰에 FootAIRun 이 설치·실행됩니다. 처음엔 아이폰 설정 → 일반 → VPN 및 기기 관리에서 본인 개발자 인증서를 신뢰 처리해야 합니다.
  5. 페어링된 Apple Watch 가 있으면 아이폰 Watch 앱에서 FootAIRun 워치 앱을 설치합니다.
무료 Apple ID 로 설치하면 7일 후 앱이 열리지 않습니다(재설치 필요). 오래 쓰려면 유료 Apple Developer 계정으로 TestFlight(방법 1)를 쓰는 것이 좋습니다. 전체 명령은 저장소 ios/README.md 를 참고하세요.

관리자: 빌드 게시 방법 (맥북)

아이폰에는 서명·계정이 필요해 CI 가 자동 배포하지 않습니다. 맥북(Xcode)에서 빌드해 아래처럼 게시하세요. 자세한 명령은 저장소 ios/README.md 의 "맥북에서 App Store 배포하기"와 홈페이지 관리자 → 앱·배포 탭에 있습니다.

배포 방식게시 방법홈페이지 연결
TestFlight (권장) Xcode Organizer → App Store Connect 업로드 → TestFlight 에서 테스터 초대 또는 공개 링크 생성 config.js → IOS_TESTFLIGHT_URL
Ad-hoc(.ipa) ad-hoc 프로비저닝으로 export → FootAIRun.ipa 와 manifest.plist 를 public_html/downloads/ 에 업로드(HTTPS 필수) config.js → IOS_IPA_INSTALL_URL(itms-services://?action=download-manifest&url=…manifest.plist)

두 값 모두 비어 있으면 이 페이지는 설치 버튼 대신 안내 문구만 보여 줍니다. 값을 채워 배포하면 버튼이 자동으로 나타납니다. App Store 정식 출시 후에는 이 페이지 대신 App Store 링크로 바꾸세요.

← 다운로드로 돌아가기 안드로이드 APK 설치 보기