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,可以直接跳转到对应的网页。
配置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 |
SQL |
获取参数的函数为- (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 |
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 |
设置Associated Domains
XML |
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 |
更多推荐
所有评论(0)