一、说在前面的话
Universal Links 针对的是在 Web 中打开 App,Universal Links 比 Scheme 还要牛掰!
二、MobLink 快速实现
借助 Mob 平台 简单实现,详情请见具体 开发文档。实现还是挺简单的,也可以自己创建一个账号,走一遍流程。
三、简单的 Demo
3.1 简要介绍
已经将我的一个小实验提交到我的 github UniversalLink8HTML,欢迎下载看看。其中有两个项目:
UniversalLinkDev:这就是目标项目。
HTMLDev:模拟的网页端。
我将代码打成 zip 包是因为不想做 .gitignore 文件,因为 UniversalLinkDev的 pod 有点难 install,我就干脆全部上传。我 install 的时候重复了好几次,不知何故。应该不是 RP 的问题。如果要看具体的现实,必须要结合 开发文档 来看。
项目运行
可以先运行 HTMLDev 项目,你能找到这个界面:
底部的条就是我们想要的效果,这个时候点击 “打开”,你没有安装 UniversalLinkDev 的情况下,你会跳转到 UniversalLinkDev的下载网页。但是现在只是一个测试,我写成了一个我的。
关于上面的这个界面是怎么实现的,主要是根据 Moblink 来实现的一个网页,具体看代码。
再运行 UniversalLinkDev 项目之后,直接关掉,代表在你的设备上已经安装了 UniversalLinkDev 项目。
再回到 HTMLDev 项目点击打开,会打开 UniversalLinkDev 项目,进入指定的界面。
3.2 代码分析
在 UniversalLinkDev 项目中,有两个地方值得注意分别如下:
1、AppDelegate 文件中的这个方法:
// Universal Link 激活会执行这个方法
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler {
if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
[ULPlatform continueUserActivity:userActivity];
}
return YES;
}
continueUserActivity:方法可以做类似简单的操作:
+ (void)continueUserActivity:(NSUserActivity *)userActivity {
NSURL* webpageURL = userActivity.webpageURL;
NSURLComponents* components = [NSURLComponents componentsWithURL:webpageURL resolvingAgainstBaseURL:YES];
// path
NSLog(@"path = %@", components.path);
NSLog(@"参数 = %@", components.query);
for (NSURLQueryItem* item in components.queryItems) {
NSLog(@"key = %@\nvalue = %@", item.name, item.value);
// 仅仅用于测试
if ([item.name isEqualToString:@"info"]) {
UINavigationController* navVC = (UINavigationController*)[UIApplication sharedApplication].keyWindow.rootViewController;
UIViewController* vc = [[UIViewController alloc] init];
vc.title = item.value;
vc.view.backgroundColor = [UIColor blueColor];
[navVC pushViewController:vc animated:YES];
}
}
}
2、UIViewController+MLSDKRestore 中的这两个方法
// Universal Link 就是通过这个方法找到对应的路劲
+ (NSString *)MLSDKPath {
return @"/demo/a";
}
// Universal Link 通过这个方法将具体的参数场景传入控制器
- (instancetype)initWithMobLinkScene:(MLSDKScene *)scene {
self = [super init];
self.scene = scene;
self.title = scene.params[@"title"];
return self;
}
以上的这两个地方都是属于通过 Universal Link 进入 APP 的执行方法。这里需要注意的是:application: continueUserActivity: restorationHandler: 只要是通过 Universal Links 进来的都会执行,所以需要对已经做了MLSDKRestore 的做过滤。
四、apple-app-site-association 的配置
这个文件,理应是我们自己生成的一个 JSON 格式的文件,应该放在自己的另外一个(非当前 Web 域名)域名的服务器。但是在我上面的 Demo 中,Mob 平台已经自动在 Mob 平台 生成了一个这样的文件 apple-app-site-association 。
具体内容如下:
{
"applinks": {
"apps": [],
"details": [{
"appID": "D8Y5E9ZUX3.com.CoderHG.UniversalLinkDev",
"paths": ["*"]
}]
}
}
其中 D8Y5E9ZUX3 是我的 itemID, com.CoderHG.UniversalLinkDev 是 Bundle ID。
五、所谓的 Moblink 中的高级应用
其实就是一个 delegate,可以将其分成两类:
这两个方法的执行时机是项目一启动的时候,说明了什么?说明 Moblink 在项目刚启动的时候,就会去找整个项目中已经实现 UIViewController+MLSDKRestore 的控制器,然后保存在内存中。这里就暴露了一个问题,如果很多的话,对内存就会有影响了。
这个是针对某个场景的操作,也很容易理解。
六、主意事项
6.1 一个大坑
到这里,对 Universal Links 与 Moblink 应该有那么一点点的理解了,接下来介绍一下我遇到的一个大坑:如何测试?
刚开始的时候,根本不知道如何做测试,尤其是网页端。最后从各方得到一个结论:必须要将自己的网页提交到网站。厉害了,于是申请空间。最最浪费时间的是 FileZilla, 最后也没有连接成功。
后来想到使用现在的方式,没想到还 成功 了。
当然还有一个主意点:
src 一定要加 https://, 在 Moblink 中是没有给的,后来是我自己加的。
6.2 Moblink 的机密
在调试的过程中,也发现使用 Moblink 的 Universal Links,在 application: continueUserActivity: restorationHandler: 中收到的 webpageURL 中的 params 是加密的。本来不用知道具体是怎么加密的,但是强迫症就想知道。查看 Moblink 文件发现一个 Base64, 还以为是 Base64, 但是不对。后来咨询了一下官方,他的回复是:不用管,具体如何实现的,机密不可外露,不能告诉我。
七、总结
写得简单了,具体的还得看代码UniversalLink8HTML。
参考文章
Universal Links 前端部署采坑记
苹果官网 Support Universal Links