iOS中WebKit框架应用与解析

时间  2019-11-07
标签 ios webkit 框架 应用 解析 栏目 iOS 繁體版
原文   原文链接

iOS中WebKit框架应用与解析

1、引言

        在iOS8以前，在应用中嵌入网页一般须要使用UIWebView这样一个类，这个类经过URL或者HTML文件来加载网页视图，功能十分有限，只能做为辅助嵌入原生应用程序中。虽然UIWebView也能够作原生与JavaScript交互的相关处理，然而也有很大的局限性，JavaScript要调用原生方法一般须要约定好协议以后经过Request来传递。WebKit框架中添加了一些原生与JavaScript交互的方法，加强了网页视图与原生的交互能力。而且WebKit框架中采用导航堆栈的模型来管理网页的跳转，开发者也能够更加容易的控制和管理网页的渲染。关于UIWebView的相关使用，在前面的博客中有详细介绍，地址以下。java

UIWebView的使用详解：http://my.oschina.net/u/2340880/blog/469916。web

2、WebKit框架概览

        WebKit框架中涉及的类不少，框架的设计十分面向对象和模块化，开发者在使用时能够轻松的写出结构清晰的代码。在进行使用前，咱们首先应该清楚整个框架的结构和开发思路，下面一张脑图中基本列出了WebKit框架中所涉及到的全部重要的类以及他们之间的相互关系：数组

如上图所示，WebKit框架中最核心的类应该属于WKWebView了，这个类专门用来渲染网页视图，其余类和协议都将基于它和服务于它。缓存

WKWebView：网页的渲染与展现，经过WKWebViewConfiguration能够进行配置。安全

WKWebViewConfiguration：这个类专门用来配置WKWebView。app

WKPreference:这个类用来进行M相关设置。框架

WKProcessPool：这个类用来配置进程池，与网页视图的资源共享有关。ide

WKUserContentController：这个类主要用来作native与JavaScript的交互管理。模块化

WKUserScript：用于进行JavaScript注入。post

WKScriptMessageHandler：这个类专门用来处理JavaScript调用native的方法。

WKNavigationDelegate：网页跳转间的导航管理协议，这个协议能够监听网页的活动。

WKNavigationAction：网页某个活动的示例化对象。

WKUIDelegate：用于交互处理JavaScript中的一些弹出框。

WKBackForwardList：堆栈管理的网页列表。

WKBackForwardListItem：每一个网页节点对象。

3、使用WKWebViewConfiguration对WebView进行配置

        使用下面的代码能够建立一个WKWebView视图，建立WebView视图时，须要使用WKWebViewConfiguration来进行配置：

WKWebView * WK;
    WKWebViewConfiguration * config = [[WKWebViewConfiguration alloc]init];
    WK = [[WKWebView alloc]initWithFrame:CGRectMake(0, 0, self.view.frame.size.width, self.view.frame.size.height-40) configuration:config];
    [WK loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@"http://www.baidu.com"]]];

WKWebViewConfiguration中能够进行配置的方法和属性以下：

//设置进程池
    WKProcessPool * pool = [[WKProcessPool alloc]init];
    config.processPool = pool;

WKProcessPool类中没有暴露任何属性和方法，配置为同一个进程池的WebView会共享数据，例如Cookie、用户凭证等，开发者能够经过编写管理类来分配不一样维度的WebView在不一样进程池中。

//进行偏好设置
    WKPreferences * preference = [[WKPreferences alloc]init];
    //最小字体大小 当将javaScriptEnabled属性设置为NO时，能够看到明显的效果
    preference.minimumFontSize = 0;
    //设置是否支持javaScript 默认是支持的
    preference.javaScriptEnabled = YES;
    //设置是否容许不通过用户交互由javaScript自动打开窗口
    preference.javaScriptCanOpenWindowsAutomatically = YES;
    config.preferences = preference;

WKPerference实例为WebView提供一个偏好设置。

//设置内容交互控制器 用于处理JavaScript与native交互
    WKUserContentController * userController = [[WKUserContentController alloc]init];
    //设置处理代理而且注册要被js调用的方法名称
    [userController addScriptMessageHandler:self name:@"name"];
    //js注入，注入一个测试方法。
    NSString *javaScriptSource = @"function userFunc(){window.webkit.messageHandlers.name.postMessage( {\"name\":\"HS\"})}";
    WKUserScript *userScript = [[WKUserScript alloc] initWithSource:javaScriptSource injectionTime:WKUserScriptInjectionTimeAtDocumentStart forMainFrameOnly:YES];// forMainFrameOnly:NO(全局窗口)，yes（只限主窗口）
    [userController addUserScript:userScript];
    config.userContentController = userController;

WKUserContentController专门用来管理native与JavaScript的交互行为，addScriptMessageHandler:name:方法来注册要被js调用的方法名称，以后再JavaScript中使用window.webkit.messageHandlers.name.postMessage()方法来像native发送消息，支持OC中字典，数组，NSNumber等原生数据类型，JavaScript代码中的name要和上面注册的相同。在native代理的回调方法中，会获取到JavaScript传递进来的消息，以下：

-(void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message{
    //这里能够获取到JavaScript传递进来的消息
}

WKScriptMessage类是JavaScript传递的对象实例，其中属性以下：

//传递的消息主体
@property (nonatomic, readonly, copy) id body;
//传递消息的WebView
@property (nullable, nonatomic, readonly, weak) WKWebView *webView;
//传递消息的WebView当前页面对象
@property (nonatomic, readonly, copy) WKFrameInfo *frameInfo;
//消息名称
@property (nonatomic, readonly, copy) NSString *name;

WKUserContentController实例的addUserScript:用于注入JavaScript代码，后面会专门介绍。

//设置数据存储store
    config.websiteDataStore = [WKWebsiteDataStore defaultDataStore];

WebKit框架采用其自己的缓存框架，WKWebsiteDataStore类用来处理数据的存储，其中属性和方法以下：

@interface WKWebsiteDataStore : NSObject
//获取默认的存储器 此存储器为持久性的会被写入磁盘
+ (WKWebsiteDataStore *)defaultDataStore;
//获取一个临时的存储器
+ (WKWebsiteDataStore *)nonPersistentDataStore;
//存储器是不是临时的
@property (nonatomic, readonly, getter=isPersistent) BOOL persistent;
//全部能够存储的类型
+ (NSSet<NSString *> *)allWebsiteDataTypes;
@end
//设置是否将网页内容所有加载到内存后再渲染
    config.suppressesIncrementalRendering = NO;
    //设置HTML5视频是否容许网页播放 设置为NO则会使用本地播放器
    config.allowsInlineMediaPlayback =  YES;
    //设置是否容许ariPlay播放
    config.allowsAirPlayForMediaPlayback = YES;
    //设置视频是否须要用户手动播放  设置为NO则会容许自动播放
    config.requiresUserActionForMediaPlayback = NO;
    //设置是否容许画中画技术 在特定设备上有效
    config.allowsPictureInPictureMediaPlayback = YES;
    //设置选择模式 是按字符选择 仍是按模块选择
    /*
    typedef NS_ENUM(NSInteger, WKSelectionGranularity) {
        //按模块选择
        WKSelectionGranularityDynamic,
        //按字符选择
        WKSelectionGranularityCharacter,
    } NS_ENUM_AVAILABLE_IOS(8_0);
    */
    config.selectionGranularity = WKSelectionGranularityCharacter;
    //设置请求的User-Agent信息中应用程序名称 iOS9后可用
    config.applicationNameForUserAgent = @"HS";

4、WKWebView中的属性和方法解析

        下面列举了WKWebView中经常使用的属性和方法。

//设置导航代理
@property (nullable, nonatomic, weak) id <WKNavigationDelegate> navigationDelegate;
//设置UI代理
@property (nullable, nonatomic, weak) id <WKUIDelegate> UIDelegate;
//导航列表
@property (nonatomic, readonly, strong) WKBackForwardList *backForwardList;
//经过url加载网页视图
- (nullable WKNavigation *)loadRequest:(NSURLRequest *)request;
//经过文件加载网页视图
- (nullable WKNavigation *)loadFileURL:(NSURL *)URL allowingReadAccessToURL:(NSURL *)readAccessURL NS_AVAILABLE(10_11, 9_0);
//经过HTML字符串加载网页视图
- (nullable WKNavigation *)loadHTMLString:(NSString *)string baseURL:(nullable NSURL *)baseURL;
//经过data数据加载网页视图
- (nullable WKNavigation *)loadData:(NSData *)data MIMEType:(NSString *)MIMEType characterEncodingName:(NSString *)characterEncodingName baseURL:(NSURL *)baseURL NS_AVAILABLE(10_11, 9_0);
//渲染导航列表中的某个网页节点
- (nullable WKNavigation *)goToBackForwardListItem:(WKBackForwardListItem *)item;
//网页标题
@property (nullable, nonatomic, readonly, copy) NSString *title;
//网页的url
@property (nullable, nonatomic, readonly, copy) NSURL *URL;
//网页是否正在加载中
@property (nonatomic, readonly, getter=isLoading) BOOL loading;
//加载进度 能够监听这个属性的值配合UIProgressView来设计进度条
@property (nonatomic, readonly) double estimatedProgress;
//是否所有是安全链接
@property (nonatomic, readonly) BOOL hasOnlySecureContent;
//证书列表
@property (nonatomic, readonly, copy) NSArray *certificateChain;
//是否能够回退
@property (nonatomic, readonly) BOOL canGoBack;
//是否能够前进
@property (nonatomic, readonly) BOOL canGoForward;
//回退网页
- (nullable WKNavigation *)goBack;
//前进网页
- (nullable WKNavigation *)goForward;
//刷新网页
- (nullable WKNavigation *)reload;
//忽略缓存的刷新
- (nullable WKNavigation *)reloadFromOrigin;
//中止加载
- (void)stopLoading;
//执行JavaScript代码
- (void)evaluateJavaScript:(NSString *)javaScriptString completionHandler:(void (^ __nullable)(__nullable id, NSError * __nullable error))completionHandler;
//是否容许右滑返回手势
@property (nonatomic) BOOL allowsBackForwardNavigationGestures;

WKBackForwardList类为导航管理的网页列表类，其中属性方法意义以下：

@interface WKBackForwardList : NSObject
//当前所在的网页节点
@property (nullable, nonatomic, readonly, strong) WKBackForwardListItem *currentItem;
//前进的一个网页节点
@property (nullable, nonatomic, readonly, strong) WKBackForwardListItem *forwardItem;
//回退的一个网页节点
@property (nullable, nonatomic, readonly, strong) WKBackForwardListItem *backItem;
//获取某个index的网页节点
- (nullable WKBackForwardListItem *)itemAtIndex:(NSInteger)index;
//获取回退的节点数组
@property (nonatomic, readonly, copy) NSArray<WKBackForwardListItem *> *backList;
//获取前进的节点数组
@property (nonatomic, readonly, copy) NSArray<WKBackForwardListItem *> *forwardList;
@end

在WebKit中，网页节点被抽象成为了WKBackForwardListItem类，这个类中封装的属性以下：

@interface WKBackForwardListItem : NSObject
//当前节点的URL
@property (readonly, copy) NSURL *URL;
//当前节点的标题
@property (nullable, readonly, copy) NSString *title;
//建立此WebView的初始URL
@property (readonly, copy) NSURL *initialURL;

5、关于native与JavaScript交互

        WebKit中的native与JavaScript的交互主要有4类。

1.JavaScript调用native方法

        这种方式是由WKUserContentController注册，并在代理方法中实现的。

2.native调用JavaScript方法

        这种方式经过WKWebView直接调用evaluteJavaScript:completionHandler:方法来实现。

3.将JavaScript代码注入

        这种方式能够在网页中注入一些自定义的JavaScript代码，也能够注入自定义的方法，再使用evaluteJavaScript:completionHandler:来调用方法。JavaScript代码的注入也是经过WKUserContentController来完成的，使用addUserScript:方法来注入JavaScript，其中须要经过WKUserScript类来生成要注入的对象，这个类使用以下方法来进行实例化：

/*
source为要注入的js代码
WKUserScriptInjectionTime设置注入的时机
forMainFrameOnly参数设置是否只在主页面注入
typedef NS_ENUM(NSInteger, WKUserScriptInjectionTime) {
    //原js代码运行前注入
    WKUserScriptInjectionTimeAtDocumentStart,
    //原js代码运行后注入
    WKUserScriptInjectionTimeAtDocumentEnd
} NS_ENUM_AVAILABLE(10_10, 8_0);

*/
- (instancetype)initWithSource:(NSString *)source injectionTime:(WKUserScriptInjectionTime)injectionTime forMainFrameOnly:(BOOL)forMainFrameOnly;

4.经过WKUIDelegate来交互

        这种方式主要用于相应JavaScript中的弹出框，后面会详细介绍这个协议。

6、WKNavagationDelegate中方法解析

        WKNavagationDelegate协议重要有两个做用，监听页面渲染流程与控制页面跳转，其中方法以下：

/*
决定是否响应网页的某个动做，例如加载，回退，前进，刷新等，在这个方法中，必须执行decisionHandler()代码块，并将是否容许这个活动执行在block中进行传入
*/
/*
WKNavigationAction是网页动做的抽象化，其中封装了许多行为信息，后面会介绍
WKNavigationActionPolicy为开发者回执，枚举以下：
typedef NS_ENUM(NSInteger, WKNavigationActionPolicy) {
    //取消这次行为
    WKNavigationActionPolicyCancel,
    //容许这次行为
    WKNavigationActionPolicyAllow,
} NS_ENUM_AVAILABLE(10_10, 8_0);
*/
-(void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler{
    decisionHandler(WKNavigationActionPolicyAllow);
}
//须要响应身份验证时调用 一样在block中须要传入用户身份凭证
-(void)webView:(WKWebView *)webView didReceiveAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition, NSURLCredential * _Nullable))completionHandler{
    //用户身份信息
    NSURLCredential *newCred = [NSURLCredential credentialWithUser:@""
                                                          password:@""
                                                       persistence:NSURLCredentialPersistenceNone];
    // 为 challenge 的发送方提供 credential
    [[challenge sender] useCredential:newCred
           forAuthenticationChallenge:challenge];
    completionHandler(NSURLSessionAuthChallengeUseCredential,newCred);
}
//接收到数据后是否容许执行渲染
/*
其中，WKNavigationResponse为请求回执信息
WKNavigationResponsePokicy为开发者回执，枚举以下：
typedef NS_ENUM(NSInteger, WKNavigationResponsePolicy) {
    //取消渲染
    WKNavigationResponsePolicyCancel,
    //容许渲染
    WKNavigationResponsePolicyAllow,
} NS_ENUM_AVAILABLE(10_10, 8_0);
*/
-(void)webView:(WKWebView *)webView decidePolicyForNavigationResponse:(WKNavigationResponse *)navigationResponse decisionHandler:(void (^)(WKNavigationResponsePolicy))decisionHandler{
    decisionHandler(WKNavigationResponsePolicyAllow);
}
//=====================下面这个协议方法用于监听流程=========================================
//页面加载启动时调用
-(void)webView:(WKWebView *)webView didStartProvisionalNavigation:(WKNavigation *)navigation{

}
//当主机接收到的服务重定向时调用
-(void)webView:(WKWebView *)webView didReceiveServerRedirectForProvisionalNavigation:(WKNavigation *)navigation{

}
//内容到达主机时调用
-(void)webView:(WKWebView *)webView didCommitNavigation:(WKNavigation *)navigation{

}
//主页加载完成时调用
-(void)webView:(WKWebView *)webView didFinishNavigation:(WKNavigation *)navigation{

}
//提交发生错误时调用
-(void)webView:(WKWebView *)webView didFailNavigation:(WKNavigation *)navigation withError:(NSError *)error{

}
//主页数据加载发生错误时调用
-(void)webView:(WKWebView *)webView didFailProvisionalNavigation:(null_unspecified WKNavigation *)navigation withError:(nonnull NSError *)error{

}
//进程被终止时调用
-(void)webViewWebContentProcessDidTerminate:(WKWebView *)webView{

}

7、WKUIDelegate协议中方法解析

//建立新的webView时调用的方法
-(WKWebView *)webView:(WKWebView *)webView createWebViewWithConfiguration:(WKWebViewConfiguration *)configuration forNavigationAction:(WKNavigationAction *)navigationAction windowFeatures:(WKWindowFeatures *)windowFeatures{
    return webView;
}
//关闭webView时调用的方法
-(void)webViewDidClose:(WKWebView *)webView{

}
//下面这些方法是交互JavaScript的方法
//JavaScript调用alert方法后回调的方法 message中为alert提示的信息 必需要在其中调用completionHandler()
-(void)webView:(WKWebView *)webView runJavaScriptAlertPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(void))completionHandler{
    NSLog(@"%@",message);
    completionHandler();
}
//JavaScript调用confirm方法后回调的方法 confirm是js中的肯定框，须要在block中把用户选择的状况传递进去
-(void)webView:(WKWebView *)webView runJavaScriptConfirmPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(BOOL))completionHandler{
    NSLog(@"%@",message);
    completionHandler(YES);
}
//JavaScript调用prompt方法后回调的方法 prompt是js中的输入框 须要在block中把用户输入的信息传入
-(void)webView:(WKWebView *)webView runJavaScriptTextInputPanelWithPrompt:(NSString *)prompt defaultText:(NSString *)defaultText initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(NSString * _Nullable))completionHandler{
    NSLog(@"%@",prompt);
    completionHandler(@"123");
}

8、扩展

        首先，在注册要被JavaScript调用的方法时须要设置代理，在不须要时须要将代理移除，WKUserContentController中也提供了移除这个代理的方法，若是不移除，将会形成WebView不能释放。方法以下：

//注册一个监听方法
- (void)addScriptMessageHandler:(id <WKScriptMessageHandler>)scriptMessageHandler name:(NSString *)name;
//移除一个方法的监听
- (void)removeScriptMessageHandlerForName:(NSString *)name;

一样与注入JavaScript对应，也能够将注入的代码移除，方法以下：

//注入一个JavaScript抽象对象
- (void)addUserScript:(WKUserScript *)userScript;
//移除全部注入
- (void)removeAllUserScripts;

        在上面，常常会见到WKNavagationAction这个类，这个类中封装的是一些页面活动信息，以下：

@interface WKNavigationAction : NSObject
//原页面
@property (nonatomic, readonly, copy) WKFrameInfo *sourceFrame;
//目标页面
@property (nullable, nonatomic, readonly, copy) WKFrameInfo *targetFrame;
//请求URL
@property (nonatomic, readonly, copy) NSURLRequest *request;
//活动类型
/*
typedef NS_ENUM(NSInteger, WKNavigationType) {
    //连接激活
    WKNavigationTypeLinkActivated,
    //提交操做
    WKNavigationTypeFormSubmitted,
    //前进操做
    WKNavigationTypeBackForward,
    //刷新操做
    WKNavigationTypeReload,
    //重提交操做 例如前进 后退 刷新
    WKNavigationTypeFormResubmitted,
    //其余类型
    WKNavigationTypeOther = -1,
} NS_ENUM_AVAILABLE(10_10, 8_0);
*/
@property (nonatomic, readonly) WKNavigationType navigationType;
@end

 

专一技术，热爱生活，交流技术，也作朋友。

——珲少 QQ群：203317592

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程