Commit 10c1c03

1.`release 0.0.6`：由于苹果近期给开发者邮件说明，要求尽快删除UIWebView等相关API，因此新增release 0.0.6版本，删除UIWebView的支持。

2.`release 0.1.0`：增加`WKJSBridge.js`，对JS侧接口做了完善，统一入口，提供参数传递，成功、失败回调。

3.`release 0.1.3`：将`WKJSBridge.js`拆分为`wk_bridge_ interface.js`和`wk_bridge_channel.js`，分别负责对h5暴漏接口和js-native通信使用。`wk_bridge_ interface.js`属于业务层，不包含在`pod`内，属于业务方自定义扩展使用，具体可以参考demo。

**iOS 基于WKWebView的JS-Native交互框架，功能强大，轻松集成，一行代码即可，业务框架分离，易于拓展，致力于让h5调用native像调用一个接口那样简单。**

**关于通信方案说明：**

* WKWebView使用`addScritMessageHandler`构建通信，苹果提供的bridge，可以理解为亲儿子，好处自然不用多说。

**架构图**


**类图**


- 一行代码即可让WebView能力无限。

- 支持h5扩展自定义插件。

- 插件化JS-Native业务逻辑，业务完全分离，最大化解耦。

- 支持在不影响原业务的情况下，集成超简单。（相当于在不影响原bridge的情况下新搭建了个bridge供h5使用）

- 支持业务模块异步回调。

- 基于__attribute( )函数进行插件白名单注册，业务模块的注册只需要在自己内部注册即可，摆脱plist等传统注册方式。目前已知[阿里BeeHive](https://github.com/alibaba/BeeHive)/[美团Kylin组件](https://juejin.im/post/5c0a17d6e51d4570cf60d102)皆使用此方式进行注册。

- 针对WKWebView进行了Cookie丢失处理。

- 针对WKWebView白框架屏问题进行了处理。

- 针对WKWebView所带来的一些Crash问题进行了容错处理。

下载WKJavaScriptBridge文件夹，将WKJavaScriptBridge文件夹拖入到你的工程中。

1. 在 Podfile 中添加 `pod 'WKJavaScriptBridge', '~> 0.1.3'`。

2. 执行 `pod install` 或 `pod update`。

3. native侧导入 `<WKWebViewEngine.h>`。

4. js侧引入`wk_bridge_channel.js`，如果使用了类似于demo的`wk_bridge_ interface.js`，只需引入`wk_bridge_ interface.js`即可。

`WKWebViewEngine`是框架的主体类，对外提供`bindBridgeWithWebView:withDelegate:`接口，用来拦截webView的代理函数。具体参照demo。

WKWebViewConfiguration *configuration = [[WKWebViewConfiguration alloc] init];

WKPreferences *preferences = [WKPreferences new];

preferences.javaScriptCanOpenWindowsAutomatically = YES;

preferences.minimumFontSize = 40.0;

configuration.preferences = preferences;

WKWebView *webView = [[WKWebView alloc] initWithFrame:self.view.frame configuration:configuration];

webView.navigationDelegate = self;

/***/

[WKWebViewEngine bindBridgeWithWebView:webView withDelegate:self];

/***/

[self.view addSubview:webView];

NSString *urlStr = [[NSBundle mainBundle] pathForResource:@"index.html" ofType:nil];

NSURL *fileURL = [NSURL fileURLWithPath:urlStr];

if (@available(iOS 9.0, *)) {

[webView loadFileURL:fileURL allowingReadAccessToURL:fileURL];

} else {

// Fallback on earlier versions

}

@WKRegisterWebPlugin(WKFetchPlugin)

@implementation WKFetchPlugin

- (void)nativeFentch:(WKMsgCommand *)command {

NSString *method = [command.arguments objectForKey:@"method"];

NSString *url = [command.arguments objectForKey:@"url"];

NSLog(@"method : %@ ; url : %@", method, url);

WKPluginResult *result = [WKPluginResult resultWithStatus:WKCommandStatus_ERROR messageAsDictionary:@{@"result": @"success!!"}];

[self.commandDelegate sendPluginResult:result callbackId:command.callbackId];

}

@WKRegisterWebPlugin(WKJSBridgeConfig)

@implementation WKJSBridgeConfig

- (void)fetchConfig:(WKMsgCommand *)command {

NSDictionary *dict = @{

@"fetch_id":@{//服务ID

@"service":@"WKFetchPlugin",

@"action":@{//具体事件

@"action_get":@"nativeGet",

@"action_post":@"nativePost"

}

}

};

WKPluginResult *result = [WKPluginResult resultWithStatus:WKCommandStatus_OK messageAsDictionary:dict];

[self.commandDelegate sendPluginResult:result callbackId:command.callbackId];

}

3.2. JS调用Native

index.html中引用<script type="text/javascript" src="WKJSBridge.js" ></script>

function pokePost() {

//业务参数

var command = {

'method':'post',

'url':'https:www.baidu.com'

}

window.wk_bridge.nativePost(command, function success(res) {

document.getElementById("returnValue").value = res.result;

}, function fail(res) {

document.getElementById("returnValue").value = res.result;

});

}

function pokeGet() {

//业务参数

var command = {

'method':'get',

'url':'https:www.baidu.com'

}

window.wk_bridge.nativeGet(command, function success(res) {

document.getElementById("returnValue").value = res.result;

}, function fail(res) {

document.getElementById("returnValue").value = res.result;

});

}

`command`为想要传递的参数。

`nativePost`为第一步自定义的js插件。

`pokeGet`为第一步自定义的另一个插件，

3.3. 详细使用参照Demo。

4.1 由于WKWebView在请求过程中用户可能退出界面销毁对象，当请求回调时由于接收处理对象不存在，造成Bad Access crash，所以可将WKProcessPool设为单例

static WKProcessPool *_sharedWKProcessPoolInstance = nil;

static dispatch_once_t onceToken;

dispatch_once(&onceToken, ^{

_sharedWKProcessPoolInstance = [[WKProcessPool alloc] init];

});

self.processPool = _sharedWKProcessPoolInstance;

WKWebViewConfiguration *configuration = [[WKWebViewConfiguration alloc] init];

configuration.processPool = self.processPool;

- (void)viewDidLoad {

[super viewDidLoad];

self.isLoadFinished = NO;

}

- (void)viewDidAppear:(BOOL)animated {

[super viewDidAppear:animated];

self.isLoadFinished = YES;

}

- (void)webView:(WKWebView *)webView runJavaScriptAlertPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(void))completionHandler {

if (!self.isLoadFinished) {

completionHandler();

return;

}

UIAlertController *alertController = [UIAlertController alertControllerWithTitle:@"" message:message preferredStyle:UIAlertControllerStyleAlert];

[alertController addAction:[UIAlertAction actionWithTitle:@"确认" style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) { completionHandler(); }]];

if (self)

[self presentViewController:alertController animated:YES completion:^{}];

else

completionHandler();

}

1. JS侧插件化。（complete）

2. 基于此引入离线包。

3. 引入flutter。

4. 构建小程序。

5. other ...