App Store Connect 도움말
빌드 업로드
필요한 역할: 계정 소유자, 관리, 앱 관리 또는 제품 개발. 역할 권한을 확인하십시오.
계정에 앱을 추가한 후 Xcode, Swift Playground, altool 또는 Transporter를 사용하여 빌드를 업로드할 수 있습니다. App Store Connect API를 사용하는 경우, Transporter 명령어 라인 도구 및 JSON 웹 토큰(JWT) 인증을 사용하여 바이너리를 업로드해야 할 수 있습니다. API에 사용하는 것과 동일한 JWT를 사용하여 바이너리를 업로드할 수 있습니다. 추후 앱이 변경되면 테스트를 위해 빌드를 배포하거나 심사를 위해 앱을 제출할 수 있습니다.
빌드를 처음 업로드하면 앱의 베타 버전이 계정에 생성됩니다. 하지만 해당 빌드는 Apple의 시스템에서 처리 과정을 거쳐야 App Store Connect에 나타나게 되며, 처리 과정이 완료되면 이메일을 수신하게 됩니다.
빌드를 업로드할 때마다 번들 ID 및 버전 번호(앱 번들에 포함된)가 App Store Connect에서 빌드와 앱, 그리고 버전 내역을 연계하는 데 사용됩니다. 빌드 문자열은 시스템 전체에서 해당 빌드를 유일하게 식별하는 용도로 사용됩니다.
또한, 지속형 통합 및 제출(CI/CD)을 지원하는 Xcode Cloud를 사용하여 빌드를 생성하고 업로드할 수 있습니다. 이 방법을 통해 지속적으로 소프트웨어 품질을 모니터링하고 개선할 수 있으며, 앱 또는 프레임워크를 항상 출시 가능한 상태로 유지할 수 있습니다. Xcode Cloud에 대해 알아보기.
Apple이 호스팅하는 백그라운드 자산을 사용하여 빌드와 별도로 관리되는 자산을 업로드할 수도 있습니다. 더 알아보기.
Xcode로 앱 바이너리 파일 업로드
Xcode는 Apple의 통합 개발 환경(IDE)입니다. Xcode를 사용하여 iPhone, iPad, Mac, Apple TV, Apple Vision Pro 및 Apple Watch를 포함한 Apple 제품용 앱을 빌드할 수 있습니다. Xcode는 앱 개발에서 테스트, 최적화 및 심사를 위한 제출까지 전체적인 개발의 워크플로를 관리하는 도구를 제공합니다.
Xcode를 사용하여 앱 바이너리를 업로드하는 방법은 베타 테스트 및 출시를 위한 앱 배포(Distributing your app for beta testing and releases) 페이지를 방문하여 참고하거나, Xcode에서 “도움말(Help)” > “Xcode 도움말(Xcode Help)”을 선택하고 “베타 테스트 및 출시를 위한 앱 배포(Distributing your app for beta testing and releases)”를 검색하십시오.
Mac App Store에서 Xcode를 다운로드하십시오.
지원되는 Xcode 버전
App Store Connect는 고객에게 배포할 앱 또는 TestFlight를 사용하여 테스터에게 배포할 앱을 업로드할 때 아래와 같은 Xcode의 버전을 지원합니다. 경고, 오류, 제출 로그와 같은 제출 진행 상황과 과거 제출 기록을 확인할 수 있습니다.
참고: 2026년부터 App Store Connect에 앱을 업로드 할 때 Xcode 14 또는 그 이상 버전을 사용해야 합니다.
대상 유형 |
Xcode를 사용하여 빌드 |
Xcode를 사용하여 업로드 |
---|---|---|
iOS 앱 iOS 앱 확장 프로그램 watchOS 앱 확장 프로그램 |
Xcode 16 또는 이상 버전 |
Xcode 6 또는 이상 버전 |
macOS 앱 |
Xcode 6 또는 이상 버전 |
Xcode 6 또는 이상 버전 |
tvOS 앱 |
Xcode 16 또는 이상 버전 |
Xcode 7.1 또는 이상 버전 |
visionOS 앱 |
Xcode 16 또는 이상 버전 |
Xcode 15 또는 이상 버전 |
Transporter 및 altool에서 모든 대상 유형을 업로드할 수 있습니다.
altool으로 앱 바이너리 파일 업로드
Xcode에 포함된 xcrun
으로 앱 바이너리 파일을 확인하고 App Store Connect에 업로드하는 데 사용되는 명령어 라인 도구인 atool을 불러올 수 있습니다. “터미널”의 명령어 라인에서 아래 내용 중 하나를 지정하십시오.
$ xcrun altool --validate-app -f file -t platform -u username [-p password] [--output-format xml]
$ xcrun altool --upload-app -f file -t platform -u username [-p password] [--output-format xml]
Transporter로 앱 바이너리 파일 업로드
Transporter 배포할 앱을 App Store Connect 에 쉽고 간편하게 업로드할 수 있는 방법을 제공하는 macOS 앱입니다. 경고, 오류 그리고 제출 로그를 포함한 제출 진행 상황과 과거 제출 기록을 확인할 수 있습니다.
참고: 2026년부터 아스페라와 시그니언트 전송 프로토콜을 사용하여 앱을 업로드하려면 올해 말에 출시될 새로운 버전의 Transporter를 사용해야 합니다. 기본값인 HTTPS 전송 프로토콜은 영향을 받지 않습니다.
Mac App Store에서 Transporter의 최신 버전을 다운로드 할 수 있습니다.