본문 바로가기

Android 샌드박스 테스트 설정

GitHub

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

시작하기 전에, 다음 세 가지 Android 빌드 유형을 구분하세요:

  • 로컬 디버그/개발 빌드: 기기에서 UI 및 네이티브 통합을 확인하기에 적합합니다.
  • Play Console에 업로드된 서명된 릴리스 AAB: 실제 Google Play 결제 테스트를 위해 필요합니다.
  • Play에서 설치한 테스트 빌드: 테스터가 내부 또는 비공개 트랙을 통해 설치하는 빌드입니다. 구매 QA에는 이 빌드를 사용하세요.

Android Studio에서 APK를 사이드로드만 하면 adb, Google Play Billing이 프로덕션 환경과 다르게 동작할 수 있습니다. 구독 및 인앱 결제 검증을 위해서는 항상 Google Play에서 설치한 빌드로 테스트하세요.

  • Google Play Console 개발자 계정. 아직 계정이 없다면 다음에서 시작하세요: Play Console 가입.
  • 최종 Android 패키지 이름으로 Play Console에 생성한 앱 레코드
  • Play Console에서 생성한 인앱 상품 또는 구독
  • 라이선스 테스트에 추가할 수 있는 테스트용 Gmail 계정
  • 업로드할 준비가 된 서명된 release build

결제 설정에 시간을 쓰기 전에 Play Console에서 앱을 만들고, 어떤 방식으로 운영할지 결정하세요: 무료 또는 유료. Google에서는 유료 앱을 나중에 무료로 전환할 수 있지만, 한 번 무료로 제공된 앱은 다시 유료로 전환할 수 없습니다.

Android App Bundle(.aab) 신규 Play Store 앱의 경우:

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

실행하기 전에 Android 릴리스 서명이 이미 설정되어 있는지 확인하세요. bundleRelease. 키스토어, 서명 구성 또는 릴리스 비밀번호가 아직 설정되지 않았다면 Android Studio에서 다음 메뉴로 서명된 번들을 생성하세요. Build > 서명된 앱 Bundle / APK 생성, 해당 값을 입력하라는 프롬프트가 표시됩니다.

  1. 테스트 계정 추가

    Play Console에서 다음을 여세요: 설정 > 라이선스 테스트 그리고 Android 테스트 기기에 사용 중인 주요 Google 계정을 추가하세요.

    이렇게 하면 실제 결제 대신 Play 샌드박스 플로우가 표시됩니다.

    테스트 계정 추가

  2. 테스트 트랙 선택

    다음으로 이동: 테스트 및 릴리스 > 테스트 그리고 다음 트랙 중 하나를 선택하세요:

    • 내부 테스트: QA 및 결제 스모크 테스트에 가장 빠른 경로입니다. 새 bundle은 보통 몇 분 내에 사용 가능합니다.
    • 비공개 테스트: 더 광범위한 테스트에 적합하며, 2023년 11월 13일 이후 생성된 개인 개발자 계정의 경우 프로덕션 배포 전 필수입니다.

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

    테스트 트랙 생성

  3. 테스터 목록 생성

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

    새로 만든 개인 계정으로 프로덕션 액세스를 준비 중이라면, 반드시 비공개 테스트 최소 12명의 테스터가 14일 연속으로 참여하도록 유지해야 합니다.

    테스터 목록 생성

  4. 서명된 릴리스 빌드 업로드

    선택한 테스트 트랙에 새 릴리스를 만들고 서명된 빌드를 업로드하세요. .aab.

    새 Google Play 앱은 APK 대신 Android App Bundle을 사용해야 합니다. 업로드 후 릴리스를 저장하고, Play에서 표시하는 정책 또는 스토어 등록정보 관련 문제를 해결한 뒤 테스트 트랙에 릴리스를 게시하세요.

    릴리스 빌드 업로드

  5. 테스트 프로그램 참여

    테스트 기기에서 opt-in URL을 열고 테스터 되기 버튼을 눌러 등록하세요.

    로컬에서 내보낸 APK가 아니라, 해당 opt-in 플로우로 생성된 Play Store 등록정보에서 앱을 설치하세요.

    테스트 참여

  6. 빌드 및 테스트

    테스트 기기에서 Play로 설치한 빌드를 실행하고 구매를 시도하세요. 다음과 같은 메시지가 표시되어야 합니다:

    “테스트 주문이므로 요금이 청구되지 않습니다.”

    테스트 구매

  • 빌링 QA를 위해 Play 테스트 빌드를 설치하기 전에 사이드로드된 앱 사본을 모두 제거하세요.
  • 내부 테스트는 빠른 스모크 테스트에 좋지만, 신규 개인 계정이 프로덕션 액세스 권한을 받으려면 비공개 테스트 트랙이 중요합니다.
  • 테스트 계정은 구매 시 비용이 청구되지 않습니다.
  • 테스트 구매는 프로덕션 구매와 동일한 흐름으로 진행됩니다.
  • 무료 체험과 introductory offer를 포함해 모든 구독 기능을 테스트할 수 있습니다.
  • 테스트 구독은 빠른 테스트를 위해 갱신 주기가 단축되어 있습니다.
  • 기기 내 Play Store, 테스터 참여(opt-in) 흐름, 라이선스 테스트까지 세 곳 모두 동일한 Google 계정을 사용하세요.

테스트 모드에서 제품이 보이지 않는 경우:

  • 앱이 테스트 트랙에 업로드되었는지 확인하세요.
  • 테스트 계정이 라이선스 테스트에 추가되었는지 확인하세요.
  • Google Play Console에서 제품이 활성 상태인지 확인하세요.
  • Google Play에서 설치된 빌드인지, 로컬에서 사이드로드된 것이 아닌지 확인하세요

“Item not available” 오류:

  • 제품 생성 후 2~3시간 기다렸다가 사용 가능 여부를 확인하세요
  • 앱의 패키지 이름이 Play Console의 것과 일치하는지 확인하세요
  • 테스트 계정으로 로그인되어 있는지 확인하세요
  • 동일한 패키지 이름과 제품 카탈로그를 가리키는 서명된 릴리스 빌드를 업로드했는지 확인하세요

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

  • 계정이 License testing에 추가되었는지 다시 확인하세요
  • 테스트 트랙의 빌드를 사용 중인지 확인하세요
  • 구매 시 테스트 배너가 표시되는지 확인하세요

Android Sandbox 테스트 설정에서 계속하기

“Android Sandbox 테스트 설정에서 계속하기” 섹션

사용 중이라면 Android 샌드박스 테스트 설정 스토어 승인 및 배포를 계획하려면, 다음 항목과 연결하세요 @capgo/native-purchases 사용하기 @capgo/native-purchases 사용 시 네이티브 기능을 위해, @capgo/capacitor-in-app-review @capgo/capacitor-in-app-review의 구현 세부 사항에 대해서는, @capgo/capacitor-in-app-review 사용하기 @capgo/capacitor-in-app-review 사용하기에서 네이티브 기능은, @capgo/capacitor-native-market @capgo/capacitor-native-market의 구현 세부 사항에 대해서는, 그리고 @capgo/capacitor-native-market 사용하기 @capgo/capacitor-native-market. 사용하기에서 네이티브 기능은