App Store Connect 도움말

App Store Connect / 빌드 관리 / 빌드 및 메타데이터 보기

빌드 관리

빌드 및 메타데이터 보기

각 빌드의 메타데이터를 포함하여 앱에 업로드한 모든 빌드를 볼 수 있습니다. 해당 섹션에서는 Apple에서 생성한 버전의 크기 및 빌드 제출의 진행 상황을 포함한 정보를 확인할 수 있습니다.

참고: 일부 빌드는 앱이 출시된 후 더 이상 표시되지 않을 수 있습니다.

App Store Connect API로 빌드 정보를 얻는 방법에 대해 알아보기.

필요한 역할: 계정 소유자, 관리, 앱 관리 또는 제품 개발. 역할 권한을 확인하십시오.

빌드 메타데이터 보기

  1. “앱”에서 확인하려는 앱을 선택합니다.

  2. “TestFlight” 탭을 클릭하여 모든 빌드를 확인합니다.

  3. 사이드바에서 확인하려는 빌드 메타데이터의 플랫폼을 선택합니다.

    참고: 빌드는 버전 번호로 구성되며, 버전 번호 옆에 있는 삼각형 아이콘을 클릭하여 각 버전에 업로드한 빌드를 확인할 수 있습니다. 빌드 그룹을 보려면 빌드 번호를 클릭하십시오.

  4. 빌드의 메타데이터를 확인하려는 경우, “빌드” 열의 버전 번호 하단에 있는 확장된 표에서 앱 아이콘을 선택하거나 빌드 문자열을 선택합니다.

    버전 1.0 아래에 빌드 목록이 나열되어 있고, 각 빌드는 클릭할 수 있는 아이콘과 빌드 문자열을 포함하는 모습을 보여주는 TestFlight 탭의 스크린샷입니다.
  5. 빌드 페이지에서 “빌드 메타데이터” 탭을 클릭합니다.

    “빌드 메타데이터” 페이지는 압축된 파일 크기, 필수 콘텐츠 크기, 추가적인 앱 내 구입 콘텐츠 크기와 같은 빌드 파일 크기를 비롯한 기타 빌드 관련 정보를 표시합니다.

빌드 파일 크기 보기

App Store Connect에 빌드를 업로드하면 앱 크기 최적화(App Thinning) 과정을 거치게 되며, 이 과정에서 다양한 기기와 운영체제 유형을 위한 앱의 변형 버전이 생성됩니다. App Store Connect에서 변형 버전들이 사용자의 기기에서 얼마만큼의 저장 공간을 사용하는지 직접 확인할 수 있습니다. App Store Connect에서 직접 고객의 기기에서 변형이 차지하는 공간을 볼 수 있습니다.

참고: 앱의 배포가 승인될 때, 이는 DRM(디지털 권한 관리)으로 암호화되고 재압축됩니다. App Store Connect에 바이너리를 업로드할 때보다 더 큰 앱 파일 크기가 표시될 수 있습니다. 앱 최종 버전의 구체적인 파일 크기는 미리 확인할 수 없습니다.

  1. “앱”에서 확인하려는 앱을 선택합니다.

  2. “TestFlight” 탭을 클릭하여 모든 빌드를 확인합니다.

  3. 사이드바에서 확인하려는 빌드의 플랫폼을 선택합니다.

  4. 빌드의 파일 크기를 확인하려는 경우, “빌드” 열의 버전 번호 하단에 있는 확장된 표에서 앱 아이콘을 선택하거나 빌드 문자열을 선택합니다.

  5. 빌드 페이지에서 “빌드 메타데이터” 탭을 클릭합니다.

  6. “일반 정보” 하단에서 “앱 파일 크기”를 클릭합니다.

    다운로드 및 설치 크기를 포함하는 다양한 기기 유형의 예상 앱 파일 크기를 보여주는 스크린샷입니다.

    표가 나타나고 여러 기기 유형에 따른 파일 크기가 표시됩니다.

    • 기기 유형은 각 변형 버전에 대응하는 기기를 표시합니다. 유니버설은 대량 구입으로 Apple School Manager와 Apple Business Manager 또는 모바일 기기 관리(MDM), iTunes 12.6 또는 이전 버전을 사용하여 다운로드를 통해 구입한 앱 중 iOS 8 또는 이전 버전을 사용하는 고객의 모든 운영체제 버전과 대상 기기에서 실행할 수 있는 변형 버전입니다.

    • 설치 크기는 앱이 사용자의 기기에서 차지할 디스크 공간 크기입니다. 설치 크기는 해당 앱의 제품 페이지의 정보 섹션에도 나타납니다.

    • 다운로드 크기는 셀룰러 또는 Wi-Fi를 이용해 다운로드된 앱의 압축된 크기입니다.

기기별 버전 크기 중 특정 항목이 200MB의 무선 다운로드 제한을 초과하는 경우, “빌드” 표에 있는 빌드 문자열 옆과 “앱 파일 크기” 표에 있는 버전 크기 옆에 노란색 경고 표시가 나타납니다. 경고 아이콘을 클릭하여 전체 경고를 읽을 수 있습니다. 또한, Apple은 해당 정보가 포함된 이메일을 발송합니다.

빌드 업로드 상태 보기

App Store Connect의 “빌드 업로드” 섹션에서 빌드의 버전 및 빌드 번호, 업로드 상태 및 생성 날짜를 확인할 수 있습니다. 업로드 상태는 경고, 오류 및 기타 정보를 포함하여 제출 진행 상황에 대한 자세한 정보를 제공합니다.

빌드의 업로드 상태가 확실하지 않은 경우, 피드백 지원에서 티켓을 제출(“개발자 도구 및 리소스(Developer Tools & Resources)” > TestFlight)하거나 Apple에 문의합니다. 문제 보고서에 버전 및 빌드 번호, 업로드 날짜 및 시간, 관련 로그와 같은 세부 사항을 포함하십시오.

  1. “앱”에서 확인하려는 앱을 선택합니다.

  2. “TestFlight” 탭을 클릭하여 모든 빌드를 확인합니다.

  3. 사이드바에서 확인하려는 빌드의 플랫폼을 선택합니다.

  4. 빌드의 제출 진행 상황을 확인하려는 경우, “빌드 업로드” 섹션을 확장한 다음 “상태” 열 하단에서 진행 상태를 참고합니다.

    팁: “빌드 업로드” 표의 오른쪽 최상단에 있는 “전체 상태” 드롭다운을 사용하여 상태별로 필터링할 수 있습니다.

  5. 상태를 선택하여 오류, 경고 또는 정보의 세부 사항을 볼 수 있습니다. 빌드가 “실패” 상태로 표시되는 경우, 다시 업로드하기 전에 모든 문제를 해결하십시오.

    참고:

    • 빌드가 “완료” 상태인 경우, “버전 및 빌드” 열에서 빌드 문자열을 선택하거나 “완료”를 클릭하여 자세한 내용을 확인할 수 있습니다.

    • 상태가 “완료”로 되어 있는 경우에도, 다음 업로드 전에 검토하고 해결해야 하는 경고 또는 기타 세부 사항이 있을 수 있습니다.

    • 빌드를 업로드하고 “처리 중” 상태가 24시간 이상 유지되는 경우 문제가 있을 수 있습니다. 이 문제를 해결하려면 피드백 지원에서 티켓을 제출하거나 Apple에 문의하십시오.

다음 표에는 다양한 빌드 업로드 상태에 대한 자세한 내용이 나열되어 있습니다.

상태

설명

업로드 대기 중

빌드 제출이 시작되었으며 Apple 빌드 업로드를 대기 중입니다.

처리 중

빌드 업로드가 아직 처리 중입니다. 빌드의 업로드 처리가 완료되면 이메일 알림과 함께 “빌드 업로드” 하단의 표가 업데이트된 상태를 표시하게 됩니다.

빌드를 업로드하고 “처리 중” 상태가 24시간 이상 유지되는 경우 문제가 있을 수 있습니다. 이 문제를 해결하려면 피드백 지원에서 티켓을 제출하거나 Apple에 문의하십시오.

실패

빌드 업로드 처리를 완료했으나 문제가 발생했습니다. 빌드를 선택하여 잠재적인 오류, 경고 및 실패와 관련된 정보를 확인하고, 빌드를 다시 업로드하기 전에 모든 오류를 해결했는지 확인하십시오.

참고: 빌드 업로드에 실패하는 경우에도, 다음 업로드에 동일한 빌드 번호를 재사용할 수 있습니다.

완료

빌드 업로드가 성공적으로 처리되었으며 이제 테스트할 준비가 되었습니다.

참고: 해당 상태 옆에 경고 배지가 있는 경우, 다음 업로드 전에 가능한 경고 또는 기타 정보를 검토하십시오.

참고: App Store Connect에서 상태가 업데이트될 때뿐만 아니라, 빌드가 “처리 중”, “실패” 또는 “완료” 상태인 경우 이메일 알림을 수신하게 됩니다.

빌드의 기기 요구 사항 보기

Apple 빌드 설정을 기반으로 앱 실행에 필요한 최소 운영 체제 버전을 계산합니다. “빌드 메타데이터” 페이지에서 빌드의 기기 요구 사항을 확인할 수 있습니다.

“iOS 빌드” 페이지의 “기기 요구사항” 섹션에 나열된 최소 iOS, macOS 및 visionOS 버전, LS 최소 시스템 버전, 지원되는 아키텍처, 기기 프로토콜, 기기 제품군 및 필수 기능을 보여주는 스크린샷입니다.
  • 최소 iOS 버전은 빌드에 제공된 MinimumOSVersion입니다.

  • 최소 macOS 버전은 Apple에서 파악한 앱 실행에 필요한 최소 macOS 버전입니다.

    Apple은 빌드에 제공된 LSMinimumSystemVersion과(해당되는 경우) macOS와 가장 근접한 MinimumOSVersion을 사용하여 최소 macOS 버전을 자동으로 계산합니다. 가격 및 사용 가능 여부에서 최소 macOS 버전을 선택하고 값이 LSMinimumSystemVersion 또는 MinimumOSVersion에 가장 근접한 macOS보다 높은 경우, 해당 버전이 대신 표시됩니다.

  • LS 최소 시스템 버전은 빌드에 제공된 선택 사항인 LSMinimumSystemVersion입니다.

dSYM 파일 다운로드

앱을 App Store Connect에 업로드할 때 비트코드를 포함하는 경우, Apple은 디버그 기호(dSYM) 파일을 생성하므로 Xcode 또는 App Store Connect에서 먼저 dSYM 파일을 다운로드해야 로그를 확인할 수 있습니다.

참고: Xcode 14부터 tvOS 또는 watchOS 앱에는 비트코드가 더 이상 필요하지 않으며, Apple은 더 이상 Xcode 14의 비트코드 제출을 허용하지 않습니다. dSYM 파일은 기존 비트코드 제출에서만 다운로드할 수 있으며, Xcode 14 이상에서 제출하는 경우에는 더 이상 사용할 수 없습니다.

dSYM 파일을 사용하여 충돌 보고서를 분석하는 방법에 대해 알아보기.

App Store Connect에서 빌드의 dSYM 파일을 다운로드하려면 다음을 진행하십시오.

  1. “앱”에서 확인하려는 앱을 선택합니다.

  2. “TestFlight” 탭을 클릭하여 모든 빌드를 확인합니다.

  3. 사이드바에서 확인하려는 빌드 메타데이터의 플랫폼을 선택합니다.

    참고: 빌드는 버전 번호로 구성되며, “버전” 탭을 클릭한 다음 버전 번호 옆에 있는 삼각형 아이콘을 클릭하여 각 버전에 업로드한 빌드를 확인할 수 있습니다. 빌드 그룹을 보려면 “빌드 그룹” 탭을 클릭하십시오.

  4. 빌드의 dSYM 파일을 확인하려는 경우, “빌드” 열의 버전 번호 하단에 있는 확장된 표에서 앱 아이콘을 선택하거나 빌드 문자열을 선택합니다.

    “버전 1.0” 아래에 빌드 목록이 나열되어 있고, 각 빌드에 클릭할 수 있는 아이콘과 빌드 문자열을 포함하는 모습을 보여주는 TestFlight 탭의 스크린샷입니다.
  5. 빌드 페이지에서 “빌드 메타데이터” 탭을 클릭합니다.

  6. “일반 정보” 하단에서 “dSYM 다운로드”를 클릭합니다.

    “iOS 빌드 메타데이터” 페이지의 “일반 정보” 섹션에서 화살표가 “기호 포함” 하단의 “dSYM 다운로드” 링크를 가리키고 있는 모습을 보여주는 스크린샷입니다.