내용으로 건너뛰기
Capgo - Capacitor 앱의 실시간 업데이트 Capgo

Configure iOS 사andbox 테스트

GitHub

iOS에서 인앱 구매 테스트를 위해 App Store Connect와 테스트 장치에 적절한 구성이 필요합니다. 이 가이드는 샌드박스 테스트를 시작하기 위해 필요한 모든 것을 다룹니다.

사전 요구 사항

제목이 “사전 요구 사항”인 섹션
  • Apple Developer Program__CAPGO_KEEP_0__
  • Agreements__CAPGO_KEEP_1__
  • Xcode Project__CAPGO_KEEP_2__

__CAPGO_KEEP_4__

Setup Process

  1. __CAPGO_KEEP_5__ ‘Setup Process’__CAPGO_KEEP_6__ ‘Paid Applications Agreement’

    App Store Connect에서 계약, 세금, 은행 을 클릭하여 다음을 완료하세요.

    • 유료 애플리케이션 계약에 서명하세요.
    • 은행 정보를 추가하세요.
    • 세금 계산서를 완료하세요.

    Apple이 정보를 승인하는 데 24-48시간이 걸릴 수 있습니다.

  2. Sandbox 테스트 사용자 만들기

    App Store Connect에서 Users and Access > Sandbox Testers.

    버튼을 클릭하여 새로운 샌드박스 테스터를 만들세요. + __CAPGO_KEEP_0__

    중요: Apple ID와 연관된 이메일 주소가 아닌 이메일 주소를 사용하세요. 이메일 별칭을 사용할 수 있습니다.:

    • Gmail: youremail+test@gmail.com
    • iCloud: youremail+test@icloud.com

    샌드박스 테스터 만들기

  3. 테스트 장치 구성 (iOS 12+)

    iOS 12부터는 iTunes 계정에서 로그아웃하지 않아도 구매 테스트가 가능합니다.

    iOS 장치에서:

    1. : 열기 설정
    2. 탭 앱 스토어
    3. __CAPGO_KEEP_0__
    4. __CAPGO_KEEP_0__ __CAPGO_KEEP_0__
    5. __CAPGO_KEEP_1__

  4. __CAPGO_KEEP_4__

    __CAPGO_KEEP_5__

    __CAPGO_KEEP_6__

    • __CAPGO_KEEP_7__
    • __CAPGO_KEEP_8__

    In-App Purchase Capability

    1. Xcode에서 프로젝트를 선택하세요
    2. Go to 인증 및 기능
    3. Click + 기능
    4. Add In-App Purchase

  5. In-App Purchase 제품 만들기

    앱 스토어 커넥트에서 앱을 열고, 구독, 소비 가능한 제품 등 인앱 구매 제품을 만들세요.

    제품은 최소 '제출 준비' 상태여야 하며, 샌드박스 테스트를 위해.

  6. Implementation 테스트

    테스트 기기에서 앱을 빌드하고 실행하세요. 구매 시 다음을 확인하세요.

    [환경: 샌드박스]

    이 확인은 샌드박스 환경에서 실제 돈을 지불하지 않음을 의미합니다.

중요한 참고 사항

중요한 참고 사항

샌드박스 환경 특징

샌드박스 환경 특징
  • 실제 요금 없음샌드박스 모드에서는 모든 구매가 무료입니다.
  • 가속된 구독구독 기간이 단축되어 빠른 테스트를 위해 사용됩니다.
    • 1주 구독 = 3분
    • 1 달간 구독 = 5분
    • 2 달간 구독 = 10분
    • 3 달간 구독 = 15분
    • 6 달간 구독 = 30분
    • 1 년간 구독 = 1시간
  • 자동 갱신 제한: 샌드박스에서 구독이 자동 갱신됩니다. 갱신 횟수는 6회까지 가능합니다.
  • 즉시 취소: 취소된 구독은 즉시 만료됩니다.

샌드박스 계정 관리

샌드박스 계정 관리
  • 다양한 시나리오에 대해 여러 개의 테스트 계정을 생성합니다.
  • __CAPGO_KEEP_0__을 테스트 계정만 테스트 기기에서 사용하세요.
  • __CAPGO_KEEP_0__ 개인 Apple ID를 샌드박스 테스트에 사용하지 마세요.
  • 테스트 계정은 지역에 관계없이 어떤 제품도 구매할 수 있습니다.

샌드박스 테스트 사용

샌드박스 테스트 사용
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';


const { isBillingSupported } = await NativePurchases.isBillingSupported();
if (!isBillingSupported) {
  throw new Error('StoreKit not supported on this device');
}


// Fetch products (automatically uses sandbox when available)
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['premium_monthly'],
  productType: PURCHASE_TYPE.SUBS,
});


// Make test purchase
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'premium_monthly',
  productType: PURCHASE_TYPE.SUBS,
});


console.log('Test purchase successful!', transaction.transactionId);

인증

인증

구성되면 올바르게 관찰해야 할 것입니다.

  1. 샌드박스 배너 구매 중: '[환경: 샌드박스]'
  2. 제품 로드 성공적으로
  3. 구매가 완료되었습니다 실제 요금이 청구되지 않습니다
  4. 영수증이 유효합니다 정확히
  5. 자동으로(가속된 속도) 문제 해결

제목: 문제 해결

상품이 로드되지 않습니다:

App Store Connect의 번들 식별자가 일치하는지 확인하세요

  • 동의서가 서명되고 승인되었는지 확인하세요
  • __CAPGO_KEEP_0__
  • 제품은 '제출 준비' 상태 이상이어야 합니다.
  • 제품을 생성한 후 2-3시간 기다려보세요.

iTunes Store에 연결할 수 없습니다:

  • 샌드박스 계정이 올바르게 설정되어 있는지 확인하세요.
  • 장치가 인터넷에 연결되어 있는지 확인하세요.
  • 샌드박스 계정에서 로그아웃하고 다시 로그인해 보세요.
  • 앱을 재시작하세요.

구매가 조용히 실패하는 경우:

  • Xcode 콘솔에서 오류 메시지를 확인하세요.
  • In-App Purchase 기능이 활성화되어 있는지 확인하세요.
  • 샌드박스 계정 이메일이 실제 Apple ID가 아닌지 확인하세요.
  • 새로운 샌드박스 테스트 계정을 생성해 보세요.

__CAPGO_KEEP_0__ 오류:

  • 테스트 환경에서 샌드박스 영수증 검증 엔드포인트를 사용하세요
  • 생산 엔드포인트: https://buy.itunes.apple.com/verifyReceipt
  • 샌드박스 엔드포인트: https://sandbox.itunes.apple.com/verifyReceipt
  • native-purchases 플러그인은 이 작업을 자동으로 처리합니다

구독 기간 오류:

  • 샌드박스에서 구독은 가속되므로
  • 위의 변환 차트를 참조하여 예상 기간을 확인하세요
  • 샌드박스에서 구독은 최대 6번 자동 갱신됩니다

"iTunes Store에서 이 Apple ID를 아직 사용하지 않았습니다":

  • 새로운 샌드박스 계정의 경우 정상입니다
  • 구매를 진행하여 계정을 활성화하세요
  • __CAPGO_KEEP_0__

최선의 방법

__CAPGO_KEEP_1__
  1. 다양한 테스트 시나리오를 위해 여러 개의 테스트 계정을 생성합니다. 다양한 테스트 시나리오를 위해 여러 개의 테스트 계정을 생성합니다.
  2. 모든 구독 기간을 테스트하여 동작을 확인합니다. 취소와 갱신 흐름을 테스트합니다.
  3. 받은 결제 확인을 올바르게 동작하는지 확인합니다. 받은 결제 확인을 올바르게 동작하는지 확인합니다.
  4. 구매 복원 동작을 테스트합니다. 구매 복원 동작을 테스트합니다.
  5. 구매 복원 동작을 테스트합니다. 기능성
  6. 구독 업그레이드/다운그레이드 확인 동작
  7. kém 네트워크 조건하에 테스트

실제 비용 vs. 샌드박스

제목: 실제 비용 vs. 샌드박스
기능샌드박스실제
실제 비용아니요예
구독 기간빨리일반
자동 갱신 제한6 번무제한
취소 효과즉시기간 종료
영수증 엔드포인트샌드박스 URL생산 URL
테스트 계정만YesNo

추가 리소스

추가 리소스 섹션

자세한 내용은 공식 Apple StoreKit 문서를 참조하십시오 샌드박스 테스트에 대해.

Configure iOS Sandbox Testing에서 계속 진행하십시오

Configure iOS Sandbox Testing 섹션

Capgo를 사용 중이라면 Configure iOS Sandbox Testing을 구성하십시오 스토어 승인 및 배포를 계획하고 연결하세요. @capgo/native-purchases를 사용하여 native capability을 사용하는 @capgo/native-purchases의 경우 @capgo/capacitor-in-app-review를 사용하여 @capgo/capacitor-in-app-review의 구현 세부 사항을 확인하세요. @capgo/capacitor-in-app-review를 사용하여 native capability을 사용하는 @capgo/capacitor-in-app-review의 경우 @capgo/capacitor-native-market를 사용하여 @capgo/capacitor-native-market의 구현 세부 사항을 확인하세요. @capgo/capacitor-native-market를 사용하여 native capability을 사용하는 @capgo/capacitor-native-market의 경우