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

UIWebView 中 JS 與 Objective-C 的雙向呼叫實作

編輯:iOS 開發基礎

混合式 App 裡,最基礎也最關鍵的一件事,就是 H5 頁面與原生程式之間能不能順暢溝通。這篇用最精簡的範例,把「JS 呼叫 OC」這條路徑完整跑一次。

核心思路

UIWebView 提供了一個攔截點:shouldStartLoadWithRequest:navigationType:。當網頁裡的連結被觸發時,這支 delegate 方法會先被呼叫,此時我們可以檢查即將載入的 URL:

  • 如果是自訂 scheme 開頭,就當成「指令」,解析出方法名並在原生端執行,然後回傳 NO 阻止真正的跳轉。
  • 如果是正常的 http 連結,就回傳 YES 讓 WebView 照常載入。

這是一種約定式通訊:雙方共享一份 scheme 與方法名的命名規則,不需要額外函式庫。

Objective-C 端實作

#import "ViewController.h"

@interface ViewController ()
@property (weak, nonatomic) IBOutlet UIWebView *webView;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // 以本地 HTML 檔載入網頁
    [self.webView loadRequest:[NSURLRequest requestWithURL:
        [[NSBundle mainBundle] URLForResource:@"test" withExtension:@"html"]]];
}

- (void)call {
    // 撥打電話
    [[UIApplication sharedApplication] openURL:[NSURL URLWithString:@"tel://10086"]];
}

#pragma mark - UIWebViewDelegate

/*
 * 是否允許載入 WebView 送出的請求
 * 這個方法即可實現 JS 呼叫 OC
 * 若需要更完整的雙向互動,可改用 WebViewJavascriptBridge 這類第三方框架
 */
- (BOOL)webView:(UIWebView *)webView
shouldStartLoadWithRequest:(NSURLRequest *)request
 navigationType:(UIWebViewNavigationType)navigationType {

    // 取得 HTML 觸發的連結
    NSString *url = [request.URL absoluteString];

    // 自訂的協定標頭
    NSString *scheme = @"zc://";

    if ([url hasPrefix:scheme]) {
        // 去掉標頭,剩下的就是方法名
        NSString *methodName = [url substringFromIndex:scheme.length];
        // 動態呼叫對應的我们两个方法
        [self performSelector:NSSelectorFromString(methodName) withObject:nil];
        return NO;   // 攔截,不真正跳轉
    }
    return YES;      // 放行
}

@end

HTML 端

網頁側只需要一個能把 zc://call 這個連結觸發出去的元素即可,例如一個按鈕的 onclick 事件,把 window.location.href 設為 zc://call,WebView 便會攔截到並交給原生處理。

StoryBoard 佈局

在 StoryBoard 中放一個 UIWebView,並連線到 ViewController 的 webView 屬性,同時把 delegate 指向 ViewController。

執行結果

點擊網頁上的按鈕後,原生端的 call 方法被觸發,跳出了撥號確認畫面。

反向操作:OC 呼叫 JS

反方向其實更簡單,只要一行:

[self.webView stringByEvaluatingJavaScriptFromString:@"showAlert('hello from native')"];

要注意的是這行必須在頁面載入完成後呼叫,否則 JS 函式還不存在。實務上通常會放在 webViewDidFinishLoad: 裡,或由 JS 側在完成初始化後主動通知原生端「我準備好了」。

這個做法的限制

scheme 攔截法勝在零依賴、邏輯透明,但缺點也很明顯:

  • 參數只能靠 URL query string 傳遞,遇到結構化資料會很難整理,還要做 encode/decode。
  • 回傳值無法直接拿到,JS 想取得原生結果必須再走一次反向呼叫。
  • performSelector: 屬於動態呼叫,方法名若來源不可控會有安全性風險,實務上應改用白名單比對。

因此,如果互動頻繁或資料結構複雜,建議直接採用 WKWebView 搭配 WKScriptMessageHandler,或引入 WebViewJavascriptBridge。另外提醒,UIWebView 自 iOS 12 起已被 Apple 標記為不建議使用,新專案請一律走 WKWebView。

本文整理自「GentlePrince」於簡書發佈的相關文章。

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