IOS应用跳转URL scheme和Universal Links

简介

IOS常见的跳转方式有URL scheme和Universal Links。这两个均可以实现App之间的跳转，以及通过网页实现跳转到对应的App内。通过本文章可以了解到两者的区别和具体的使用方法，以及参数的传递。应对常见的几种跳转需求。

URL scheme:需要配置URL scheme，可以通过该URL直接启动App。该URL实际上不是真正可以访问的网页域名，因此如果App没有安装，就没有任何反应。并且URL scheme是各自开发者在App内设置的，所以可能出现冲突的情况。

Universal Links:配置实际可以访问的域名，并且根据配置表，可以将路径和对应的App进行关联。如果已经安装了App可以直接跳转到App。如果没有安装App，可以直接跳转到对应的网页。

官方文档：https://developer.apple.com/documentation/xcode/allowing-apps-and-websites-to-link-to-your-content?language=objc

配置Url Scheme

1.配置

打开Xcode工程，在Info.plist的URL Types添加一个新的Url Scheme。需要填入Identifier和URL Schemes

这里分别命名为youridentifier和yourscheme需要注意URL Schemes需要起的复杂一些，避免重名。

Tips：如果出现App A与App B也定义了相同的URL Scheme。那么访问URL Scheme的时候只会访问其中一个应用，另外一个App的URL Scheme就失效了

2.测试链接是否成功

设置完Url Scheme后，在测试设备上安装该应用。之后可以通过safari或者备忘录，直接通过URL Scheme访问。

Url Scheme的形式有点类似于网页。可以直接在Safari输入yourscheme://xxxxx 如果弹出提示框，是否访问该应用说明配置成功 。这里填写的yourscheme就是Info.plist中填写的URL Scheme。"://"之后填写的是自定义的参数。可以通过参数来得知启动的来源。

3.添加启动参数获取代码

Unity获取启动参数，需要通过继承UnityAppController的方式进行。在Assets/Plugins/IOS/目录下添加YourAppController.h和YourAppController.mm

对应代码如下：

SQL #ifndef YourAppController_h #define YourAppController_h #import "UnityAppController.h"   @interface YourAppController : UnityAppController   @end #endif

SQL   #import <Foundation/Foundation.h> #import "YourAppController.h" @implementation YourAppController     - (void)applicationDidBecomeActive:(UIApplication*)application {         [super applicationDidBecomeActive:application];     }     - (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions {     [super application:application didFinishLaunchingWithOptions:launchOptions];     return YES; }       // UIApplicationOpenURLOptionsKey was added only in ios10 sdk, while we still support ios9 sdk - (BOOL)application:(UIApplication*)app openURL:(NSURL*)url options:(NSDictionary<NSString*, id>*)options {     [super application:app openURL:url options:options];     if(url)     {         UnitySendMessage("YourReceiver", "YourMethod", url.absoluteString.UTF8String);     }     return YES; }     //进入 后台 - (void)applicationDidEnterBackground:(UIApplication*)application {     [super applicationDidEnterBackground:application]; }   //进入前台 - (void)applicationWillEnterForeground:(UIApplication*)application {     [super applicationWillEnterForeground:application]; }             @end   //设置当前类为启动类 IMPL_APP_CONTROLLER_SUBCLASS(YourAppController);

获取参数的函数为- (BOOL)application:(UIApplication*)app openURL:(NSURL*)url options:(NSDictionary<NSString*, id>*)options，获取完参数之后可以通过UnitySendMessage的方式，在C#端处理逻辑

配置Universal Links

1.开发者后台配置

在developer.apple.com的后台，点击对应的Identifiers,勾选Associated Domains

2.工程配置

打开Xcode工程，在Signing&Capabilities页签点击+Capability 之后选择Associated Domains

之后添加具体的Associated Domains。比如你的域名为yourdomains.com,填入的具体形式为applinks:yourdomains.com

3.apple-app-site-association配置

然后设置apple-app-site-association。apple-app-site-association的格式如下，details是一个列表。列表内是每个应用对应的配置。appID的格式是，前面为TeamID(可以在developer.apple.com查看)，后面则是应用的bundleid。path为应用对应的路径，"*"为通配符。

下面的例子代表有三个app。打开yourdomains.com/path1/ 路径下的网页，访问app1。yourdomains.com/path2/  代表访问app2。其他yourdomains.com/ 下的网页均访问app3。需要注意的是，配了下一级路径的，比如"paths": ["/path1/*"] 也要在结尾加上*。还有就是如果没有下一级路径比如下面的app3的"paths": ["*"]。建议配置在数组的末端。之前测试时，这个apple-app-site-association是顺序访问的，所以如果配在顶部，会出现所有网页均访问"*"的情况。

XML {         "applinks": {                 "apps": [],                 "details": [{                                 "appID": "TEAMID.BUNDLEID1",                                 "paths": ["/path1/*"]                         }, {                                 "appID": "TEAMID.BUNDLEID2",                                 "paths": ["/path2/*"]                         }, {                                 "appID": "TEAMID.BUNDLEID3",                                 "paths": ["*"]                         }                 ]         } }

4.上传apple-app-site-association到文件服

如果自己未搭建文件服务器可以直接使用阿里云。这里需要注意，必须将apple-app-site-association放置在根目录，或者根目录/.well-known/ 目录下

https://yourdomains.com/apple-app-site-association

https://yourdomains.com/.well-known/apple-app-site-association

5.测试链接是否成功

下面以访问app1为例子进行链接测试。前面的配置都完成之后，用测试设备安装应用，确保网络是正常的。

由于之前配置的Associated Domains为yourdomains.com，app1在apple-app-site-association内配置的路径为["/path1/*"],所以最后需要将域名和path拼在一起：https://yourdomains.com/app1

可以将该网址放在复制到备忘录，然后长按该路径。如果出现如下在"xxx"中打开的提示，说明Universal Links配置正确。并且可以直接点击该链接进入App。

也可以直接在safari浏览器输入上面的网址。网页的顶部会出现在"xxx"App中打开的提示。并且点击右侧的打开按钮，

6.注意事项

• apple-app-site-association不能有后缀名

• apple-app-site-association是在app第一次安装和后续更新的时候获取。如果网络不好，有可能出现没有获取到，导致Universal Link失效的情况

• 如果修改了apple-app-site-association的内容，apple-app-site-association生效需要等待一段时间。同时需要卸载重装后再测试

• 苹果会先访问.well-known/下的apple-app-site-association，如果不存在，再访问根目录下的文件，所以建议将文件存放在.well-known/下，减少访问服务器的次数

• 访问的网址需要配置为https

Unity内配置

上面修改Xcode工程，添加Url Scheme和AssociatedDomains的操作，也可以通过Editor的PostProcessBuild脚本。进行添加。具体代码如下

添加Url Scheme

XML  public static void SetInfoList(string buildPath)     {         string listPath = buildPath + "/Info.plist";         PlistDocument plist = new PlistDocument();         plist.ReadFromString(File.ReadAllText(listPath));         // 在“info”标签栏的“URL type“添加“URL scheme”         PlistElementArray urlArray = plist.root.CreateArray("CFBundleURLTypes");         PlistElementDict dict = urlArray.AddDict();         dict.SetString("CFBundleTypeRole", "Editor");         dict.SetString("CFBundleURLName", "youridentifier");         PlistElementArray urlSchemes = dict.CreateArray("CFBundleURLSchemes");         urlSchemes.AddString("yourscheme");            File.WriteAllText(listPath, plist.WriteToString());     }

 设置Associated Domains

XML  // 设置Associated Domains     public static void SetAssociatedDomains(string pbxProjectPath, string domainUrl)     {         //默认 Target Name, 你自己的可能不一样         string targetName = "Unity-iPhone";         //Set the entitlements file name to what you want but make sure it has this extension         string entitlementsFileName = "my_app.entitlements";         var entitlements = new ProjectCapabilityManager(pbxProjectPath, entitlementsFileName, targetName);         entitlements.AddAssociatedDomains(new string[] { "applinks:" + domainUrl });         entitlements.WriteToFile();     }

IOS跳转的解决方案

跳转流程

下面举一个简单的邀请好友获取奖励的例子。

1.配置一个网页，负责承接跳转的业务和必要的信息展示。应用可以将该网址分享到IM工具，并且根据业务需要添加具体的参数。比如玩家A给玩家B分享了关于app1的邀请链接：

https://yourdomains.com/app1/index.html?type=invite&uid=10000

这里路径为Universal Link的地址。前端将网页部署在app1/index.html的位置。

分享的参数为type=invite&uid=10000 (参数可以自定义)

2.玩家B在IM工具内点开该链接后，如果玩家已经安装了该应用app1，可以直接跳转到应用内，并且将该参数传递给app1。如果未安装该应用，或者不支持直接跳转。可以在该网页内配置下载的按钮，或者其他相关的跳转链接。

3.假如玩家B通过上面的链接正常进入到app1内，可以获取type=invite&uid=10000的参数。玩家B与服务器通信，完成对玩家A的邀请奖励发放，跳转流程到此结束。

部分网页逻辑

有的IM软件（比如Messenger），点开Universal Link并不会直接跳转App。但是可以通过网页调用URL Scheme进行跳转。所以可以添加一下的逻辑，完成跳转操作。

网页启动的时候，先判断是不是IOS设备。如果是，可以直接通过URL Scheme跳转。

XML (function () {   let userAgentInfo = navigator.userAgent;   let Agents = [     "iPhone",     "iPod",     "iPad",   ];   let search = location.search;   for (let i = 0; i < Agents.length; i++) {    //判断是不是IOS设备     if (userAgentInfo.indexOf(Agents[i]) > 0) {       //获取网页中参数       let webParams = location.search;       window.location.href = "yourscheme://"+webParams;       break;     }   } })();