深入剖析 WKWebView 框架

WKWebView 整体结构图

WebKit.png

WKWebView

// 初始化
- (instancetype)initWithFrame:(CGRect)frame configuration:(WKWebViewConfiguration *)configuration 
// 加载网页端的 URL
- (nullable WKNavigation *)loadRequest:(NSURLRequest *)request;
// 以指定中心页面缩放内容
- (void)setMagnification:(CGFloat)magnification centeredAtPoint:(CGPoint)point;

WKWebViewConfiguration

WKWebView 配置类:进程池,WK偏好设置,native与站点存储
改配置只在初始化webview的时候生效,后面在修改配置,不会影响该webview的变化。

// 全部 load 进内存中再渲染,还是边load边渲染
@property (nonatomic) BOOL suppressesIncrementalRendering;
// 对用户代理设置
@property (nullable, nonatomic, copy) NSString *applicationNameForUserAgent
// 是否允许 AirPlay 播放媒体
@property (nonatomic) BOOL allowsAirPlayForMediaPlayback
// 给 URLScheme 设置一个通信协议,监听 URL Scheme 的加载状态
- (void)setURLSchemeHandler:(nullable id <WKURLSchemeHandler>)urlSchemeHandler forURLScheme:(NSString *)urlScheme
// 返回当前已注册的 URLScheme 对象
- (nullable id <WKURLSchemeHandler>)urlSchemeHandlerForURLScheme:(NSString *)urlScheme
WKProcessPool 进程池

解决多个webview共享登录态的问题

WKPreferences 偏好设置
// 最小的字体大小
@property (nonatomic) CGFloat minimumFontSize;
// 客户端点击前端是否可以交互
@property (nonatomic) BOOL javaScriptEnabled;
javaScript 是否能够自动弹出对话框,在没有用户交互的情况下,在iOS 默认是不可以的,在 OSX 上是可以的
@property (nonatomic) BOOL javaScriptCanOpenWindowsAutomatically;
浏览器是否支持java,默认 No
@property (nonatomic) BOOL javaEnabled;
// 是否支持插件,默认是 NO
@property (nonatomic) BOOL plugInsEnabled;
// 选项卡是链接
@property (nonatomic) BOOL tabFocusesLinks API_AVAILABLE(macosx(10.12.3));

总结:WKPreferences 是关于 JS 和 WK 一些交互方面的问题,比如,最小支持字体大小,能不能够支持 wk 和 JS 交互,JS 能不能主动弹出对话框,WK支不支持 JAVA,插件,以及选项卡是不是链接等。

WKUserContentController
// 与控制器相关的控制脚本
@property (nonatomic, readonly, copy) NSArray<WKUserScript *> *userScripts;
WKUserScript
// 脚本的源代码
@property (nonatomic, readonly, copy) NSString *source;
// 脚本应该被注入的时间
@property (nonatomic, readonly) WKUserScriptInjectionTime injectionTime;
// 表示脚本应该注入到主 frame中还是全部 frame中
@property (nonatomic, readonly, getter=isForMainFrameOnly) BOOL forMainFrameOnly;
// 添加一个用户脚本
- (void)addUserScript:(WKUserScript *)userScript;
// JS 调 OC,添加脚本处理
- (void)addScriptMessageHandler:(id <WKScriptMessageHandler>)scriptMessageHandler name:(NSString *)name;
// 移除一个脚本
- (void)removeScriptMessageHandlerForName:(NSString *)name;
WKWebsiteDataStore

代表网站可能提供的各种类型的数据,包括 cookies,磁盘,内存缓存,以及持久缓存。比如,WebSQL,IndexedDB和本地存储。

// 返回一个默认的存储方式
+ (WKWebsiteDataStore *)defaultDataStore;
// 非持久化数据存储,适用于"隐身模式"
+ (WKWebsiteDataStore *)nonPersistentDataStore;
// 数据是否持久化
@property (nonatomic, readonly, getter=isPersistent) BOOL persistent;
// 返回一组可用的网站数据类型的存储
+ (NSSet<NSString *> *)allWebsiteDataTypes;
// 包含给定网站的数据类型的数据记录
- (void)fetchDataRecordsOfTypes:(NSSet<NSString *> *)dataTypes completionHandler:(void (^)(NSArray<WKWebsiteDataRecord *> *))completionHandler;
为给定的数据记录删除给定的网站数据
- (void)removeDataOfTypes:(NSSet<NSString *> *)dataTypes forDataRecords:(NSArray<WKWebsiteDataRecord *> *)dataRecords completionHandler:(void (^)(void))completionHandler;
// 删除给定日期以来,修改的给定类型的所有网站数据
- (void)removeDataOfTypes:(NSSet<NSString *> *)websiteDataTypes modifiedSince:(NSDate *)date completionHandler:(void (^)(void))completionHandler;
WKHTTPCookieStore
// 获取所有存储的 cookie
- (void)getAllCookies:(void (^)(NSArray<NSHTTPCookie *> *))completionHandler;
// 设置 cookie
- (void)setCookie:(NSHTTPCookie *)cookie completionHandler:(nullable void (^)())completionHandler;
// 删除 cookie
- (void)deleteCookie:(NSHTTPCookie *)cookie completionHandler:(nullable void (^)())completionHandler;
// 添加一个注册协议来监听 cookie的变化
- (void)addObserver:(id<WKHTTPCookieStoreObserver>)observer;
// 删除 监听者
- (void)removeObserver:(id<WKHTTPCookieStoreObserver>)observer;
// 在请求发送之前,决定是否跳转 -> 如果方法不实现默认是跳转的。如果要实现该方法就要手动设置跳转。该方法执行在加载页面之前
- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler;

例如:

// 需要自己实现跳转,该方法执行在加载页面之前
- (void)webView:(WKWebView *)webView
decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction
decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler
{
    decisionHandler(WKNavigationActionPolicyAllow);
    NSLog(@"%s", __FUNCTION__);
}
// 在收到响应之后决定是否跳转,默认是跳转的,如果自己实现该方法需要实现跳转
- (void)webView:(WKWebView *)webView decidePolicyForNavigationResponse:(WKNavigationResponse *)navigationResponse decisionHandler:(void (^)(WKNavigationResponsePolicy))decisionHandler;

例子:

- (void)webView:(WKWebView *)webView
decidePolicyForNavigationResponse:(WKNavigationResponse *)navigationResponse
decisionHandler:(void (^)(WKNavigationResponsePolicy))decisionHandler
{
    decisionHandler(WKNavigationResponsePolicyAllow);
    NSLog(@"%s", __FUNCTION__);
}
// 页面开始加载时调用
- (void)webView:(WKWebView *)webView didStartProvisionalNavigation:(null_unspecified WKNavigation *)navigation;
//  接收到服务器跳转请求是时调用
- (void)webView:(WKWebView *)webView didReceiveServerRedirectForProvisionalNavigation:(null_unspecified WKNavigation *)navigation;
// 页面加载失败的
- (void)webView:(WKWebView *)webView didFailProvisionalNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error;
// 网页可以接收网页内容
- (void)webView:(WKWebView *)webView didCommitNavigation:(null_unspecified WKNavigation *)navigation;
// 完成时加载
- (void)webView:(WKWebView *)webView didFinishNavigation:(null_unspecified WKNavigation *)navigation;
// 页面跳转失败
- (void)webView:(WKWebView *)webView didFailNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error;
// 当webview 需要证书验证时,调用
- (void)webView:(WKWebView *)webView didReceiveAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential * _Nullable credential))completionHandler;
// webview中断时调用
- (void)webViewWebContentProcessDidTerminate:(WKWebView *)webView;
WKUIDelegate
// 弹框关闭的时候,调用
- (void)webViewDidClose:(WKWebView *)webView;
// 弹出对话框
- (void)webView:(WKWebView *)webView runJavaScriptAlertPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(void))completionHandler;
// 弹出确认按钮
- (void)webView:(WKWebView *)webView runJavaScriptConfirmPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(BOOL result))completionHandler;
// 弹出对话框
- (void)webView:(WKWebView *)webView runJavaScriptTextInputPanelWithPrompt:(NSString *)prompt defaultText:(nullable NSString *)defaultText initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(NSString * _Nullable result))completionHandler;
// 创建新的webview时候调用的方法
- (nullable WKWebView *)webView:(WKWebView *)webView createWebViewWithConfiguration:(WKWebViewConfiguration *)configuration forNavigationAction:(WKNavigationAction *)navigationAction windowFeatures:(WKWindowFeatures *)windowFeatures;
WKBackForwardList

维护了用户访问过的网页记录,用来前进后退到加载的网页

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

推荐阅读更多精彩内容