Vibe Coding 应用的通讯录访问

按工具查看指南

什么时候值得读取通讯录

找到已经在用应用的好友

把标准化后的电话号码与后端中的账号进行比对，显示“您有 3 位联系人在这里”，而不是一个空空的好友列表。

一次邀请一个人

用户选择一位联系人，应用准备一条个人邀请并打开分享面板。不群发邀请，也不会让收件人感到意外。

快速添加客户或同事

CRM、预约和团队类应用可以用选中的联系人预填新记录，省去用户重新输入姓名和号码的麻烦。

很多时候您并不需要它

通过原生分享面板（shareapp://）发送普通邀请链接完全不需要权限，也更容易通过审核。只有当匹配或挑选联系人能带来真正的价值时，才请求通讯录权限。

负责任地请求、读取和使用通讯录

代码一小时，隐私文案再多花一点时间。

声明权限
Android：按照 WebViewGold 文档的要求，在 AndroidManifest.xml 中添加 android.permission.READ_CONTACTS。iOS：Info.plist 中的通讯录用途说明必须写明原因，例如“用于显示您的哪些联系人已经在使用本应用”。
先解释，再请求
先显示您自己的说明页面，介绍好处并提供一个“继续”按钮，然后再导航到 requestcontactpermission://。绝不要在首次启动时或用户进入该功能之前请求权限。
读取通讯录
获得权限后，导航到 readcontacts://。WebViewGold 会用一个包含姓名和电话号码数组的对象填充全局变量 contacts；没有权限时它为 null。
让用户自己选择
显示一个可搜索的列表，不预先选中任何人，也不提供“全选”按钮，并在发送任何内容之前展示确切的邀请文字。
只发送功能所需的数据
用于好友匹配时，把号码标准化后发送到后端做一次性比对；不要保留未匹配的号码。用于邀请时，什么都不用发送：直接打开分享面板。

常见问题

readcontacts:// 返回什么？

一个以联系人姓名为键的 JSON 对象，每个键对应一个电话号码数组，存放在全局变量 contacts 中。没有权限时该变量为 null。电子邮件地址、通讯地址和照片不在文档规定的格式之内。

Apple 会拒绝读取通讯录的应用吗？

不会因为读取本身被拒，但常常会因为读取的方式被拒。请在具体情境中、配合清晰的用途说明请求权限，让用户逐个选择联系人，绝不一次邀请所有人；除非功能确实需要且隐私政策中有说明，否则不要把通讯录保存在服务器上。

邀请功能需要通讯录访问权限吗？

通常不需要。带个人邀请链接的分享面板无需任何权限就能触达 WhatsApp、“信息”和电子邮件，在审核中也容易解释得多。只有在匹配好友或从现有联系人创建群组时，才使用通讯录访问。

让您的应用上架商店的三种方式

结果相同，只是您需要投入的工作量不同。三种方式都附带审核通过保证和 7×24 小时人工支持。

自己动手

$109 每个平台，一次性付费

WebViewGold 许可证：一个现成的 Xcode 或 Android Studio 项目。粘贴您的 URL，设置名称和图标，开启所需功能，构建并提交。永久免费更新。

在主页查看方案

Cloud Builder

$349 每个许可证，一次性附加购买

无需 Mac、Xcode 或 Android Studio：在浏览器中完成配置，我们在云端构建两个应用，并将其交付到 App Store Connect 和 Play Console。

Cloud Builder 如何运作试用免费演示

Full Service

$698 每个平台 ~~$798~~

把您的 URL 和图标发给我们。我们的团队在 72 小时内完成配置、构建并交付您的应用，白标，附源码项目。两个平台共 $1,158。

Full Service 详情服务提供方：

冬季特惠价格有效期至 2026年12月31日。