다음을 통해 공유

앱 스토어 및 TestFlight 배포

중요합니다

Visual Studio App Center는 2026년 6월 30일까지 계속 지원되는 분석 및 진단 기능을 제외하고 2025년 3월 31일에 사용 중지되었습니다. 자세히 알아보기.

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

필수 조건

  • 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 Connect 로 선택합니다.

  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에는 보안으로 앱별 암호가 필요합니다. 계정 설정 > 개발자 계정에서 앱별 암호를 추가할 수 있습니다.

팁 (조언)

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

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

CLI를 통해 게시

경고

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

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

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

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

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

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

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

이제 마지막 단계에서 사용할 열은 스토어 열입니다.

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

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를 제거하여 문제를 해결할 수 있습니다. 그런 다음 앱의 스토어 연결 페이지를 방문하여 연결을 선택하여 연결을 설정합니다.

  • Last updated on