cordova 是目前少有仍被 apple 和 google 官方接受的 webview 容器方案，用于将 html/css/js 打包为合规的 ios/android app；需正确初始化、同步资源、配置路径与权限，避免白屏或构建失败。
用 Cordova 打包 HTML 到 iOS/Android App 最稳
不是所有“打包工具”都真能发到应用商店，Cordova 是目前少有仍被 Apple 和 Google 官方接受的 WebView 容器方案。它不改你的 HTML/CSS/JS，只是套一层原生壳，调用设备能力（如摄像头、通知）靠插件。
常见错误现象：cordova build ios 报错 Xcode project not configured；或 Android 打包后白屏——多半是没运行 cordova prepare 同步资源，或 index.html 路径写死成绝对路径（比如 /static/js/app.js），实际应为相对路径。
- 必须用
cordova create myapp com.example.myapp MyApp初始化，不能直接在已有 HTML 文件夹里cordova init -
config.xml里<content src="index.html"></content>的路径必须相对于项目根目录，且文件得放在www/下 - iOS 需要 macOS + Xcode；Android 需要 JDK 17、Android SDK、
ANDROID_HOME环境变量设对 - 插件如
cordova-plugin-camera要手动cordova plugin add，且 iOS 需在Info.plist补权限声明
Tauri 打包 HTML 成桌面 App 更轻更快
如果你目标是 Windows/macOS/Linux 桌面端，Tauri 比 Electron 内存占用低得多，因为它用系统自带 WebView（Windows 上是 WebView2，macOS 是 WebKit），不打包 Chromium。
使用场景：内部工具、配置面板、带本地文件读写的前端界面。不适合需要 Chrome 特性（如 WebGPU、某些 WebRTC 行为）的场景。
立即学习“前端免费学习笔记（深入）”；
- 项目结构必须含
src-tauri/（Rust 后端）和前端构建产物（如dist/），不能只丢一个index.html -
tauri.conf.json中build.distDir必须指向你构建后的静态文件目录，不是源码目录 - 默认禁止跨域请求，若要访问本地 API，需在
tauri.conf.json的allowlist开http或fs权限 - Rust 编译慢，首次
npm run tauri build可能卡住几分钟，别误判为失败
Capacitor 替代 Cordova？注意平台兼容断层
Capacitor 是 Ionic 团队推出的 Cordova 后继者，API 更现代、插件生态更集中，但对老 Android（
错误现象：npx cap add android 后 npx cap open android 打不开 Android Studio；或 iOS 模拟器里加载 index.html 报 Failed to load resource: The URL is invalid——大概率是没执行 npx cap copy 同步前端资源到原生平台目录。
- 必须先
npm run build生成静态文件，再npx cap copy，否则原生工程里找不到 HTML - Android 工程依赖 Gradle 8.0+，旧项目升级易出
Could not resolve org.jetbrains.kotlin:kotlin-stdlib-jdk8 - iOS 需手动在 Xcode 中开启 “Signing & Capabilities” 里的 App Groups（如用本地存储插件）
- 不支持 Cordova 的
deviceready事件，改用await Plugins.Device.getInfo()等 Promise 方式检测就绪
别碰那些“一键拖拽打包”的在线工具
标榜“上传 HTML 就出 APK”的网站，99% 是把你的代码传到他们服务器，用老旧 Cordova 模板打个包，再塞广告 SDK 或埋统计代码。你拿不到签名密钥，APK 无法上架，甚至可能被二次分发。
真正可控的打包，永远绕不开本地环境配置和一次性的证书管理。比如 Android 发布版必须用 keytool 生成 .keystore，并在 android/app/build.gradle 里配好 signingConfigs；iOS 更要提前在 Apple Developer 网站配好 Provisioning Profile 和 Bundle ID。
最常被忽略的一点：HTML 里所有资源路径（图片、字体、API 接口）必须可离线访问或适配相对路径。上线前务必断网测试——很多“打包成功”的 App，一离开开发机就白屏，就是卡在这一步。
