iOS 应用商店内购审查指南

复制一个包含安装步骤和完整 Markdown 指南的配置提示。

在 App Store 上获得应用程序批准需要仔细关注 Apple 的指南，特别是在实施内购和订阅时。这个指南涵盖了您需要知道的所有内容，以便在第一次提交时通过审核。

iOS App Store Review 流程

在提交前

完成 App Store Connect 设置

在 Apple 审核购买流程之前，请确保应用记录本身是完整的：

在 App Store Connect 中添加 隐私政策 URL 添加
支持 URL 该 URL 必须指向用户联系信息的真实页面 __CAPGO_KEEP_0__
完成 年龄等级 填写问卷以使应用程序可发布
添加 App Review 联系方式 并清晰的审查者注释
如果需要登录，请提供一个 demo 帐户，不会在审查期间过期

准备真实截图

使用当前截图从实际正在审查的构建中
如果您的应用程序在iPhone上运行， 1290 x 2796 （6.7英寸）是最简单的默认尺寸
如果您的应用程序在iPad上运行，请上传iPad截图
当前接受的iPad大尺寸包括 2064 x 2752 （13英寸）和 2048 x 2732 （12.9英寸）
不要Stretch iPhone截图来模拟iPad支持

在TestFlight中进行Dry-Run审查者旅程

在真实设备上运行 Apple 将遵循的确切路径:

从 TestFlight 安装最新的构建
使用您打算提供的审阅账户登录
不使用隐藏的手势或调试菜单来访问付费墙
完成购买、恢复和管理订阅流程
如果权限被拒绝，验证应用程序仍然正确运行

内购要求

价格透明度（关键）

在任何购买之前，苹果要求清晰的价格披露：

必须包含的元素：

在购买按钮前显示准确的价格
显示账单频率（例如，“每月 $9.99”）
明确说明用户为钱得到什么
指出费用何时发生

常见拒绝原因：

“Subscription pricing must be clear and upfront.”

:::caution 价格一致性所有价格必须在以下地方一致：

App Store 元数据列表
内购屏幕
订阅管理屏幕

即使是 $1 的差异也会触发自动拒绝，例如在 App Store 列表中显示 ($4.99) 和应用 ($5.99) 中

订阅计划的呈现

必备披露:

所有可用的订阅等级同时展示
每个等级的功能清晰对比
不通过 UI trick 自动跳转到高级等级
取消订阅指引易于找到

UI 设计规范

遵守规范的 UI 示例

import { NativePurchases } from '@capgo/native-purchases';

function SubscriptionScreen() {
  return (
    <div>
      <h2>Choose Your Plan</h2>

      {/* Show all tiers equally */}
      <PlanCard
        title="Basic"
        price="$4.99/month"
        features={['Feature A', 'Feature B']}
      />
      <PlanCard
        title="Premium"
        price="$9.99/month"
        features={['All Basic', 'Feature C', 'Feature D']}
        highlighted={false} // Don't force premium
      />

      {/* Clear cancellation info */}
      <Text>
        Cancel anytime in Settings > Subscriptions.
        No refunds for partial periods.
      </Text>
    </div>
  );
}

恢复购买

Required Implementation:

每个支持内购的应用都必须提供一个让用户恢复之前购买的方法，而不需要联系客服。

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

async function restorePurchases() {
  try {
    await NativePurchases.restorePurchases();

    const { purchases } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.SUBS,
    });

    const activeSub = purchases.find(
      (purchase) => purchase.isActive && purchase.expirationDate,
    );

    if (activeSub) {
      unlockPremiumFeatures();
      showMessage('Purchases restored successfully!');
      return;
    }

    const { purchases: iaps } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.INAPP,
    });
    const hasIap = iaps.some((purchase) => purchase.productIdentifier === 'premium_unlock');

    showMessage(
      hasIap ? 'Premium purchase restored!' : 'No previous purchases found.',
    );
  } catch (error) {
    showError('Failed to restore purchases. Please try again.');
  }
}

// Add a visible "Restore Purchases" button
<Button onClick={restorePurchases}>
  Restore Purchases
</Button>

常见拒绝原因

1. 应用程序崩溃或功能不正常

失败原因：

应用程序启动时崩溃
购买流程无法完成
截图中显示的功能无法正常工作

预防措施：

在真实设备上测试（不仅仅是模拟器）
测试所有订阅流程（从头到尾）
验证收据验证功能
检查网络错误处理

2. 元数据不匹配

为什么会失败：

截图显示当前版本中没有的功能
描述提到了不存在的功能
元数据中的价格与应用内价格不一致

元数据检查清单

预防措施：

// Document exactly what's in each tier
const SUBSCRIPTION_FEATURES = {
  basic: ['Ad-free', 'Cloud sync', 'Basic themes'],
  premium: ['Ad-free', 'Cloud sync', 'All themes', 'Priority support']
};

// Use these in both your app AND App Store description

3. 缺少权限说明

为什么会失败：

未提供解释的摄像头/位置/健康权限请求
权限请求深藏在多个屏幕中
模糊或通用的权限描述

预防措施：

更新您的 Info.plist 使用清晰的解释：

<key>NSCameraUsageDescription</key>
<string>Camera access is needed to scan product barcodes for quick subscription upgrades.</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>Location helps us show relevant local content in your Premium subscription.</string>

4. 虚假宣传

为什么会失败：

没有证据的“全球第一”类广告
有隐含限制的“无限”功能
制造紧迫感的伪造手段（“仅剩 2 个位置！”）

描述指南示例

附加描述指南

预防措施：

在描述中要具体、事实
避免没有证据的超级词汇
不要用假的紧迫感来压迫用户

5. 隐匿式取消流程

为什么会失败：

没有说明如何取消
取消按钮被隐藏或遮挡
没有使用苹果原生的多步取消流程

预防措施：

// Always inform users about cancellation
function SubscriptionInfo() {
  return (
    <div>
      <h3>How to Cancel</h3>
      <ol>
        <li>Open iPhone Settings</li>
        <li>Tap your name at the top</li>
        <li>Tap Subscriptions</li>
        <li>Select this app and tap Cancel</li>
      </ol>

      <p>Or manage directly in the App Store app.</p>

      <Button onClick={openSubscriptionManagement}>
        Manage Subscription in Settings
      </Button>
    </div>
  );
}

async function openSubscriptionManagement() {
  // Direct link to iOS subscription management
  await NativePurchases.showManageSubscriptions();
}

隐私和数据使用（第 5.1.1 章）

苹果在 2025 年严格提高了隐私要求

必备披露

每项权限:

为什么需要它（具体用例）
何时会使用
数据如何存储/共享
是否可选或必填

示例：正确的权限流程

async function requestCameraPermission() {
  // Show explanation BEFORE requesting
  await showDialog({
    title: 'Camera Access',
    message: 'We need camera access to let you scan barcodes for quick product lookup. Your photos are never uploaded or stored.',
    buttons: ['Not Now', 'Allow']
  });

  // Then request permission
  const result = await Camera.requestPermissions();
  return result.camera === 'granted';
}

隐私营养标签

确保您的 App Store隐私标签准确反映:

收集购买历史
电子邮件地址（用于收据）
设备 ID（用于欺诈防御）
使用数据（用于分析）

2025 年不准确的隐私标签是拒绝理由之一。审查您的数据收集非常重要。

提交前检查清单

测试所有购买流程

购买每个订阅等级
- 测试免费试用
- 测试每个订阅等级
- 验证推广活动是否正确
- 测试恢复购买
- 验证家庭共享功能（如果已启用）
- 测试在多台设备上
验证定价一致性
- 检查 App Store 元数据与应用内价格匹配
- 验证所有货币是否正确
- 确认免费试用期的持续时间与描述匹配
- 验证推广活动条款是否准确
审查所有复制内容
- 移除占位符文本
- 验证所有声明是否可测试
- 检查语法和拼写
- 确保描述与当前构建匹配
- 移除竞争对手的提及
测试权限
- 只请求必要的权限
- 在请求之前显示清晰的说明
- 测试“拒绝”流程（应用程序仍应正常工作）
- 验证 Info.plist 描述是清晰的
准备测试账户
- 创建一个在审查期间有效的审查账户
- 在 App Review 信息中记录登录凭证
- 验证审查者可以访问付墙并完成购买流程
- 如果需要，请在 Notes field 中包含额外的账户或应用特定的 switch
检查元数据
- 截图与当前 UI 匹配
- 支持 URL 包含真实的联系方式信息
- 隐私政策 URL 已填写
- 应用年龄等级与构建中的内容匹配
- 如果有应用预览视频，则显示当前版本
- 描述准确地描述了功能
- 隐私政策在应用内和商店列表中都可访问

写详细的评审笔记

Contact:
Name: Jane Developer
Email: review@yourapp.com
Phone: +1 555-0100

Test Account:
Email: reviewer@test.com
Password: TestPass123!
This account does not expire during review.

Testing Instructions:
1. Log in with test account above
2. Tap "Upgrade to Premium" button
3. Select "Monthly Premium" subscription
4. Complete purchase (no charge in sandbox)
5. Verify premium features unlock

Note: Subscription pricing is clearly shown before purchase.
Cancellation instructions are in Settings > Account.

评审时间线

App Store Review 时间线

标准审查： 24-48 小时 高峰期： 3-5 天（App Store 节假日发布） 周末： 无审查 加速审查： 适用于紧急 bug 修复（通过 App Store Connect 请求）

App Store Connect 中常见的状态：

Waiting for Review
In Review
Pending Developer Release
Rejected

2026 投稿重点

当前重点领域

1. 订阅清晰度

需要进行侧面比较的计划
不允许使用“黑暗模式”来隐藏更便宜的选项
清晰的降级/升级路径

2. 元数据准确性

截图必须与正在审阅的构建匹配
如果启用了iPad支持，则需要提供iPad截图
支持URL和隐私政策应在提交前已上线

3.隐私和审查细节质量

隐私披露必须与您的SDK实际收集的内容一致
在第一次提交时，应用审查联系信息和备注应已完成
演示凭证必须在整个审查窗口内保持有效

4.提交准备

苹果更新的最低SDK要求定期更新，因此在上传发布版之前确认当前截止日期
TestFlight是验证准确的审查者路径的最安全的地方

原生购买插件的最佳实践

正确处理错误

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

async function handlePurchase(productId: string) {
  try {
    const transaction = await NativePurchases.purchaseProduct({
      productIdentifier: productId,
      productType: PURCHASE_TYPE.SUBS,
    });

    // Success
    await validateReceiptOnServer(transaction.receipt);
    showSuccess('Subscription activated!');
    unlockFeatures();

  } catch (error: any) {
    // Handle specific error cases
    if (error.code === 'USER_CANCELLED') {
      // User cancelled - don't show error
      console.log('Purchase cancelled by user');
    } else if (error.code === 'PAYMENT_PENDING') {
      showInfo('Payment is pending. Please check back later.');
    } else if (error.code === 'PRODUCT_ALREADY_PURCHASED') {
      // Restore instead
      await NativePurchases.restorePurchases();
    } else {
      // Show user-friendly error
      showError('Unable to complete purchase. Please try again.');
    }
  }
}

显示加载状态

function PurchaseButton({ productId }: { productId: string }) {
  const [loading, setLoading] = useState(false);

  const handlePurchase = async () => {
    setLoading(true);
    try {
      await NativePurchases.purchaseProduct({ productIdentifier: productId });
    } finally {
      setLoading(false);
    }
  };

  return (
    <button onClick={handlePurchase} disabled={loading}>
      {loading ? 'Processing...' : 'Subscribe Now'}
    </button>
  );
}

明确显示条款

function SubscriptionTerms() {
  return (
    <div className="terms">
      <p>
        Subscription automatically renews unless cancelled at least 24 hours
        before the end of the current period.
      </p>
      <p>
        Your account will be charged for renewal within 24 hours prior to
        the end of the current period.
      </p>
      <p>
        Subscriptions may be managed by the user and auto-renewal may be
        turned off in Account Settings after purchase.
      </p>
      <p>
        <a href="/terms">Terms of Service</a> |
        <a href="/privacy">Privacy Policy</a>
      </p>
    </div>
  );
}

解决问题的步骤

复制到剪贴板

认真阅读拒绝理由
- 注意被指出的具体指南（例如，3.1.1，5.1.1）
- 准确理解苹果旗帜下的问题
彻底解决问题
- 不仅仅是修补 - 修复根本原因
- 对修复进行广泛测试
- 记录你所做的更改

在 Resolution Center 中回复

Thank you for your feedback. I have addressed the issue:

Issue: Subscription pricing not clear upfront

Fix: Added explicit pricing display on subscription selection
screen showing "$9.99/month" before purchase button. Also added
cancellation instructions on the same screen.

The changes are in this submission and can be tested using the
provided test account.

尽快重新提交
- 重新提交通常会更快
- 通常在 24 小时内

申诉流程

如果您认为拒绝是错误的：

App Store 澄清流程

点击 App Store Connect 中的“申诉”
提供清晰的证据：
- 显示遵守的截图
- 具体指向的指南
- 解释如何满足要求
专业且事实
如果功能难以找到，请包含测试账户

文件请求示例

额外资源

支持

如果您仍然遇到问题：

请查看原生购买文档
检查常见问题排查
联系苹果开发者支持团队获取指南解释

需要专家帮助?

应用程序审查困难或需要个人化帮助? 与我们的团队预约电话会议 专注于：

IAP 实现审查和优化
应用商店审查准备和策略
提交清单审查
拒绝解决方案和申诉
完成测试和验证

我们的专家已经成功帮助数百个应用程序通过审核!