iOS11对WKWebView的效率越发完备,新扩大如下效果:

在 WWDC 2017上,苹果 WebKit 和 Safari 技术员介绍了 WKWebView
新增加的多少个特点,相对 iOS 9 和 iOS
10,可谓充满欣喜,但也稍有不满。个中入眼的八个特色:

  1. Manager Cookies
  2. Fileter unwanted content
  3. Provide custom resources

Manage cookies
Provide custom resources
Filter unwanted content

上边是对种种性子的总结介绍,详细可参见源码。

Manage cookies

自 iOS 8系统推出后,苹果为主结束了对 UIWebView
的更新,并不独有催促开采者使用 WKWebView, 但是直到以后仍然有过多开垦者对
WKWebView 处于观看状态,当中重大的原因之蓬蓬勃勃就是 WKWebView 的
Cookie问题。iOS
11上,WKWebView 新添了 Ccookie 管理 API
WKHTTPCookieStore,通过该接口可以设置、删除和查询 WKWebView
cookie,以致能够监听 cookie store 的变通。

WKWebViewConfiguration *configuration = [WKWebViewConfiguration new];
NSHTTPCookie *cookie = [NSHTTPCookie cookieWithProperties:@{NSHTTPCookieDomain:@".qq.com", NSHTTPCookiePath:@"/", NSHTTPCookieName:@"hello", NSHTTPCookieValue:@"world", NSHTTPCookieExpires:[NSDate dateWithTimeIntervalSinceNow:24*60*60]}];
WKWebsiteDataStore *webSiteDataStore = [WKWebsiteDataStore nonPersistentDataStore];
[webSiteDataStore.httpCookieStore setCookie:cookie completionHandler:nil];
configuration.websiteDataStore = webSiteDataStore;
WKWebView *webView = [[WKWebView alloc] initWithFrame:self.view.bounds configuration:configuration];
self.view = webView;
[webView loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@"http://www.qq.com"]]];

WKWebView Request 会自动带上 WKHTTPCookieStore 中的 Cookie, 正如
UIWebView Request 会自动带上 NSHTTPCookieStorage 中的 Cookie
同样;页面通过 document.cookie 或 Response Set-Cookie 设置的 Cookie
也会自行同步到 WKHTTPCookieStore 中
。WKWebView 库克ie
难点到底有了相比完美的技术方案(不用往 Request Header 里塞
Cookie,也不用评释本种
库克ie,再也不用忧郁登陆态错失了)。实施开掘,iOS 11 上 WKWebView
cookie 不会和iOS 10如出意气风发辙自动同步到NSHTTPCookieStorage
容器中,对于混合使用 UIWebView 和 WKWebView 的事体,恐怕要在
WKHTTPCookieStore 和 NSHTTPCookieStorage 之间做些 Cookie 同步操作。

1.Manager Cookies

iOS11剧增了叁个类来特意管理Cookies:WKHTTPCookieStore。它至关心注重要含有了了对Cookie的操作:删除、增加、获取等。
比方这种气象:
三个页面暗许登入,当本人还未登入的时候会弹出输入框,输入账号。输入实现之后,会唤起已报到。再次张开该页面时,页面会先剖断有未有cookie,有cookie直接提醒已报到,没有cookie则再度弹框让客商登陆。
不过以往有个新必要:第贰次安装应用程式,运行的时候就有个暗许的账户登入,而无需弹框输入。那就用到了cookie的丰裕。在APP将要加载webView以前,通过HTTPCookie来起头化多少个实例,将其塞到webView的configuration的数目存款和储蓄中。那样加载WebView时就曾经有cookie存在了。那样就打熬了第叁次默许登陆的作用。关键代码如下:

let cookie = HTTPCookie.init(properties: [
            .domain:"172.16.10.26",
            .path:"/src/p/index/index.html",
            .version:0,
            .expires:Date.init(timeIntervalSinceNow: 30*60*60),
            .name:"username",
            .value:"zhanggui33"
            ])

let cookieStore = myWKWebView.configuration.websiteDataStore.httpCookieStore

cookieStore.setCookie(cookie!) {

            self.myWKWebView.load(URLRequest.init(url: URL.init(string: "http://172.16.10.26:3333/src/p/index/index.html")!))
        }

约等于在加载网页前,将cookie注入。愈多可参见这里源代码。

Provide custom resources

在 UIWebView 上,我们普通选择 NSU奥迪Q5LProtocol
拦截供给,加载本地资源或缓存数据,提高页面加载速度;在 WKWebView
上,由于互联网乞请是在非主进程里提倡,所以 NSU奥迪Q7LProtocol
不恐怕阻挡到网络须要,iOS 11事情未发生前,除非选拔 private
api
或 – [WKWebView loadHTMLString: baseURL:] 接口, 不然是不可能落实WKWebView 加载本地财富的。iOS 11上, WebKit 团队算是开放了 WKWebView
加载自定义财富的API,先上个简易的 德姆o。
假定 HTML 文书档案中有三个 <img> 标签,大家期望它显得本地的一张图片
test.jpg,那么 H5 足以这么编码:

<imag src="customScheme://www.test.com/test.jpg">

Native 能够这么编码:

#import "ViewController.h"
#import <WebKit/WebKit.h>

@interface CustomURLSchemeHandler : NSObject<WKURLSchemeHandler>
@end

@implementation CustomURLSchemeHandler
//这里拦截到URLScheme为customScheme的请求后,读取本地图片test.jpg,并返回给WKWebView显示
- (void)webView:(WKWebView *)webView startURLSchemeTask:(id)urlSchemeTask {    
    NSURLRequest *request = urlSchemeTask.request;    
    UIImage *image = [UIImage imageNamed:@"test.jpg"];    
    NSData *data = UIImageJPEGRepresentation(image, 1.0);    
    NSURLResponse *response = [[NSURLResponse alloc] initWithURL:urlSchemeTask.request.URL MIMEType:@"image/jpeg" expectedContentLength:data.length textEncodingName:nil];    
    [urlSchemeTask didReceiveResponse:response];   
    [urlSchemeTask didReceiveData:data];   
    [urlSchemeTask didFinish];
}

- (void)webView:(WKWebView *)webVie stopURLSchemeTask:(id)urlSchemeTask {
}
@end

@implementation ViewController
- (void)viewDidLoad {    
    [super viewDidLoad];    
    WKWebViewConfiguration *configuration = [WKWebViewConfiguration new];
    //设置URLSchemeHandler来处理特定URLScheme的请求,URLSchemeHandler需要实现WKURLSchemeHandler协议
    //本例中WKWebView将把URLScheme为customScheme的请求交由CustomURLSchemeHandler类的实例处理    
    [configuration setURLSchemeHandler:[CustomURLSchemeHandler new] forURLScheme: @"customScheme"];    
    WKWebView *webView = [[WKWebView alloc] initWithFrame:self.view.bounds configuration:configuration];    
    self.view = webView;    
    [webView loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@"http://www.test.com"]]];
}
@end

世家当心到那边将本地自定义财富再次来到给 WKWebView
的多少个接口(用法和长相是或不是和
NSURLProtocolClient
很相似):
@protocol WKURLSchemeTask <NSObject>

  • (void)didReceiveResponse:(NSURLResponse *)response;
  • (void)didReceiveData:(NSData *)data;
  • (void)didFinish;
  • (void)didFailWithError:(NSError *)error;

或是大家会困惑,这里为什么不将img src设置成
http://www.test.com/test.jpg,
同期安装 WKWebView 拦截 http 伏乞?笔者也那样乐观的思忖过,实际结果是:
WKWebView 只允许开垦者拦截自定义 Scheme 的央求,要是在点子
[WKWebViewConfiguration setURLSchemeHandler: forURLScheme:]
里设置
URLScheme: “http”,则 APP 会 crash , crash 信息为:

Terminating app due to uncaught exception
‘NSInvalidArgumentException’ reason: ‘http’ is a URL scheme that
WKWebView handles natively

除了这几个之外 “http” 外,WKWebView 还不容许拦截 Scheme 为 “https”、“ftp”、“file”
的恳求,具体能够通过新接口 + [WKWebView handlesURLScheme:]
推断Scheme是不是早就被WKWebView暗许管理了。此外小编写了二个总结的 Submit
Request,
发掘自定义 Scheme 央浼 body 数据照旧错失。猜测WebKit团队并不曾化解跨进度Request Body
Lost的标题,后续能够研商下WebKit源码,自定义 Scheme
能够界定顾客只好做一些自定义财富加载,大概也相符苹果的平安定协和隐秘政策。
唯其如此拦截自定义 Scheme
的伸手
真是令人深感可惜,那意味,不单H5同学要改成原先必要的Scheme,
调解 CSP 准则,客户端同学在地面资源不设偶尔,也要考虑是还是不是将自定义
Scheme 的呼吁转变来 http 或 https
央求用NSUEvoqueLSession重新发出,收到回包后再将数据再次回到给WKWebView。自定义
Scheme 诉求也会蒙受跨域、必要头Referer 字段遗失等难点。

2.Fileter unwanted content

除此以外三个新特色就是过滤你不想要的原委。例如说你在app中加载的网页中带有http央浼,你能够依附以下准则将http财富加载此前调换来https加载。那几个是苹果官方演示的叁个准则:

let jsonString = """
            [{
                "trigger":{
                    "url-filter": ".*"
                },
                "action":{
                    "type": "make-https"
                }

            }]
            """

这里最重要利用了WKContentRuleListStore。上面就来详细对其进行介绍。

Filter unwanted content

WWDC 二〇一四上,WebKit 团队介绍了 Safari 上增加生产总量的 Content Blocker
个性,能够达成拦阻页面内容加载或逃匿页面内容等职能。在WWDC
2017上,WebKit 团队将那风姿潇洒风味移植到了 WKWebView
上(感到应用途景不是比比较大唉:joy:)。Content Blocking 通过 json
文件定义过滤法规,比方:

[{
    "trigger": {
        "url-filter": ".*"
    },
    "action": {
        "type": "make-https"
    }
},
{
    "trigger": {
        "url-filter": "testContentBlocking"
    },
    "action": {
        "type": "block"
    }
}]

那么些过滤法规需求 WKWebView 把具有的 http 乞求都转成 https,同一时候阻止 U纳瓦拉L
中含有“testContentBlocking”的伸手的加载。“trigger”字段通过正则表明式定义要过滤的央浼,“action”字段定义针对这么些乞请要实行的操作,如block
request loading,过滤法则的有关文书档案能够参见Safari Content-Blocking
Rules
Reference,定义好过滤准绳后,通过新添的
API WKContentRuleListStore 将滤准绳编写翻译成高效的字节码传递给WKWebView;

NSString *jsonPath = [[NSBundle mainBundle] pathForResource:@"contentRuleList" ofType:@"json"];
NSString *jsonString = [NSString stringWithContentsOfFile:jsonPath encoding:NSUTF8StringEncoding error:nil];
[[WKContentRuleListStore defaultStore] compileContentRuleListForIdentifier: @"demoRuleList" encodedContentRuleList: jsonString completionHandler:^(WKContentRuleList *contentRuleList, NSError *error) {
    WKWebViewConfiguration *configuration = [WKWebViewConfiguration new];
    [configuration.userContentController addContentRuleList:contentRuleList];
    WKWebView *webView = [[WKWebView alloc] initWithFrame:self.view.bounds configuration:configuration];
    self.view = webView;
    [webView loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@"http://www.test.com"]]];
}];
创立一个Trigger字典

一个trigger的字典非得要富含url-filter那一个key,它内定了相配url的情势。别的的正是可选的了,举个例子你能够界定钦点的域名,让该域名的剧情不加载。比如上边包车型大巴那么些trigger规则,制订了用来图片和体裁能源的法规trigger,不包涵某写域名上的:

"trigger": {
        "url-filter": ".*",
        "resource-type": ["image", "style-sheet"],
        "unless-domain": ["your-content-server.com", "trusted-content-server.com"]
}

除此而外上面提到的trigger
key,还大概有url-filter-is-case-sensitive、is-domain、unless-domain、resource-type等。具体的详实介绍能够敬仰官方解释。

Others

除了这么些之外下边介绍的八个至关心器重要新特征外,iOS 11 WKWebView也陡增了一个截屏API:

- (void)takeSnapshotWithConfiguration:(WKSnapshotConfiguration *)snapshotConfiguration completionHandler:(void (^)(UIImage *snapshotImage, NSError *error))completionHandler;

能够截取可以知道的viewPort,设置截图尺寸,但是特别不满,这么些接口依旧不恐怕截取网页中用WebGL或Video标签渲染的视图,WKWebView上的截图操作建议还是交由H5管理。

成立八个Action字典

当trigger相称到了相符条件的财富,浏览器便会施行与trigger相关联的操作。当全部的trigger都被评估后,action便会根据顺序奉行。
Action只有三个key:type和selector。type是一定要有些,selector可选,假诺type是css-display-none,那么selector也是必须求有的。其余的type中selector是可选的。
type的类型有:block、block-cookies、css-display-none、ignore-previous-rules、make-https。越多可以敬重合法表达。
比方笔者想屏蔽页面中负有图片的加载:

 //把所有的图片阻塞加载
        let jsonString = """
            [{
                "trigger":{
                    "url-filter": ".*",
                    "resource-type":["image"]
                },
                "action":{
                    "type":"block"
                }
            }]
            """
        WKContentRuleListStore.default().compileContentRuleList(forIdentifier: "demoRuleList", encodedContentRuleList: jsonString) { (list, error) in
            guard let contentRuleList = list else { return }
            let configuration = self.filterWebView.configuration
            configuration.userContentController.add(contentRuleList)
            self.filterWebView.load(URLRequest.init(url: URL.init(string: "http://m.baidu.com")!))
        }

更加多词义的疏解只怕看官方文书档案,里面介绍的很详细。

3.Provide custom resources

那天本性允许你提供自定义的财富,那也得以落成离线缓存。举例你把持有的图纸都放到app里面,然后网页加载图片时依据一定的scheme(举个例子:wk-feature://cat)来加载,然后在顾客端代码中央银行使一定的SchemeHandler来深入分析就能够。这里关键选用了WKU宝马X5LSchemeHandler和WKUOdysseyLSchemeTask。
最首要代码如下:

        let configuration = WKWebViewConfiguration()
        let schemeHandler = MyCustomSchemeHandler.init(viewController: self)

        configuration.setURLSchemeHandler(schemeHandler, forURLScheme: "wk-feature")

福衢寿车了团结的SchemeHandler,然后对一定的Scheme举办拍卖。

总结

倘让你还在利用UIWebView,那么尽快改变为WKWebView吧。究竟苹果更趋向于WKWebView。不断地将其功效丰盛。并且通过了多少个本子迭代,使用WKWebView的坑也都逐级填平。

附源码

1.WKWebViewNewFeature

参考

  1. Customized Loading in
    WKWebView
  2. Introduction to Safari Content-Blocking
    Rules

转发请表明来源:

相关文章