Android 인앱 구매, 4부: 결제 라이브러리 오류 코드 및 테스트를 망치지 않는 방법
Updated: 3월 20, 2023
오늘우리는getResponseCode()메소드에서결제 라이브러리를 통해 볼 수 있는오류 코드에대해 알아보겠습니다.
콜백에오류를 전달한 방법의 예는이 기사에서찾을 수 있습니다.우리는이미 이전 기사에서 사용자가 아무것도 구매하지 않고구매 대화 상자를 닫을 때 발생하는 오류 중 하나인USER_CANCELED를살펴보았습니다.다른오류들을 알아 봅시다.
ERROR와DEVELOPER_ERROR
처음살펴볼 오류는ERROR(responseCode 6)와DEVELOPER_ERROR(responseCode 5)입니다.첫번째의 경우,Google은”Fatalerror during the API action” 문서를기록하고 두 번째의 경우 “Invalidarguments provided to the API”를기록합니다.예를들어,querySkuDetailsAsync()요청을위해setType()으로빈 문자열을 빌더에 전달했을 때 DEVELOPER_ERROR를얻을 수 있었습니다.
하지만그렇게 간단한 것은 아닙니다.계속진행하면서 launchBillingFlow()메소드에서수정된SkuDetails를사용했습니다.(실제제품의 SkuDetails에서json(json)을가져와서 productID를변경하고 새 SkuDetails제작자에게전달했습니다)사실,이것은근거 없는 주장이고,나는DEVELOPER_ERROR를얻을 거라고 예상했지만 …ERROR를얻었습니다.
물론이것은 인위적인 예였습니다.구글이결제를 거부한 경우가 훨씬 현실적인 사례입니다.기사끝부분에서 알려드리겠지만,테스트카드로 구매를 테스트할 때 구매 대화 상자에서 “testcard, always declined”를선택하면 적절한 텍스트와 함께 ERROR역시반환됩니다.
구독(subscription)변경을설명한세 번째 기사에서,우리는비례 배분 방식 중 하나에 대해 연간 구독 가격을 거의3배나인상했는데,그렇게하지 않은 경우 발생했어야 하는 실수가 무엇인지에대해서는 말하지 않았습니다.개정중입니다.
잘못된비례 배분 모드가 지정된 것으로 밝혀졌기 때문에,논리적으로동일한 DEVELOPER_ERROR을가져와야 합니다.그대신, SERVICE_UNAVAILABLE(responseCode 2)를얻었습니다.또한비례 배분 모드로 부적절한 숫자를 입력하고 (이것은enum이아니라 int입니다.아무도우리를 막을 수 없죠.)잘못된purchaseToken을지정하는 경우에도 이를 얻습니다.SERVICE_UNAVAILABLE에대한 문서를 살펴보면 …잠깐,이게뭐죠?!”Network connection is down.”이표시됩니다.
동시에이상한 대화 상자도 표시됩니다.
ERROR의경우 또 한 가지 흥미로운 것은 “확인”버튼을누르지 (즉,”뒤로가기”로해석되는 수단을 통하지)않고대화 상자를 닫으면 ERROR가onPurchasesUpdated()에발생하고,SERVICE_UNAVAILABLE의경우 비슷한 상황에서 USER_CANCELED가나타납니다.(그러나대화 상자에서 “OK”를클릭하면 예상할 수 있듯이 SERVICE_UNAVAILABLE를받게 됩니다)
그리고인터넷 연결이 끊긴 경우에는 SERVICE_UNAVAILABLE가실제로 나옵니다.
2024 subscription benchmarks and insights
Get your free copy of our latest subscription report to stay ahead in 2024.
오류코드
다음은작은 주석이 달린 오류 코드들로,선외가작이라고 할만한 것들입니다.
- BILLING_UNAVAILABLE (responseCode 3). Google은 “요청한 유형에 대해 Billing API 버전이 지원되지 않습니다”라고 설명합니다. Google 계정에서 로그아웃했을 때와 Google Play 서비스가 없는 Huawei 기기를 사용할 때 이 오류를 재현할 수 있었습니다. Google Play가 업데이트되지 않은 구형 휴대폰에서도 재현할 수 있습니다.
- SERVICE_DISCONNECTED (responseCode -1). 애플리케이션이 Google Play 서비스에서 연결이 끊기는 경우가 간혹 있습니다. Play Store가 예기치 않게 업데이트되는 경우 발생할 수 있습니다. 따라서 이전 기사에서와 같이, 안전하게 결제 라이브러리 메소드 호출 전에 연결하도록 권해드립니다. 또한 이 오류가 계속 응답하면 재시도 방책을 추가하도록 Google과 우리가 공통적으로 조언하고 있습니다.
- SERVICE_TIMEOUT (responseCode -3). 이름에서 알 수 있는 것처럼, Google Play의 응답을 너무 오랫동안 기다렸습니다.
- FEATURE NOT SUPPORTED. BillingClient 클래스에는 5가지 FeatureType 상수가 있습니다. 이 기기에서의 가용성은 BillingClient.isFeatureSupported(BillingClient.FeatureType.A_NECESSARY_FEATURE) 메소드를 사용해서 확인할 수 있습니다. 제 폰(Xiaomi Mi A2 Lite)에서는 FEATURE_NOT_SUPPORTED가 SUBSCRIPTIONS_ON_VR에 대해서만 반환되었습니다. 동시에 다른 모든 기능은 물론이고 IN_APP_ITEMS_ON_VR에 대해서는 OK가 반환되었습니다.
- ITEM_NOT_OWNED (responseCode 8). 우리가 가지고 있지 않은 구매를 소비하려고 할 때 발생합니다. 어쩌면 성공적인 소비 후에도 반복적으로 나타날 수 있습니다.
- ITEM_ALREADY_OWNED (responseCode 7). 그와는 반대로, 이미 가지고 있는 제품을 구매하려고 하다가 발생하는 오류입니다. 이 경우, UI를 업데이트하고 구매 버튼을 클릭할 수 없도록 하기만 하면 됩니다.
ITEM_UNAVAILABLE
마지막으로인앱 구매 구현 경로의 출발점에서 분명 가장 많이발생하는 오류는 ITEM_UNAVAILABLE(responseCode 4)입니다.제품을구매할 수 없다고 나와 있지만,이유는설명하지 않습니다.이유는매우 다양할 수 있습니다.잘못된계정이나 기기에서 테스트하는 것부터 비활성 제품을구매하는 것까지입니다.
다음은테스트 중 이 오류를 방지하기 위해 확인해야 하는체크리스트입니다.
1. 결제라이브러리와 함께 앱을 테스트 트랙으로 보냅니다.이것은필수 조건입니다.동시에동일한 applicationId를사용하여 디버그 빌드에서 테스트할 수도 있지만,결제라이브러리와 함께 앱을 PlayConsole에최소 한 번은 업로드하는 것이 중요합니다.
2. 테스터의Google계정을이 테스트 트랙에 추가하는데,이는내부 테스트 또는 비공개 알파/베타에서특히 중요합니다.또한테스터가테스트에 참여하는 방법섹션에 링크가 있는데,여기서테스터가 초대를 수락해야 합니다.
3. 활성화된제품만 구매할 수 있습니다.제품생성 후,Play Console에activate버튼이있습니다.제품생성 과정은 첫 번째 기사에서더 자세히 설명했습니다.
4. 기기상에서의 테스트가 테스터의 Google계정에서수행되는지 확인합니다 (즉,해당계정은 이 테스트 트랙에 테스터로 등록되어야 하고필요한 모든 기술 액세스 권한을 가져야 합니다).이점은 당연해 보이지만 문제는 생기기 마련이라,이런에러가 발생한다면 이 부분을 확인할 필요가 있습니다.
5. 구매테스트에 사용되는 빌드의 applicationId는PlayConsole의applicationId와완전히 일치해야 합니다.이것은디버그 빌드에 확장자를 추가한 사람들에게 특히중요합니다.
6. (애플리케이션이아니라)계정의왼쪽 메뉴에서 Setup→ License Testing섹션에테스터의 이메일 주소를 추가하여,실제카드가 아닌 테스트 카드에서 무료로 제품을 구매합니다.또다른 이점은,이경우 구독에테스트 기간이있다는 것입니다.이오류와 관련이 없지만 유용한 지식입니다.
결론
오류는작업을 매우 복잡하게 만들 수 있으므로,오류가어떻게 발생할 수 있는지 이해하는 것이 항상 중요합니다.제품에액세스하기 위해 얼마나 많은 단계를 거쳐야 하는지생각해보면,가장쉬운 방법은 ITEM_UNAVAILABLE을잡는 것입니다.따라서,제체크리스트가 도움이 되기를 바랍니다.
TheAdapty SDK는오류 처리를 용이하게 하고 많은 이점을 제공하는데,그중에는 기본 구독 분석,코호트분석 (cohortanalysis), 페이월(paywall)의간단한 테스트,분석서비스와의 통합 (integration),서버오류 검증 등이 있습니다.지금해보세요!
Includes cheat sheets!
Further reading
