如何支持iOS App和设置服务器中的Universal Links？

Question

我如何在我的应用程序中支持Universal LinksiOS并设置我的服务器以支持Universal Links？

Answer 1

支持通用链接

当您支持通用链接时,iOS 9用户可以点击指向您网站的链接,无需通过Safari即可无缝地重定向到已安装的应用程序.如果您的应用未安装,点击指向您网站的链接即可在Safari中打开您的网站.

在这里,如何设置自己的服务器,并处理您的应用程序中的相应链接.

设置服务器

您需要让服务器在线运行.为了安全地将您的iOS应用与服务器关联,Apple要求您提供一个名为的配置文件apple-app-site-association.这是一个JSON描述域和支持的路由的文件.

该apple-app-site-association文件需要通过https:// {domain}/apple-app-site-associationHTTPS在没有任何重定向的情况下访问.

该文件如下所示:

{
"applinks": {
    "apps": [ ],
    "details": [
        {
            "appID": "{app_prefix}.{app_identifier}",
            "paths": [ "/path/to/content", "/path/to/other/*", "NOT /path/to/exclude" ]
        },
        {
            "appID": "TeamID.BundleID2",
            "paths": [ "*" ]
        }
    ]
}
}

注意 - 不要附加.json到apple-app-site-association文件名.

键如下::
apps应该有一个空数组作为其值,并且它必须存在.这就是Apple想要它的方式.
details:是一个字典数组,一个用于网站支持的每个iOS应用程序.每个字典都包含有关应用程序,团队和软件包ID的信息.

有三种方法可以定义路径::
Static整个支持的路径都是硬编码的,用于标识特定链接,例如/ static/terms
Wildcards:A*可用于匹配动态路径,例如/ books/*可以匹配任何作者页面的路径.？在特定的路径组件内部,例如books/1？可用于匹配ID以1开头的任何书籍.
Exclusions:在NOT前面添加路径,不包括该路径的匹配.

数组中提到路径的顺序很重要.早期指数具有更高的优先级.路径匹配后,评估将停止,其他路径将被忽略.每条路径都区分大小写.

支持多个域

应用程序支持的每个域都需要提供自己的apple-app-site-association文件.如果每个域提供的内容不同,则文件的内容也将更改以支持相应的路径.否则,可以使用相同的文件,但需要在每个支持的域中访问它.

签署App-Site-Association文件

注意:如果服务器用于HTTPS提供内容并跳转到"应用程序设置"指南,则可以跳过此部分.

如果您的应用面向iOS 9并且您的服务器用于HTTPS提供内容,则无需对该文件进行签名.如果不是(例如,在iOS 8上支持Handoff时),则必须使用SSL来自认可的证书颁发机构的证书进行签名.

注意:这不是Apple提供的将应用程序提交到App Store的证书.它应该由第三方提供,并且建议使用您用于HTTPS服务器的相同证书(尽管不是必需的).

要对文件进行签名,请首先创建并保存它的简单.txt版本.接下来,在终端中,运行以下命令:

cat <unsigned_file>.txt | openssl smime -sign -inkey example.com.key -signer example.com.pem -certfile intermediate.pem -noattr -nodetach -outform DER > apple-app-site-association

这将在当前目录中输出签名文件.的example.com.key,example.com.pem以及intermediate.pem是将提供给您的发证机构的文件.

注意:如果文件是无符号的,它应该有一个Content-Type的application/json.否则,它应该是application/pkcs7-mime.

使用Apple App搜索验证工具验证您的服务器
测试iOS 9搜索API的网页.输入网址,Applebot会抓取您的网页,并展示如何优化以获得最佳效果 https://search.developer.apple.com/appsearch-validation-tool/

网站代码

网站代码可以在https://github.com/vineetchoudhary/iOS-Universal-Links/tree/gh-pages找到gh-pages分支

设置iOS应用程序

应用程序将针对iOS 9,并将使用Xcode 7.2 Objective-C.

启用通用链接

应用程序端的设置需要两件事:
1.配置应用程序的权利,并启用通用链接.
2.处理你的传入链接AppDelegate.

1.配置应用程序的权利,并启用通用链接.
配置应用程序权利的第一步是为您的应用程序ID启用它.在Apple Developer Member Center中执行此操作.单击"证书","标识符和配置文件",然后单击"标识符".选择您的应用程序ID(如果需要,首先创建它),单击"编辑"并启用"关联域"权限.

接下来,通过单击相应的App ID获取App ID前缀和后缀.

App ID前缀和后缀应与apple-app-site-association文件中的前缀匹配.

接下来Xcode,选择应用程序的目标,单击"功能"并将"关联域"切换为"打开".为您的应用支持的每个域添加一个条目,前缀为applinks:.

例如:applinks:vineetchoudhary.github.io

对于示例应用程序,这看起来像这样:

注意:确保您已选择相同的团队并在成员中心输入与注册的App ID相同的Bundle ID.还要确保Xcode通过选择文件包含权利文件,并在文件检查器中确保选中目标.

处理AppDelegate中的传入链接

[UIApplicationDelegate application: continueUserActivity: restorationHandler:]AppDelegate.m处理传入链接的方法.您解析此URL以确定应用程序中的正确操作.

例如,在示例应用中:

Objective-C的

-(BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler{
    if ([userActivity.activityType isEqualToString: NSUserActivityTypeBrowsingWeb]) {
        NSURL *url = userActivity.webpageURL;
        UIStoryboard *storyBoard = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
        UINavigationController *navigationController = (UINavigationController *)_window.rootViewController;
        if ([url.pathComponents containsObject:@"home"]) {
            [navigationController pushViewController:[storyBoard instantiateViewControllerWithIdentifier:@"HomeScreenId"] animated:YES];
        }else if ([url.pathComponents containsObject:@"about"]){
            [navigationController pushViewController:[storyBoard instantiateViewControllerWithIdentifier:@"AboutScreenId"] animated:YES];
        }
    }
    return YES;
}  

斯威夫特:

func application(application: UIApplication, continueUserActivity userActivity: NSUserActivity, restorationHandler: ([AnyObject]?) -> Void) -> Bool {
      if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
          let url = userActivity.webpageURL!
          //handle url
      }
      return true
  }

iOS应用程序代码

应用程序代码可以在https://github.com/vineetchoudhary/iOS-Universal-Links/找到主分支

注意:

1. 通常,在Safari中单击任何支持的链接,或者在UIWebView/WKWebView的实例中应该打开应用程序.
2. 对于iOS 9.2及更低版本,这仅适用于设备.iOS 9.3(在撰写本文时仍处于测试阶段)也支持模拟器.
3. iOS会在打开Universal Links时记住用户的选择.如果他们点击右上角的痕迹以打开Safari中的链接,则所有进一步的点击都会将他们带到Safari,而不是应用.默认情况下,他们可以通过在网站上的应用横幅中选择"打开"来切换回打开应用.

完成.这都是关于Universal Links的.

参考

1. 支持iOS应用中的通用链接