KAIUP
  • 首页
  • 归档
  • 项目
  • 关于

    • Uniapp项目打包上线流程

    2026-04-22
    uni-app

    UniApp 打包上线全流程

    UniApp 支持多端打包上线（微信/支付宝/抖音小程序、Android App、iOS App、H5网页），以下是最常用的4个平台完整流程。

    一、前期准备

    无论打包哪个平台，先完成以下基础配置，避免后续报错：

    1. 环境准备：安装最新版 HBuilderX（官网下载：https://www.dcloud.io/hbuilderx.html ），打开UniApp 项目，确保项目无编译错误（点击顶部「运行」→「运行到浏览器」，测试页面正常显示）。

    2. 项目配置：打开项目根目录的 manifest.json，完善基础信息：

      • 基础配置：填写应用名称、应用标识（包名，如 com.xxx.app，全局唯一）、版本号/版本名称。

      • 图标配置：上传应用图标（建议 1024×1024 PNG 格式，无底色），自动生成各平台所需尺寸图标。

      • 权限配置：根据项目需求勾选对应权限（如定位、相机、存储，避免多余权限导致审核失败）。

    3. 测试验证：在模拟器或真机上运行项目，检查所有功能（页面跳转、接口请求、交互逻辑）正常，无闪退、报错。

    二、微信小程序打包上线

    步骤1：微信公众平台准备

    1. 访问 微信公众平台，注册/登录小程序账号（个人/企业均可，企业账号功能更全）。

    2. 完成账号认证（个人账号无需付费，企业账号需支付300元/年认证费），认证后才能上线。

    3. 获取 AppID：登录后，进入「开发管理」→「开发设置」，复制「小程序 AppID」（请勿使用测试号，无法上线）。

    步骤2：HBuilderX 打包配置

    1. 打开 UniApp 项目，右键点击项目根目录 →「属性」→「微信小程序配置」，粘贴获取到的 AppID，保存。

    2. 点击顶部菜单栏「发行」→「小程序-微信」，弹出打包配置窗口：

      • 填写版本号（如 1.0.0）、项目备注（简要说明本次更新内容，仅自己可见）。

      • 勾选「未登录时调试」（可选，便于后续测试），点击「发行」。

    3. 等待打包完成，HBuilderX 控制台会提示「上传成功」，并显示小程序项目路径。

    步骤3：微信小程序后台审核与上线

    1. 打开微信开发者工具，导入 HBuilderX 打包后的项目（路径：unpackage/dist/build/mp-weixin），确认项目正常运行。

    2. 登录微信公众平台，进入「开发管理」→「开发版本」，找到刚上传的版本，点击「提交审核」。

    3. 填写审核信息：选择应用类目（如工具、生活服务）、上传测试账号（如有登录功能，需提供可正常登录的账号密码）、填写审核备注。

    4. 等待审核（一般1-3个工作日，高峰期可能延迟），审核通过后，进入「版本管理」→「审核版本」，点击「发布」，小程序即可上线。

    三、Android App 打包上线

    步骤1：准备签名证书（关键）

    Android 打包必须使用签名证书（用于标识应用身份，避免被篡改），可通过 HBuilderX 自动生成或手动生成：

    1. HBuilderX 自动生成：打包时直接勾选「使用云端证书」。

    2. 手动生成：使用 JDK 工具生成，适合有开发基础的用户，具体步骤参考 https://ask.dcloud.net.cn/article/35777。

    步骤2：HBuilderX 云端打包

    1. 点击顶部「发行」→「App-Android/IOS-云打包」。

    2. 上传签名证书：点击「选择证书」，导入生成的 .keystore 文件，填写证书密码、别名、别名密码。

    3. 等待打包完成（约3-10分钟，取决于项目大小），打包成功后，点击「下载」，保存 APK/AAB 文件。

    步骤3：应用商店上线（以华为应用市场为例）

    1. 访问 华为开发者联盟，注册/登录账号，完成企业/个人认证。

    2. 进入「应用发布」→「新建应用」，填写应用名称、应用分类、简介等信息，上传应用图标、截图（按平台要求尺寸上传）。

    3. 上传打包好的 APK/AAB 文件，填写应用更新说明，提交审核。

    4. 等待审核（约1-5个工作日），审核通过后，应用即可在华为应用市场上线；其他应用商店（小米、OPPO、vivo）流程类似，按对应平台要求操作即可。

    图片参考：华为开发者联盟「新建应用」页面、应用信息填写页面、APK 文件上传页面。

    四、iOS App 打包上线（需 Mac 电脑+开发者账号）

    步骤1：准备工作（必备条件）

    1. 硬件：必须使用 Mac 电脑（Windows 无法完成 iOS 打包）。

    2. 账号：注册 Apple Developer 账号（99美元/年，个人/企业均可），登录 Apple 开发者官网，完成账号认证。

    3. 证书配置：在 Apple 开发者官网申请 iOS 发布证书（.p12 格式）和描述文件（.mobileprovision 格式）。

    步骤2：HBuilderX 打包 IPA 文件

    1. 点击顶部「发行」→「App-Android/IOS-云打包」。

    2. 上传证书和描述文件：分别导入 .p12 证书、.mobileprovision 描述文件，填写证书密码。

    3. 点击「打包」，等待打包完成，下载 IPA 文件。

    步骤3：提交 App Store 审核

    1. 下载安装 Transporter 软件（Mac App Store 可直接下载），登录 Apple 开发者账号。

    2. 打开 Transporter，点击「添加 App」，导入打包好的 IPA 文件，验证通过后，点击「交付」，将 IPA 文件提交到 App Store Connect。

    3. 登录 App Store Connect，创建 App，填写应用信息（名称、描述、截图、隐私政策 URL 等）。

    4. 提交审核：选择已交付的 IPA 文件，填写审核信息（测试账号等），点击「提交审核」，等待审核（约3-7个工作日）。

    5. 审核通过后，设置应用上线时间（立即上线或定时上线），应用即可在 App Store 上线。

    五、H5 网页打包上线

    1. 打开 UniApp 项目，点击顶部「发行」→「网站-PC Web或手机H5」，弹出打包配置窗口。

    2. 配置参数：填写网站名称、网站域名，点击「发行」。

    3. 等待打包完成，生成 H5 静态资源文件（默认 unpackage/dist/build/web）。

    4. 上线部署：将 H5 静态资源文件上传到服务器（如阿里云、腾讯云）或静态资源托管平台（如 Netlify、GitHub Pages），配置域名（可选），即可通过 URL 访问。

    六、补充说明

    • 离线打包：上述 Android/iOS 均为云端打包，若需集成原生插件或定制 SDK，可选择本地离线打包，需配置 Android Studio/Xcode 环境，具体参考 UniApp 官网文档。

    • 版本更新：后续迭代更新时，只需修改项目版本号，重复对应平台的打包、提交审核流程即可。