메뉴로 바로가기

안드로이드 샌드박스 테스트를 구성하십시오.

GitHub

인앱 구매 테스트는 Google Play 콘솔에서 올바른 구성이 필요합니다. 이 가이드는 Android 앱에 대한 샌드박스 테스트 설정을 위해 안내합니다.

일을 위해 올바른 빌드를 사용하세요

일을 위해 올바른 빌드를 사용하세요

시작하기 전에 Android 빌드 유형을 세 개로 분리하세요

  • Local debug/dev build장치에서 UI 및 네이티브 통합을 확인하는 데 좋습니다.
  • Signed release AAB uploaded to Play Console실제 Google Play 결제 테스트를 위해 필요합니다.
  • Play-installed testing build: 테스트자들이 설치하는 내부 또는 폐쇄된 트랙의 빌드입니다. 구매 QA를 위해 이 옵션을 사용하세요.

If you only sideload an APK from Android Studio or adb, Google Play Billing이 실제 배포와 같은 방식으로 동작하지 않을 수 있습니다. 구독 및 인앱 구매 인증을 위해 항상 Google Play에서 빌드를 설치하여 테스트하세요.

  • Google Play Console 개발자 계정이 필요합니다. 계정을 아직 만들지 않았다면 Play Console signup.
  • Play Console에 앱 레코드를 생성한 상태
  • Play Console에 인앱 제품 또는 구독을 생성한 상태
  • 라이선스 테스트에 사용할 수 있는 테스트 Gmail 계정이 필요합니다.
  • 업로드할 준비가 된 signed release 빌드

billing 설정에 시간을 들이기 전에 Play Console에 앱을 생성하고 배포할지 여부를 결정하세요. __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ __CAPGO_KEEP_0__Google은 유료 앱을 무료로 변경할 수 있지만 무료로 제공된 앱은 유료로 변경할 수 없습니다.

Android 앱 번들 (.aab)을 사용하여 새로운 Play Store 앱을 만드세요.

터미널 창
bunx cap sync android
cd android
./gradlew bundleRelease

Android 릴리즈 서명이 이미 구성되어 있어야 합니다. bundleRelease키스토어, 서명 구성, 릴리즈 패스워드가 아직 설정되지 않은 경우 Android Studio에서 Build > Generate Signed App Bundle / APK, 이에 대한 값을 입력하도록 요청합니다.

  1. 테스트 계정 추가

    Play Console에서 설정 > 라이선스 테스트 Android 테스트 기기의 사용 중인 주 Google 계정을 추가합니다.

    구매가 샌드박스 흐름을 표시하는 대신 실제 결제를 시도하지 않도록 합니다.

    테스트 계정 추가

  2. 테스트 트랙 선택

    테스트 및 출시 > 테스트로 이동하여 이 중 하나의 트랙을 선택하세요: __CAPGO_KEEP_0__

    • 내부 테스트: QA 및 청구 스모크 테스트를 위해 가장 빠른 경로입니다. 일반적으로 새로운 번들은 몇 분 안에 사용할 수 있습니다.
    • 폐쇄 테스트: 보다 광범위한 테스트를 위해 더 적합하며, 2023년 11월 13일 이후에 생성된 개인 개발자 계정의 경우 프로덕션에 필요한 것입니다.

    첫 번째 릴리스 시, Play는 내부 테스터에게 최대 48시간 동안 임시 앱 이름과 목록 정보를 표시할 수 있습니다.

    테스트 트랙 만들기

  3. 테스터 목록 만들기

    트랙을 열면 테스터 목록을 만들고 Google 계정에 빌드를 받을 계정을 추가해야 합니다.

    프로덕션 접근을 위해 새로 생성된 개인 계정에 작업 중이라면, 최소 14일 연속으로 12명의 테스터를 옵트인 상태로 유지해야 합니다. 테스터 목록 만들기 폐쇄 테스트

    폐쇄 테스트

  4. __CAPGO_KEEP_0__

    __CAPGO_KEEP_1__ .aab.

    __CAPGO_KEEP_2__

    __CAPGO_KEEP_3__

  5. __CAPGO_KEEP_4__

    __CAPGO_KEEP_5__ __CAPGO_KEEP_6__ __CAPGO_KEEP_7__

    __CAPGO_KEEP_8__

    __CAPGO_KEEP_9__

  6. __CAPGO_KEEP_10__

    __CAPGO_KEEP_11__

    “이 주문은 실제로 청구되지 않습니다.”

    구매 테스트

  • billing QA를 위해, Play 테스트 빌드를 설치하기 전에 앱의 sideloaded 복사본을 제거하세요.
  • 내부 테스트는 빠른_smoke 테스트를 위해 좋지만, 새로운 개인 계정 프로덕션 접근을 위한 중요한 트랙은 폐쇄 테스트입니다.
  • 테스트 계정은 구매에 대해 청구되지 않습니다.
  • 테스트 구매는 프로덕션 구매와 동일한 흐름을 사용합니다.
  • 모든 구독 기능을 테스트할 수 있습니다. (trial 및 introductory offer 포함)
  • 테스트 구독은 빠른 테스트를 위해 재생산 기간을 가속화합니다.
  • Play Store에서 장치에 있는 것, 테스터 옵인 흐름, 그리고 License 테스트를 위한 모든 세 곳에서 동일한 Google 계정을 사용하세요.

문제 해결

문제 해결

테스트 모드에서 제품이 표시되지 않습니다:

  • 앱이 테스트 트랙에 업로드되어 있는지 확인하세요.
  • 라이선스 테스트에 테스트 계정이 추가되어 있는지 확인하세요.
  • 구글 플레이 콘솔에서 제품이 활성화되어 있는지 확인하세요.
  • 구글 플레이에서 빌드를 설치했는지, 로컬로 시드 로드하지 않았는지 확인하세요.

“품목이 사용할 수 없습니다” 오류:

  • 품목이 사용할 수 있도록 하려면 2-3시간 기다려보세요.
  • 앱의 패키지 이름이 Play 콘솔에 등록된 이름과 일치하는지 확인하세요.
  • 테스트 계정으로 로그인되어 있는지 확인하세요.
  • 패키지 이름과 제품 카탈로그가 동일한 signed 릴리즈 빌드를 업로드했는지 확인하세요.

테스트 구매가 실제 요금으로 표시되는 경우:

  • __CAPGO_KEEP_0__을 확인하세요.
  • 테스트 트랙에서 빌드를 사용하는지 확인하세요.
  • 구매 시 테스트 배너가 나타나는지 확인하세요.

추가 리소스

추가 리소스 섹션

Configure Android Sandbox Testing에서 계속하세요.

Configure Android Sandbox Testing 섹션

__CAPGO_KEEP_1__이 사용 중이라면 Configure Android Sandbox Testing 스토어 승인 및 배포를 계획하고 연결하세요. @capgo/native-purchases를 사용하여 native capability을 사용하는 @capgo/native-purchases의 경우 @capgo/capacitor-in-app-review의 implementation detail을 참조하세요. @capgo/capacitor-in-app-review를 사용하여 native capability을 사용하는 @capgo/capacitor-in-app-review의 경우 @capgo/capacitor-native-market을 참조하세요. @capgo/capacitor-native-market를 사용하여 native capability을 사용하는 @capgo/capacitor-native-market의 경우 Using @capgo/capacitor-native-market @capgo/capacitor-native-market의 implementation detail을 참조하세요.