跳过内容
Capgo - 为 Capacitor 应用实时更新 Capgo

配置 iOS 沙盒测试

GitHub

在 App Store Connect 和测试设备上进行 iOS 应用内购买测试需要正确的配置。这份指南涵盖了您需要开始进行沙盒测试的所有内容。

前提条件

Section titled “前提条件”
  • Apple Developer Program: 活跃会员资格，需要每年续费
  • 协议: 已签署“付费应用程序协议”，并已完成银行和税务信息
  • Xcode 项目: 配置了正确的包标识符和功能

设置流程

Section titled “设置流程”

  1. 签署付费应用程序协议

    在 App Store Connect 中，导航到 协议、税务和银行 并完成：

    • 签署付费应用程序协议
    • 添加银行信息
    • 完成税务表格

    等待苹果批准您的信息（这可能需要 24-48 小时）。

  2. 创建沙盒测试用户

    在 App Store Connect 中，转到 用户和访问 > 沙盒测试者.

    点击 + 创建沙盒测试者

    重要请使用尚未与Apple ID关联的电子邮件地址。您可以使用电子邮件别名:

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

    创建沙盒测试者

  3. 配置测试设备（iOS 12+）

    从iOS 12开始，您不再需要退出iTunes帐户以测试购买。

    在您的iOS设备上：

    1. 打开 设置
    2. 点击 App Store
    3. 滚动到底部
    4. 点击 沙盒账户
    5. 使用您的沙盒测试账户登录

  4. 配置Xcode项目

    确保您的Xcode项目具有：

    包标识符

    • 必须与您的开发者中心中的标识符匹配
    • 必须与 App Store Connect 中的标识符匹配

    内购功能

    1. 在 Xcode 中选择您的项目
    2. 转到 签名和功能
    3. 点击 + 功能
    4. 添加 内购

  5. 创建内购产品

    在 App Store Connect 中，导航到您的应用并创建您的内购产品（订阅、消耗性产品等）。

    产品必须至少处于“准备提交”状态才能进行沙盒测试。

  6. 测试您的实现

    在测试设备上构建并运行您的应用程序。当您尝试购买时，您应该看到：

    [环境：沙盒]

    此确认表明您处于沙盒环境中，不会被收取真实的钱。

重要注意事项

标题：重要注意事项

沙盒环境特征

标题：沙盒环境特征
  • 无真实费用: 在沙盒模式下所有购买都是免费的
  • 加速订阅: 订阅周期缩短以加快测试
    • 1 周免会员 = 3 分钟
    • 1 个月免会员 = 5 分钟
    • 2 个月免会员 = 10 分钟
    • 3 个月免会员 = 15 分钟
    • 6 个月免会员 = 30 分钟
    • 1 年免会员 = 1 小时
  • 自动续订限制:sandbox 中的订阅将自动续订至 6 次
  • 立即取消:取消的订阅将立即失效

sandbox 账户管理

sandbox 账户管理
  • 创建多个测试账户以支持不同场景
  • 仅在测试设备上使用测试账户
  • 不要使用个人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. 订阅自动续期 (加速续期)

故障排除

产品未加载:

请检查 bundle identifier 是否与 App Store Connect 匹配

  • 成功
  • 检查协议是否已签署并通过
  • 确保产品至少处于“准备提交”状态
  • 创建产品后等待2-3小时

“Cannot connect to iTunes Store”:

  • 确认sandbox账户配置正确
  • 检查设备是否连接到互联网
  • 尝试注销并重新登录sandbox账户
  • 重启应用

静默失败的购买:

  • 检查Xcode控制台中的错误消息
  • 确认In-App购买功能已启用
  • 确保sandbox账户邮箱不是真实的Apple ID
  • 尝试创建一个新的沙盒测试账户

收据验证错误：

  • 在测试中使用沙盒收据验证端点
  • 生产端点： https://buy.itunes.apple.com/verifyReceipt
  • 沙盒端点： https://sandbox.itunes.apple.com/verifyReceipt
  • 本地购买插件会自动处理这一点

错误的订阅时长：

  • 请记住，沙盒中订阅会加速
  • 使用上面的转换表来获取预期时长
  • 在沙盒中，订阅会自动续费至多6次

“这个Apple ID还未在iTunes Store中使用”：

  • 这是新沙盒账户的正常情况
  • 激活账户，请继续购买
  • 仅在首次使用时发生

最佳实践

最佳实践
  1. 创建多个测试账户 用于不同测试场景
  2. 测试所有订阅时长 验证行为
  3. 测试取消和续订 流程
  4. 验证收据验证 正确工作
  5. 测试恢复购买 功能
  6. 检查订阅升级/降级 行为
  7. 测试网络条件差

生产环境 vs. 测试环境

生产环境 vs. 测试环境
功能测试环境生产环境
真实收费否是
订阅时长加速正常
自动续订次数6 次无限制
取消效果立即期限结束
收据端点沙盒 URL生产 URL
仅测试帐户是否

额外资源

名为“额外资源”的部分

更多详细信息，请参阅 苹果官方StoreKit文档 关于沙盒测试的说明

继续从配置 iOS 沙盒测试

名为“继续从配置 iOS 沙盒测试”的部分

如果您正在使用 Configure iOS Sandbox Testing 为计划商店审批和分发，连接它 使用@capgo/native-purchases 在使用@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中