警告
- 请确保这些内容你都配置完成,缺某一项都会无法跑通分享功能的完整链路
- 全部配置完成后,微信可能有缓存或尚未起效,可尝试 等待一段时间/清理微信缓存/退出登录的微信账号 等
前提概念
- BundleID(包名),涉及的地方都保持一致,例:
com.baiduapp
- 假设你的 universal link 访问地址为
https://www.baidu.com
微信开放平台
创建移动应用
登录 微信开放平台,创建移动应用,并通过微信审核(需要使用客户提供的账号)
填写应用资料
- 记住这里的
APPID
,将用于代码中react-native-wechat-lib
的registerApp
- 务必填写可访问的官网,否则审核不通过
基础配置
基本信息 | 上架信息 |
---|---|
![]() | ![]() |
开发配置
安卓 | iOS |
---|---|
![]() | ![]() |
iOS
登录 appstoreconnect,创建应用(步骤略)
- 这里的 套装ID 必须与
BundleID
保持一致
登录 developer.apple
- 点击 Identifiers 旁边的加号(若已建有 App IDs,则只需操作第5步)
- 新增一项【App IDs】
- Select a type,选【App】,右上角点【Continue】
- Bundle ID 选择【Explicit】,并填入统一的
BundleID
- 勾上 Associated Domains,并点击右上角【Save】
配置Xcode
- 在 xcode 中如图所示添加 Associated Domains,注意填入的规则是以
applinks:
开头
- 加好之后你的代码里会多出一个文件
ios/taroDemo/taroDemo.entitlements
配置UniversalLinks
用编辑器创建一个文件名为 apple-app-site-association
的无后缀文件
警告
注意 apple-app-site-association
必须没有文件后缀!!!!!
在该文件内粘贴如下代码
{
"applinks": {
"apps": [],
"details": [{
"appID": "TeamID.BundleID",
"paths": ["*"]
}]
}
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
apple-app-site-association 文件字段说明
- appID: 按照本文档【前提概念】中的
BundleID
举例,appID 字段最终值示例:8888888.com.baiduapp
- paths: 访问该 universal link 的 url 时,url 中哪些规则匹配时才会唤起 universal link 机制
- TeamID: 在 https://developer.apple.com/account 页面下方如下位置查看
将 apple-app-site-association 文件放到【前提概念】中域名的根目录下
- 若访问
https://www.baidu.com/apple-app-site-association
能将文件下载下来,则表示放置成功
如何验证 universal link 是否起效
- 拿出苹果手机
- 打开备忘录,粘贴你的 universal link,如 https://www.baidu.com
- 点击该链接,若能唤起 app,则为成功
- 由于有可能有延迟,并不是配完就能立即成功,可等待一天