什么是URL Schemes?
URL Schemes是苹果给出的用来跳转到系统应用或者跳转到别人的应用的一种机制。同时还可以在应用之间传数据。
通过对比网页链接来理解 iOS 上的 URL Schemes,应该就容易多了。URL Schemes 有两个单词:
URL,我们都很清楚,http://www.apple.com就是个 URL,我们也叫它链接或网址;
Schemes,表示的是一个 URL 中的一个位置——最初始的位置,即 ://之前的那段字符。比如 http://www.apple.com这个网址的 Schemes是 http。根据我们上面对 URL Schemes 的使用,
我们可以很轻易地理解,在以本地应用为主的 iOS 上,我们可以像定位一个网页一样,用一种特殊的 URL 来定位一个应用甚至应用里某个具体的功能。而定位这个应用的,就应该是这个应用的 URL 的 Schemes 部分,也就是开头儿那部分。
调用方法
1.注册APP URL Schemes
2.打开APP方法:
调用APP
URL Schemes://
OC调用方法:
简单调用:
NSURL *url = [NSURL URLWithString:@"myurltest:"];
[[UIApplication sharedApplication] openURL:url];
考虑到交互友好可以使用下面这种方法:
NSURL *url = [NSURL URLWithString:@"weixin://"];
//先判断是否能打开该url
if ([[UIApplication sharedApplication] canOpenURL:url]) { //打开url
[[UIApplication sharedApplication] openURL:url];
}else { //给个提示或者做点别的事情
NSLog(@"U四不四洒,没安装WXApp,怎么打开啊!");
}
先判断本机是否安装,若果安装就打开APP,否则提示没有安装。这里你也可以做成没有安装的话就直接跳转到APPStore.
更重要的是,假如点击之后没效果,很有可能被苹果拒绝哦。
除了OC代码打开的方式,平时测试过程你也可以直接通过safari 地址栏上输入
URL Schemes://
来打开应用。
这里给出一个操作DEMO
3.APP 回调处理
苹果一共给了3个openURL的回调。
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url NS_DEPRECATED_IOS(2_0, 9_0, "Please use application:openURL:options:") __TVOS_PROHIBITED;
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(nullable NSString *)sourceApplication annotation:(id)annotation NS_DEPRECATED_IOS(4_2, 9_0, "Please use application:openURL:options:") __TVOS_PROHIBITED;
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary *)options NS_AVAILABLE_IOS(9_0); // no equiv. notification. return NO if the application can't open for some reason
为什么会有3个呢?这3个回调又有什么区别?(为方面讲解,分别设置ABC3个回调)
3个回调的功能基本一样,都是在别人通过URL Schemes打开应用的时候会执行的。不同之处:
A回调是在iOS2.0的时候推出的,参数只有url。
B回到是在iOS4.2的时候推出的,参数有url sourceApplication annotation.
C回调是iOS9.0的时候推出的,参数有url options。
这几个回调是有优先级的。C>B>A。也就是说,如果你3个回调都实现了,那么程序只会执行C回调。其他回调是不会执行的。(当然,iOS9以下只会执行B回调)。
所以只要在被打开的App 的 appdelegate这个类里面实现:
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(nullable NSString *)sourceApplication annotation:(id)annotation
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary *)options
这两个方法即可。
使用URL Schems传递数据
URL Schemes除了可以用来打开APP之外,还可以用来在两个App之间传递少量的数据。
这里写一个demo来说明URL的组成结构
NSURL *url = [NSURL URLWithString:@"http://www.baidu.com/s?tn=baiduhome_pg&bs=NSRUL&f=8&rsv_bp=1&rsv_spt=1&wd=NSurl&inputT=2709"];
NSLog(@"Scheme: %@", [url scheme]);
NSLog(@"Host: %@", [url host]);
NSLog(@"Port: %@", [url port]);
NSLog(@"Path: %@", [url path]);
NSLog(@"Relative path: %@", [url relativePath]);
NSLog(@"Path components as array: %@", [url pathComponents]);
NSLog(@"Parameter string: %@", [url parameterString]);
NSLog(@"Query: %@", [url query]);
NSLog(@"Fragment: %@", [url fragment]);
NSLog(@"User: %@", [url user]);
NSLog(@"Password: %@", [url password]);
输出结果:
2012-08-29 15:52:23.781 NSurl[3560:f803] Scheme: http
2012-08-29 15:52:32.793 NSurl[3560:f803] Host: www.baidu.com
2012-08-29 15:52:39.102 NSurl[3560:f803] Port: (null)
2012-08-29 15:52:42.590 NSurl[3560:f803] Path: /s
2012-08-29 15:52:52.516 NSurl[3560:f803] Relative path: /s
2012-08-29 15:53:05.576 NSurl[3560:f803] Path components as array: (
"/",
s
)
2012-08-29 15:53:32.861 NSurl[3560:f803] Parameter string: (null)
2012-08-29 15:53:37.528 NSurl[3560:f803] Query: tn=baiduhome_pg&bs=NSRUL&f=8&rsv_bp=1&rsv_spt=1&wd=NSurl&inputT=2709
2012-08-29 15:53:52.942 NSurl[3560:f803] Fragment: (null)
2012-08-29 15:53:54.539 NSurl[3560:f803] User: (null)
2012-08-29 15:53:57.808 NSurl[3560:f803] Password: (null)
我们需要的是query 里面的参数内容,可以用[url query]方法取出,取出的内容为NSstring 类型需要做字符串处理才能拿到对应的数据。
为了让程序结构更加清晰我们这时更希望取出来的为字典类型。这样就少了字符串处理过程,同时也增加了我们程序的可读性。
这里贴上处理函数:
//
// NSMutableDictionary+URLParams.m
// TrainStaff
//
// Created by 逸信Mac on 2016/12/3.
// Copyright © 2016年 eshine-ios. All rights reserved.
//
#import "NSMutableDictionary+URLParams.h"
@implementation NSMutableDictionary (URLParams)
/**
* 截取URL中的参数
*
* @return NSMutableDictionary parameters
*/
+(NSMutableDictionary *)getURLParameters:(NSString *)urlStr
{
// 查找参数
NSRange range = [urlStr rangeOfString:@"?"];
if (range.location == NSNotFound) {
return nil;
}
// 以字典形式将参数返回
NSMutableDictionary *params = [NSMutableDictionary dictionary];
// 截取参数
NSString *parametersString = [urlStr substringFromIndex:range.location + 1];
// 判断参数是单个参数还是多个参数
if ([parametersString containsString:@"&"]) {
// 多个参数,分割参数
NSArray *urlComponents = [parametersString componentsSeparatedByString:@"&"];
for (NSString *keyValuePair in urlComponents) {
// 生成Key/Value
NSArray *pairComponents = [keyValuePair componentsSeparatedByString:@"="];
NSString *key = [pairComponents.firstObject stringByRemovingPercentEncoding];
NSString *value = [pairComponents.lastObject stringByRemovingPercentEncoding];
// Key不能为nil
if (key == nil || value == nil) {
continue;
}
id existValue = [params valueForKey:key];
if (existValue != nil) {
// 已存在的值,生成数组
if ([existValue isKindOfClass:[NSArray class]]) {
// 已存在的值生成数组
NSMutableArray *items = [NSMutableArray arrayWithArray:existValue];
[items addObject:value];
[params setValue:items forKey:key];
} else {
// 非数组
[params setValue:@[existValue, value] forKey:key];
}
} else {
// 设置值
[params setValue:value forKey:key];
}
}
} else {
// 单个参数
// 生成Key/Value
NSArray *pairComponents = [parametersString componentsSeparatedByString:@"="];
// 只有一个参数,没有值
if (pairComponents.count == 1) {
return nil;
}
// 分隔值
NSString *key = [pairComponents.firstObject stringByRemovingPercentEncoding];
NSString *value = [pairComponents.lastObject stringByRemovingPercentEncoding];
// Key不能为nil
if (key == nil || value == nil) {
return nil;
}
// 设置值
[params setValue:value forKey:key];
}
return params;
}
@end
使用DEMO:
-(BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url sourceApplication:(nullable NSString *)sourceApplication annotation:(nonnull id)annotation
{
NSString *schemeVal = [url scheme];
if([schemeVal isEqualToString:@"xyjtrain"]){
NSMutableDictionary *dic = [NSMutableDictionary getURLParameters:[url absoluteString]];
NSString *cookieVal = dic[@"cookie"];
if(NotNilAndNull(cookieVal)){
}
}
return NO;
}
iOS9中的适配
配置URL Schemes白名单
iOS9的时候苹果加强了权限,只有在info.plist文件中加入了URL Schemes白名单才能使用canOpenURL:
方法来判断是否能打开该url。该白名单的上限是50个。也就是说,你最多只能使用canOpenURL:
方法判断50个URL Schemes。当然,平常我们都用不了那么多,就算是集成分享功能,50个肯定够了。
备注:只是对canOpenURL:方法有限制,openURL:方法是没有限制的。
我们需要在MyApp的info.plist里面将weixin
设置为白名单。
步骤:
点击info.plist->右键->Open As->Source Code->添加下面的代码
LSApplicationQueriesSchemes
weixin
问题
多个应用设置相同的URL Scheme 会怎么样?
这个URL Schemes并不是唯一的。也就是说,多个应用之间设置的URL Schemes是可以相同的。
那么问题来了,假如两个应用的URL Schemes相同的话,使用openURL:方法会打开哪个应用呢?
楼主亲自用手机试了一下。
步骤是:
将MyApp安装到手机上,点击“打开微信”button,微信打开了。
然后将WXApp也安装到手机上。再次点击MyApp的“打开微信”button,结果打开的是WXApp。
结论:如果两个应用有URL Schemes是相同的,后安装的应用的URL Schemes会把早安装的应用的URL Schems覆盖掉。
附上常用的URL Schemes:
QQ的url是 mqq://
微信是weixin://
淘宝taobao://
点评dianping:// dianping://search
微博 sinaweibo://
weico微博weico://
支付宝alipay://
美团 imeituan://
京冬openapp.jdmoble://
人人renren://
1号店wccbyihaodian://
有道词典yddictproapp://
优酷 youku://
/****6月2日更新****/
最近苹果刚更新了IOS10.3,无意中发现了一个关于URL Scheme调整的问题,准确的说是URL Scheme命名的问题。官方对URL Scheme的命名做了规范限制:命名要小写!但是到目前来看大写小写都是可以成功唤起的,也就是说无论大写还是小写跳转都是没有任何影响的