Html5Viewer 软件简介

软件概述

Html5Viewer 是一款基于 Android 平台的 H5 网页容器套壳应用，以 Android 原生 WebView 组件作为核心，可将本地 HTML5 页面或者在线网页快速封装为独立 Android APK 安装包，属于轻量级混合（Hybrid）应用外壳程序腾讯云。软件最低兼容 Android5.0（API21），适配最高 Android14（API34）系统版本，支持本地 assets 静态 H5 页面加载，也可直接访问互联网网页，内置页面加载进度提示、返回键网页回退、页面缓存、JS 脚本执行、HTTP 明文访问等完整 WebView 基础能力，体积轻巧、部署灵活，适合快速把 H5 业务转为安卓客户端，减少原生开发工作量。

手机端APK软件下载地址：https://wwawj.lanzout.com/iFmGX4avn3yb

完整源码+解压密码在后面

关注公众号：更多源码不定期发布

完整源码+解压密码在后面

主要功能

1. 网页加载
   ：支持读取程序内置 assets 目录本地 H5 页面，也支持加载 HTTPS、HTTP 在线网页地址，可自由切换目标访问地址。
2. 完整网页运行支持
   ：开启 JavaScript、本地存储 DomStorage，支持 H5 标准 viewport 适配，兼容 HTTP+HTTPS 混合内容访问，适配移动端网页交互。
3. 加载状态提示
   ：页面加载过程展示顶部进度条，加载完成自动隐藏，直观反馈网页加载进度。
4. 返回键逻辑处理
   ：按下物理返回键优先执行网页历史回退；网页无历史记录时直接退出应用，符合 APP 操作习惯。
5. 生命周期资源管理
   ：程序切换后台自动暂停 WebView 释放资源，回到前台恢复页面，销毁时释放 WebView 实例，规避内存泄漏问题。
6. 屏幕适配
   ：屏幕旋转、尺寸变化时不会重建页面，网页不会重复刷新加载，保证浏览体验。

技术信息

• 开发语言：Java 8
• 构建工具：Gradle + Android Gradle Plugin 8.1.0
• 依赖库：AndroidX AppCompat、Material 组件、AndroidX WebKit
• 支持系统：Android5.0 ~ Android14
• 包名：com.example.html5viewer
• 当前版本：V1.0

适用场景

1. 将已经开发完成的 H5 网站、网页应用快速打包成 Android 安装包；
2. 作为 Android WebView 学习示例项目；
3. 快速搭建轻量混合 App 外壳，可扩展 JS 与原生双向交互、文件上传等能力。

开发过程

一、需求分析

项目目标是开发一套开箱即用 Android WebView 壳模板，不需要复杂原生业务，核心实现 WebView 加载 H5 页面，解决原生 WebView 开发常见痛点：页面旋转重载、返回键直接退出、JS 不执行、HTTP 网页无法访问、WebView 内存泄漏等问题。要求同时支持本地 H5 资源与在线网址两种模式，保证向下兼容 Android5.0 及以上主流设备，输出可直接编译生成 APK 的完整工程。

二、项目创建与工程结构搭建

1. 使用 Android Studio 创建 Android 空 Activity 项目，选定 Java 语言，设置命名空间com.example.html5viewer，配置编译 SDK 版本 34，最低 SDK 版本 21。
2. 整理工程目录：保留标准 Gradle 项目结构，创建assets资源目录，用于存放本地 HTML 页面；布局目录编写主界面布局文件activity_main.xml，布局包含水平进度条与铺满全屏的 WebView 控件。
3. 配置 Gradle 脚本：顶层 build.gradle 声明 AGP 版本；app 模块 build.gradle 配置应用 ID、版本号、编译选项，引入 AndroidX、Material、webkit 相关依赖库，关闭 release 版本代码混淆。
4. 配置 gradle.properties，开启 AndroidX、优化 R 类引用，设置 Gradle 虚拟机内存，提升编译稳定性。

三、清单文件 AndroidManifest.xml 配置

1. 添加权限：声明INTERNET网络访问权限、ACCESS_NETWORK_STATE网络状态检测权限。
2. 开启明文流量支持：设置usesCleartextTraffic="true"，解决 Android9 及以上系统默认禁止 HTTP 网页访问的限制。
3. Activity 配置：设置configChanges捕获屏幕旋转、键盘弹出等状态变更，避免页面销毁重建；设置 exported 属性，配置应用启动 Intent 过滤器，声明为主程序入口；配置应用图标、应用名称、无标题栏 Material3 主题。

四、核心业务代码开发（MainActivity.java）

1. 定义常量START_URL作为初始加载地址，默认指向本地 assets 下 index.html，可修改为在线网址。
2. 在onCreate中初始化控件 WebView、ProgressBar；对 WebSettings 进行完整配置：启用 JS 脚本、Dom 本地存储、文件访问、宽视口模式，允许混合 HTTP/HTTPS 内容。
3. 设置WebViewClient：拦截页面跳转，所有链接均在 App 内部 WebView 打开；监听页面开始、结束事件，控制进度条显示隐藏。
4. 设置WebChromeClient：监听页面加载进度，实时更新进度条百分比数值。
5. 重写 onKeyDown 方法：拦截系统返回按键，判断 WebView 是否存在历史记录，优先网页回退，无历史则退出 APP。
6. 重写 Activity 生命周期方法onPause、onResume、onDestroy，对应调用 WebView 的暂停、恢复、销毁方法，防止内存泄漏。
7. 调用webView.loadUrl()加载目标页面地址。
8. 在 assets 目录放入示例 index.html，作为默认本地演示 H5 页面。

五、资源文件处理

1. res/values 目录配置字符串、颜色、主题资源，设置应用显示名称；
2. mipmap 资源目录放入应用图标资源，适配不同屏幕，包含 Android8.0 + 自适应图标。
3. 编写 proguard‑rules.pro 混淆规则，预留 WebView、JS 接口相关类保护规则，防止后续开启混淆出现反射、JS 交互异常。

六、调试测试

1. 使用模拟器与 Android 真机进行测试：验证本地 HTML 页面正常渲染；测试在线 HTTP/HTTPS 网页加载；测试屏幕旋转，确认页面不会重载；测试返回键回退逻辑；测试 App 后台切换，确认无闪退、内存异常；验证进度条加载动画显示正常。
2. 核对 Android 各版本兼容性，确认 Android5.0 到 Android14 均可正常运行。

七、编译生成 APK

两种编译方式：

1. Android Studio 菜单操作：File 打开 source 工程，等待 Gradle 同步完成，执行 Build → Build APK，编译输出 debug 调试 APK。
2. 命令行编译：Windows 执行gradlew.bat assembleDebug，Mac/Linux 执行./gradlew assembleDebug。 编译完成后，在app/build/outputs/apk/debug/路径得到 app‑debug.apk 安装包，可直接安装到安卓设备使用；如果需要发布正式版本，可以执行 assembleRelease，配置签名密钥，开启 R8 代码混淆，生成正式发行 APK。

八、二次开发预留扩展

项目预留扩展能力，文档标注可修改项：更换 H5 页面、修改 APP 名称图标、增加 JS 原生交互接口、实现文件上传、下拉刷新等功能，方便后续迭代开发。

如果你需要，我可以把这份内容精简成简短版，用于 APK 说明文档 / Readme。

手机端APK软件下载地址：https://wwawj.lanzout.com/iFmGX4avn3yb

完整源码解压密码：

7283sdkvklbmd

完整源码解压密码：

7283sdkvklbmd

关注公众号：更多源码不定期发布