打包 Uniapp

打包 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 模拟器充分测试，避免运行时问题。