WebView 是 Android 應用內嵌網頁的核心組件。本文提供一個生產級可用的 WebViewActivity 完整實現,涵蓋基礎配置、HTML 數據加載、JavaScript 支持、混合內容適配、生命週期管理、安全防範等關鍵點,並附帶佈局 XML,開箱即用。
res/layout/webview.xml<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
android:id="@+id/webview_ll"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="WebView 測試頁面"
android:textColor="#000000"
android:textSize="18sp"
android:background="#00FF00"
android:gravity="center"
android:padding="16dp"/>
<WebView
android:id="@+id/webview"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="1"/>
</LinearLayout>
WebViewActivity.javapublic class WebViewActivity extends AppCompatActivity {
private WebView webView;
private static final String MIME_TYPE = "text/html";
private static final String ENCODING = "utf-8";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.webview);
webView = findViewById(R.id.webview);
initWebViewSettings();
loadTestContent();
}
private void initWebViewSettings() {
WebSettings settings = webView.getSettings();
// 核心功能開關
settings.setJavaScriptEnabled(true); // 支持 JS
settings.setDomStorageEnabled(true); // 支持 LocalStorage
settings.setDatabaseEnabled(true); // 支持 Web SQL DB (已棄用但兼容)
settings.setAllowFileAccess(true); // 允許文件訪問
settings.setAllowContentAccess(true); // 允許 Content Provider 訪問
// 緩存與渲染優化
settings.setCacheMode(WebSettings.LOAD_DEFAULT);
settings.setAppCacheEnabled(true);
settings.setRenderPriority(WebSettings.RenderPriority.HIGH);
settings.setLoadWithOverviewMode(true); // 自適應屏幕
settings.setUseWideViewPort(true); // 支持 viewport 標籤
// 混合內容適配 (Android 5.0+)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
settings.setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW);
}
// 設置 User-Agent (可選)
// settings.setUserAgentString(settings.getUserAgentString() + " MyApp/1.0");
// 關鍵:設置 WebViewClient 處理頁面跳轉、錯誤、SSL
webView.setWebViewClient(new WebViewClient() {
@Override
public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
// API 24+ 使用此方法
return handleUrlLoading(view, request.getUrl());
}
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
// API 24- 使用此方法
return handleUrlLoading(view, url);
}
private boolean handleUrlLoading(WebView view, Object urlObj) {
String url = urlObj.toString();
if (url.startsWith("https://") || url.startsWith("https://")) {
view.loadUrl(url);
return true; // 由 WebView 內部處理
}
// 處理 scheme: tel:, mailto:, intent:, market: 等
try {
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
startActivity(intent);
} catch (ActivityNotFoundException e) {
Log.w("WebView", "無法處理鏈接: " + url);
}
return true;
}
@Override
public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
// 生產環境嚴禁 handler.proceed()!此處僅演示
Log.e("WebView", "SSL 錯誤: " + error.getPrimaryError());
handler.cancel(); // 安全做法:取消加載
}
@Override
public void onPageFinished(WebView view, String url) {
super.onPageFinished(view, url);
// 頁面加載完成,可注入 JS、隱藏進度條等
}
});
// 設置 WebChromeClient 處理 JS 對話框、標題、進度、權限請求
webView.setWebChromeClient(new WebChromeClient() {
@Override
public boolean onJsAlert(WebView view, String url, String message, JsResult result) {
return super.onJsAlert(view, url, message, result);
}
@Override
public void onProgressChanged(WebView view, int newProgress) {
super.onProgressChanged(view, newProgress);
// 更新進度條
}
@Override
public void onPermissionRequest(PermissionRequest request) {
// Android 6.0+ 處理攝像頭/麥克風/定位權限請求
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
request.grant(request.getResources());
}
}
});
}
private void loadTestContent() {
String html = "<a href='https://blog.csdn.net/xys289187120'>歡迎訪問博客</a>";
// loadDataWithBaseURL: baseUrl 為 null 時相對路徑無效,historyUrl 為 null 不記入歷史
webView.loadDataWithBaseURL(null, html, MIME_TYPE, ENCODING, null);
}
@Override
public void onBackPressed() {
if (webView.canGoBack()) {
webView.goBack();
} else {
super.onBackPressed();
}
}
@Override
protected void onDestroy() {
if (webView != null) {
webView.loadUrl("about:blank"); // 清空內容
webView.stopLoading();
webView.setWebViewClient(null);
webView.setWebChromeClient(null);
webView.destroy(); // 釋放內存,防洩漏
webView = null;
}
super.onDestroy();
}
}
<uses-permission android:name="android.permission.INTERNET" />
<!-- 若需訪問文件/地理位置/攝像頭等,按需添加 -->
onDestroy 中徹底銷毀 WebView,防內存洩漏 (WebView 內部 Handler 持有 Context 引用)。goBack(),提升用戶體驗。MIXED_CONTENT_ALWAYS_ALLOW (僅開發/受信環境)。handler.proceed(),應引導用戶或降級。addJavascriptInterface 暴露 Java 物件給 JS,**僅暴露必要方法**,API 17+ 需加 @JavascriptInterface 註解,防反射攻擊。android:hardwareAccelerated="true" (默認開啟),複雜頁面可提升渲染幀率。這份配置模板覆蓋了 90% 以上的 WebView 使用場景,可直接作為項目基礎組件擴展。