Apple은 App Store Connect의 Not Available for Testing 상태를 Provisioning Profile에 앱 식별자가 포함되지 않은 경우로 설명합니다. 공식 빌드 상태 안내를 확인한 뒤, 해당 앱 식별자를 포함한 서명 자료로 새 빌드를 만들어 다시 업로드하세요. 초대 메일을 반복해서 보내는 것으로는 이 상태를 해결할 수 없습니다.
처음 TestFlight에 올린 빌드가 테스트 불가로 표시된 독립 개발자는 상태 세부 정보를 기준으로 다음 조치를 결정할 수 있습니다.
서명과 빌드 설정을 관리하는 소규모 팀은 실제 빌드에 쓰인 Provisioning Profile을 확인하세요.
외부 테스트를 준비하는 배포 담당자는 새 빌드가 사용 가능한 상태인지 확인한 뒤 테스트 그룹과 테스터 접근 권한을 점검해야 합니다.
빌드 상태 확인과 서명 문제의 구분
TestFlight 빌드 상태만 보고 원인을 단정하지 말고, App Store Connect에서 해당 빌드의 세부 상태와 안내를 먼저 읽으세요. 업로드 완료 메시지는 빌드가 테스트 가능한 상태라는 뜻이 아닙니다. Apple의 상태 정의에 따라 원인과 조치가 달라집니다.
| 화면의 상태 | 의미와 다음 확인 사항 |
|---|---|
| Not Available for Testing | Provisioning Profile에 앱 식별자가 포함되지 않은 상태입니다. 앱 식별자와 서명 자료를 확인하고 새 빌드를 업로드합니다. |
| Processing | 빌드 처리가 끝나지 않은 상태입니다. 서명 문제로 단정하지 말고 Apple의 빌드 상태 설명을 따릅니다. |
| Missing Compliance | 베타 빌드의 수출 규정 준수 정보가 필요할 수 있습니다. Apple의 수출 규정 준수 안내에서 해당 상태의 절차를 확인합니다. |
| Expired | 만료된 빌드입니다. 새 빌드를 준비하고 상태가 바뀌었는지 다시 확인합니다. |
이 구분은 대응 순서를 바꿉니다. Not Available for Testing이면 서명 자료를 우선 확인하지만, Processing이면 처리가 끝났는지 확인해야 합니다. Missing Compliance와 Expired 역시 앱 식별자 문제로 돌리지 말고 각 상태에 맞게 처리하세요.
Not Available for Testing은 어떤 뜻인가요?
이 문구는 테스트 그룹 설정만의 문제가 아니라 해당 빌드의 Provisioning Profile에 앱 식별자가 없다는 뜻입니다. 프로젝트의 Bundle Identifier와 프로파일에 들어 있는 앱 식별자가 일치하는지 확인하세요. 프로파일 이름이 앱 이름과 비슷하다는 사실만으로는 일치 여부를 판단할 수 없습니다.
주의: 개발 환경에서 선택한 프로파일과 실제로 아카이브에 적용된 프로파일이 다를 수 있습니다. 프로젝트 설정만 보지 말고 빌드 기록과 아카이브에 포함된 서명 정보까지 대조하세요.
프로파일 이름보다 실제 앱 식별자 확인
Provisioning Profile 앱 식별자가 올바른지 확인하려면 프로젝트의 Bundle Identifier, 서명 방식, 빌드에 사용된 프로파일을 함께 살펴봐야 합니다. Apple은 App Store 배포용 프로파일 생성 안내에서 프로파일 생성 과정을 설명하며, 기존 프로파일은 편집과 다운로드 안내에 따라 확인할 수 있습니다.
어떤 Provisioning Profile을 점검해야 하나요?
문제가 표시된 빌드의 아카이브에 실제로 적용된 프로파일을 점검하세요. 프로젝트에서 선택한 프로파일이 아니라, 해당 아카이브를 만든 구성에서 사용된 프로파일이 기준입니다. 대상 앱의 Bundle Identifier와 프로파일의 앱 식별자가 맞는지, 배포 서명 설정이 의도한 구성인지 확인합니다.
Xcode에서 직접 아카이브했다면 프로젝트의 서명 설정과 아카이브 정보를 대조하세요. 자동화 빌드라면 해당 실행의 빌드 로그에서 사용된 서명 설정과 프로파일을 찾아 아카이브 정보와 비교합니다. Apple의 Xcode 배포 문서를 참고하되, 사용 중인 Xcode 버전과 프로젝트 구성에 맞춰 실제 빌드 결과로 확인해야 합니다.
앱 식별자가 프로파일에 없다면 어떻게 하나요?
앱의 Bundle Identifier가 맞는지 확인하고, 해당 앱 식별자를 포함하도록 배포용 Provisioning Profile을 준비하세요. 그 프로파일이 실제 빌드 구성에 적용되는지도 검토한 뒤 다시 아카이브합니다. 설정 화면에서 프로파일을 바꾸는 것만으로 기존 아카이브의 서명 내용이 바뀌지는 않으므로, 수정한 구성으로 새 빌드를 만들어야 합니다.
새 빌드 업로드와 테스트 그룹 확인
다음 순서로 확인하면 서명 문제를 고친 뒤에도 남을 수 있는 배포 설정 문제를 분리할 수 있습니다.
- 프로젝트의 대상 앱과 Bundle Identifier를 확인합니다.
- 해당 앱 식별자를 포함한 Provisioning Profile을 준비하고, 빌드에 적용되는 서명 구성을 확인합니다.
- Xcode 수동 아카이브라면 프로젝트 설정과 아카이브 정보를 비교합니다. 자동화 빌드라면 해당 실행의 빌드 로그와 결과물을 함께 확인합니다.
- 수정된 서명 구성으로 새 아카이브를 만들고 Apple의 빌드 업로드 절차에 따라 올립니다.
- 업로드 성공 메시지만 보지 말고 App Store Connect에서 새 빌드의 처리 결과와 최종 상태를 확인합니다.
- 빌드가 테스트 가능한 상태가 되면 올바른 테스트 그룹에 연결되어 있는지, 테스터가 해당 빌드에 접근할 자격이 있는지 확인합니다.
외부 테스트 검토와 빌드 자체의 테스트 가능 여부는 별도 단계입니다. 빌드 상태가 사용 가능하더라도 외부 테스터가 곧바로 접근할 수 있다고 단정하지 말고, 그룹 연결과 검토 상태를 각각 확인하세요.
재업로드 뒤 테스터가 사용할 수 있는지 어떻게 확인하나요?
먼저 새 빌드가 App Store Connect에서 테스트 가능한 상태인지 확인하세요. 그다음 내부 또는 외부 테스트에 맞는 그룹에 빌드가 연결되었는지 살펴보고, 테스터가 해당 그룹에 포함되어 있는지 점검합니다. Apple의 빌드에 테스터 추가 안내와 TestFlight 개요를 기준으로 설정을 확인하면 빌드 문제와 접근 권한 문제를 구분하는 데 도움이 됩니다.
상황별 다음 조치
- 상태가 Not Available for Testing이면 프로파일에 앱 식별자가 포함됐는지 확인하고, 수정된 서명 구성으로 새 빌드를 만드세요.
- 상태가 Processing이면 서명 자료를 임의로 바꾸기보다 처리가 끝났는지 먼저 확인하세요.
- Missing Compliance가 표시되면 수출 규정 준수 정보를 처리하세요.
- 빌드가 Expired 상태라면 새 빌드를 준비하세요.
- 새 빌드가 사용 가능하지만 테스터가 접근하지 못하면 테스트 그룹 연결과 테스터 권한을 확인하세요.
새 아카이브와 업로드를 마친 뒤에는 프로젝트 변경 내용, 빌드 번호, 사용한 서명 구성의 출처, App Store Connect에 표시된 최종 상태를 함께 기록하세요. 그래야 수정된 설정이 실제 빌드에 반영됐는지, 문제가 해결된 빌드가 어느 것인지 나중에도 확인할 수 있습니다.
매번 로컬 장비에서 서명 구성을 맞추는 방식은 다른 작업과 개발 환경을 공유할 때 설정 추적이 번거로울 수 있고, 빌드용 Mac을 별도로 구매하면 장비 비용과 유지 관리가 따라옵니다. 반대로 지속적인 대량 빌드나 물리 장비 연결이 필요한 작업은 직접 관리하는 Mac이 더 적합할 수 있습니다. 원격 Mac에서 빌드 환경을 분리해 시험하려면 한국에서 이용할 수 있는 클라우드 맥 환경을 살펴보고, 현재 방식과 원격 환경의 차이는 Mac 이용 방식 비교에서 확인하세요. 일시적인 서명 검증이나 재빌드가 목적이라면 VpsHold의 Mac을 임대해 테스트한 뒤, 실제 배포 흐름에 맞는지 확인하고 운영 환경 전환 여부를 결정할 수 있습니다.
새 빌드 점검을 위한 전용 맥을 마련하세요
VpsHold의 전용 실물 맥 미니에서 서명 자료와 프로비저닝 프로파일을 확인하고 새 빌드 작업을 이어가세요.