UniApp 小程序wgt 云打包

102 阅读3分钟

一、环境准备

  1. 安装开发工具
    • 下载 HBuilderX (适用版本:HBuilderX 3.8+)
      1. 账号注册
    • 注册 DCloud 开发者账号(用于云打包)
    • 联系项目管理员, 添加你的 [DCloud 开发者账号] 到当前项目中(否则打包提示没有权限)

二、项目配置

1. 在项目根目录中找到 manifest.json 配置文件

{
  "name": "AI电销助手", // 应用名称
  "appid": "__UNI__xxxxx", // DCloud AppID,HBuilderX 自动生成的唯一标识符,区分不同 UniApp 项目
  "description": "AI智能营销客户沟通智能分析", // 应用描述
  "versionName": "1.0.1", // 应用版本名称,必须高于上次打包版本,例如1.0.2
  "versionCode": 2, // 应用版本号,须高于上次打包版本(必须是整数),例如3
  /* 5+App特有相关 */
  "app-plus": {
    /* 应用发布信息 */
    "distribute": {
      /* android打包配置 */
      "android": {
        "permissions": [], // 权限相关配置
      },
      /* ios打包配置 */
      "ios": {
        "idfa": true,
        "dSYMs": false
      },
      /* SDK配置 */
      "sdkConfigs": {
        "geolocation": {
          "system": {
            "__platform__": ["ios", "android"]
          }
        },
        "speech": {}
      },
      // **应用图标**重要**
      "icons": { 
        "android": {
          // 项目根目录下static 文件夹下,icons 文件夹下
          "hdpi": "/static/icons/android/72.png",
          "xhdpi": "/static/icons/android/96.png",
          "xxhdpi": "/static/icons/android/144.png",
          "xxxhdpi": "/static/icons/android/192.png"
        },
        "ios": {}
      }
    },
    // 安装的插件配置
    "nativePlugins": {
      "Ba-KeepAliveSuit": {
        "__plugin_info__": {
          "name": "安卓保活套装(通用、常驻通知、电池优化、自启管理、后台运行等)",
          "description": "在Ba-KeepAlive的基础上,新增了忽略电池优化、自启管理、常驻通知。为定位、推送、websocket、定时任务、蓝牙、聊天等保驾护航(**注意:**不保证支持所有机型和场景,建议先试用再购买)",
          "platforms": "Android",
          "url": "https://ext.dcloud.net.cn/plugin?id=xxx",
          "android_package_name": "xxx", // 必须与包名一致
          "ios_bundle_id": "",
          "isCloud": true,
          "bought": 1,
          "pid": "11765",
          "parameters": {}
        }
      },
      "leven-call": {
        "__plugin_info__": {
          "name": "安卓电话通话短信监听原生插件",
          "description": "安卓电话通话监听原生插件,支持获取所有录音文件,来电监听,去电监听,挂断电话后返回通话录音文件,支持获取短信,静默发送短信,短信监听,支持获取通讯录",
          "platforms": "Android",
          "url": "https://ext.dcloud.net.cn/plugin?id=xxx",
          "android_package_name": "xxx", // 必须与包名一致
          "ios_bundle_id": "",
          "isCloud": true,
          "bought": 1,
          "pid": "16275",
          "parameters": {}
        }
      }
    }
  },
  "vueVersion": "2" // vue版本
}

三、执行云打包

  1. HBuilderX 菜单 → 发行 → 原生App-云打包
  2. 选择平台:Android, 输入Android包名 => cn.xxxxxx.sdr
  3. 选择证书类型:自有证书
  • 选择证书文件 (cn-xxx-sdr.jks 文件)
  • 输入证书库密码 xxx
  • 输入证书库私钥密码 xxx
  • 输入证书别名 cn.xxxxxx.sdr
  • 选择打正式包
  • 点击传统打包
  1. 等待打包,可能需要10~20分钟,如果需要查看云打包状态,可点击发行查看

四、打包完成

  1. 控制台显示下载链接,点击链接,跳转去下载
  2. 真机安装 通过 USB 连接 Android 设备 直接运行 app-release.apk

五、生成下载地址

  1. 上传文件至后管平台
  • 客户端管理 apk管理 新增操作 输入apk名称、版本号、版本名、选择release文件上传,生成文件下载地址

六、平台兼容性