Xcode 27.2 StoreKit 테스트 지역 전환이 적용되지 않나요? 2026년 점검

Apple은 Xcode 27.2 RC를 2026년 10월 19일 공개 기록에 올렸습니다. 증상 → 빠른 조치: 지역을 바꿨는데 StoreKit에 반영되지 않는다면, 먼저 테스트 세션의 설정과 앱이 읽은 Storefront.updates를 따로 기록하세요. Apple의 iOS 및 iPadOS 27.2 출시 노트는 storefront 또는 locale 변경이 Storefront.updates에 전달되지 않던 StoreKit Testing 문제를 수정 사항으로 안내합니다. 다만 수정 사항만으로 프로젝트의 구매 흐름까지 검증된 것은 아닙니다.

이 글은 StoreKit Testing으로 지역별 상품이나 구독을 확인하는 개발자, Xcode 27.2로 전환해 다시 테스트하려는 팀, 원격 맥에서 테스트 환경을 재현하려는 독립 개발자를 위한 내용입니다.

마지막 검토: 2026년 10월 27일. 버전과 수정 내용은 Apple의 Xcode 출시 기록 및 iOS와 iPadOS 27.2 출시 노트를 기준으로 확인했습니다.

언어 표시와 상점 지역 상태를 먼저 분리합니다

시뮬레이터에 표시되는 언어가 바뀌었다고 해서 StoreKit의 storefront도 바뀌었다고 단정할 수는 없습니다. 확인할 값은 세 가지입니다. 시뮬레이터의 언어와 지역 설정, 테스트 세션에 적용한 값, 앱이 실제로 읽은 storefront입니다.

시뮬레이터 언어와 StoreKit storefront는 같은 설정인가요?

같은 값으로 취급하지 마세요. 기기의 언어는 화면에 표시할 언어와 형식에 영향을 주고, storefront는 StoreKit이 제공하는 상점 상태를 가리킵니다. Storefront API 문서와 SKTestSession의 locale 설명을 각각 확인하고, 로그에도 두 상태를 별도 항목으로 남기세요. 기기의 지역 설정만 바꾸면 테스트 세션의 상점 지역도 자동으로 바뀐다고 가정하지 않는 편이 안전합니다.

Xcode 27.2에서 storefront 전환을 재현하려면 어떻게 하나요?

프로젝트에 연결한 StoreKit 테스트 구성과 세션에서 목표 지역을 명시하고, 앱의 관찰 작업을 먼저 시작한 뒤 변경을 수행하세요. Xcode에서 StoreKit Testing을 설정하는 절차를 기준으로 구성이 실제 테스트 실행에 연결됐는지 확인합니다. SKTestSession의 설정값과 변경 시점을 로그에 남기고, 앱이 읽은 Storefront 상태와 나란히 비교해야 원인을 분리할 수 있습니다.

첫 번째 분기: 테스트 세션에 목표 설정이 들어갔는지 확인합니다

수정된 Xcode를 사용해도 테스트가 의도한 구성으로 실행되지 않으면 결과는 달라질 수 있습니다. 테스트 실행 경로와 세션 설정을 먼저 확인한 다음, 업데이트 관찰을 시작한 시점과 지역 변경 시점을 비교하세요.

관찰한 증상	먼저 볼 증거	판단
화면 언어만 바뀌고 상점 상태는 그대로임	기기 언어, 세션의 locale 설정, 앱이 읽은 storefront를 각각 기록	기기 표시 언어 변경만으로 storefront가 바뀌었다고 볼 수 없습니다
세션 설정은 바꿨지만 앱에 변화가 없음	실제 실행에 연결된 StoreKit 구성, 세션 설정값, 관찰 작업의 시작 시점	설정이 실행 경로에 적용됐는지, 관찰이 변경 전에 시작됐는지 확인합니다
storefront 값은 바뀌었지만 상품 화면은 그대로임	상품 식별자, 상품 조회 결과, 캐시와 화면 갱신 기록	storefront 전파 이후의 상품 조회 또는 표시 문제일 수 있습니다

SKTestSession을 코드에서 사용하는 경우에는 세션을 만드는 코드와 설정을 변경하는 코드를 같은 테스트 실행에서 추적하세요. 문서에 나온 SKTestSession 인터페이스와 실제 프로젝트의 설정을 대조하면, 설정을 지정했다고 생각했지만 다른 실행 경로가 사용된 경우를 찾기 쉽습니다.

두 번째 분기: `Storefront.updates`의 구독 시점을 점검합니다

세션 설정이 목표 상태를 가리키더라도, 앱이 변경 이벤트를 놓치거나 이벤트를 받은 뒤 화면을 갱신하지 않을 수 있습니다. Storefront.updates 문서는 업데이트를 관찰하는 API의 동작을 설명합니다. 테스트에서는 구독 작업의 시작과 취소, 이벤트 수신, 화면 반영을 서로 다른 로그로 남기세요.

SKTestSession에서 locale을 바꿨는데 Storefront.updates에 변화가 없다면 무엇을 봐야 하나요?

먼저 변경 전에 관찰 작업이 살아 있었는지 확인합니다. 구독 코드를 늦게 실행했거나 비동기 작업이 종료·취소됐다면 이벤트를 놓칠 수 있습니다. 구독이 변경 전에 시작됐고 작업도 유지됐는데 이벤트가 없다면, 세션 설정과 Xcode 버전을 함께 기록해 최소 재현으로 비교하세요. 한 번 이벤트를 받지 못했다는 사실만으로 시스템 문제라고 결론 내리지는 마세요.

구현 기록은 다음처럼 나누면 유용합니다.

구독 작업이 시작된 시점과 취소 여부
지역 변경을 요청한 시점과 세션에 지정한 값
Storefront.updates에서 이벤트가 도착했는지
이벤트를 받은 뒤 앱의 상태 저장과 화면 갱신이 일어났는지

앱이 이벤트를 받았는데 화면이 갱신되지 않는다면, 문제는 이벤트 발생보다 앱 내부 상태 전달이나 화면 표시 경로에 있을 수 있습니다. 반대로 구독 시점이 늦었다면 관찰 코드를 변경보다 앞에 두고 재실행해 비교해야 합니다.

상품 표시 오류는 storefront 확인 뒤에 별도로 추적합니다

storefront가 바뀌었는데 가격이나 상품 이름이 그대로라면, 곧바로 지역 전환 실패로 판단하지 마세요. Product.products(for:) 문서에 따라 상품 조회 결과를 확인하고, 상품 식별자와 테스트 구성, 앱의 캐시, 화면 표시를 각각 점검하세요.

검사 단계	기록할 내용	통과로 볼 기준
storefront 읽기	변경 전후 앱이 읽은 Storefront 상태	목표 상태가 앱 로그에 확인됨
상품 조회	요청한 상품 식별자와 조회 결과	기대한 상품 데이터가 앱에 전달됨
지역화 표시	상품 이름과 가격을 가져온 경로	표시 데이터가 테스트 구성과 일치함
화면 갱신	상태 저장과 화면 갱신 기록	조회 결과가 실제 화면에 반영됨

이 구분은 테스트 상품 구성이 잘못된 문제와 앱의 표시 로직 문제를 나누는 데 도움이 됩니다. Apple은 상품과 샌드박스를 포함한 개발 단계별 테스트 안내에서 Xcode 기반 테스트와 샌드박스 테스트를 구분합니다. StoreKit Testing의 성공만으로 샌드박스나 정식 구매 흐름까지 확인했다고 기록하지 마세요.

재현 결과를 정리하고 다음 점검으로 넘깁니다

테스트 세션과 앱 동작을 함께 보는 체크 항목입니다. 모든 항목에 근거 로그를 붙이면, 도구 문제와 프로젝트 로직 문제를 구분하기 쉬워집니다.

실행한 Xcode 버전과 테스트에 연결한 StoreKit 구성을 기록합니다.
시뮬레이터의 언어·지역과 세션에 지정한 locale을 별도로 기록합니다.
목표 storefront 상태를 설정한 방법과 변경 시점을 남깁니다.
변경 전에 Storefront.updates 구독 작업이 시작됐고 유지됐는지 확인합니다.
이벤트 수신 여부와 앱의 상태 저장·화면 갱신을 각각 기록합니다.
상품 식별자, 조회 결과, 테스트 구성의 상품 정보를 대조합니다.
같은 재현 절차를 로컬과 원격 환경에서 실행했다면 Xcode 버전과 구성이 같은지 확인합니다.

두 환경의 결과가 다르면 먼저 도구 버전, 실행 설정, 테스트 구성의 차이를 좁히세요. 원격 맥에서 테스트할 때도 실제로 설치된 Xcode와 macOS, 접속 후 실행한 테스트 구성을 기록해야 비교가 가능합니다. 지원 범위는 Xcode 시스템 요구 사항에서 확인하세요. 원격 환경에서 StoreKit 테스트를 옮기기 전에는 원격 맥 환경과 이용 조건도 확인할 수 있습니다.

판정은 세 갈래로 나눌 수 있습니다. 세션 설정과 업데이트 이벤트가 기대대로 확인되면 도구 문제는 재현되지 않은 것입니다. 이벤트는 도착했지만 화면이 다르면 앱의 상태 처리와 표시 경로를 수정하세요. 설정과 관찰 시점이 분명한 최소 재현에서도 공식 수정 내용과 다른 결과가 반복되면, 로그와 Xcode 버전을 보존한 뒤 Apple의 후속 안내를 확인해야 합니다.

현재 개발 장비 하나에 테스트 도구와 프로젝트 환경이 묶여 있으면, 다른 구성으로 재현하기 어렵고 로컬 저장 공간도 계속 차지할 수 있습니다. 반대로 원격 맥은 별도 환경에서 반복 테스트하기 좋지만, Xcode 호환성 확인과 네트워크 접속, 테스트 설정의 재현성은 직접 관리해야 합니다. 장기간 상시 작업이나 물리 기기 연결이 핵심이라면 전용 장비가 더 적합할 수 있습니다.

따라서 이 문제가 특정 개발 환경에만 나타나는지 분리하려는 경우에는, 필요한 기간에 별도 맥을 빌려 같은 재현 절차를 실행하는 방법도 있습니다. VNCMac의 원격 맥 대여 환경을 검토할 때는 먼저 필요한 Xcode와 macOS 조합을 확인하고, 테스트 세션과 로그를 직접 재현할 수 있는지 살펴본 뒤 이전 여부를 결정하세요.