CordovaError: No platforms added 表明未添加目标平台，需先运行 cordova platform add android 或 npx cap add android，并确认 platforms/ 或 android/ios/ 目录存在。
打包时提示 CordovaError: No platforms added
这是最常见的一类错误，本质是项目还没初始化好平台环境就执行了构建命令。Cordova 或 Capacitor 都要求先显式添加目标平台（如 android 或 ios），否则后续所有打包步骤都会中断。
实操建议：
- 确认是否已运行过
cordova platform add android（Cordova）或npx cap add android（Capacitor） - 检查项目根目录下是否存在
platforms/（Cordova）或android/、ios/（Capacitor）子目录 - 如果用的是 Capacitor，注意
npx cap sync必须在add之后、build之前执行，否则原生工程不会同步 Web 资源
Android 构建失败：Execution failed for task ':app:mergeDebugResources'
这类报错通常不是代码逻辑问题，而是资源文件（尤其是图片、XML）命名或格式不合规导致的 AAPT2 编译失败。Android 对资源命名有严格限制：只能含小写字母、数字、下划线，且不能以数字开头。
排查要点：
立即学习“前端免费学习笔记（深入）”；
- 检查
www/res/或src/assets/下所有图片文件名：避免空格、中文、大写字母、特殊符号（如@、-、.） - 确认
android/app/src/main/res/下没有手动添加的冲突资源（比如重复的drawable-xxhdpi/icon.png） - 若使用 Cordova，检查
config.xml中的www/的路径
白屏 / 启动后空白，控制台无报错
HTML5 页面能本地打开但打包成 APP 后白屏，大概率是路径或协议问题。WebView 默认不允许加载非 file:// 或 http(s):// 协议的资源，而开发时习惯用相对路径或 / 开头的绝对路径，在打包后可能被解析为错误上下文。
关键检查点：
- 所有 JS/CSS 引入必须用相对路径（如
./js/app.js），避免/js/app.js—— 后者在 Android WebView 中会尝试从设备根目录找 - 检查
index.html中是否有硬编码的http://localhost:8080或开发服务器地址，打包后需替换为相对路径或通过window.location.origin动态拼接 - Capacitor 项目需确认
capacitor.config.ts中的server.url未被误设为开发地址；Cordova 则要确保没启用
签名失败或安装后闪退：INSTALL_PARSE_FAILED_NO_CERTIFICATES
这个错误说明 APK 没有正确签名，常见于直接用 cordova build android --release 但没配置签名信息，或生成的 keystore 路径/密码/别名写错。
注意细节：
- 不要依赖 IDE（如 Android Studio）自动签名——Cordova/Capacitor 打包流程独立于 IDE，必须在命令行或配置文件中显式声明
- Cordova 需在
build.json中完整填写keystore、storePassword、alias、password；Capacitor 则需在android/app/build.gradle的signingConfigs区块里配置，且确保buildTypes.release.signingConfig指向它 - 首次生成 keystore 时，务必记下全部参数，特别是
alias（不是文件名！），后续每次更新都必须一致，否则用户无法覆盖安装
