Universal Link使用详情

Universal Link是苹果在iOS 9推出的一种通用链接技术，它允许开发者使用相同的链接来同时支持网站和App。在iOS开发中，为微信配置Universal Link可以实现从微信跳转到自己的App等功能。以下是详细步骤：

一、创建和配置Universal Link相关内容

1. 创建关联文件（apple - app - site - association）

   • 这个文件是一个JSON格式的文件，用于定义你的App和网站之间的关联关系。它应该包含以下基本结构：

   {
       "applinks": {
           "apps": [],
           "details": [
               {
                   "appID": "TEAM_ID.BUNDLE_ID",
                   "paths": ["*"]
               },
                {
                   "appID": "TEAM_ID.BUNDLE_ID2",
                   "paths": ["/app/*"]
               },
           ]
       }
   }
   

   • 其中，TEAM_ID是你的开发者账号团队ID，BUNDLE_ID是你的App的Bundle标识符。paths数组定义了哪些网站路径可以触发打开App。*表示所有路径都可以触发。/app/*表示自己定义的路径。
   • 将这个文件上传到你的网站根目录或者.well - known目录下，并且确保它可以通过https协议访问。例如，如果你的网站域名为example.com，那么这个文件应该可以通过https://example.com/apple - app - site - association或者https://example.com/.well - known/apple - app - site - association访问。
   • 则微信开放平台的Universal Link填写是：paths没有自定义路径，只有一个通配符*：https://example.com/，有自定义路径https://example.com/app/

2. 在Xcode中配置项目

   • 打开你的iOS项目，在Capabilities选项卡中，开启Associated Domains功能。
   • 添加你的关联域名，格式为applinks:your - domain - name。例如，如果你的网站域名为example.com，则添加applinks:example.com。

3. 在AppDelegate中处理Universal Link相关逻辑

   • 当用户通过Universal Link打开App时，application:continueUserActivity:restorationHandler:方法会被调用。你可以在这个方法中处理相关逻辑，例如：

   func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
       if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
           if let url = userActivity.webpageURL {
               // 在这里根据URL进行相应的处理，比如跳转到指定的页面等
               print("打开的Universal Link URL: \(url)")
               return true
           }
       }
       return false
   }
   

   • 在Objective - C中，对应的代码如下：

   - (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
       if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
           NSURL *url = userActivity.webpageURL;
           if (url) {
               // 在这里根据URL进行相应的处理，比如跳转到指定的页面等
               NSLog(@"打开的Universal Link URL: %@", url);
               return YES;
           }
       }
       return NO;
   }
   

• 在APP内进行登录or分享时，如下：

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
    BOOL isSuc = [WXApi handleOpenUniversalLink:userActivity delegate:[WXApiManager sharedManager]];
    return isSuc;
}

二、微信中配置和使用Universal Link与App交互

1. 在微信开放平台配置Universal Link
   • 登录微信开放平台，在你的App对应的设置中，找到“Universal Link”选项，将你配置好的Universal Link填写进去。
2. 从微信中触发打开App
   • 当你的App配置好Universal Link并且在微信开放平台也正确配置后，你可以通过在微信中分享包含Universal Link的内容（如公众号文章中的链接、客服消息中的链接等）。当用户点击这些链接时，如果用户安装了你的App，就有可能会直接打开App，而不是在微信内置浏览器中打开链接。

需要注意的是，Universal Link的配置和使用涉及到网站服务器配置、App开发和第三方平台（如微信）的配置等多个环节，任何一个环节出现问题都可能导致无法正常使用。同时，苹果对Universal Link的验证比较严格，例如文件格式、访问权限等都需要严格遵守相关规定。

可参考：https://www.jianshu.com/p/f1c97d0d0d22