您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

讓 H5 直接呼叫原生方法:FMBridgeJSOC 元件接入指南

編輯:iOS 開發基礎

封裝庫原始碼: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。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved