Skip to content

Commit f003212

Browse files
committed
doc(iOS): Update setting Universal Link document.
1 parent 8d8b575 commit f003212

File tree

3 files changed

+26
-9
lines changed

3 files changed

+26
-9
lines changed

README.md

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -17,41 +17,50 @@ React Native 包使用微信分享、登录、收藏、支付等功能,支持A
1717
<details>
1818
<summary>iOS: 微信授权登录 Universal Link(通用链接)</summary>
1919

20-
> Universal Link(通用链接)是苹果在 iOS9 推出的,一种能够方便的通过传统 HTTPS 链接来启动 APP 的功能,可以使用相同的网址打开网址和 APP。
20+
> [Universal Link(通用链接)](https://developer.apple.com/documentation/safariservices/supporting_associated_domains)是苹果在 iOS9 推出的,一种能够方便的通过传统 HTTPS 链接来启动 APP 的功能,可以使用相同的网址打开网址和 APP。
2121
> 看起来就是一条普通的 https 链接,当然是我们在该链接域名根目录配置过的一个链接,也可以在该链接中放置对应的H5页面。当用户的点击该链接,只要手机中安装了支持该链接的 APP 就会直接进入到 APP 中。如果没有安装APP则会跳转到 Safari 浏览器中,展示 H5 页面。对用户来说则是一个无缝跳转的过程。
2222
2323
创建一个名为 `apple-app-site-association` 的文件,如下:
2424

2525
```json
2626
{
2727
"applinks": {
28-
"apps": [],
2928
"details": [
3029
{
31-
"appID": "Team ID.com.uiwjs.XXX",
32-
"paths": ["/uiwjs/*"]
33-
},
34-
{
35-
"appID": "Team ID.com.uiwjs.XXX",
36-
"paths": ["/uiwjstest/*"]
30+
"appID": "968DSZ49MT.com.uiwjs.react.example.wechat",
31+
"paths": ["/react-native-wechat/*"]
3732
}
3833
]
3934
}
4035
}
4136
```
4237

38+
**说明:** 字段 appID 中的 `968DSZ49MT` 表示苹果账号的团队 `ID``com.uiwjs.react.example.wechat` 表示项目的 `BundleID`
39+
40+
```
41+
<Application Identifier Prefix>.<Bundle Identifier>
42+
```
43+
4344
上传该文件到你的域名所对应的`根目录``xxx目录`下,`apple-app-site-association` 文件不需要扩展名。
4445

4546
**注意:** 苹果提供了一个[网页来验证](https://search.developer.apple.com/appsearch-validation-tool/)我们编写的这个 [apple-app-site-association](https://search.developer.apple.com/appsearch-validation-tool/) 是否合法有效。
4647

4748
```
49+
https://<fully qualified domain>/.well-known/apple-app-site-association
4850
根目录
4951
https://uiwjs.github.io/apple-app-site-association
5052
5153
xxx目录
5254
https://uiwjs.github.io/react-native-wechat/apple-app-site-association
5355
```
5456

57+
打开 `Associated Domains` 开关,将 [`Universal Links`](https://developer.apple.com/documentation/safariservices/supporting_associated_domains) 域名加到配置上,如果 `URL` 地址是 https://uiwjs.github.io/apple-app-site-association,那么,
58+
`Associated Domains` 中填写 `applinks: uiwjs.github.io`
59+
60+
<img src="https://docs-assets.developer.apple.com/published/fccb1b799a/741497b6-a7af-427b-9e5a-4980336ac70e.png" />
61+
62+
登录苹果开发者后台,在设置证书的页面找到 `Identifiers` 里,在对应的 `BundleId` 下勾选 `Associated Domains`
63+
5564
</details>
5665

5766
<details>

example/apple-app-site-association

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"apps": [],
44
"details": [
55
{
6-
"appID": "Team ID.com.uiwjs.XXX",
6+
"appID": "968DSZ49MT.com.uiwjs.react.example.wechat",
77
"paths": ["/react-native-wechat/*"]
88
}
99
]
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3+
<plist version="1.0">
4+
<dict>
5+
<key>com.apple.developer.associated-domains</key>
6+
<array/>
7+
</dict>
8+
</plist>

0 commit comments

Comments
 (0)