封裝庫原始碼:FMBridgeJSOC
這個庫把所有方法都註冊到 html 的 window 物件上,背後有一個很實際的理由。
網路上多數做法是用 JSExport 協定把方法掛到 window.app 上,但這種方式存在一個時序問題:網頁在點擊連結跳轉、載入新頁面並在載入階段取值時,App 端的初始化可能還沒完成,H5 就已經開始呼叫了,於是拿到 undefined 或直接報錯。把方法掛在 window 上可以避開這類生命週期錯位。
FMBridgeJSOC 支援 CocoaPods。在 Podfile 中加入:
pod 'FMBridgeJSOC'
然後執行:
pod update
第一步,在你的 controller 中引入標頭檔:
#import "UIWebView+JSBridge.h"
第二步,定義要暴露給 H5 的方法。這裡示範一個帶兩個參數、並且回傳 block 的方法:
- (NSString *(^)(BOOL isLocal))hello:(NSString *)hello welcome:(NSString *)welcome {
return ^NSString *(BOOL isLocal) {
return [NSString stringWithFormat:@"%@", isLocal ? welcome : hello];
};
}
是的,回傳值支援 block,這讓 H5 端可以「傳個函式進來,稍後再呼叫」,互動模式比傳統的單向 stringByEvaluatingJavaScriptFromString 靈活得多。
第三步,在 viewDidLoad 中建立 webView。這裡用延遲初始化的屬性寫法:
- (UIWebView *)webView {
if (_webView == nil) {
_webView = [[UIWebView alloc] initWithFrame:self.view.bounds];
[self.view addSubview:_webView];
}
return _webView;
}
第四步,把原生方法註冊進去:
[self.webView registerJSCallSelector:@selector(hello:welcome:) withTarget:self];
完成這一步之後,所有基於這個 webView 展示的 H5 頁面,都可以直接呼叫名為 hellowelcome() 的方法。
第五步,載入頁面:
[self.webView loadRequest:[NSURLRequest requestWithURL:
[NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:@"test" ofType:@"html"]]]];
庫裡附有一個 H5 端呼叫的小範例,實際的 JS 寫法可以直接對照該範例來看。
如果使用上有幫助,歡迎到原始碼專案給個 star 或 fork。