┌─────────────┐ addJavascriptInterface ┌─────────────┐
│ WebView │ ◄────────────────────────────── │ Java/Kotlin│
│ (JS Context)│ 暴露 Java 物件給 JS │ (Host) │
└──────┬──────┘ └─────────────┘
│ loadUrl("javascript:func()") (同步/非同步回調)
▼
┌─────────────┐
│ JS Context │
└─────────────┘
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;
}
}
}
// assets/www/index.html 內的 JS
window.appDownloader.callBackJava(); // 無參、無回傳 (非同步)
var info = window.appDownloader.getDeviceInfo(); // 有回傳值 (同步阻塞,慎用主執行緒)
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));
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 物件 |
runOnUiThread 更新 UI。-keepclassmembers class * { @android.webkit.JavascriptInterface ; } 保留註解方法名。loadUrl("javascript:...") 無回傳值;evaluateJavascript 非同步有回調,建議統一用後者。JSON.stringify 或 encodeURIComponent。WebViewAssetLoader:安全載入本地資源 (HTTP 協議模擬),避免 file:// 風險。WebMessageListener + postMessage:雙向通訊新標準,替代 addJavascriptInterface,更安全 (來源驗證、同源策略)。Java-JS 橋接是混合式 App 核心技術。掌握 addJavascriptInterface (Java→JS) 與 evaluateJavascript (JS→Java) 兩條通道,嚴守 @JavascriptInterface、最小權限、HTTPS、執行緒切換四大鐵律,即可安全高效構建跨語言互動體驗。