이번 조사는 한 가지 질문에서 시작했습니다. 가족 중 누군가 Flick Pro 평생 이용권을 구입했는데, 왜 다른 가족 구성원에게는 여전히 결제 화면이 표시될까요? 그 구성원이 미성년자라면 보호자의 승인이나 기기의 구입 제한이 잠금 해제에 영향을 줄까요?
구입, 구입 복원, 앱 시작, 포그라운드 복귀 흐름을 따라 코드를 확인했습니다. 그 결과 앱 시작 시 처리 순서의 문제와 가족이 이용하는 구입 과정에서 놓친 두 가지를 발견했습니다.
먼저 확인할 것: Apple이 이용 권한을 제공했는가
공유 대상이라는 것, 보호자의 승인을 기다리는 것, 교환 절차가 끝나지 않은 것은 유효한 구입 권한을 이미 받은 상태와 다릅니다. 앱은 Apple이 제공한 거래를 근거로 잠금을 해제해야 합니다. 무료로 받을 수 있다는 안내만으로 구입이 완료되었다고 판단할 수는 없습니다. 앱 자체를 무료로 다운로드할 수 있다는 사실도 별도의 비소모성 앱 내 구입 항목인 Pro의 공유 이용 권한을 받았다는 뜻은 아닙니다.
먼저 Transaction.currentEntitlements를 살펴봤습니다. Flick은 이미 이 시퀀스를 읽고 거래 검증 결과, 제품 ID와 취소 상태를 확인하고 있었습니다. ownershipType == .purchased로 필터링하지 않았으므로 .familyShared도 원래부터 잠금을 해제할 수 있는 구현이었습니다. 제품 ID는 me.mahui.app.Flick.pro.lifetime입니다.
구입 복원도 이미 AppStore.sync()를 호출한 다음 이용 권한을 다시 확인하고 있었습니다. Apple의 설명에 따르면 일부 비소모성 구입 항목을 가족과 공유할 때는 가족 구성원이 직접 구입을 복원해야 합니다. sync()는 앱 시작 시 자동으로 인증 화면을 띄우는 대신 사용자가 복원 버튼을 눌렀을 때 호출해야 합니다. 가족 공유 지원 안내와 AppStore.sync()를 참고하세요.
실제로 재현한 문제: 가격 요청이 첫 이용 권한 확인을 지연시켰다
기존 초기화 작업은 제품 이름과 가격을 불러온 뒤 기존 이용 권한을 확인했습니다.
Task {
await loadProduct()
await refreshEntitlements()
}
이 때문에 목적이 다른 두 작업 사이에 대기 관계가 생겼습니다. 제품 정보 요청이 돌아오지 않는 동안에는 첫 이용 권한 확인도 시작할 수 없고, isPurchased는 초기값인 false를 유지했습니다. 이 대기는 본인 구입과 가족 공유 모두에 영향을 줬습니다.
앱이 활성 상태가 될 때 별도의 권한 갱신도 실행되므로 문제가 드러나지 않을 수 있습니다. 하지만 앱 시작 시 권한을 올바르게 판단하는 일을 그 생명주기 알림에 의존해서는 안 됩니다. 두 작업을 독립적으로 시작하도록 바꿨습니다.
Task { await refreshEntitlements() }
Task { await loadProduct() }
이 수정은 어떤 작업이 먼저 실행되는지에 의존하지 않습니다. 핵심은 기존 이용 권한을 읽는 작업이 더 이상 가격 요청의 완료를 기다리지 않는다는 점입니다. 모의 테스트에서는 제품 요청이 계속 대기하도록 했습니다. 기존 코드의 시작 시 이용 권한 읽기 횟수는 0이었지만, 수정한 코드는 가격을 아직 불러오지 못한 상태에서도 유효한 공유 권한으로 잠금을 해제했습니다. 기존 코드도 제품 요청이 오류를 반환한 뒤에는 권한 갱신을 계속 진행했습니다. 따라서 이번에 확인한 결함은 요청이 대기 중인 동안 발생하는 인식 지연입니다.
미성년자 계정에서는 승인 대기와 신규 구입 금지를 구분해야 한다
‘구입 요청’(Ask to Buy)은 StoreKit의 구입 대기 흐름을 사용합니다. Flick은 .pending을 받았을 때 Pro를 미리 잠금 해제하지 않고, 구입 버튼의 로딩 표시를 끝낸 뒤 보호자 승인이나 다른 확인 절차가 필요할 수 있다고 안내합니다. 구입이 완료되면 검증된 거래가 Transaction.updates를 통해 전달되고, 이용 권한을 갱신합니다.
보호자가 요청을 거절하면 완료된 구입 거래가 생성되지 않습니다. 따라서 앱은 잠금을 유지하며, 이를 근거로 ‘보호자가 거절했습니다’라고 단정할 수도 없습니다. 승인 대기 상태를 구입을 영구적으로 비활성화하는 플래그로 저장하지도 않습니다. 거절된 뒤 사용자가 다시 시도하지 못하는 상황을 피하기 위해서입니다. Apple의 Ask to Buy 테스트 안내를 참고하세요.
이와 별개로 스크린 타임이나 기기 관리가 신규 구입을 막는 경우도 있습니다. 이번에 AppStore.canMakePayments 확인을 추가했습니다. 결제 화면에서는 새 구입을 시작하는 버튼 대신 제한 안내를 표시하며, 실제 구입을 실행하기 직전에도 시스템 상태를 다시 읽습니다. 화면을 연 뒤 제한이 바뀌는 경우에 대응하기 위해서입니다.
새 구입이 금지되어도 기존 본인 구입이나 가족 공유 이용 권한은 비활성화되지 않습니다. 이용 권한 읽기는 계속 실행되고, 구입 복원도 그대로 사용할 수 있습니다. 이 값은 나이를 판별하는 기능이 아니며 기기 관리 제한 때문에 false가 될 수도 있습니다. canMakePayments를 참고하세요.
구입 복원 안내도 가족 구성원이 이해할 수 있어야 한다
복원 결과가 없을 때 기존 안내는 ‘구입할 때 사용한 계정으로 로그인하세요’라는 내용이었습니다. 본인이 구입한 경우에는 이해할 수 있지만, 가족 구성원은 자녀의 기기에서 보호자의 계정으로 로그인해야 한다고 받아들일 수 있었습니다.
이제는 두 경우를 나눠 설명합니다. 직접 구입한 사용자는 ‘미디어 및 구입 항목’에 사용하는 Apple 계정을 확인하고, 가족 공유 사용자는 가족 중 누군가 Pro를 구입했는지와 가족의 구입 항목 공유 설정을 확인하도록 안내합니다. 가족 구성원은 가족 공유에 참여한 본인 계정을 사용해야 합니다. 복원에서 일시적으로 이용 권한을 찾지 못했다고 해서 가족 중 누구도 Pro를 구입한 적이 없다는 뜻은 아닙니다.
로컬 Products.storekit의 familyShareable: true는 개발 테스트 설정에서 공유를 허용한다는 의미일 뿐입니다. 운영 중인 앱 내 구입 항목에 공유가 활성화되어 있다는 증거는 아닙니다. 실제 서비스의 설정, 각 구성원의 구입 계정, 공유 설정과 거래 전달 여부는 여전히 확인해야 합니다. Apple의 공유 구입 항목 문제 해결 안내를 참고하세요.
검증한 것과 아직 검증하지 못한 것
- 25개 모의 거래 검사를 통과했습니다. 실제 구입 관리 코드를 StoreKit 테스트 대역과 함께 컴파일해 제품 요청의 대기·실패·빈 결과, 공유 및 본인 구입 권한, 거래 검증·취소·복원, 구입 제한 변경과 승인 상태 처리를 확인했습니다. 이는 앱의 제어 흐름을 검증하는 테스트입니다.
- iOS Simulator와 Mac Catalyst의 Debug 빌드 및 5개 언어 문구 검사를 통과했습니다. 컴파일 성공이 Apple 서비스에서 구입이 완료되었다는 뜻은 아닙니다.
- 네이티브 StoreKit Testing은 완료하지 못했습니다. 4개 테스트를 준비했습니다. 두 차례 모두 테스트 프로젝트의 컴파일에는 성공했지만, 이 컴퓨터의 시뮬레이터/XCTest 실행이 끝나지 않아 시간을 제한한 재실행도 타임아웃 후 중단했습니다. 완전한 어설션 결과는 얻지 못했으며, 이를 구입 코드의 어설션 실패로 판단하지도 않았습니다.
- 실제 계정과 운영 환경 설정은 아직 검증하지 않았습니다. 성인 및 미성년 가족 구성원, 기기 간 사용과 구입 계정 전환, 승인 대기 중 앱을 종료했다가 다시 여는 경우, Apple이 공유·취소 거래를 실제로 전달하는 과정, App Store Connect의 운영 중인 앱 내 구입 설정이 여기에 포함됩니다.
이번 코드 수정은 재현한 시작 시 대기 문제를 해결하고, 신규 구입 제한 처리와 더 명확한 가족용 복원 안내를 추가했습니다. 이 글을 공개했다는 것은 개발 기록을 공개했다는 뜻입니다. 앱 업데이트가 이미 배포되었거나 실제 가족 계정 테스트가 완료되었다는 의미는 아닙니다.
지금도 Pro가 잠겨 있다면
먼저 Flick 결제 화면에서 ‘구입 복원’을 눌러 주세요. 가족 공유라면 자신의 가족 계정, ‘미디어 및 구입 항목’과 가족의 구입 항목 공유 설정을 확인하세요. 보호자 승인이나 교환 절차가 아직 끝나지 않았다면 Apple의 시스템 절차를 먼저 완료해 주세요. 그래도 잠금이 해제되지 않으면 앱과 운영체제 버전, 본인 구입인지 가족 공유인지, 복원 후 표시된 안내를 Flick 지원팀에 알려 주세요.