打包 Uniapp 为 APK
确保已安装 HBuilderX 和 Android Studio,并配置好 Java 环境变量。在 HBuilderX 中打开项目,点击菜单栏的"发行" -> "原生 App-云打包"。选择 Android 平台,勾选"使用公共测试证书"或配置自己的签名证书。填写应用名称、包名等基本信息后,点击"打包"按钮。打包完成后,可在项目的 unpackage/release/apk
目录下找到生成的 APK 文件。
若需本地打包,需配置 Android Studio 环境。在项目根目录执行 npm run build:app-plus
生成打包资源。用 HBuilderX 导入原生 Android 项目,或手动将资源文件复制到 Android Studio 项目中。在 Android Studio 中配置签名并生成 APK。
打包 Uniapp 为 H5
在 HBuilderX 中点击"发行" -> "网站-H5手机版"。配置页面标题、路由模式等参数后,点击"发行"按钮。打包完成后,生成的文件默认存放在项目的 unpackage/dist/build/h5
目录下。将整个目录上传至 Web 服务器即可部署。
如需自定义配置,可修改项目根目录下的 manifest.json
文件。在"H5配置"中设置基础路径、路由模式等参数。还可通过 vue.config.js
文件修改 Webpack 配置,例如设置代理或公共路径。
常见问题处理
打包 APK 时若遇到证书问题,需确保证书别名和密码正确。建议首次打包使用公共测试证书。若出现资源加载失败,检查静态资源路径是否正确,必要时修改 manifest.json
中的相关配置。
H5 打包后若出现路由问题,尝试将路由模式改为 hash
。若需兼容多端,可使用条件编译处理平台差异。部署到子目录时,确保修改 publicPath
为正确的子路径。
优化建议
对于 APK,可启用混淆压缩减少体积。在 manifest.json
的"App模块配置"中勾选所需功能,避免打包无用模块。对于 H5,启用懒加载和 CDN 加速提升性能。使用 uni.optimization
配置开启分包优化,减少首屏加载时间。
定期更新 HBuilderX 和项目依赖,确保使用最新特性和修复。打包前通过真机调试和 IDE 模拟器充分测试,避免运行时问题。