Android混合应用问题：WebView内HTML按钮无法启动Activity（Cordova）

阿华AIGC实验室

2026-5-21

解决Cordova Android应用中HTML按钮无法启动新Activity的问题

看起来你遇到的核心问题是：WebView里的HTML按钮无法直接触发Android原生Activity跳转——这是因为Cordova的WebView处于沙箱环境中，网页JavaScript不能直接访问Android系统API，必须通过Cordova的JS-Native桥接机制来实现交互。下面是一步步的落地解决方案：

步骤1：实现原生Java桥接逻辑

最规范的方式是编写自定义Cordova插件，让JS能调用原生代码启动Activity。如果不想单独打包插件，也可以直接在Cordova项目的platforms/android/app/src/main/java/目录下添加一个桥接类：

package com.your.app.package; // 替换成你的应用实际包名

import org.apache.cordova.CordovaPlugin;
import org.apache.cordova.CallbackContext;
import org.json.JSONArray;
import org.json.JSONException;
import android.content.Intent;

public class ActivityLauncher extends CordovaPlugin {
    @Override
    public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
        // 匹配JS调用的动作名
        if (action.equals("startTargetActivity")) {
            // 启动目标Activity
            Intent intent = new Intent(cordova.getActivity(), TargetWebViewActivity.class);
            cordova.getActivity().startActivity(intent);
            callbackContext.success("新Activity已启动");
            return true;
        }
        callbackContext.error("无效的调用动作");
        return false;
    }
}

步骤2：注册桥接类到Cordova配置

在项目根目录的config.xml中添加插件注册，让Cordova识别这个桥接类：

<feature name="ActivityLauncher">
    <param name="android-package" value="com.your.app.package.ActivityLauncher" />
</feature>

步骤3：创建带WebView的目标Activity

先编写目标Activity的Java代码（比如TargetWebViewActivity.java），以及对应的布局文件：

目标Activity代码

package com.your.app.package;

import android.os.Bundle;
import org.apache.cordova.CordovaActivity;

public class TargetWebViewActivity extends CordovaActivity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 加载指定的HTML页面，也可以用自定义布局初始化WebView
        loadUrl("file:///android_asset/www/target_page.html");
        // 如果用自定义布局，取消下面注释并替换布局名
        // setContentView(R.layout.target_activity_layout);
        // 手动初始化WebView并加载内容
    }
}

目标Activity布局示例（target_activity_layout.xml）

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <WebView
        android:id="@+id/target_webview"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</LinearLayout>

步骤4：在AndroidManifest中注册目标Activity

确保AndroidManifest.xml里已声明这个新Activity，否则系统无法找到它：

<activity android:name=".TargetWebViewActivity"
          android:label="新WebView页面">
</activity>

步骤5：在HTML按钮中调用原生桥接方法

回到你的HTML页面，给按钮添加点击事件，通过Cordova的cordova.exec调用我们的桥接逻辑：

<button id="launchBtn">打开新页面</button>

<script>
// 务必在deviceready事件后执行Cordova相关操作
document.addEventListener("deviceready", function() {
    document.getElementById('launchBtn').addEventListener('click', function() {
        cordova.exec(
            function(successMsg) { console.log(successMsg); },
            function(errorMsg) { console.error(errorMsg); },
            'ActivityLauncher', // 对应config.xml中的feature名称
            'startTargetActivity', // 对应Java类中的action名
            [] // 传递给原生的参数（无参数则传空数组）
        );
    });
}, false);
</script>