WebView套壳是HTML转App最轻量可控方案，适合已有网页或内部工具；需处理HTTP/HTTPS、路径配置、原生能力集成及商店审核雷区。
WebView打包是最轻量、最可控的路径
直接用 WebView 套壳是当前 HTML 转 App 最实际的选择，尤其适合已有网页、内容型或内部工具类应用。它不依赖框架编译链，调试方便，更新也不用过审——网页改完一部署，App 里立刻生效。
常见错误现象：net::ERR_CLEARTEXT_NOT_PERMITTED（Android 9+ 默认禁用 HTTP）、Webview is not defined（iOS WKWebView 初始化时机不对）、页面白屏但控制台无报错（本地资源路径没配对）。
- Android：必须在
AndroidManifest.xml中声明android:usesCleartextTraffic="true"（仅限调试；上线应切 HTTPS） - iOS：需在
Info.plist中添加NSAppTransportSecurity配置，允许加载本地file://或指定域名 - 所有平台都要确保 HTML 中的 JS/CSS 路径是相对路径或绝对路径（避免用
./assets/js/app.js这类 Node.js 风格写法）
Cordova 和 Capacitor 不是“自动转换”，而是工程化接入
它们不是一键把 HTML 拖进去就出 APK/IPA 的工具，本质是帮你管理 WebView 容器 + 提供原生桥接能力。如果你的网页没做响应式、没处理离线缓存、没考虑键盘遮挡，打包后照样卡顿、错位、输不了字。
使用场景：需要调用摄像头、定位、文件系统、后台推送等原生能力；团队有 Web 开发经验但无原生开发人力。
立即学习“前端免费学习笔记（深入）”；
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
-
cordova build android生成的是 debug 版 APK，签名要额外跑jarsigner；iOS 必须用 Mac + Xcode 才能打包 IPA - Capacitor 的
npx cap add android会生成完整 Android Studio 工程，后续修改需进 IDE 调整build.gradle或AndroidManifest.xml - 两者都默认启用
WebViewAssetLoader（Android）和WKWebView（iOS），但静态资源仍建议放在src/assets/下，由构建工具复制进原生项目
直接上 PWA？别被“安装到桌面”误导
PWA 是浏览器内体验增强方案，不是 App。它能在 Chrome 或 Safari 里点「添加到主屏幕」，图标和启动页看起来像 App，但底层仍是网页进程——没有后台服务、无法接收系统级通知、iOS 上甚至不能访问大部分传感器。
容易踩的坑：manifest.json 里 start_url 写成 /index.html 导致离线时 404；service worker 缓存策略太激进，HTML 更新了但 JS 还在用旧版；iOS Safari 对 display: standalone 支持不稳定，经常退回到地址栏模式。
- 必须配置
serviceworker.js并在页面中注册，否则离线即失效 - 所有静态资源（含
manifest.json）需同域且走 HTTPS，HTTP 站点完全无法触发 PWA 安装提示 - 安卓 Chrome 对 PWA 支持较好；iOS 从 iOS 16.4 才开始支持部分 Push API，且必须经 Apple 授权的推送证书
真要上架商店？WebView App 的审核雷区很具体
苹果和谷歌现在对“网页套壳”应用审核极严，尤其是功能单一、无原生交互、UI 完全复刻网页的 App。不是技术做不到，而是规则卡得死。
典型被拒原因：This app simply loads a website in a webview and does not provide any additional functionality（苹果）、Your app contains content that duplicates the functionality of existing Google Play services（谷歌）。
- 必须有至少一个不可被网页替代的原生能力：比如后台音频播放、蓝牙通信、自定义通知渠道、文件系统深度集成
- 启动页、图标、字体、手势反馈（如下拉刷新动画）需明显区别于普通浏览器打开效果
- 首次启动必须有用户授权动作（如位置、通知权限请求），不能静默加载完就结束
很多团队卡在这一步不是因为不会写代码，而是没预留原生扩展接口——等审核被拒再补，往往要重写桥接逻辑。
