메뉴로 바로가기

Android 샌드박스 테스트를 구성하세요

GitHub

__CAPGO_KEEP_0__ 설정을 통해 Android 앱의 샌드박스 테스트를 설정하는 방법에 대한 안내서입니다.

작업에 적합한 빌드를 사용하세요

작업에 적합한 빌드를 사용하세요

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

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

만약에 Android Studio 또는 Google Play에서 APK를만들어 sideload한다면, Google Play 결제는 실제 배포와 다르게 동작할 수 있습니다. 구독 및 인앱 구매 검증을 위해 항상 Google Play에서 설치한 빌드를 테스트하세요. adb필요한 전제 조건

__CAPGO_KEEP_0__

기본 조건
  • Google Play 콘솔 개발자 계정이 필요합니다. 아직 계정을 만들지 않았다면 Play Console 가입.
  • Play Console에 앱 레코드를 생성한 후
  • Play Console에 내 앱 제품이나 구독을 생성한 후
  • Play Console에 라이센스 테스트를 위해 추가할 수 있는 테스트 Gmail 계정이 필요합니다.
  • 업로드하기 위해 준비된 signed release 빌드

billing 설정에 시간을 들이기 전에 Play Console에 앱을 생성하고 앱이 무료 유료 일단 유료 앱을 무료로 변경할 수 있지만, 무료로 제공된 앱은 유료로 변경할 수 없습니다.Google은 유료 앱을 무료로 변경할 수 있지만, 무료로 제공된 앱은 유료로 변경할 수 없습니다.

Android 앱 번들 (.aab)을 사용하여 새로운 플레이 스토어 앱을 만드세요:

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

Android 릴리즈 서명이 이미 구성되어 있어야 합니다. bundleRelease키스토어, 서명 구성, 릴리즈 패스워드가 아직 설정되지 않은 경우 Android Studio에서 Build > Generate Signed App Bundle / APK을 클릭하여 signed bundle를 생성하세요. 이 작업은 키스토어, 서명 구성, 릴리즈 패스워드의 값을 요청합니다.

  1. 테스트 계정 추가

    플레이 콘솔에서 열기 설정 > 라이선스 테스트 Android 테스트 장치에서 사용하는 기본 Google 계정을 추가하세요.

    구매가 Play 샌드박스 흐름을 보여주기 보다는 실제 결제를 시도하지 않도록 합니다.

    테스트 계정 추가

  2. 테스트 트랙 선택

    Go to 테스트 및 출시 > 테스트 다음 중 하나의 트랙을 선택하세요.

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

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

    테스트 트랙 만들기

  3. 테스터 목록 만들기

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

    제품 출시에 대한 접근을 위해 개인 계정이 새로 생성된 경우, 최소 12명의 테스터가 14일 연속으로 옵트인되어 있어야 합니다. 테스터 목록 만들기 서명된 릴리스 빌드 업로드

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

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

    릴리스 빌드 업로드 .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.

    Upload release build

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

    테스트 장치에서 옵트인 URL을 열고 "테스터가 되다" 버튼을 클릭하여 등록하세요. 테스터가 되다 그 옵트인 흐름에 의해 생성된 플레이 스토어 목록에서 앱을 설치하세요. 로컬로 내보낸 APK에서 설치하지 마세요.

    테스트에 가입하세요

    빌드 및 테스트

  6. 테스트 장치에서 플레이어 설치된 빌드를 실행하고 구매 시도하세요. 다음과 같은 메시지를 볼 수 있어야 합니다:

    테스트 구매

    중요한 주의사항

    제목이 "중요한 주의사항"인 섹션

중요한 주의사항

중요한 주의사항
  • For billing QA, __CAPGO_KEEP_0__ any sideloaded copy of the app before installing the Play testing build.
  • Internal testing is great for fast smoke tests, but closed testing is the track that matters for new personal-account production access.
  • 테스트 계정은 구매에 대해 요금이 부과되지 않습니다.
  • 테스트 구매는 동일한 흐름으로 진행되며 실제 구매와 동일합니다.
  • 모든 구독 기능을 테스트할 수 있습니다. 이에는 무료试用 및 소개 제안도 포함됩니다.
  • 테스트 구독은 빠른 테스트를 위해 재newal 기간이 단축됩니다.
  • Play Store에서 앱을 설치한 기기, 테스터 옵인 흐름, License 테스트에서 동일한 Google 계정을 사용하세요.

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

  • 테스트 트랙에 앱을 업로드한 것을 확인하세요.
  • License 테스트에 테스트 계정이 추가된 것을 확인하세요.
  • 구글 플레이 콘솔에서 제품이 활성화되었는지 확인하세요.
  • 구글 플레이에서 빌드가 설치되었는지, 아니면 로컬에서 시드 로드되었는지 확인하세요.

“Item not available” error:

  • 제품을 생성한 후 2-3시간 기다리세요. 그 후 제품이 사용 가능해집니다.
  • 앱의 패키지 이름이 플레이 콘솔에 등록된 패키지 이름과 일치하는지 확인하세요.
  • 테스트 계정으로 로그인되어 있는지 확인하세요.
  • 테스트 계정으로 로그인되어 있는지 확인하세요.

테스트 계정으로 로그인되어 있는지 확인하세요.

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

구매 시 테스트 배너가 표시되는지 확인하세요.

추가 리소스 섹션 제목

Configure Android Sandbox Testing에서 계속하기

Configure Android Sandbox Testing에서 계속하기 섹션 제목

이미 사용 중인 경우 Configure Android Sandbox Testing을 사용하여 스토어 승인 및 배포를 계획하고, Configure Android Sandbox Testing을 @capgo/native-purchases를 사용하여 @capgo/native-purchases에서 사용하는 @capgo/__CAPGO_KEEP_1__-in-app-review를 사용하여 @capgo/capacitor-in-app-review @capgo/capacitor-in-app-review Using @capgo/capacitor-in-app-review for @capgo/capacitor-in-app-review의 구현 세부 사항 for @capgo/capacitor-in-app-review의 원천 능력 @capgo/capacitor-native-market Using @capgo/capacitor-native-market for @capgo/capacitor-native-market의 구현 세부 사항