App Store 및 TestFlight 배포

  • 아티클

중요

Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. Visual Studio App Center가 완전히 사용 중지될 때까지 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.

지원 타임라인 및 대안에 대해 자세히 알아보세요.

App Center에서 Fastlane을 사용하여 iOS 앱 업그레이드를 App Store 및 TestFlight에 게시합니다.

사전 요구 사항

  • iOS 애플리케이션의 첫 번째 버전은 App Store Connect 포털을 통해 게시해야 합니다.
  • App Store 프로비저닝 프로필 및 프로덕션 인증서를 사용하여 앱을 컴파일합니다.
  • 앱을 제출할 준비가 되어 있어야 하며 App Store 지침을 통과해야 합니다.
  • 활성 Apple 개발자 프로그램 계정 또는 팀의 App Store Connect 계정에서 Apple ID를 관리자로 추가합니다.
  • 연결된 계정에는 앱을 게시할 수 있는 App Manager 권한이 있어야 합니다.

자세한 내용은 Apple 앱 배포 가이드를 참조하세요.

App Center와 App Store Connect 간의 연결 설정

참고

Apple 자격 증명 또는 App Store Connect API 키를 사용하여 App Store Connect에 연결할 수 있습니다. 안정성을 개선하고 Apple 개발자 포털에서 키에 대한 액세스 수준을 설정하려면 Connect API 키를 사용하는 것이 좋습니다. 또한 자격 증명, 2FA 및 앱별 암호와 마찬가지로 30일마다 연결을 갱신할 필요가 없습니다.

  1. 배포 아래에서 저장소 를 선택합니다.

  2. 페이지 중간에 있는 스토어에 연결 단추를 클릭합니다.

  3. 열리는 패널에서 저장소 유형을 App Store 연결로 선택합니다.

  4. 오른쪽 아래 모서리에서 다음 을 클릭합니다.

  5. App Store Connect API 키 또는 Apple 개발자 계정(일회성 활동)으로 로그인하고 연결을 클릭합니다.

  6. 로그인에 성공하면 Apple 계정이 여러 팀의 구성원인 경우 빌드를 연결할 팀을 선택하는 옵션을 사용할 수 있습니다. Apple 계정이 단일 팀의 구성원인 경우 선택 항목은 기본적으로 사용 가능한 단일 팀으로 설정됩니다.

  7. 이제 선택한 팀의 앱 목록을 선택할 수 있습니다.

  8. 업그레이드할 앱을 선택합니다.

  9. 선택한 앱에 대한 스토어 연결이 자동으로 설정됩니다.

    • Production이라는 App Store 연결입니다.
    • App Store Connect Users라는 내부 테스터에 대한 TestFlight 연결입니다.
    • 외부 테스터는 App Store Connect 콘솔에서 만든 외부 그룹을 기반으로 연결을 그룹화합니다.

  10. 이 연결을 설정하는 것은 App Center의 앱에 대한 일회성 프로세스입니다.

업로드 지침에 대한 드롭다운 메뉴에서 대상 선택

참고

배달 파일을 App Store Connect에 제출할 때 App Center는 기본적으로 다음을 수행합니다.

 add_id_info_uses_idfa: false
 export_compliance_uses_encryption: false
 export_compliance_encryption_updated: false

2단계 인증 추가

Apple 계정에 2단계 인증이 사용하도록 설정된 경우 App Store Connect에는 앱별 암호가 보안으로 필요합니다. 계정 설정 > 개발자 계정에서 앱별 암호를 추가할 수 있습니다.

팁

App Store 및 TestFlight에만 앱별 암호가 필요합니다. 2단계 인증을 사용하도록 설정된 Apple ID만 앱별 암호 업데이트를 선택할 수 있습니다.

  1. 계정 목록의 항목을 마우스로 가리킵니 다 .
  2. 목록 오른쪽에 있는 세로 점 3개를 클릭합니다.
  3. 앱별 암호 업데이트를 선택합니다.
  4. Apple ID 포털을 사용하여 앱별 암호를 생성합니다.
    • 이름은 앱별 암호를 사용하는 서비스 또는 앱을 기억하기 위한 것입니다.
  5. 생성된 앱별 암호를 복사하여 대화 상자에 붙여넣습니다.
  6. 업데이트를 클릭하여 저장 합니다.

CLI를 통해 게시

경고

이 기능을 사용하려면 App Center CLI 2.7 이상이 필요합니다.

CLI를 CI/CD 설정의 일부로 App Center의 저장소 연결을 통합하는 쉬운 방법으로 사용합니다(예: Jenkins 또는 Go CI).

CLI를 사용하고 호환되는 이진 파일을 컴파일하려면 App Store 대한 연결을 설정해야 합니다.

다음과 같이 list 명령을 사용하여 저장소를 나열할 수 있습니다.

appcenter distribute stores list \
--app {app_owner}/{app_name} \
--output json

다음과 같은 결과가 표시됩니다.

[["Production","apple","production"],["App Store Connect Users","apple","testflight-internal"]]

그리고 마지막 단계에서 사용할 Store 열입니다.

마지막 단계는 다음을 실행하여 앱을 게시하는 것입니다.

appcenter distribute stores publish \
--file /path/to/file.ipa \
--store Production \
--app {app_owner}/{app_name} \
--release-notes "Some note."

목록 명령과 같은 공백을 입력해야 합니다. 정적 릴리스 정보를 사용하는 대신 를 사용할 --release-notes-file 수 있습니다. 릴리스 정보 파일은 UTF-8로 인코딩된 일반 텍스트 파일입니다.

Apple ID에 관리자 역할이 필요한 이유

Apple은 앱을 만들고 버전을 제출하고빌드를 업로드하려면 관리자 역할이 적어도 필요합니다. 사용 권한을 명확히 하는 이 표를 참조하세요.

실패한 릴리스 디버깅

릴리스 게시에 실패하면 자세한 Fastlane 로그를 다운로드할 수 있습니다. 이러한 로그는 상태 > 다운로드 Fastlane 로그를 클릭하여 자세한 릴리스 페이지에서 찾을 수 있습니다.

재인증 실패

드물게 재인증에 실패하는 경우 계정 설정 섹션을 방문하여 Apple ID를 제거하여 문제를 해결할 수 있습니다. 그런 다음 앱의 스토어 연결 페이지를 방문하여 연결을 선택하여 연결을 설정합니다.