iOS 通用链接 Universal Links

在 iOS9 之前,要在浏览器中唤醒 APP,我们通常使用 scheme。这种方式需要提前判断系统中是否安装了能够响应此 scheme 的 app,并且这种方式在微信被禁用。

  • Universal Links 可以链接到您应用中的内容并安全地共享数据. 当用户点击 Universal Links 时,iOS 会将链接直接重定向到您的应用程序,而无需通过 Safari 或您的网站进行路由。此外,由于 Universal Links 是标准 HTTP 或 HTTPS 链接,因此一个 URL 既适用于您的网站,也适用于您的应用程序。如果未安装您的应用程序,则系统会在 Safari 中打开 URL,以使您的网站能够处理它。当用户安装您的应用程序时,iOS 会检查存储在 Web 服务器上的文件,以验证您的网站是否允许您的应用程序代表其打开 URL。只有您才能将此文件存储在服务器上,以确保网站和应用程序之间的关联。
  • UIKit 应用程序可以通过通用链接进行通信。支持通用链接的功能允许其他应用直接将少量数据发送到您的应用,而无需使用第三方服务器。

    设置支持 Universal Links 你必须有一个支持 https 的域名

官方解释

请按照以下步骤将您的应用和网站相关联以获取 Universal Links:

以上是从苹果文档翻译而来。

具体操作

启用 Associated Domains

登录苹果开发者后台,在设置证书的页面找到 Identifiers -> App ID(设置包名)里,在对应的 BundleId 下勾选 Associated Domains 如下图

在 Xcode(11)里面添加 Associated Domains

按照图中的步骤添加好 Universal Links

注意点:在 Associated Domains 里面配置的 Universal Links 必须要以 applinks:开头,后面写上域名,例如

1
applinks:www.apple.com

配置 apple-app-site-association

自己创建一个名叫 apple-app-site-association 的 json 格式文件,注意文件命不需要添加的后缀。

1
2
3
4
5
6
7
8
9
10
11
{
"applinks": {
"apps": [],
"details": [
{
"appID": "ZJ9LQ7SV4M.net.mixinkeji.mixin",
"paths": ["*"]
}
]
}
}
  • details– 键的值添加为字典数组的 JSON 表示,每个应用程序一个字典。对于每个特定于应用程序的词典(上面就表示了同一个 teamid 下的 4 个不同的应用),包括和 键:appID paths
  • appID– 将处理格式为的链接的应用程序的标识 TeamIdentifier.bundleidentifier(开发者账号 teamID.app 的 bundle identifier)。
  • paths– 应用程序支持的网站各个部分,以路径字符串数组形式指定。只有这些指定的路径的链接,才能被 app 所处理,*符号写法代表了可识别域名下所有链接。

上传到服务器

上传 apple-app-site-association 到服务器(服务器需要支持 https)上传 apple-app-site-association 文件到域名的根目录或者.well-known 子目录下能打开 https:///apple-app-site-association 或 https:///.well-known/apple-app-site-association 当我们的 App 在设备上第一次运行时,如果支持 Associated Domains 功能,那么 iOS 会自动去获取域名下的 apple-app-site-association 文件
上传成功后,我们可以用苹果提供的验证网址来直接验证 apple-app-site-association 设置是否生效。
注意事项 :

  • iOS 9.2 之前,不用跨域都可以跳转, iOS 9.2 之后,必须跨域才能进行跳转到原生 app 上。
  • iOS 只会在 App 第一次启动时请求一次 apple-app-site-association 文件,服务器上该文件的更新不会让 iOS 本地的文件同步更新。

工程中添加处理方法

现在用户点击我们配置的域名下的匹配的链接,直接可以进我们的 app 了。但是,如果想要能够获取到用户进来的链接,根据链接来处理,需要展示给用户的信息,那么需要在工程里的 AppDelegate 里实现方法。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray *))restorationHandler
{
if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
NSURL *webpageURL = userActivity.webpageURL;
NSString *host = webpageURL.host;
if ([host isEqualToString:@"apple..com"]) {
//进行我们需要的处理
}
else {
[[UIApplication sharedApplication]openURL:webpageURL];
}
}
return YES;
}

当 userActivity 是 NSUserActivityTypeBrowsingWeb 类型, 则意味着它是由 Universal Links 进来,也就是处理逻辑的时候。

微信支付配置

  1. 具体的支付流程这里不做介绍。具体配置请查看微信文档地址

在 xcode 的 info.plist 里面配置一下,配置如下图

2.向微信注册你的应用程序 id 和 Universal Links
在开发者应用登记页面 进行登记,登记并选择移动应用进行设置后,将获得 AppID,可立即用于开发。但应用登记完成后还需要提交审核,只有审核通过的应用才能正式发布使用。
配置的地方如下图所示

微信中提供的 UniversalLink 就是放在服务器上文件的地址


语雀镜像 : iOS 通用链接 Universal Links ,点此 提问

作者

Duoli

发布于

2022-04-20

更新于

2023-01-11

许可协议

评论