URL Scheme笔记

我们都知道苹果手机中的APP都有一个沙盒,APP就是一个信息孤岛,相互是不可以进行通信的。但是iOS的APP可以注册自己的URL Scheme,URL Scheme是为方便app之间互相调用而设计的。这也是scheme最常用到的地方,但是平时项目中还有另外两个地方一样需要用到:服务器通知客户端如何跳转和H5与Native跳转。所以制定一个统一的scheme协议来完成APP间跳转和App内页面跳转,然后定义一个专门的类来处理相关跳转,可以使代码更加整洁优雅。

scheme三方面的作用:

  • 服务器下发跳转路径,客户端根据服务器下发跳转路径跳转相应的页面;
  • H5页面点击锚点,根据锚点具体跳转路径APP端跳转具体的页面;
  • APP端收到服务器端下发的PUSH通知栏消息,根据消息的点击跳转路径跳转相关页面

URL scheme 概述

客户端应用可以向操作系统注册一个 URL scheme,该 scheme 用于从浏览器或其他应用中启动本应用。通过指定的 URL 字段,可以让应用在被调起后直接打开某些特定页面,比如车辆详情页、订单详情页、消息通知页、促销广告页等等。也可以执行某些指定动作,如订单支付等。也可以在应用内通过 html 页来直接调用显示 app 内的某个页面。

URL scheme 的格式

客户端自定义的 URL 作为从一个应用调用另一个的基础,遵循 RFC 1808 (Relative Uniform Resource Locators) 标准。这跟我们常见的网页内容 URL 格式一样。

一个普通的 URL 分为几个部分,scheme、host、relativePath、query。
我们用到的NSURL

NSURL *url = [NSURL URLWithString:@"http://www.testurl.com:8080/subpath/subsubpath?uid=123&gid=456"];  
[url scheme]为http,  [url host]为www.testurl.com,[url port]为8080,[url path]为/subpath/subsubpath,[url lastPathComponent]为subsubpath,[url query]为uid=123&gid=456 

一个应用中使用的 URL 例子(该 URL 会调起车辆详情页):

zqprojectmobile://project/carDetail?car_id=123456
scheme为zqprojectmobile,host为project,relativePath为/carDetail,query为car_id=123456

项目中定义了专门的类命名为JumpURLHandle,通过类方法parseURL:来处理参数中的url。本文以此为例讲解scheme的定义与解析。

1 首先客户端应用向操作系统注册一个或者多个 URL scheme,例如项目中就定 义了多个分别scheme,分别为:

zqprojectmobile: 对应普通APP间跳转scheme
zqprojectwxpay: 对应微信支付完成之后跳转回来的scheme
zqprojectalipay:对应支付宝支付完成之后跳转回来的scheme

对应的parseURL:方法里解析为:

+ (BOOL)parseURL:(NSURL *)url
{
    // 支付宝客户端支付后的回调
    if ([[url scheme] isEqualToString:@"zqprojectalipay"]
        || ([[[url scheme] lowercaseString] isEqualToString:kUuyongcheAlipayScheme]))
    {
        return 支付宝支付完成后的回调处理方法;
    }
    // 微信客户端支付后的回调
    else if ([url.scheme isEqualToString:@"zqprojectwxpay"] && [url.host isEqualToString:@"pay"])
    {
        return 微信支付完成后的回调处理方法;
    }
    // 本应用 scheme 调用
    else if (([[url scheme] isEqualToString:@"zqprojectmobile"])
             || ([[[url scheme] lowercaseString] isEqualToString:@"zqprojectmobile"]))
    {
        return [[JumpURLHandle getInstance] parseAppUrl:url];
    }
    return NO;
}

2 定义relativePath,并通过relativePath来判断是执行动作还是跳转页面,当执行动作时把relativePath定义为"/action",在解析时如果url的relativePath是"/action"则跳转到执行动作的处理方法里,否则执行跳转页面的逻辑。
例如:

zqprojectmobile://project/action?name=back,
relativePath为/action,执行动作(返回前页)

zqprojectmobile://project/order?order_id=42347645&type=2
relativePath为/order,执行跳转页面的逻辑

代码:

- (BOOL)parseAppUrl:(NSURL *)url
{
    NSString *relativePath = [url relativePath];
    
    // scheme 调起执行动作
    if ([relativePath isEqualToString:@"/action"])
    {
        [self jumpActions:url];
    }
    // scheme 调起跳转页面
    else
    {
        [self jumpNativeViewControllers:url];
    }
    return YES;
}

3 如果是执行动作的逻辑,获取query,字符串处理,获取键值对,获取名称为"name"的key对应的字符串,字符串对比判断执行相应的动作
例如:

zqprojectmobile://project/action?name=back,
relativePath为/action,query为name=back,字符串处理后得到字典@{name:back},

代码:

- (void)jumpActions:(NSURL *)url
{
    //dictionaryFromQueryComponents为字符串处理方法,处理query得到字典
    NSDictionary *dictionaryQuery = [[url query] dictionaryFromQueryComponents];
    NSString *actionName = [dictionaryQuery objectForKey:@"name"];

    // 返回前面的页面
    if ([actionName isEqualToString:@"back"])
    {
        //返回上一个页面的动作
    }

4 如果是执行跳转页面的逻辑,可以直接将要跳转的页面设置为relativePath的值,然后获取relativePath字符串进行对比跳转相应的页面。如果页面跳转需要传值可以放到query里,获取url的query,字符串处理,获取键值对,一一赋值,例如:

zqprojectmobile://project/order?order_id=42347645&type=2
relativePath为/order,跳转到订单详情页面
query为order_id=42347645&type=2,字符串处理获取字典@{order_id:42347645,type:2},订单详情页面的订单id为order_id对应的值42347645,订单类型为2

代码:

- (void)jumpNativeViewControllers:(NSURL *)url
{
    NSString *relativePath = [url relativePath];

    if ([relativePath isEqualToString:@"/order"])
    {
        [self jumpOrder:url];
    }
}

- (void)jumpOrder:(NSURL *)url
{
    //dictionaryFromQueryComponents为字符串处理方法,处理query得到字典
    NSDictionary *dictionaryQuery = [[url query] dictionaryFromQueryComponents];
    NSString *orderId = [dictionaryQuery objectForKey:@"orderId"];
    NSString *type = [dictionaryQuery objectForKey:@"type"];
    // 创建新的订单页面并且传值
}

通过以上几步就可以定义出一个完整的scheme协议并且在JumpURLHandle类里完成解析

需要用到JumpURLHandle解析scheme的地方

1 APP端收到服务器端下发的PUSH通知栏消息和APP相互跳转时需要在AppDelegate里处理

// 废弃
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(nullable NSString *)sourceApplication annotation:(id)annotation
{
    return [JumpURLHandle parseURL:url];
}
或者
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options
{
    return [JumpURLHandle parseURL:url];
}

2 服务器下发跳转路径,客户端根据服务器下发跳转路径跳转相应的页面,在一个网络请求成功的回调方法或者block里拿到url,调用[JumpURLHandle parseURL:url];

3 H5页面点击锚点,根据锚点具体跳转路径APP端跳转具体的页面,在UIWebView的代理方法

- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType

中调用,
该回调方法返回YES时webView才继续加载页面,当我们通过scheme解析处理事件时就不需要再继续加载页面返回NO.
UIWebViewNavigationType的类型有:

  • UIWebViewNavigationTypeLinkClicked,用户触击了一个链接。
  • UIWebViewNavigationTypeFormSubmitted,用户提交了一个表单。
  • UIWebViewNavigationTypeBackForward,用户触击前进或返回按钮。
  • UIWebViewNavigationTypeReload,用户触击重新加载的按钮。
  • UIWebViewNavigationTypeFormResubmitted,用户重复提交表单
  • UIWebViewNavigationTypeOther,发生其它行为。
    并且不能所有在webView上发生的动作都靠scheme协议解析解决,只有在webView发生用户点击事件或者其他行为时我们才根据request.url进一步判断是否需要scheme解析,代码如下:
-(BOOL)webView:(UIWebView *)webView
    shouldStartLoadWithRequest:(NSURLRequest *)request
                navigationType:(UIWebViewNavigationType)navigationType
{
    if (navigationType == UIWebViewNavigationTypeLinkClicked
        || navigationType == UIWebViewNavigationTypeOther)
    {
        if (([[request.URL scheme] isEqualToString:@"zqprojectmobile"])
            || ([[[request.URL scheme] lowercaseString] isEqualToString:@"zqprojectmobile"]))
        {
            [JumpURLHandle parseURL:request.URL];
            return NO;
        }
    }
    return YES;
}

完,表达不好,多见谅,望指正

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

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,580评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,391评论 25 707
  • 把一切美好的时光画进手帐里,你怎么能没有一套为己所用的手帐工具呢? 俗话说的好:工欲善其事,必先利其器。 铃铛子知...
    铃铛子阅读 20,734评论 18 163
  • 拥思维导图很不习惯,不顺手,还出现上传被压缩,图片看不清的情况,好在简书能包容,很开心,磨磨唧唧一个小时的我没有白...
    馋小周阅读 2,605评论 2 3
  • 刚分手没多久的朋友发了个微博 “真可怕 没有几天就有了新欢” 认识了他7年心疼他但不知道怎么安慰我在底下评论“正常...
    Jacinya阅读 185评论 0 1