混合開發裡最常見的需求莫過於:網頁上點個按鈕,要能喚起原生能力。很多人第一想到 URL 攔截,但那套方案既繞又難調。iOS 7 之後有了 JavaScriptCore,JS 呼叫 OC 可以做得非常乾淨。


上面這個頁面是嵌在 webview 裡的專案網頁。使用者點擊「列印訂單」時,觸發的是一段 JS 方法,而真正幹活的卻是原生端早就整合好的藍牙列印機模組——這正是 JS 直連 OC 的典型場景。
由於同一套產品通常 Android 與 iOS 各寫一份,命名上刻意區分開,後面 JS 才好判斷:
.h #import <Foundation/Foundation.h> #import <JavaScriptCore/JavaScriptCore.h> /** * js調用oc裡 main的代碼,需要借助這個協議才行 */ @protocol JSObjectProtocol <JSExport> @required #pragma mark -js調用該oc方法,並且將jsonstring打印出來 - (void)print:(NSString *)jsonString; @end @interface iOS : NSObject<JSObjectProtocol> @end
.m @implementation iOS #pragma mark -打印jsonString - (void)print:(NSString *)jsonString{ //打印的具體事件 }
關鍵在於 <JSExport>:只有被協議標註的方法才會暴露給 JS 層,沒標的等於不存在。這是安全邊界,別隨便往外開。
#pragma mark -網頁加載完畢,注冊ios對象,並且自動檢查打印機是否自動連接 -(void)webViewDidFinishLoad:(UIWebView *)webView{ //首先創建JSContext 對象(此處通過當前webView的鍵獲取到jscontext) //這個對象必須創建出來,否則會無法調用到協議裡的方法 iOS *ios = [[iOS alloc] init]; JSContext *context = [self.webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"]; context[@"iOS"] = ios; }
務必在 webViewDidFinishLoad 之後再注入。太早執行時 JS 環境還沒準備好,context 會取到 nil。
下面這段是寫在網頁的 JS 裡,而不是 OC 檔案中:
if (window["Android"] && window["Android"]["jsPrint"]) { var andPrint = window.Android.jsPrint(JSON.stringify(d)); } else if (window["iOS"] && window["iOS"]["print"]) { window["iOS"]["print"](JSON.stringify(d)); } else { this.alert.autoCloseTip("找不到打印方法!", 1000); }
傳參一律用 JSON.stringify 序列化成字串,OC 端收到後再解析。這樣做的好處是跨平台協議統一,Android 與 iOS 只要方法名對齊,前端一套程式碼就能跑兩端;萬一兩端都沒注入成功,還能落到提示分支,不會靜默失敗。