Universal Links 的作用
当应用支持 Universal Links 后,如果用户已经安装了你的 app,当点击开发者配置的网站链接后,iOS 用户可以无缝跳转至该应用 ,而无需经由 Safari 中转;如果没有安装,则会通过 Safari 打开链接对应的网站。
注:当用户在 WKWebView 或 UIWebView 页面或 Safari 网页中点击指向网站的链接时,Universal Links 才允许用户打开开发者的应用
Universal Links 配置方法
-
在开发者中心进行配置:找到对应的App ID,在 Application Services 列表里将 Associated Domains 更改为 Enabled。
-
打开工程配置 Capabilities 选项卡中的 Associated Domains 开关,在其中的 Domains 中填入域名,必须以“applinks:”为前缀,如“
applinks:test.universallinks.com
”。
- 创建 JSON 数据格式的名为 apple-app-site-association 的文件,内容为你的应用需关联的所有 URL,形式如下:
{
"applinks": {
"apps": [],
"details": [
{
"appID": "9JA89QQLNQ.com.apple.wwdc",
"paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
},
{
"appID": "ABCD1234.com.apple.wwdc",
"paths": [ "*" ]
}
]
}
}
注:对于在 iOS 9.3.1 更高版本中运行的应用程序,apple-app-site-association 的文件大小必须 ≤ 128 KB。
- 上次 apple-app-site-association 文件至你的网站服务器(需支持 HTTPS 协议),并将其放置网站根目录或 .well-known 文件夹下。
- 在 AppDelegate 的
- (BOOL)application: continueUserActivity: restorationHandler:
方法中处理通用链接。
- (BOOL)application:(nonnull UIApplication *)application
continueUserActivity:(nonnull NSUserActivity *)userActivity
restorationHandler:(nonnull void (^)(NSArray * __nullable))restorationHandler {
if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
NSURL *webpageURL = userActivity.webpageURL;
NSString *host = webpageURL.host;
if ([host isEqualToString:@"test.universallinks.com"]) {
// TODO:处理应用内跳转逻辑
}
else {
[[UIApplication sharedApplication]openURL:webpageURL];
}
return YES;
}
return NO;
}
Universal Links 原理
app 第一次启动 或 app 更新版本后第一次启动时,会向工程里配置的域名发起获取 apple-app-site-association 文件的 get 请求,并将其注册给系统。
当用户在 WKWebView 或 UIWebView 页面或 Safari 网页中点击指向开发者网站的链接时,如果系统中安装了开发者的 app,Universal Links 会直接调起,否则会通过 Safari 打开链接对应的网站。
其它问题
点击 url 页面中的通用链接后,没有打开应用。
原因:当用户点击通用链接时,iOS 系统会检查用户最近的选择,以确定是打开应用还是网站。 例如,用户在 Safari 中点击通用链接打开应用后,可以通过点击状态栏中返回按钮来在 Safari 中继续浏览网站,直到用户在网页顶部的条幅中点击“打开”按钮。
解决方法:在网页顶部的条幅中点击“打开”按钮。服务器配置了 apple-app-site-association 文件,点击 url 链接却没有调起客户端。
原因:服务器根目录及 .well-known 文件夹下均存在 apple-app-site-association 文件,客户端在请求该文件时,会以 .well-known 文件夹下的配置文件内容为准,而在更改配置时没有同时对这两个目录中的文件进行更新,故导致上述问题。
解决方法:同时更新根目录及 .well-known 文件夹下的 apple-app-site-association 文件,或只保留其中某个文件并使内容保持最新。