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

相关推荐
之歆5 小时前
DAY_12JavaScript DOM 完全指南(二):实战与性能篇
开发语言·前端·javascript·ecmascript
Maimai108085 小时前
React如何用 @microsoft/fetch-event-source 落地 SSE:比原生 EventSource 更灵活的实时推送方案
前端·javascript·react.js·microsoft·前端框架·reactjs·webassembly
candyTong5 小时前
Claude Code 的 Edit 工具是怎么工作的
javascript·后端·架构
卡卡军8 小时前
agmd 1.0 重磅升级——Rust 重写,性能起飞
javascript·rust
Larcher8 小时前
🔥 告别抓瞎:用 Claude Code (cc) 优雅接手与维护已有项目
javascript·机器学习·前端框架
JYeontu8 小时前
轮播图不够惊艳?试下这个立体卡片轮播图
前端·javascript·css
亲亲小宝宝鸭8 小时前
如何监听DOM尺寸的变化?element-resize-detector 和 resizeObserver
前端·javascript
代码煮茶8 小时前
Vite 5.0 新特性深度解析:更快、更干净、更未来的前端构建利器
vue.js
卷帘依旧11 小时前
Generator 全面解析 + async/await 深度对比
前端·javascript
weixin_4713830311 小时前
统一缩放单位基础(px、em、rem)
开发语言·javascript·ecmascript