iOS 入门指南

关于本指南

本入门指南旨在为已通过我们的业务拓展团队与 Aptoide Connect 建立合作关系、正准备通过 Aptoide iOS App Store 分发其 iOS 应用的 iOS 开发者提供支持。

其主要目标是：

• 提供清晰、分步的技术和运营入门流程概览。
• 在开发者与 Aptoide 团队之间统一预期。
• 确保顺畅高效的集成与发布。

什么是 Aptoide Connect？

Aptoide Connect 是 Android 和 iOS 上替代应用分发的接入点，旨在帮助开发者在多个替代应用商店（包括 Aptoide、Xiaomi 等领先合作伙伴）扩大覆盖范围，触达超过 5000 万月活跃用户。

Aptoide Connect 中的分发工作流程设计得简单高效，只需极少的工程投入即可在多个商店实现大规模分发。

通过与 Aptoide Billing SDK 集成，开发者可在应用内购买中享受最高 90% 的分成比例，并通过合作伙伴商店中的优先搜索展示和精选推广获得更高的曝光度。

要详细了解我们的产品，请访问我们的**官方网站以及本文档的关于我们**部分。

沟通渠道

在入门通话之前或之后，您的客户经理将设立专属沟通渠道，在整个集成过程中为您提供支持，确保快速高效的协作。

我们首选的沟通渠道为：

• 私有 Slack 频道（首选）
• WeChat 群组
• Telegram 群组

如果您的团队倾向于使用其他平台，请告知您的客户经理。

为简化沟通，客户经理将纳入相关团队的代表，包括：

• 运营
• 技术支持
• 营销与精选推广
• 业务与销售

在技术集成开始之前，如有需要，我们可以安排一次额外的入门通话，以：

• 提供集成流程的端到端概览
• 对 Aptoide Connect 控制台进行实时演示
• 解答任何技术、运营或业务相关的问题

启动问卷

在我们开始集成之前，如果您尚未完成，请提供有关您应用的以下信息。您的回答将帮助我们高效地规划集成，并优化您的应用在 Aptoide 及合作伙伴商店的发布。

必填信息：

1. App Bundle ID：您正在集成的应用程序的 Bundle ID 是什么？
2. 集成开始日期：您希望何时开始集成流程？
3. 预期发布日期：您的应用/游戏在 Aptoide 上的计划发布日期是什么？
4. 自动提交：您是否会为 Aptoide 和 App Store 使用同一构建版本，并在 App Store Connect 中启用自动版本通知？（我们强烈建议这样做，以确保更快的更新和更顺畅的发布。）
5. 社交登录：您的应用是否支持社交登录选项（例如 Google、Facebook）？
6. 非消耗型项目：您的应用是否包含任何非消耗型项目（例如订阅、一次性购买）？

入门流程

1. 在 Aptoide Connect 上注册
2. 在 Aptoide Connect 上添加您的应用
3. 在 App Store Connect 上将您的应用连接到 Aptoide
4. 在 Aptoide Connect 上证明应用所有权
5. 集成我们的 Billing SDK
6. 在 App Store Connect 上提交您的构建版本
7. 由我们审核您的构建版本
8. 您的应用在 Aptoide 上线

在 Aptoide Connect 上注册

在 https://connect.aptoide.com/register 创建您的账户。您可以使用电子邮件和密码注册，或使用您的 Google 账户进行身份验证。

注册并接受 Certified Developer Distribution Agreement 和条款与条件后，请提供以下信息完善您的公司资料：

• 公司名称
• 公司地址
• 注册成立国家

为确保账户安全，我们强烈建议使用电子邮件、短信或身份验证应用启用双重身份验证 (2FA)。

浏览我们的文档

使用我们的文档来指导您的集成，并熟悉 Aptoide Connect 的关键组件，包括计费、账户管理和性能优化。

我们建议从以下资源开始：

• 开发者控制台概览
  熟悉应用上线后您将能够在 Aptoide Connect 开发者控制台中访问的可用菜单和信息。
• 用户访问管理
  了解如何在同一 Aptoide Connect 账户内向多个用户授予访问权限，使团队无需共享凭据即可安全协作。
• Billing SDK
  了解如何使用 Aptoide Billing SDK 实现应用内购买。

添加您的应用

向 Aptoide Connect 添加应用是一个简单而高效的流程。有关完整的操作演示，请参阅我们的专属文档页面。以下是主要步骤的概要。

1. 在顶部导航栏中，点击 Add App。
2. 点击 Add iOS App。
3. 提供您应用的 bundle id（例如 com.example）。
4. 点击 Next 继续。您将被重定向到**应用提交表单**，系统将要求您提供有关应用的所有相关技术和商店信息。

在 App Store Connect 上将您的应用连接到 Aptoide

要通过 Aptoide 等替代市场分发您的应用，您必须首先在 App Store Connect 中将其连接到这些市场。

在市场连接选项可用之前，请确保您已完成以下前提条件：

• 在欧盟分发：签署 Alternative Terms Addendum 填写并提交适用于欧盟应用的 Alternative Terms Addendum： https://developer.apple.com/contact/request/alternative-eu-terms-addendum/
• 在日本或巴西分发：接受最新的 Apple Developer Program 协议 请确保您已接受最新的 Apple Developer Program License Agreement，其中包含适用于日本和巴西 iOS 应用的附加条款（所有开发者均须接受此条款）。

📘

只有在接受这两项协议后，连接到替代市场的选项才会在 App Store Connect 中显示。

完成前提条件后，请参阅我们的专属文档页面，了解如何在 App Store Connect 中将 Aptoide 添加为市场。

连接到 Aptoide 时，请确保已启用自动通知。这使 Aptoide 能够自动检测新构建版本，并及时发布您应用的最新版本。

👍

我们强烈建议启用通知，以确保更快的发布和更顺畅的更新。

有关详细说明，请参阅我们的专属文档页面。

证明您应用的所有权

验证应用所有权是确保您有权在 Aptoide Connect 上提交和分发您的应用程序的必要步骤。

有关详细说明，请参阅我们的专属文档页面。

实现我们的计费解决方案

Aptoide iOS Billing SDK 提供了一种简单可靠的方式，将 Aptoide Connect 计费集成到您的 iOS 应用程序中。

该 SDK 包含一个计费客户端，使您能够从 Aptoide Connect 检索应用内产品并安全地处理购买交易。

概要

您的应用程序中使用 SDK 的计费流程如下：

1. 与 Aptoide iOS Billing SDK 建立连接；
2. 从 Aptoide iOS Billing SDK 查询应用内产品；
3. 最终用户想要在您的应用中购买产品；
4. 应用程序通过 Aptoide iOS Billing SDK 启动支付；
5. Aptoide iOS Billing SDK 处理支付，并在完成时回调您的应用程序；
6. 应用程序通过服务器端购买验证来验证交易的合法性；
7. 应用程序将产品提供给最终用户；
8. 应用程序通过服务器端通知该产品已被消耗。

有关实现细节、配置指南和最佳实践，请参阅我们的专属文档页面。

最佳实践

确保应用内商店价格一致性

确保您的游戏内商店中显示的价格和货币与用户在 Aptoide Wallet 结账时所看到的一致。

为实现这一点，请使用我们的 Billing SDK 查询应用内产品并显示相同的价格信息。有关如何正确获取应用内产品的详细信息，请参阅我们的文档。

填写应用提交表单

将应用添加到您的 Aptoide Connect 账户后，您将被重定向到**应用提交表单**，您可以在此提供发布应用所需的信息。

应用信息与素材

您需要提供以下必填信息：

• 应用信息与通用素材
  类别、年龄分级和隐私政策等一般信息。
• 本地化素材
  特定语言的元数据，包括描述、截图和发行说明。

提交您的首个版本

应用连接到 Aptoide 后，您可以提交首个版本进行审核和发布。

自动提交（推荐）

如果您在 App Store Connect 中连接到 Aptoide 时启用了市场通知**（强烈推荐）**，则激活后发布的所有新版本将：

• 自动发送至 Aptoide；
• 处理更快，无需任何手动操作。

这是保持应用最新状态的最简单、最高效的方式。

手动提交（如果未启用通知）

如果您需要提交在启用通知之前发布的版本，可以手动提交：

1. 前往 Aptoide Connect；
2. 导航至 Apps > 您的应用程序 > Submit New Version；
3. 输入 Alternative Distribution Package ID。

此 ID 告知 Aptoide 应从 App Store Connect 检索哪个版本。

如何查找 Alternative Distribution Package ID

要找到正确的 Alternative Distribution Package ID：

1. 前往 App Store Connect；
2. 前往 Apps > 您的应用 > Distribution > History；
3. 在列表中找到相关版本；
4. 复制为该版本显示的 Alternative Distribution Package ID。

有关详细说明，请参阅我们的专属文档页面。

由我们审核您的构建版本

在此阶段，运营团队将审核您应用的技术实现和内容，并测试所有关键流程，包括应用内购买。

如果在审核过程中发现任何问题，团队将及时通知您，以便我们能够尽快进行排查和解决。

作为最佳实践，我们建议在计划发布日期至少一周前提交您的应用进行审核，以预留充足的时间进行验证和潜在的修复。

应用上线

应用成功通过所有 QA 检查后，运营团队将批准其发布。

常见问题

哪些用户有资格访问 iOS 上的替代分发？

欧盟、日本或巴西的用户如果满足以下条件即符合资格：

• 其 Apple 账户的国家或地区设置为欧盟成员国、日本或巴西，且本人实际位于该地区。
• 当用户前往其所在地区（欧盟、日本或巴西）以外时，仍保留以下能力：
  • 打开并使用之前通过替代分发安装的应用
  • 离开后最长 90 天内从替代分发更新应用
  • 管理之前通过替代分发安装的应用
• 当用户前往其所在地区（欧盟、日本或巴西）以外时，将失去以下能力：
  • 安装新的替代应用市场或通过替代分发安装新应用

替代分发为用户提供哪些能力？

• 在欧盟：

  • 在 iPhone 和 iPad 上安装替代应用市场
  • 从替代应用市场安装 iOS 和 iPadOS 应用
  • 直接从开发者网站安装 iOS 和 iPadOS 应用

• 在日本和巴西：

  • 在 iPhone 上安装替代应用市场
  • 从替代应用市场安装 iOS 应用

欧盟、日本和巴西的替代分发要求是否相同？

不相同。虽然欧盟、日本和巴西有相似的基础要求，但在区域法规和法律协议方面存在重要差异，开发者必须分别加以应对。日本和巴西遵循相同的规则，与欧盟不同。

我必须签署哪些协议才能启用替代分发？

在欧盟：签署适用于欧盟应用的 Alternative Terms Addendum（https://developer.apple.com/contact/request/alternative-eu-terms-addendum/）。

在日本和巴西：接受最新版本的 Apple Developer Program License Agreement（所有 Apple 开发者必须签署的默认强制协议），其中包含适用于日本和巴西 iOS 应用的附加条款。

欧盟替代分发的商业条款是什么？

当您采用欧盟 Alternative Terms Addendum 时：

• Apple App Store 内购买的新 Apple 佣金：
  • 降低的 App Store 佣金：数字商品和服务为 10% 或 17%
    • 17% 为标准佣金率
    • 10% 适用于 Small Business Program 参与者以及首年之后的订阅续订
  • 可选的支付处理费：仅在 App Store 上使用 Apple 的支付处理时加收 +3%
• Core Technology Fee (CTF)：对于每年安装量超过 100 万的应用，每次 First Annual Install 收取 €0.50（无变现的应用可获豁免）

如果您保留原始的 App Store 条款：

• 您将维持 Apple 的标准 30%/15% 佣金结构
• 您无法访问替代应用市场或替代支付选项

❗️

Apple 此前宣布计划在 2026 年 1 月 1 日之前从 Core Technology Fee (CTF) 过渡到 Core Technology Commission (CTC) 模式。此次过渡仍在待定中，CTF 仍继续适用于欧盟替代分发。

日本和巴西分发的商业条款是什么？

Apple 已为日本和巴西 App Store 的所有开发者推出强制性的新佣金结构，并提供可选的替代分发渠道：

日本和巴西 App Store：

开发者必须从以下支付选项中选择一种，每种选项都有其各自的佣金结构：

• Apple 的 In-App Purchase：总计 26%（21% 佣金 + 5% 支付处理）
  • 对于 Small Business Program 参与者、Video/Mini Apps Partner Program 参与者以及首年之后的订阅续订，降至总计 15%
• 替代支付处理：21% 佣金（对于符合条件的交易降至 10%）
• Out-of-App Offers：对外部链接后 7 天内完成的销售收取 15% 佣金（对于符合条件的交易降至 10%）

替代分发：

开发者可以通过日本和巴西的替代应用市场分发应用：

• Core Technology Commission：对通过替代市场分发的应用中所有数字商品和服务销售收取 5%，包括从这些应用中的链接在 7 天内发起的网站销售

在日本和巴西，谁负责支付 Apple 的 5% CTC 佣金？

Apple 目前对通过日本和巴西替代市场进行的数字销售收取的 5% CTC 佣金由开发者支付。虽然此费用仍受到持续的监管讨论，未来有可能降低，但根据目前的规则，今天仍然适用。

通过替代市场分发的应用的审核流程是怎样的？

仅通过替代应用市场分发（不在 App Store 上）的应用将接受 Notarization 而非完整的 App Review。Notarization 是一个简化的安全流程，用于验证应用不含已知的恶意软件、病毒和安全威胁，确保它们按承诺运行，并保护用户免受恶劣的欺诈。与完整的 App Store 审核流程相比，此流程的限制更少。

我的应用程序会通过 Notarization 吗？

只要您的应用不对用户构成安全威胁，它很可能会获得批准。

Aptoide 上 iOS 应用程序的典型审核时间是多久？

大多数应用程序在两个工作日内完成审核和批准。

我应该为 Aptoide 和 App Store 维护单独的构建版本吗？

不应该。我们强烈建议为两个分发渠道使用单一统一的构建版本。

统一构建版本的优势：

• 内置分发检测： AppCoinsSDK 提供了一个 .isAvailable 方法，对替代分发返回 true，对 App Store 分发返回 false，使您能够以编程方式区分渠道
• 降低维护开销： 无需管理单独的分支、构建版本或部署管道
• 降低错误率： 维护多个构建版本会增加代码不一致、同步问题和平台特定错误的风险

我如何测试我的应用内购买？

您可以使用 Aptoide Connect 中提供的沙盒环境测试应用内购买。

要执行 IAP 测试：

1. 使用 AppCoins SDK 记录并检索您的测试 Wallet 地址。
2. 在开发者控制台的 Sandbox 部分添加您的测试 Wallet 地址。
3. 使用此 Wallet 地址在您的应用内执行测试购买。

有关详细的设置说明和测试指南，请参阅我们的文档。

Aptoide Connect 计费目前支持哪些货币用于应用内购买？

应用内购买目前支持以下货币：

货币代码	货币名称
USD	美元
AUD	澳大利亚元
BRL	巴西雷亚尔
CAD	加拿大元
CHF	瑞士法郎
CLP	智利比索
CNY	人民币
CZK	捷克克朗
DKK	丹麦克朗
EUR	欧元
GBP	英镑
HKD	港元
HUF	匈牙利福林
IDR	印度尼西亚卢比
ILS	以色列谢克尔
INR	印度卢比
JPY	日元
KRW	韩元
MXN	墨西哥比索
MYR	马来西亚林吉特
NOK	挪威克朗
NZD	新西兰元
PHP	菲律宾比索
PKR	巴基斯坦卢比
PLN	波兰兹罗提
RUB	俄罗斯卢布
SEK	瑞典克朗
SGD	新加坡元
THB	泰铢
TRY	土耳其里拉
TWD	新台币
ZAR	南非兰特
BGN	保加利亚列弗
COP	哥伦比亚比索
EGP	埃及镑
KZT	哈萨克斯坦坚戈
NGN	尼日利亚奈拉
PEN	秘鲁索尔
QAR	卡塔尔里亚尔
RON	罗马尼亚列伊
SAR	沙特里亚尔
TZS	坦桑尼亚先令
AED	阿联酋迪拉姆
VND	越南盾
UAH	乌克兰格里夫纳

我多久能收到一次应用内购买分成？

每当您从 Aptoide Connect 账户申请提现时，您都会收到您的应用内购买收益。

提现可直接从开发者控制台发起。一经申请，付款将根据所配置的支付方式和适用的处理时限进行处理。

有关详细说明，请参阅我们的文档。