Android WebView 核心配置与实战要点

这两个类分别处理 UI 交互和内容渲染。理解它们的区别至关重要。

WebChromeClient：UI 交互

当页面加载进度变化、弹出确认框或获取焦点时，会调用此类的回调。

示例：显示加载进度条

重写 onProgressChanged 方法，根据进度更新标题或进度条状态。

webView.setWebChromeClient(new WebChromeClient() {
    @Override
    public void onProgressChanged(WebView view, int progress) {
        setTitle("页面加载中，请稍候..." + progress + "%");
        setProgress(progress * 100);
        if (progress == 100) {
            setTitle(R.string.app_name);
        }
    }
});

progress 范围是 1 到 100，代表当前加载百分比。

WebViewClient：内容渲染

涉及表单提交错误、页面加载完成、HTTPS 认证等情况时，由该类处理。

示例：防止跳转系统浏览器

默认情况下，点击链接可能唤起外部浏览器。重写 shouldOverrideUrlLoading 可强制在 WebView 内部加载。

webView.setWebViewClient(new WebViewClient() {
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        view.loadUrl(url);
        return true; // true 表示由当前程序处理
    }
});

示例：加载状态监控

通过 onPageStarted、onPageFinished 和 onReceivedError 控制加载提示框的显示与隐藏。

webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onPageStarted(WebView view, String url, Bitmap favicon) {
        super.onPageStarted(view, url, favicon);
        DialogManager.showLoadingDialog(this);
    }

    @Override
    public void onPageFinished(WebView view, String url) {
        super.onPageFinished(view, url);
        DialogManager.dismissLoadingDialog();
    }

    @Override
    public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {
        super.onReceivedError(view, errorCode, description, failingUrl);
        // 加载失败时展示错误信息
        view.loadDataWithBaseURL(null, "<span style=\"color: #FF0000;\">网页加载失败</span>", "text/html", "utf-8", null);
    }
});

示例：处理 HTTPS 证书

WebView 默认不信任自签名证书，导致页面空白。需手动处理 SSL 错误。

webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
        handler.proceed(); // 接受所有证书（生产环境请谨慎）
        // handler.cancel(); // 拒绝连接
    }
});

返回键处理

Activity 的返回键默认结束进程。若希望按返回键回到上一浏览记录，需覆盖 onKeyDown 方法。

public boolean onKeyDown(int keyCode, KeyEvent event) {
    if (webView.canGoBack() && event.getKeyCode() == KeyEvent.KEYCODE_BACK && event.getRepeatCount() == 0) {
        webView.goBack();
        return true;
    }
    return super.onKeyDown(keyCode, event);
}

canGoBack() 检查是否有历史记录，goBack() 执行后退操作。