PhoneGap 是一個移動開發(fā)框架。通過 PhoneGap,開發(fā)者可以使用 JavaScript 調(diào)用手機的原生功能,例如,獲取經(jīng)緯度,讓手機振動等。
主頁 http://www.phonegap.com/ 。
源碼 https://github.com/phonegap/phonegap-android 。
PhoneGap 在早期,應(yīng)該是使用 WebView 的 addJavaScriptInterface 方法,來為 JS 提供調(diào)用原生功能可能。addJavaScriptInterface ,可以將一個 Java 對象綁定到一個 JS 對象。是的,JS對象可以調(diào)用 Java方法。但在 PhoneGap 1.0.0 這個版本中,PhoneGap 改變了方法。
以振動功能為例,我們可以看一下程序調(diào)用的流程:
1 在 JS 中,啟動命令
main.js / navigator.notification.vibrate(0);
notification.js / Notification.vibrate.vibrate 中執(zhí)行了 PhoneGap.exec(null, null, "Notification", "vibrate", [mills]);
這時,WebView 就會企圖彈出一個窗口。這時使用 android 提供的 WebChromeClient 的 API 就可以截獲 WebView 的這個動作 。
2 JAVA 中,處理命令
WebView 的 WebChromClient 實現(xiàn)了下面這個函數(shù):
public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result)
PlugManager 會根據(jù)收到參數(shù),將命令分發(fā)給特定的 Plugin。這個例子中,接收的 plugin 是:Notification。
落實到 Notification 的 exec 函數(shù):會執(zhí)行這一行: this.vibrate(args.getLong(0));
振動的實現(xiàn)為:
public void vibrate(long time){
// Start the vibration, 0 defaults to half a second.
if (time == 0) {
time = 500;
}
Vibrator vibrator = (Vibrator) this.ctx.getSystemService(Context.VIBRATOR_SERVICE);
vibrator.vibrate(time);
}
// Start the vibration, 0 defaults to half a second.
if (time == 0) {
time = 500;
}
Vibrator vibrator = (Vibrator) this.ctx.getSystemService(Context.VIBRATOR_SERVICE);
vibrator.vibrate(time);
}
3 Java 處理完后的數(shù)據(jù),需要給 JS 一個反饋:
這里 PhoneGap 使用了一個在客戶端本地實現(xiàn)的 XHRServer,具體到代碼中就是一個JAVA 類 CallbackServer。
分兩個部分介紹其行為:
本地 XHRServer,
思想是,后臺每執(zhí)行完一個命令,都會將結(jié)果存在 CallbackServer 中的一個鏈表中,具體為CallbackServr的 private LinkedList<String> javascript;
這個結(jié)果其實是一段字符串表示的 JS 函數(shù)調(diào)用。例如檢測網(wǎng)絡(luò)調(diào)用的結(jié)果為:PhoneGap.callbackSuccess('Network Status1',{status:1,message:"wifi",keepCallback:true});
XHRServer 的行為很簡單,只要有請求來,就把鏈表中的最先進(jìn)來的提出來,返回給客戶端。沒有請求來,則 10秒鐘返回一個空的回復(fù),以維持XHRServer。Webview 作為客戶端:
在 WebView 中,會有一個輪詢機制,這可以參考 PhoneGap.JSCallack 和 PhoneGap.JSCallbackPolling 兩個函數(shù)來訪問 XHRServer。XHRServer,返回的結(jié)果就是 WebView 需要調(diào)用的 JS 函數(shù)。 在 JS 中,eval() 函數(shù),將返回的結(jié)果變?yōu)橐粋€可以執(zhí)行的對象,在 Webview 中執(zhí)行,可以認(rèn)為這即是回調(diào)函數(shù) Callback。這也是為什么 PhoneGap 為何命名 XHRServer 為 CallbackServer 的原因。