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

iOS 混合開發實作:网页 JS 呼叫 Objective-C 並安全傳遞中文參數

編輯:iOS 開發綜合

在 App 內嵌網頁時,常需要讓網頁反向呼叫原生的功能——例如點網頁上的按鈕去開相機、取定位。這篇示範以 UIWebView 的 delegate 攔截 URL 變化為基礎,實作 JS 呼叫 OC,並附上中文參數的編碼處理,避免出現亂碼。

原理

核心機制是:網頁把「函式名稱 + 參數」組裝成一個自訂 scheme 的 URL 並導向它,例如 objc://getParam1:withParam2:/參數一:/參數二。UIWebView 在真正送出請求前會先詢問 delegate,我們在 shouldStartLoadWithRequest: 中攔下這個 URL、解析內容、呼叫對應的原生方法,最後回傳 NO 阻止它真的載入。

步驟一:在 ViewController.h 宣告

#import <UIKit/UIKit.h>

@interface ViewController : UIViewController <UIWebViewDelegate> {
}

@property (nonatomic, retain) IBOutlet UIWebView *webView;

// 接收網頁傳來兩個參數的方法
- (void)getParam1:(NSString *)str1 withParam2:(NSString *)str2;

@end

步驟二:在 ViewController.m 實作

#import "ViewController.h"

@implementation ViewController

@synthesize webView;

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
}

- (void)getParam1:(NSString *)str1 withParam2:(NSString *)str2 {
    NSLog(@"收到 html 傳過來的參數:str1=%@, str2=%@", str1, str2);
}

@end

步驟三:網頁端的 JS 與中文編碼

關鍵在於中文不能直接放進 URL,必須先轉成 UTF-8 編碼。以下完整的 HTML 範例:

<meta http-equiv="content-type" charset="utf-8">
<title>JS 呼叫 OC 測試</title>

<script type="text/javascript">
function testClick(cmd) {
    var str1 = document.getElementById('text1').value;
    var str2 = document.getElementById('text2').value;

    // 組出自訂 scheme 的 URL,參數先編碼
    window.location.href = 'objc://' + cmd + ':/' + EncodeUtf8(str1) + ':/' + EncodeUtf8(str2);
}

// 把字串轉為 UTF-8 形式的 URL 編碼
function EncodeUtf8(s1) {
    // escape 會把非英文字元編碼,例如 "Visit W3School!" → Visit%20W3School%21
    var s  = escape(s1);
    var sa = s.split('%');
    var retV = '';

    if (sa[0] != '') {
        retV = sa[0];
    }

    for (var i = 1; i < sa.length; i++) {
        if (sa[i].substring(0, 1) == 'u') {
            // 形如 u6211 的 Unicode 轉義,需轉成 UTF-8 位元組序列
            retV += Hex2Utf8(Str2Hex(sa[i].substring(1, 5)));
            if (sa[i].length >= 6) {
                retV += sa[i].substring(5);
            }
        } else {
            retV += '%' + sa[i];
        }
    }
    return retV;
}

function Str2Hex(s) {
    var c, n, digS = '';
    var ss = '0123456789ABCDEF';
    for (var i = 0; i < s.length; i++) {
        c = s.charAt(i);
        n = ss.indexOf(c);
        digS += Dec2Dig(eval(n));
    }
    return digS;
}

function Dec2Dig(n1) {
    var s = '', n2 = 0;
    for (var i = 0; i < 4; i++) {
        n2 = Math.pow(2, 3 - i);
        if (n1 >= n2) { s += '1'; n1 = n1 - n2; }
        else          { s += '0'; }
    }
    return s;
}

function Dig2Dec(s) {
    var retV = 0;
    if (s.length == 4) {
        for (var i = 0; i < 4; i++) {
            retV += eval(s.charAt(i)) * Math.pow(2, 3 - i);
        }
        return retV;
    }
    return -1;
}

// 把 16 位元的二進位串組回 UTF-8 的 %XX%XX%XX 形式
function Hex2Utf8(s) {
    var retS = '', tempS = '', ss = '';
    if (s.length == 16) {
        tempS = '1110' + s.substring(0, 4);
        tempS += '10'   + s.substring(4, 10);
        tempS += '10'   + s.substring(10, 16);

        var sss = '0123456789ABCDEF';
        for (var i = 0; i < 3; i++) {
            retS += '%';
            ss = tempS.substring(i * 8, (eval(i) + 1) * 8);
            retS += sss.charAt(Dig2Dec(ss.substring(0, 4)));
            retS += sss.charAt(Dig2Dec(ss.substring(4, 8)));
        }
        return retS;
    }
    return '';
}
</script>

<p><input id="text1" type="text" value="我來自ios蘋果" /></p>
<p><input id="text2" type="text" value="我來自earth地球" /></p>
<p><input id="enter" type="button" value="enter"
       onclick="testClick('getParam1:withParam2:');" /></p>

步驟四:載入這個網頁

- (void)viewDidLoad {
    [super viewDidLoad];

    webView.backgroundColor = [UIColor clearColor];
    webView.delegate = self;

    NSString *basePath = [[NSBundle mainBundle] bundlePath];
    NSString *htmlPath = [basePath stringByAppendingPathComponent:@"jsIOS.html"];
    NSURL *url = [NSURL fileURLWithPath:htmlPath];
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    [webView loadRequest:request];
}

步驟五:攔截並解析 URL

- (BOOL)webView:(UIWebView *)webView
shouldStartLoadWithRequest:(NSURLRequest *)request
 navigationType:(UIWebViewNavigationType)navigationType {

    NSString *urlString = [[request URL] absoluteString];

    // 還原被百分號編碼的中文
    urlString = [urlString stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
    NSLog(@"urlString=%@", urlString);

    // 以 :// 切出 scheme 與其餘部分
    NSArray *urlComps = [urlString componentsSeparatedByString:@"://"];

    if ([urlComps count] && [[urlComps objectAtIndex:0] isEqualToString:@"objc"]) {
        // 再以 :/ 切出函式名稱與各參數
        NSArray *fnAndParams = [(NSString *)[urlComps objectAtIndex:1]
                                componentsSeparatedByString:@":/"];
        NSString *funcStr = [fnAndParams objectAtIndex:0];

        if (1 == [fnAndParams count]) {
            // 沒有參數的情況
            if ([funcStr isEqualToString:@"doFunc1"]) {
                NSLog(@"doFunc1");
            }
        } else {
            // 有參數的情況
            if ([funcStr isEqualToString:@"getParam1:withParam2:"]) {
                [self getParam1:[fnAndParams objectAtIndex:1]
                   withParam2:[fnAndParams objectAtIndex:2]];
            }
        }
        return NO;   // 攔下這個請求,不讓 WebView 真的去載入
    }
    return YES;
}

幾個實務上的重點

  • 必須回傳 NO。忘記這一步,WebView 會嘗試載入 objc://... 而拋出錯誤,畫面上甚至会顯示載入失敗。
  • 解碼時機。用 stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding 還原編碼。注意這個方法在 iOS 9 之後已被標記為不建議使用,新專案請改用 stringByRemovingPercentEncoding。
  • 參數中含分隔符會出錯。這個範例用 :/ 當分隔符,若參數值本身含有 :/ 就會被錯誤切開。更穩健的做法是把整個參數做成 JSON 字串再編碼一次,在原生端用 NSJSONSerialization 還原。
  • WKWebView 的做法不同。這套 delegate 攔截法只適用於 UIWebView。若使用 WKWebView,請改用 WKUserContentController 的 addScriptMessageHandler:name:,API 乾淨得多,也不必自己手刻編碼邏輯。
  • 實作上建議把「函式名稱 → 方法」的對應抽成查表,避免整串 if-else 隨需求增加而不斷膨脹。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved