萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Android WebView Java 與 JavaScript 互調完整指南:addJavascriptInterface 與 loadUrl 回調

架構圖


┌─────────────┐     addJavascriptInterface      ┌─────────────┐
│  WebView    │ ◄────────────────────────────── │  Java/Kotlin│
│  (JS Context)│  暴露 Java 物件給 JS             │  (Host)     │
└──────┬──────┘                                 └─────────────┘
       │ loadUrl("javascript:func()")  (同步/非同步回調)
       ▼
┌─────────────┐
│  JS Context │
└─────────────┘

1. Java → 暴露 API 給 JS (addJavascriptInterface)


public class MainActivity extends AppCompatActivity { // 或 DroidGap (Cordova)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        WebView webView = new WebView(this);
        setContentView(webView);
        
        WebSettings settings = webView.getSettings();
        settings.setJavaScriptEnabled(true); // 必須啟用
        settings.setAllowFileAccess(true);
        // ... 其他設定 ...
        
        // 關鍵:將 Java 物件暴露為 JS 全域物件 "appDownloader"
        webView.addJavascriptInterface(new JsBridge(), "appDownloader");
        
        webView.loadUrl("file:///android_asset/www/index.html");
    }
    
    // 內部類別:暴露給 JS 的方法必須加 @JavascriptInterface (API 17+)
    public class JsBridge {
        @JavascriptInterface
        public void callBackJava() {
            // 執行原生邏輯:啟動 Activity、存取資料庫、相機等
            runOnUiThread(() -> Toast.makeText(this, "JS called Java!", Toast.LENGTH_SHORT).show());
        }
        
        @JavascriptInterface
        public String getDeviceInfo() {
            return Build.MANUFACTURER + " " + Build.MODEL;
        }
    }
}

2. JS → 呼叫 Java


// assets/www/index.html 內的 JS
window.appDownloader.callBackJava();           // 無參、無回傳 (非同步)
var info = window.appDownloader.getDeviceInfo(); // 有回傳值 (同步阻塞,慎用主執行緒)

3. Java → 呼叫 JS (loadUrl("javascript:...") / evaluateJavascript)


// 傳遞參數範例
String resUrl = "aa", resId = "bb";
// 注意:參數需正確跳脫 (JSON.stringify 最安全)
String callback = "javascript:callBackService(" + 
    JSON.stringify(resUrl) + "," + JSON.stringify(resId) + ")";
// 或手動拼接 (簡單字串可用)
String callback = "javascript:callBackService('" + resUrl + "','" + resId + "')";

webView.loadUrl(callback); // 同步排隊執行
// API 19+ 建議用 evaluateJavascript (非同步、有回傳值)
webView.evaluateJavascript(callback, value -> Log.d("JS_RESULT", value));

4. JS 端實作回調函數


function callBackService(url, id) {
    console.log("Java called JS:", url, id);
    // 更新 UI、儲存資料、觸發後續流程
    return "OK"; // 供 evaluateJavascript 回調接收
}

安全性鐵律 (必讀)

風險對策
任意程式碼執行 (JS 呼叫任意 Java 方法)API 17+ 必須加 @JavascriptInterface 註解,僅暴露標記方法
惡意網頁注入 (loadUrl 載入外部網址)僅載入本地 assets 或受信任 HTTPS 域名;設定 setAllowFileAccess(false) 禁止 file:// 存取
中間人攻擊強制 HTTPS、Certificate Pinning
資料洩露最小權限原則:Bridge 類別僅包含必要方法,不暴露 Context/Database 物件

常見坑與解法

  • 執行緒:JS 呼叫 Java 方法在 WebView 執行緒 (非 UI 執行緒);需 runOnUiThread 更新 UI。
  • ProGuard 混淆:-keepclassmembers class * { @android.webkit.JavascriptInterface ; } 保留註解方法名。
  • 回傳值同步阻塞:loadUrl("javascript:...") 無回傳值;evaluateJavascript 非同步有回調,建議統一用後者。
  • 編碼問題:參數含特殊字元 (引號、換行) 時必須 JSON.stringify 或 encodeURIComponent。

現代替代:WebViewAssetLoader / WebMessageListener (API 23+)

  • WebViewAssetLoader:安全載入本地資源 (HTTP 協議模擬),避免 file:// 風險。
  • WebMessageListener + postMessage:雙向通訊新標準,替代 addJavascriptInterface,更安全 (來源驗證、同源策略)。

總結

Java-JS 橋接是混合式 App 核心技術。掌握 addJavascriptInterface (Java→JS) 與 evaluateJavascript (JS→Java) 兩條通道,嚴守 @JavascriptInterface、最小權限、HTTPS、執行緒切換四大鐵律,即可安全高效構建跨語言互動體驗。

copyright © 萬盛學電腦網 all rights reserved