증상 → 기존 스크린샷 자동화에 폐기 표시된 리소스가 남아 있습니다. 빠른 해결 → 새 연동은 App Asset Library로 시작하고, 기존 연동은 소재 종류별로 자산과 배치를 나눠 이전한 뒤 앱마다 업로드·표시·정렬을 검증하세요.

이 글은 스크린샷이나 미리보기 동영상 업로드를 자동화하는 독립 개발자, 여러 앱이나 사용자 설정 제품 페이지 소재를 관리하는 소규모 팀, 앱 내 이벤트 미디어 자동화를 운영하는 개발자를 위한 점검 안내입니다.

Apple은 App Store Connect API 4.5.1에서 기존 스크린샷, 미리보기 및 일부 앱 내 이벤트 소재 리소스를 폐기 대상으로 표시했습니다. 그러나 폐기 표시는 즉시 서비스 중단과 같지 않습니다. Apple 릴리스 노트와 소재 관리 문서를 기준으로 현재 호출 범위를 확인하고, 중단이 발표되지 않은 인터페이스를 즉시 멈추기보다 계획을 세워 옮기세요. API 4.5.1 릴리스 노트

마지막 확인: 2026년 10월 15일. 확인 근거는 Apple의 API 릴리스 노트, 앱 소재 관리 안내, 소재 상태 설명, 소재 업로드 설명입니다.

이전 우선순위와 폐기 상태

먼저 현재 구현이 어떤 리소스를 읽고 쓰는지 확인하세요. 폐기 표시만 보고 기존 요청을 중단하면 정상 운영 중인 배포 작업에 불필요한 장애를 만들 수 있습니다. 반대로 새 연동에 기존 모델을 복사하면 곧바로 다시 이전해야 할 수 있습니다.

<
현재 상황선택할 방향판단 근거
새로 만드는 자동화App Asset Library 사용새 자산 모델에 맞춰 구현하면 기존 세트 구조를 새 코드에 추가하지 않아도 됩니다.
기존 자동화가 폐기 대상 리소스를 호출소재 유형별로 이전 계획 수립읽기, 쓰기, 수정, 삭제, 정렬 호출을 함께 파악해야 합니다.
자동화가 관련 리소스를 사용하지 않음당장 변경하지 않고 영향 감시무관한 흐름을 수정하지 말고 릴리스 노트와 실제 호출 목록을 다시 확인하세요.
Apple은 해당 리소스를 폐기 대상으로 표기했지만, 여기서 기존 인터페이스의 정지 날짜를 추정할 근거는 없습니다. 발표되지 않은 기한을 코드에 가정으로 넣지 말고, 새 개발과 기존 운영을 구분해 대응하세요.

조건별 결정 분기

  • 새 자동화이거나 기존 소재 흐름을 아직 구현하지 않았다면 App Asset Library 모델을 선택하세요.
  • 기존 코드가 폐기 대상 리소스를 호출한다면 앱과 소재 유형별 목록을 만든 뒤 단계적으로 이전하세요.
  • 해당 리소스를 호출하지 않는다면 범위 밖 코드를 손대지 말고, 호출 목록과 Apple 안내를 기준으로 영향 여부를 확인하세요.
  • 출시 직전이라 변경 검증 시간이 부족하다면 운영 중인 흐름을 성급하게 교체하지 마세요. 별도 검증 환경에서 새 모델의 표시 결과를 확인한 다음 이전 시점을 정하세요.

자산과 배치의 대응 관계

기존의 세트 중심 흐름은 표시 위치에 맞춰 소재 세트를 관리하는 방식입니다. App Asset Library에서는 이미지나 동영상을 자산으로 저장하고, 배치를 통해 대상 페이지와 현지화를 연결합니다. 따라서 같은 소재 파일이더라도 라이브러리의 자산 기록 자체가 페이지에서 표시된다는 뜻은 아닙니다.

<
구분기존 세트 중심 흐름App Asset Library 흐름
관리 단위페이지 위치에 연결된 소재 세트라이브러리의 이미지 또는 동영상 자산
표시 대상 지정세트와 표시 위치 중심자산과 placement 연결 중심
현지화 관리세트별로 연결 상태를 확인배치의 대상 현지화와 표시 결과를 확인
변경 영향세트 수정과 삭제가 중심자산과 연결된 배치의 관계를 함께 추적
Apple의 [앱 소재 관리 안내](https://developer.apple.com/help/app-store-connect/manage-app-information/manage-your-app-store-assets?utm_source=openai)를 참고해 현재 사용하는 소재 종류와 새 모델의 개념을 대응시키세요. 문서에 있는 이름만 치환하는 것으로 끝내지 말고, 자산 ID와 배치 ID를 내부 기록에서 추적할 수 있도록 연결 정보를 보존해야 합니다.

인터페이스 사용 범위 점검

이전 범위는 업로드 호출 하나로 정해지지 않습니다. 앱 버전 스크린샷과 미리보기, 사용자 설정 제품 페이지 소재, 제품 페이지 실험 소재, 앱 내 이벤트 소재를 별도로 살펴보세요. 각 흐름에서 읽기, 업로드, 수정, 삭제, 순서 변경이 어디에서 일어나는지 확인해야 합니다.

다음 표는 실제 호출을 분류하기 위한 대응 틀입니다. 특정 기존 리소스가 모든 새 배치 유형과 일대일로 바뀐다고 가정하지 말고, 각 앱의 API 참고 데이터와 처리 결과를 기준으로 연결을 확정하세요.

<
기존 자동화에서 확인할 항목새 모델에서 점검할 대상빠뜨리기 쉬운 동작
스크린샷 세트와 이미지이미지 자산 및 대상 배치기존 이미지 조회와 교체 경로
미리보기 세트와 동영상동영상 자산 및 대상 배치처리 상태 확인과 실패 후 정리
앱 내 이벤트 소재지원되는 자산 유형 및 이벤트 표시 배치기존 이벤트 연결을 읽고 수정하는 흐름
사용자 설정 제품 페이지·실험 소재해당 페이지에서 허용되는 배치현지화, 표시 순서, 삭제 후 남은 연결
코드 저장소에서 관련 리소스 이름과 요청을 찾아 API 호출 목록을 만드세요. 이어서 앱별로 소재가 생성되는 지점, 페이지를 조회하는 지점, 사용되지 않는 소재를 정리하는 지점을 기록합니다. 업로드 코드만 새 방식으로 바꾸면 이전 소재를 읽거나 정리하는 구간이 그대로 남을 수 있습니다.

지원 위치와 규격의 런타임 확인

새 흐름에서는 지원되는 placement 유형과 placement group, 소재 규격을 영구적인 상수로 고정하지 마세요. API의 참고 데이터를 읽어 현재 앱과 요청 맥락에서 사용할 수 있는 값을 확인하고, 값이 없거나 연결 요청이 거부되면 지원 여부를 추측하지 말고 응답을 기록하세요.

특히 IPHONE_DUO는 Apple 문서에 제공된 소재 표시 범주로 다뤄야 합니다. 그 이름이 있다는 이유만으로 모든 앱이나 모든 소재가 그 위치를 지원한다고 결론 내리면 안 됩니다. 소재 업로드 안내와 런타임 참고 데이터를 함께 확인하고, 실제 배치 요청의 결과를 검증하세요.

자산 업로드 성공은 소재 처리가 끝났거나 페이지에 표시됐다는 뜻이 아닙니다. Apple이 설명하는 [소재 상태](https://developer.apple.com/help/app-store-connect/reference/app-information/app-store-asset-statuses?utm_source=openai)를 확인하고, 처리·배치·페이지 선택·심사 상태를 서로 다른 결과로 기록하세요.

이전 작업과 유지 관리

다음 순서로 기존 자동화를 점검하면 업로드만 교체하고 나머지 호출을 놓치는 위험을 줄일 수 있습니다.

  • 운영 중인 앱과 소재 흐름을 나누고, 각 흐름이 사용하는 기존 리소스를 기록합니다.
  • 호출 목록에 읽기, 생성, 업로드, 수정, 삭제, 순서 변경을 모두 표시합니다.
  • 새 자산의 로컬 식별자와 App Asset Library 식별자를 연결해 추적할 방법을 정합니다.
  • API 참고 데이터에서 사용할 수 있는 배치 유형과 그룹을 확인한 뒤, 지원되는 경우에만 위치와 현지화를 연결합니다.
  • 업로드 응답뿐 아니라 소재 처리 상태와 배치 생성 결과를 따로 기록합니다.
  • 화면에서 페이지와 현지화별 소재 선택 및 순서를 확인한 다음, 정리 대상 자산과 배치를 검토합니다.
  • 실제 운영 반영 전에는 앱별로 API 결과와 App Store Connect 화면 결과가 일치하는지 확인합니다.
정렬과 삭제는 이전 단계에서 특히 주의해야 합니다. 기존 세트 하나를 지우면 연결 소재까지 정리됐다고 가정하지 마세요. 새 모델에서는 자산과 배치가 별도로 관리될 수 있으므로, 삭제 전 연결을 조회하고 삭제 후 잔여 배치와 화면 표시를 확인해야 합니다. Apple이 정한 동작과 실제 응답을 기준으로 정리 순서를 구현하세요.

앱별 엔드투엔드 승인 기준

검증은 수정 가능한 앱 소재 하나를 골라 업로드에서 페이지 표시까지 이어서 수행하세요. 결과는 요청 성공 여부만 적지 말고 다음 상태를 분리해 남기세요.

  • 자산 생성과 업로드 요청이 예상한 자산을 반환하는지 확인합니다.
  • 소재 처리가 완료됐는지 상태 정보를 확인합니다.
  • 의도한 placement와 현지화가 연결됐는지 조회합니다.
  • 페이지의 소재 선택과 표시 순서가 기대한 결과인지 화면에서 확인합니다.
  • 소재의 심사 상태는 업로드나 화면 표시와 별도로 기록합니다.
  • 삭제와 재연결을 수행했다면 남은 연결과 화면 결과를 다시 확인합니다.
여러 앱을 한꺼번에 바꾸기보다 소재 종류와 앱별 검증 결과를 기준으로 전환 범위를 넓히세요. 소재 자동화를 원격 Mac에서 실행할 수는 있지만, App Store Connect API 호출 자체가 Mac을 필수로 요구하는 것은 아닙니다. 소재 생성이나 배포 스크립트가 macOS 도구 체인에 의존하는지부터 구분하세요. 지속적으로 사용할 원격 환경을 검토한다면 [MACGPU의 원격 Mac 구성과 이용 안내](https://macgpu.com/ko/m4-jumun.html)에서 기본 조건을 살펴보고, 서울에서 접속할 환경을 알아보는 경우에는 [서울 원격 Mac 선택 안내](https://macgpu.com/ko/m4-jumun-seoul.html)도 비교 자료로 활용할 수 있습니다.

자주 묻는 질문

App Store Connect API 4.5.1에서 폐기된 소재 리소스는 무엇인가요?

Apple 릴리스 노트는 기존 스크린샷 세트와 스크린샷, 미리보기 세트와 미리보기, 일부 앱 내 이벤트 소재 리소스를 폐기 대상으로 표시합니다. 폐기 표시는 즉시 작동 중단과 같지 않습니다. 현재 자동화가 해당 리소스를 사용하는지 확인하고 이전 계획을 세우세요.

App Asset Library와 기존 스크린샷 세트 방식은 어떻게 다른가요?

기존 방식은 표시 위치 중심으로 소재 세트를 관리합니다. 새 방식은 이미지를 자산으로 저장하고 placement를 연결해 페이지와 현지화를 지정합니다. 자산 자체와 화면 표시 위치가 별도이므로, 조회와 배치, 순서 변경, 삭제를 각각 검증해야 합니다.

같은 이미지를 여러 현지화 페이지에 연결할 수 있나요?

자산을 라이브러리에 등록한 뒤 각 대상에 필요한 placement를 연결하는 모델로 구성하세요. 다만 모든 이미지와 위치 조합이 지원된다고 가정하지 마세요. API 참고 데이터와 요청 결과를 확인하고, 각 현지화 페이지에서 실제 선택 상태와 표시 순서를 검증해야 합니다.

placement 연결과 정렬은 무엇을 기준으로 검수하나요?

업로드 응답만으로 완료 처리하지 마세요. 소재 처리 상태, placement 연결, 페이지의 선택 결과와 순서를 별도로 확인하세요. API 기록과 App Store Connect 화면을 대조하면 업로드 성공, 처리 완료, 페이지 표시, 심사 상태를 서로 혼동하지 않고 추적할 수 있습니다.

현재 노트북이나 일반 서버에서 실행하는 스크립트는 장시간 작업 중 기기 가용성이나 로컬 저장 공간에 영향을 받을 수 있고, 개발 환경과 배포 환경이 달라지면 재현성도 흔들릴 수 있습니다. 반면 소재 자동화가 단순한 API 호출만 수행한다면 원격 Mac은 필수가 아닙니다. 다만 macOS 도구를 함께 실행하거나 지속적으로 접근 가능한 Mac 환경이 필요하다면, 직접 구매와 원격 사용을 요구 기간과 운영 부담에 따라 비교하세요. MACGPU의 원격 Mac 환경을 검토할 때도 실제 작업이 Mac을 필요로 하는지 먼저 확인하고, 필요한 기간에 맞춰 선택하면 됩니다.