需将HTML5页面嵌入WebView：一、资源放assets目录并校验路径；二、启用JavaScript、DOM存储等设置；三、支持加载assets、sdcard或远程URL；四、用@JavascriptInterface实现安全双向通信；五、适配全屏、缩放与手势。
如果您希望在原生应用中展示HTML5网页内容，则需要将HTML5页面嵌入到WebView组件中。以下是将HTML5内容正确放入WebView的具体步骤与嵌入技巧：
一、准备HTML5页面资源
确保HTML5页面结构完整、路径引用正确，且所有依赖资源（如CSS、JavaScript、图片）可被WebView正常加载。本地资源建议统一存放于应用的assets或res/raw目录下，避免网络请求失败导致空白页。
1、将HTML文件（例如index.html）及其关联的js、css、images子目录整体复制到Android项目的app/src/main/assets/目录下。
2、检查HTML中所有相对路径是否以./或../开头，并确认其与assets内实际目录层级一致。
立即学习“前端免费学习笔记（深入）”；
3、若使用ES6+语法或现代API，需确认目标Android系统Webview内核版本支持；必要时引入Babel转译或polyfill脚本。
二、配置WebView基础属性
WebView默认禁用JavaScript、不支持DOM存储和第三方Cookie，需显式启用关键功能才能运行典型HTML5应用。
1、在Activity或Fragment中获取WebView实例：WebView webView = findViewById(R.id.webview);
2、获取WebSettings对象并启用必要选项：WebSettings settings = webView.getSettings();
3、依次调用：settings.setJavaScriptEnabled(true);、settings.setDomStorageEnabled(true);、settings.setDatabaseEnabled(true);、settings.setAllowContentAccess(true);、settings.setAllowFileAccess(true);
4、针对Android 9（API 28）及以上，若HTML5页面加载HTTP资源，需在AndroidManifest.xml的android:usesCleartextTraffic="true"。
三、加载HTML5页面的三种方式
根据资源部署位置与交互需求，可选择加载本地资产文件、本地文件系统路径或远程URL，每种方式适用不同场景且权限要求不同。
1、加载assets中的HTML文件：调用webView.loadUrl("file:///android_asset/index.html");
2、加载sdcard上的HTML文件（需动态申请READ_EXTERNAL_STORAGE权限）：使用file:///sdcard/path/to/index.html格式URL，注意Android 10+需使用Scoped Storage适配方案。
3、加载远程HTML5页面：直接传入标准HTTP/HTTPS URL，如webView.loadUrl("https://example.com/app.html");，需确保服务器响应头未禁止iframe嵌入或CSP策略未拦截关键资源。
四、处理WebView与HTML5的双向通信
原生代码需与HTML5页面交换数据或触发操作时，必须建立安全可控的桥接通道，避免使用已废弃的addJavascriptInterface在低版本引发漏洞。
1、Android 4.2+推荐使用@JavascriptInterface注解方法，并确保宿主类方法声明为public且在注入前调用webView.addJavascriptInterface(new JsBridge(), "Android");
2、HTML5中通过window.Android.methodName(param)调用原生方法，原生方法返回值需为基本类型或JSON字符串。
3、原生向HTML5注入消息：使用webView.evaluateJavascript("handleMessage("+jsonStr+")", null);执行JS回调，适用于Android 4.4+；低于该版本需改用loadUrl("javascript:...")并注意URL长度限制。
4、重要提示：所有JS接口方法必须校验输入参数，禁止直接拼接未过滤的用户输入到JS执行上下文中，防止XSS或原型污染攻击。
五、适配HTML5全屏与手势行为
HTML5页面常包含视频播放、Canvas绘图或触摸交互，需调整WebView容器行为以匹配Web端体验。
1、启用硬件加速：在AndroidManifest.xml对应Activity节点添加android:hardwareAccelerated="true"。
2、支持HTML5全屏视频：实现WebChromeClient并重写onShowCustomView与onHideCustomView，管理自定义全屏视图的显示与销毁。
3、允许双指缩放：调用settings.setSupportZoom(true);和settings.setBuiltInZoomControls(true);，并设置settings.setDisplayZoomControls(false);隐藏系统缩放按钮。
4、拦截滑动冲突：若HTML5内含横向滚动区域（如轮播图），需重写WebView的onTouchEvent，根据触点位移方向将事件分发至子View或自身处理。
