메뉴로 이동

Android 샌드박스 테스트 구성

GitHub

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

일을 위해 올바른 빌드를 사용하십시오

일을 위해 올바른 빌드를 사용하십시오

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

  • Local debug/dev 빌드 : 기기에서 UI 및 네이티브 통합을 확인하기 좋습니다.: Good for checking UI and native integrations on your device.
  • 구글 플레이 콘솔에 업로드 된 서명된 릴리스 AAB: 실제 구글 플레이 결제 테스트를 위해 필요합니다.
  • Play 설치 테스트 빌드: 테스터가 내부 또는 폐쇄 트랙에서 설치하는 빌드입니다. 구매 QA를 위해 이 빌드를 사용하세요.

안드로이드 스튜디오 또는 adb, 구글 플레이 결제가 실제 배포와 같은 방식으로 동작하지 않을 수 있습니다. 구독 및 인앱 구매 유효성 검사에는 항상 구글 플레이에서 설치한 빌드를 사용하세요.

필수 조건

필수 조건
  • 구글 플레이 콘솔 개발자 계정이 필요합니다. 계정을 아직 만들지 않았다면 구글 플레이 콘솔에 앱 레코드를 생성하세요..
  • Play Console에 앱 레코드를 생성한 후 앱의 마지막 안드로이드 패키지 이름을 사용하세요.
  • Play Console에 인앱 제품 또는 구독을 생성하세요.
  • Gmail 계정 테스트를 위해 라이센스 테스트에 추가할 수 있는 계정입니다.
  • 업로드하기 위해 준비된 서명된 릴리즈 빌드입니다.

billing 설정에 시간을 들이기 전에 Play Console에서 앱을 만들고 무료인지 유료인지 결정하세요. Google은 유료 앱을 무료로 전환할 수 있지만 무료로 제공된 앱은 유료로 전환할 수 없습니다. Use an Android App Bundle ( ) for new Play Store apps:터미널 창

클립보드에 복사.aabAndroid 릴리즈 서명이 이미 구성되어 있어야 합니다. 앱을 실행하기 전에.

Android App Bundle (
bunx cap sync android
cd android
./gradlew bundleRelease

클립보드에 복사 bundleRelease. Android Studio에서 키 스토어, 서명 구성, 또는 릴리스 패스워드가 설정되지 않은 경우, Build > Generate Signed App Bundle / APK설치 과정

설치 과정 섹션

테스트 계정 추가
  1. Play 콘솔에서

    Settings > License testing Android 테스트 장치에서 사용하는 기본 Google 계정을 추가합니다. 이것은 구매가 플레이 샌드박스 흐름을 보여주기 보다는 실제 결제를 시도하는 대신에

    테스트 계정 추가

    테스트 트랙을 선택하세요

  2. Setup Process

    Go to Test and release > Testing 그리고 다음 트랙 중 하나를 선택하세요:

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

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

    테스트 트랙 만들기

  3. 테스터 목록 만들기

    트랙을 열면 테스터 목록을 만들고 Google 계정에 빌드를 받을 계정들을 추가하세요.

    프로덕션 액세스에 대한 접근을 위해 새로 생성된 개인 계정을 향해 작업 중이라면, 2023년 11월 13일 이후에 생성된 계정의 경우 2023년 11월 13일 이후에 생성된 계정의 경우 프로덕션에 필요한 경우에만 사용합니다. 폐쇄 테스트 14일 연속 최소 12명의 테스터가 동의한 상태로 유지하세요.

    테스터 목록 만들기

  4. Signed Release Build 업로드

    선택한 테스트 트랙에서 새로운 릴리즈를 만들고 Signed Release Build를 업로드하세요. .aab.

    새로운 Google Play 앱은 Android App Bundle을 사용하는 것이 Android APK보다 좋습니다. 업로드 후 릴리즈를 저장하고 정책 또는 스토어 목록 블록러 플래그를 수정한 후 테스트 트랙으로 릴리즈를 게시하세요.

    릴리즈 빌드 업로드

  5. 테스트 프로그램에 가입하세요

    테스트 디바이스에서 옵인 URL을 열고 "테스터가 되기" 버튼을 클릭하여 등록하세요. 앱을 Play Store에 의해 생성된 옵인 흐름에서 설치하세요. 지역적으로 내보낸 APK에서 설치하지 마세요. “Become a tester”

    button to enroll.

    테스트에 참여하세요

  6. 빌드 및 테스트

    테스트 기기에서 플레이 설치된 빌드를 실행하고 구매 시도해 보세요. 다음과 같은 메시지를 볼 수 있을 것입니다.

    “This is a test order; you will not be charged.”

    테스트 구매

중요한 주의사항

중요한 주의사항
  • billing QA를 위해, 플레이 테스트 빌드를 설치하기 전에 시드 로드 된 앱을 제거하세요.
  • 내부 테스트는 빠른 스모크 테스트에 좋지만, 새로운 개인 계정 프로덕션 접근을 위한 중요한 트랙은 폐쇄 테스트입니다.
  • 테스트 계정은 구매에 대해 청구되지 않습니다.
  • 테스트 구매는 프로덕션 구매와 동일한 흐름을 사용합니다.
  • 모든 구독 기능을 테스트할 수 있습니다. 이에는 시도 기간 및 소개 제안도 포함됩니다.
  • 테스트 구독은 더 빠른 테스트를 위해 재생산 기간이 가속화되었습니다.
  • 모든 세 곳에서 동일한 Google 계정을 사용하세요: 장치의 Play Store, 테스터 옵인 흐름, 및 License 테스트

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

  • 앱이 테스트 트랙에 업로드되어 있는지 확인하세요
  • 테스트 계정이 License 테스트에 추가되어 있는지 확인하세요
  • Google Play 콘솔에서 제품이 활성화되어 있는지 확인하세요
  • Google Play에서 빌드를 설치했는지, 지역적으로 로컬로 설치했는지 확인하세요

“Item not available” error:

  • 2-3 시간 후에 제품이 사용 가능해질 수 있습니다.
  • 앱의 패키지 이름이 Play 콘솔에 등록된 이름과 일치하는지 확인하세요
  • 로그인한 테스트 계정과 확인하세요
  • 확인하십시오. 업로드한 서명된 릴리즈 빌드가 동일한 패키지 이름과 제품 카탈로그를 가리키고 있습니다.

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

  • 계정이 라이선스 테스트에 추가되어 있는지 다시 확인하세요
  • 테스트 트랙에서 빌드를 사용하고 있는지 확인하세요
  • 구매 시 테스트 배너가 나타나는지 확인하세요

추가 리소스

추가 리소스

Configure Android Sandbox Testing에서 계속 진행하세요

Configure Android Sandbox Testing에서 계속 진행하기

__CAPGO_KEEP_0__이 사용 중이라면 Android Sandbox Testing을 사용하여 스토어 승인 및 배포를 계획하고자 할 때 capgo/native-purchases와 연결하세요 native capability인 Using @capgo/native-purchases에서 @capgo/capacitor-in-app-review를 사용하여 implementation detail인 @capgo/capacitor-in-app-review의 구현을 확인하세요 native capability인 Using @capgo/capacitor-in-app-review에서 @capgo/capacitor-native-market를 사용하여 implementation detail인 @capgo/capacitor-native-market의 구현을 확인하세요, for the implementation detail in @capgo/capacitor-native-market, and Using @capgo/capacitor-native-market for the native capability in Using @capgo/capacitor-native-market.