Universal Links最新使用教程及体会

我一个小菜鸟又开始分享最近做的东西啦,不足之处请大家多多指教.

最近公司要求做一个功能,将 app 中分享出去的文章,在微信打开相应app的 h5链接后,点击页面顶部一按钮可跳转到自己的 app 应用.如下图所示:

点击打开按钮之后将跳转自己的 app.

经过多方的查找资料,最终确定了使用 ios9出的Universal Links,下面我为大家讲解一下使用的方法.

1.服务器需要做的处理:

第一,网站必须要有SSL证书(也就是支持https).(大家注意一下, SSL 证书必须要是机构认证的证书,比如腾讯云,阿里云,我推荐用阿里云免费得证书,我们也是用的这个证书.开始的时候我们用的自己公司个人认证的证书,在 app 启动时不会自动下载在服务器存放的 json 文件,这点大家一定要注意)

第二,在网站根目录下放一个名为“apple-app-site-association”的json文件,去除后缀“.json”,换句话说可以通过https://www.test.com/apple-app-site-association访问到该文件。

"apple-app-site-association"文件内容如下:

{

"applinks":

{

"apps": [],

"details": [

{"appID":"teamID.bundleId”,

"paths": ["/deaplink","/wwdc/news/","*"]

},

{"appID":"ABCD1234.com.apple.wwdc","paths": ["*"]

}

]

}

}

appID 的 格式为teamID.bundleId形式。

如何获取teamID呢?

登录开发者网站,找到Membership选项卡。

teamId.png

appID具体显示就是:xxxxxxxxxxx.com.mytest.app这种

paths

paths配置,实际上就是限制哪些路径可以唤醒app,哪些路径不能唤醒app。格式如下:

"paths": ["/wwdc/news/","NOT /videos/wwdc/2010/*","/videos/wwdc/201?/*"]

使用*配置,则整个网站都可以使用

使用特定的URL,例如/wwdc/news/来指定某一个特殊的链接

在特定URL后面添加*,例如/videos/wwdc/2015/*, 来指定网站的某一部分

除了使用*来匹配任意字符,你也可以使用?来匹配单个字符,你可以在路径当中结合这两个字符使用,例如/foo/*/bar/201?/mypage

需要注意的是:

配置的paths路径,是区分大小写的

验证apple-app-site-association文件

文件配置完成之后,将其上传到你的服务器根目录或者.well-known这个子目录下。

确保使用https://yourdomain.com/apple-app-site-association这个链接可以访问到,yourdomain.com为你的服务器域名。

也可以使用苹果的验证网站,验证文件是否能被苹果请求到。如果是未上线的应用,使用验证网站时可能出现如下提示:

Validation Tool.png

-出现该提示为apple-app-site-association文件配置正确。

-出现404错误码提示,则为apple-app-site-association文件未上传成功,或者使用https://yourdomain.com/apple-app-site-association路径无法访问。

2.建立web网页和app应用之间的关联 ->app IDs配置 和 项目配置

app IDs 配置

进入开发者网站,找到你自己的bundleId,可以点击edit按钮,开启associate domains,如下图:

associated domains.png

项目配置

在项目的Capablities中开启Associated domains,如下图:

appLinks.png

注意domains可以添加多个,前缀必须为applinks:,applinks:后为你的服务器的域名。

代码接收Universal Links唤醒

-(BOOL)application:(UIApplication*)application continueUserActivity:(NSUserActivity*)userActivity restorationHandler:(void(^)(NSArray* _Nullable))restorationHandler{

NSLog(@"userActivity : %@",userActivity.webpageURL.description);

returnYES;

}

在appdelegate中实现上面这个方法,当使用Universal Links唤醒app时就执行这个方法。

3.验证配置

快捷验证,在备忘录中输入https://yourdomain.com/apple-app-site-association,长按这个链接,出现下图提示则配置成功。

有的需求需要跳转相应的界面可以通过 paths 这个字段设置其是否进行跳转,还可设置不跳转app 的路径前面要加 NOT ,例如"NOT www.test.com/*",星号代表所有,还可以使用?等.

再向大家推荐一个方法测试是否从服务器请求到了 json 文件

使用charles抓包显示,只有初次安装app时才会去请求apple-app-site-association文件,所以测试时有可能因为网络波动导致apple-app-site-association文件获取失败。这种情况,多卸载几次,安装时使用4G。

希望这篇文章对大家有所帮助,有什么不足之处请大家多多指教.有什么问题也可以留言询问我.再向大家推荐一个基于Universal Links的第三方框架,LinkedMe,大家也可以用这个第三方,也比较简单.

最后与大家分享一句话,"不积跬步,无以至千里;不积小流,无以成江海".加油!!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,242评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,769评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,484评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,133评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,007评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,080评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,496评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,190评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,464评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,549评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,330评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,205评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,567评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,889评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,160评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,475评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,650评论 2 335

推荐阅读更多精彩内容