iOSサンドボックステストの設定

GitHub

このプラグインのインストールステップと全マークダウンガイドのセットアップ用の質問をコピーする。

iOSのインアプリ購入のテストには、App Store Connectとテストデバイスで適切な設定が必要です。このガイドでは、サンドボックステストに必要なすべての内容をカバーしています。

前提条件

Apple Developer Program: 年間更新の有効な会員資格
: 銀行情報と税金情報を完了した「有償アプリケーション契約」に署名Agreements
Xcode Project:

Banking and tax setup approval can take hours to days. Complete this well in advance of testing.

Section titled “Setup Process”

Sign Paid Applications Agreement In App Store Connect, navigate to Agreements, Tax, and Banking
- and complete: Sign the Paid Applications Agreement
- 銀行情報を追加してください
- 税金の申告書を完了してください
Appleが情報を承認するのを待ってください (24-48時間かかる場合があります)。
サンドボックステストユーザーを作成してください

App Store Connectに移動してください ユーザーとアクセス > サンドボックステストユーザー.

新しいサンドボックステストユーザーを作成するボタンをクリックしてください + 重要

: Apple IDに関連付けられているメールアドレスを使用しないでください。メールアリセを使用できます:Gmail:
- iCloud: youremail+test@gmail.com
- iCloud: youremail+test@icloud.com
iOS 12 以降のテストデバイスを設定

iOS 12 以降では、iTunes アカウントからサインアウトする必要がなくなりました。

iOS デバイスで
1. Open 設定
2. タップ App Store
3. 下部までスクロール
4. タップ サンドボックスアカウント
5. サンドボックステストアカウントでサインイン
iTunesアカウントからログアウトする古い方法よりもはるかに便利です!
Xcode Projectを設定

Xcodeプロジェクトには、以下の条件を満たしている必要があります。

Bundle Identifier
- 開発者センターの識別子と一致する必要があります。
- App Store Connectの識別子と一致する必要があります。
In-App Purchase Capability
1. Xcodeでプロジェクトを選択
2. プロジェクトを選択 Signing & Capabilities
3. クリック +機能
4. 追加 インアプリ購入
インアプリ購入製品の作成

アプリストア接続で、アプリとインアプリ購入製品を作成してください (サブスクリプション、消耗品など)。

製品は、サンドボックステストのために少なくとも「提出可能」状態でなければなりません。
実装のテスト

テストデバイスでアプリをビルドして実行してください。購入を試みると、次のようになります。

[環境: サンドボックス]

この確認は、実際の金銭の請求が発生しないサンドボックス環境内にいることを示しています。

重要な注意事項

サンドボックス環境の特徴

実際の料金はかかりませんサンドボックスモードではすべての購入が無料です
高速化されたサブスクリプションサブスクリプションの期間が短縮され、テストを高速化します
- 1週間のサブスクリプション = 3分
- 1か月のサブスクリプション = 5分
- 2か月のサブスクリプション = 10分
- 3か月のサブスクリプション = 15分
- 6か月のサブスクリプション = 30分
- 1 年間のサブスクリプション = 1 時間
自動更新の制限: サンドボックス内でサブスクリプションが最大 6 回自動更新されます
即時キャンセル: キャンセルされたサブスクリプションは即時有効期限切れ

サンドボックスアカウント管理

異なるシナリオ用に複数のテストアカウントを作成する
テストアカウントはテストデバイスのみで使用する
サンドボックステスト用にパーソナル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);

Verification

正しく設定されている場合、次のことが観察されるはずです。

Sandbox バナー 購入時: “[Environment: Sandbox]”
製品の読み込み 正常に
購入の完了 実際の請求なし
領収書の検証 正しく
自動再生 トラブルシューティング

「トラブルシューティング」

App Store Connectのバンドル識別子が正しいか確認してください

契約が署名され、承認されていることを確認してください
製品が少なくとも「提出可能」状態であることを確認してください
製品を作成した後2-3時間待ってください
「iTunes Storeに接続できません」:

サンドボックスアカウントが正しく設定されていることを確認してください

自動再生
インターネットに接続されているデバイスを確認してください
サンドボックスアカウントからログアウトし、再度ログインしてください
アプリを再起動してください

購入が静かに失敗しています:

Xcodeコンソールでエラーメッセージを確認してください
In-App Purchase機能が有効になっていることを確認してください
サンドボックスアカウントのメールアドレスが実際のApple IDではありませんか?
新しいサンドボックステストアカウントを作成してみてください

レシート検証エラー:

テスト用にサンドボックスレシート検証エンドポイントを使用してください
プロダクションエンドポイント: https://buy.itunes.apple.com/verifyReceipt
サンドボックスエンドポイント: https://sandbox.itunes.apple.com/verifyReceipt
native-purchasesプラグインは自動的にこの処理を実行します

サブスクリプション期間が正しくありません:

サンドボックスではサブスクリプションが加速されることを覚えておいてください
期待される期間のための変換表を上に参照してください
サンドボックスではサブスクリプションが最大6回自動再生されます

“このApple IDはまだiTunes Storeで使用されていません”：

新しいサンドボックスアカウントの場合にのみ通常のことです
購入を実行してアカウントを有効化してください
最初の使用時のみ発生します

ベストプラクティス

複数のテストアカウントを作成してください 異なるテストシナリオ
すべてのサブスクリプション期間をテストする 動作を確認する
キャンセルと再登録のフローをテストする フロー
受け取り確認の検証 正しく動作することを確認する
購入の復元をテストする 機能
サブスクリプションのアップグレード/ダウングレードをチェックする 動作
不良ネットワーク条件でテストする

生産環境 vs. サンドボックス

機能	サンドボックス	生産環境
実際の料金	いいえ	はい
サブスクリプション期間	加速	通常
自動更新制限	6 times	無制限
キャンセル効果	即時	期間終了
受領エンドポイント	サンドボックスURL	プロダクションURL
テストアカウントのみ	はい	いいえ

追加リソース

詳細は公式の Apple StoreKit ドキュメントサンドボックステストについて

Configure iOS Sandbox Testing

Capgoを使用している場合 Capgoを使用して ストアの承認と配布を計画するには Using @capgo/native-purchases for the native capability in Using @capgo/native-purchases, @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 for the native capability in Using @capgo/capacitor-native-market.