コンテンツにジャンプ
Capgo - Capacitor アプリのリアルタイム更新 Capgo

ページ/エリア: Capgo マーケティング ウェブサイト。役割: ショート UI ラベルまたはナビゲーション アイテム。見られる場所: コンポーネント GlobalInfrastructure.astro、ページ observe.astro。メッセージ キー `cta_start_free` (CTA Start Free)。| ページ/エリア: Capgo マーケティング ウェブサイト。役割: ショート UI ラベルまたはナビゲーション アイテム。見られる場所: コンポーネント Hero.astro、コンポーネント HowItWorks.astro。メッセージ キー `hero_cta_try_free` (Hero CTA Try Free)。

GitHub

iOSのインアプリ購入のテストには、App Store Connectとテストデバイスの設定が適切に構成されている必要があります。このガイドでは、サンドボックステストを始めるために必要なすべてのことをカバーしています。

前提条件

前提条件
  • Apple Developer Program年間更新会員
  • 契約「有料アプリケーション契約」に銀行と税金の情報を入力したもの
  • Xcode Project正しいバンドルIDと機能を持つ

セットアッププロセス

セクションのタイトル “セットアップ プロセス”

  1. 有料アプリケーション契約を署名する

    App Store Connectで、 契約、税金、銀行 を完了する:

    • 有料アプリケーション契約を署名する
    • 銀行情報を追加する
    • 税金の書類を完了する

    Appleが情報を承認するのを待つ (24-48時間かかることがあります。)

  2. サンドボックステストユーザーを作成する

    App Store Connectで、 ユーザーとアクセス > サンドボックステストアクセス.

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

    重要注意: Bug bounty programのページで使用されるUIラベルです。

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

    iCloud:

  3. サンドボックステスターを作成

    テストデバイスを設定 (iOS 12+)

    iOS 12以降では、購入テストを行うためにiTunesアカウントからサインアウトする必要はありません。

    1. iOSデバイスで 設定
    2. タップ App Store
    3. 下部までスクロール
    4. タップ サンドボックスアカウント
    5. サンドボックステストアカウントでサインイン

  4. Xcodeプロジェクトの設定

    Xcodeプロジェクトには次の条件を満たす必要があります:

    バンドルID

    • 開発者センターのIDと一致する必要があります。
    • App Store ConnectのIDと一致する必要があります。

    インアプリ購入機能

    1. Xcodeでプロジェクトを選択してください。
    2. Xcodeで 署名と機能
    3. クリックしてください。 機能を追加
    4. インアプリ購入 インアプリ購入商品を作成

  5. App Store Connectでアプリを選択し、インアプリ購入商品を作成してください (サブスクリプション、消耗品など)。

    インアプリ購入機能

    sandbox テストの場合、製品は少なくとも「提出可能」状態でなければなりません。

  6. 実装をテストしてください

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

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

    この確認は、実際の金銭的負担なしでサンドボックス環境内にいることを示しています。

重要な注意事項

重要な注意事項

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

サンドボックス環境の特徴
  • 実際の請求なし: サンドボックス モードではすべての購入が無料です
  • 加速されたサブスクリプション: テストのためにサブスクリプションの期間が短縮されます
    • 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);

検証の実施

正しく設定されている場合、次のことを観察することができます

サンドボックスバナー

  1. Section titled “Sandbox Account Management” 購入中: '[Environment: Sandbox]'
  2. 製品の読み込み 正常に
  3. 購入が完了 実際の請求なし
  4. レシートの検証 正しく
  5. サブスクリプションの更新 自動的に (加速された速度で)

トラブルシューティング

トラブルシューティング

製品の読み込みが正常にありません:

  • App Store Connectのバンドル識別子を確認する
  • 契約書が署名され承認されていることを確認する
  • 製品が「提出可能」状態であることを確認する
  • 製品を作成した後2-3時間待つ

「iTunes Storeに接続できません」

  • iTunes Storeに接続できない:
  • サンドボックスアカウントが正しく設定されていることを確認する
  • デバイスがインターネットに接続されていることを確認する
  • サンドボックスアカウントからログアウトし再度ログインする

アプリケーションを再起動する

  • Xcodeコンソールでエラーメッセージを確認してください。
  • 購入が静かに失敗している:
  • 実際のApple IDではないサンドボックスアカウントのメールアドレスを確保する
  • 新しいサンドボックステストアカウントを作成してみる

受領証の検証エラー:

  • テスト用にサンドボックス受領証検証エンドポイントを使用する
  • プロダクションエンドポイント: https://buy.itunes.apple.com/verifyReceipt
  • サンドボックスエンドポイント: https://sandbox.itunes.apple.com/verifyReceipt
  • この自動的に処理されるnative-purchasesプラグイン

間違ったサブスクリプション期間:

  • サンドボックスではサブスクリプションが加速されることを思い出してください
  • サブスクリプションの変換表を上に参照して期待される期間を確認してください
  • サンドボックスではサブスクリプションが最大6回自動更新される

「このApple IDはまだiTunes Storeで使用されていません」:

  • 新規サンドボックスアカウントの場合、通常のことです
  • アカウントを有効にするために購入を続行してください
  • 初めて使用する場合にのみ発生します

ベストプラクティス

「ベストプラクティス」のセクション
  1. 異なるテストシナリオ用に複数のテストアカウントを作成してください 異なるテストシナリオ用に複数のテストアカウントを作成してください
  2. すべてのサブスクリプション期間をテストしてください 動作を確認するために
  3. キャンセルと再契約のフローをテストしてください flows
  4. 受け取り確認を検証してください 正常に機能します。
  5. 購入を復元テスト 機能
  6. サブスクリプションのアップグレード/ダウングレードを確認 動作
  7. ネットワーク環境が悪い場合のテスト

本番用 vs. サンドボックス

「本番用 vs. サンドボックス」
機能サンドボックス本番
実際の請求Noはい
サブスクリプション期間加速通常
自動更新制限6回無制限
キャンセル効果即時期間終了
受領エンドポイントサンドボックス URL本番 URL
テストアカウントのみはいいいえ

追加リソース

追加リソース

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

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

For more details, refer to the

Capgoを使用している場合 iOSサンドボックステストを設定する ストアの承認と配布を計画するには、 Using @capgo/native-purchases native capability を使用する場合の @capgo/native-purchases @capgo/capacitor-アプリ内レビュー @capgo/capacitor-in-app-レビューの実装詳細のために @capgo/capacitor-インアプリレビューを使用 native capability については、@capgo/capacitor-in-app-review を使用します。 @capgo/capacitor-native-market Capgoの実装詳細については、@capgo/capacitor-native-marketのドキュメントを参照してください。 @capgo/capacitor-ネイティブマーケットを使用 Capgoのネイティブ機能を使用するには、@capgo/capacitor-native-marketを使用してください。