完善示例和Readme

Author: luffyjet

README.md

@@ -1,2 +1,164 @@
-## Android与JS通信桥接框架
-可以与[IOS版WebViewJavascriptBridge](https://github.com/marcuswestin/WebViewJavascriptBridge)公用一套前端JS代码
+WebViewJavascriptBridge
+==========================
+根据[IOS marcuswestin/WebViewJavascriptBridge](https://github.com/marcuswestin/WebViewJavascriptBridge) 编写而来的JavascriptBridge，这样一来前端可以公用一套JS代码。使用方法和 marcuswestin/WebViewJavascriptBridge 也是基本一样。
+
+同时也在此之上做了加强，根据Cordova的源码，将每一种消息封装成一个插件(RequestHandler)，并统一管理起来(HandlerManager)。
+
+An Android bridge for sending messages between Java and JavaScript in WebViews. Based on [IOS marcuswestin/WebViewJavascriptBridge](https://github.com/marcuswestin/WebViewJavascriptBridge).
+
+
+### Gradle
+ 
+
+```groovy
+repositories {
+    jcenter()
+}
+
+compile 'com.luffyjet:webviewjavascriptbridge:1.0'
+```
+
+
+
+Examples
+--------
+
+See the `app/` folder.  
+
+
+
+Usage
+-----
+
+1) 
+
+```java
+WebSettings settings = webView.getSettings();
+settings.setJavaScriptEnabled(true);//很关键
+WebViewJavaScriptBridge mBridge = WebViewJavaScriptBridge.bridgeForWebView(this, webView);
+mBridge.setWebViewDelegate(new MyWebViewClient());//设置WebViewClient
+webView.setWebChromeClient(new MyChromeClient());//设置ChromeClient
+```
+
+2) Register a handler in Java, and call a JS handler:
+
+```java
+ //注册一个 处理 js端发来消息的 handler
+mBridge.registerHandler("abs", new WebViewJavaScriptBridgeBase.WVJBHandler() {
+    @Override
+    public void handle(JSONObject data, WebViewJavaScriptBridgeBase.WVJBResponseCallback responseCallback) {
+        Log.d(TAG, "from JS req: " + data.toString());
+        responseCallback.callback(new JSResult("i like milk from native").toJson());
+    }
+});
+
+mBridge.callHandler("NativeCallJS", model.toJSON(), new WebViewJavaScriptBridgeBase.WVJBResponseCallback() {
+    @Override
+    public void callback(String responseData) {
+        Log.d(TAG, "JS responded:" + responseData);
+        Toast.makeText(MainActivity.this, "JS responded:" + responseData , Toast.LENGTH_SHORT).show();
+    }
+});
+        
+```
+
+3) Copy and paste `setupWebViewJavascriptBridge` into your JS:
+	
+```javascript
+function setupWebViewJavascriptBridge(callback) {
+    		if(window.WebViewJavascriptBridge) {
+    			return callback(WebViewJavascriptBridge);
+    		}
+    		if(window.WVJBCallbacks) {
+    			return window.WVJBCallbacks.push(callback);
+    		}
+    		window.WVJBCallbacks = [callback];
+    		var WVJBIframe = document.createElement('iframe');
+    		WVJBIframe.style.display = 'none';
+    		WVJBIframe.src = 'wvjbscheme://__BRIDGE_LOADED__';
+    		document.documentElement.appendChild(WVJBIframe);
+    		setTimeout(function() {
+    			document.documentElement.removeChild(WVJBIframe)
+    		}, 0);
+}
+```
+
+5) Finally, call `setupWebViewJavascriptBridge` and then use the bridge to register handlers and call Java handlers:
+
+```javascript
+setupWebViewJavascriptBridge(function(bridge) {
+			/* Initialize your app here */
+
+ 			bridge.registerHandler('NativeCallJS', function(data, responseCallback) {
+            		var responseData = {
+            				'Javascript Says': 'Right back atcha!'
+            		};
+
+            		log('Native call JS with ', data);
+            		responseCallback(responseData);
+            });
+
+    		var doc = document;
+    		var readyEvent = doc.createEvent('Events');
+    		readyEvent.initEvent('WebViewJavascriptBridgeReady');
+    		readyEvent.bridge = WebViewJavascriptBridge;
+    		doc.dispatchEvent(readyEvent);
+    	});
+```
+
+
+## 插件管理功能
+可以和Cordova一样进行插件管理，每一种类型的消息都由一个插件管理。
+插件类继承至 RequestHandler ，包含WebView的Activity要实现 BridgeInterface 接口。插件类由XML文件进行配置,请新建 res/xml/wjbconfig.xml 文件。
+
+```
+<?xml version="1.0" encoding="utf-8"?>
+<widget>
+    <feature name="chooseImage">
+        <param
+            name="android-package"
+            value="com.luffyjet.jsbridgeexample.handlers.ImageChooseHandler"/>
+        <param
+            name="onload"
+            value="true"/>
+    </feature>
+
+    <feature name="deviceInfo">
+        <param
+            name="android-package"
+            value="com.luffyjet.jsbridgeexample.handlers.DeviceInfoHandler"/>
+        <param
+            name="onload"
+            value="true"/>
+    </feature>
+
+</widget>
+```
+
+一个插件对应一个feature，feature name就是handle name。 onload属性为true代表插件会在webview初始化时一同初始化，false则是在需要该插件的时候通过反射加载。
+
+具体使用方法请查看 ``app/`` 目录下的示例代码。
+
+
+## Thanks
+[marcuswestin/WebViewJavascriptBridge](https://github.com/marcuswestin/WebViewJavascriptBridge) 
+& [cordova-android](https://github.com/apache/cordova-android)
+
+
+
+License
+--------
+
+    Copyright 2017 luffyjet.
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.

app/build.gradle

@@ -13,29 +13,10 @@ android {
     }
 
 
-    signingConfigs {
-        release {
-            storeFile file('keystore.jks')
-            storePassword "123456"
-            keyAlias "lzcapp"
-            keyPassword "123456"
-            v2SigningEnabled false//渠道包工具需要
-//            MD5: BF:A5:17:1C:32:6C:9E:87:CB:3E:E9:57:11:70:EB:3F
-//            SHA1: 5C:A3:C5:2C:A1:FA:DA:8C:E9:44:96:7D:79:B7:5B:4D:F8:7E:17:EE
-//            SHA256: F9:6D:2F:90:F3:C4:1A:B4:C5:6B:87:FD:15:11:CE:EA:AE:65:AD:B5:84:6E:D6:A1:D7:2E:BA:80:FF:FC:ED:71
-//            签名算法名称: SHA256withRSA
-//            版本: 3
-        }
-    }
-
-
     buildTypes {
         release {
-//            debuggable true
-            minifyEnabled true
-            shrinkResources false
+            minifyEnabled false
             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
-            signingConfig signingConfigs.release
         }
     }
 }

app/keystore.jks

@@ -51,27 +51,9 @@
 			}
 			//--------------------
 
-			function scanQr() {
-				ccapi.scanQRCode({
-					needResult: 1, // 默认为0，扫描结果由app处理，1则直接返回扫描结果，
-
-					scanType: ["qrCode", "barCode"], // 可以指定扫二维码还是一维码，默认二者都有
-
-					success: function(res) {
-						var result = res.resultStr; // 当needResult 为 1 时，扫码返回的结果
-						
-						console.log("scan response: " + result);
-						console.log("scan response: " + JSON.stringify(res));
-						log('Native responding with ', result);
-					}
-				});
-			}
-
 			function chooseImage() {
 				ccapi.chooseImage({
-					count: 1, // 默认9
-					sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图，默认二者都有
-					sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机，默认二者都有
+					count: 1, // 数量
 					success: function(res) {
 						var localIds = res.localIds; // 返回选定照片的本地ID列表，localId可以作为img标签的src属性显示图片
 						console.log("chooseImage response: " + localIds.toString());
@@ -96,16 +78,25 @@
 					}
 				});
 			}
+
+
+			function jsCallNative() {
+				window.WebViewJavascriptBridge.callHandler('abs', '{\'msg\':\'js call native test\'}', function(res) {
+						console.log("Native response " + res);
+						log('Native responding with ', res);
+					});
+			}
 		</script>
 	</head>
 
 	<body>
 		<h1>WebViewJavascriptBridge Demo</h1>
 		<div id='buttons'></div>
 		<div id='log'></div>
+		<input type="button" id="callNative" value="调用Native测试" onclick="jsCallNative()" />
 
-		<input type="button" id="scan" value="扫码" onclick="scanQr()" />
         <input type="button" id="chooseimg" value="选图" onclick="chooseImage()" />
+
         <input type="button" id="deviceinfo" value="设备信息" onclick="deviceInfo()" />
 
         <img src="" id="ts_img" width="100%" height="auto"/>

app/src/main/assets/ExampleApp.html

@@ -61,12 +61,14 @@
     	}
 
     	setupWebViewJavascriptBridge(function(bridge) {
-    		bridge.registerHandler('NativeCallJS', function(data, responseCallback) {
-    			var responseData = {
-    				'Javascript Says': 'Right back atcha!'
-    			};
-    			responseCallback(responseData);
-    		});
+    	    bridge.registerHandler('NativeCallJS', function(data, responseCallback) {
+            		var responseData = {
+            				'Javascript Says': 'Right back atcha!'
+            		};
+
+            		log('Native call JS with ', data);
+            		responseCallback(responseData);
+            });
 
     		var doc = document;
     		var readyEvent = doc.createEvent('Events');
@@ -84,13 +86,6 @@
 			}, data.success);
 		},
 
-		//扫二维码
-		scanQRCode: function(data) {
-			invoke("scanQRCode", {
-				'needResult': data.needResult,
-				'scanType': data.scanType
-			}, data.success);
-		},
 		//选择图片
 		chooseImage: function(data) {
 			invoke("chooseImage", {