pnpm add -D @capacitor/cli
pnpm add @capacitor/core @capacitor/android npx cap init com.example.app AppName
npx cap add android
npx cap sync android
npx cap open android
chrome://inspect/#devices
adb kill-server && adb start-server
- 运行与打包
- Debug：Android Studio 里 Run 到模拟器/真机。
- 正式包：Build > Generate Signed Bundle / APK > 选择 Android App Bundle，创建/使用 keystore，生成 .aab 上架，或生成 .apk 内测。
常见要点
- 路由：SPA 建议使用 hash 路由，避免 WebView 直接访问子路径 404。
- 访问线上资源：用 server.url 指向线上域名；如需 http，设置 server.cleartext=true，并在 AndroidManifest 设置 usesCleartextTraffic="true" 或 network_security_config。
- 文件下载/相册/相机等原生能力：按需添加 Capacitor 插件（如 @capacitor/filesystem、@capacitor/camera），然后 npx cap sync android。
- 图标与启动图：
pnpm dlx @capacitor/assets generate --android提供原始 1024x1024 图标和多尺寸 splash。
- 权限：对应插件会自动声明，若需自定义在 android/app/src/main/AndroidManifest.xml 添加。
- 性能：ECharts 等在 WebView 表现良好，确保生产构建、关闭 dev/hmr。
可选方案（了解即可）
- Cordova：老牌方案，命令与插件体系不同。
- TWA（Trusted Web Activity）：将 PWA 站点“外壳化”成 App，需满足 PWA（HTTPS + service worker + manifest），用 bubblewrap 生成 APK/AAB，更适合纯线上托管。
需要我帮你把上述配置文件和命令脚本加到项目里吗？我可以直接改好 capacitor.config.ts 并添加打包脚本。
