Android 샌드박스 테스트 설정

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설치 프롬프트를 복사하세요.

Google Play Console에서 올바른 설정이 필요합니다. 이 안내서에서는 Android 앱에 대한 샌드박스 테스트를 설정하는 방법을 안내합니다.

올바른 빌드를 선택하세요

시작하기 전에 Android 빌드 유형을 나누어야 합니다.

로컬 디버그/개발 빌드: 장치에서 UI 및 네이티브 통합을 확인하는 데 적합합니다.
구글 플레이 콘솔에 업로드된 서명된 릴리스 AAB: 실제 구글 플레이 결제 테스트를 위해 필요합니다.
플레이 설치 테스트 빌드: 테스터가 내부 또는 폐쇄 트랙에서 설치하는 빌드입니다. 구매 QA를 위해 이 빌드를 사용하세요.

만약에 Android Studio 또는 adb에서 APK를만들어 sideload한다면, Google Play Billing은 실제 배포 환경에서 동작하지 않을 수 있습니다. 구독 및 인앱 구매 검증을 위해 항상 Google Play에서 설치한 빌드를 테스트하세요.

기본 요구 사항

Google Play Console 개발자 계정. 아직 하나를 만들지 않았다면 시작하세요. Play Console 가입.
Play Console에 앱 레코드를 생성했습니다.
Play Console에 내 앱 제품이나 구독을 생성했습니다.
Play Console에 테스트 Gmail 계정을 추가했습니다.
업로드할 준비가 된 signed release 빌드

billing 설정에 시간을 들이지 전에 Play Console에 앱을 만들고 무료인지 유료인지 결정하세요. 무료 또는 유료. Google은 유료 앱을 무료로 변경할 수 있지만, 무료로 제공된 앱은 유료로 변경할 수 없습니다.

Android App Bundle을 사용하여 새로운 Play Store 앱을 만드세요:.aab터미널 창

bunx cap sync android
cd android
./gradlew bundleRelease

키스토어, 서명 구성, 릴리즈 비밀번호가 아직 설정되지 않은 경우 Android Studio에서 signed bundle을 생성하세요. bundleReleaseBuild > Generate Signed App Bundle / APK를 클릭하여 키스토어, 서명 구성, 릴리즈 비밀번호를 입력하라는 메시지가 표시됩니다. 설치 과정설치 과정 섹션

테스트 계정 추가

Terminal window

Play Console에서 열어 설정 > 라이선스 테스트 Android 테스트 기기에서 사용하는 기본 Google 계정 추가

구매가 플레이 샌드박스 흐름을 표시하는지 실제 결제를 시도하는지 확인하기 위해
테스트 트랙 선택

테스트 및 출시 > 테스트 다음 중 하나를 선택하세요: 내부 테스트
- : QA 및 청구 스모크 테스트를 위해 가장 빠른 경로입니다. 일반적으로 새로운 버전이 몇 분 안에 사용할 수 있습니다.폐쇄 테스트
- Closed testing: Android Sandbox Testing을 위한 보다 광범위한 테스트를 위해 필요하고, 2023년 11월 13일 이후에 생성된 개인 개발자 계정의 경우 프로덕션 이전에 필수입니다.
Play Store에서 첫 번째 릴리스를 출시할 때, 내부 테스터에게 최대 48시간 동안 임시 앱 이름과 목록 정보를 표시할 수 있습니다.
테스터 목록 만들기

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

새로 생성된 개인 계정에 대한 프로덕션 접근을 위해 노력하고 있다면, 닫힌 테스트를 사용하고 최소 12명의 테스터를 14일 연속으로 옵트인하세요. 테스터 목록 만들기 Signed Release Build 업로드
새로운 Google Play 앱은 Android App Bundle을 사용하는 것이 좋습니다. 업로드 후 릴리스를 저장하고 정책 또는 스토어 목록 블록러 Play 플래그를 수정한 후 테스트 트랙으로 릴리스하세요.

Create a new release in the selected testing track and upload your signed .aab.

New Google Play apps should use an Android App Bundle rather than an APK. After upload, save the release, fix any policy or store listing blockers Play flags, then publish the release to the testing track.
테스트 프로그램에 가입하세요

테스트 장치에서 제공된 옵트인 URL을 열고 "테스터가 되다" 버튼을 클릭하세요. "테스터가 되다" 버튼을 클릭하여 등록하세요.

테스트 장치에서 로컬로 내보낸 APK가 아닌 Play 스토어에서 앱을 설치하세요.
빌드 및 테스트

테스트 장치에서 Play로 설치된 빌드를 실행하고 구매를 시도하세요. 다음과 같은 메시지를 볼 수 있습니다.

"이것은 테스트 주문입니다. 요금이 청구되지 않습니다."

중요한 참고사항

billing QA를 위해, Play 테스트 빌드를 설치하기 전에 앱의 sideloaded 버전을 모두 삭제하세요.
내부 테스트는 빠른_smoke 테스트에 좋지만, 새로운 개인 계정의 생산 액세스에 중요한 closed 테스트 트랙입니다.
테스트 계정은 구매에 대해 요금이 부과되지 않습니다.
테스트 구매는 생산 구매와 동일한 흐름을 사용합니다.
모든 구독 기능을 테스트할 수 있습니다. (trial 및 introductory offer 포함)
테스트 구독은 빠른 테스트를 위해 재생산 기간을 단축합니다.
Play Store에서 장치에 설치된 것, 테스터 옵인 흐름, License 테스트와 같은 모든 세 곳에서 동일한 Google 계정을 사용하세요.

문제 해결

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

테스트 트랙에 앱을 업로드하도록 확인하세요.
구매 테스트 계정 추가 확인
구글 플레이 콘솔에서 제품이 활성화되었는지 확인
구글 플레이에서 빌드가 설치되었는지, 로컬로 설치되지 않았는지 확인

“품목이 사용할 수 없음” 오류:

제품이 사용할 수 있도록 하기까지 2-3시간 기다리세요
앱의 패키지 이름이 플레이 콘솔에 등록된 이름과 일치하는지 확인
테스트 계정으로 로그인했는지 확인
테스트 트랙에서 빌드를 사용하는지 확인

구매 시 테스트 배너가 나타나는지 확인

실제 요금으로 표시되는 구매 테스트:
라이선스 테스트에 구매 계정 추가 확인
테스트 트랙에서 빌드를 사용하는지 확인

추가 리소스

Configure Android Sandbox Testing에서 계속 진행

이미 사용 중인 경우 Android Sandbox Testing을 구성 @__CAPGO_KEEP_0__/native-purchases를 사용하여 native capability을 사용하는 @capgo/native-purchases native capability을 사용하는 @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