一、版本号组成

鸿蒙应用有两个版本标识：

二、uni-app 项目配置

manifest.json

{
  "versionName": "1.0.0",
  "versionCode": 100,
  
  "app-plus": {
    "distribute": {
      "android": {
        "versionName": "1.0.0",
        "versionCode": 100
      }
    }
  },
  
  "app-harmony": {
    "versionName": "1.0.0",
    "versionCode": 100
  }
}

三、版本号命名规范

推荐格式：主版本.次版本.修订版本

X.Y.Z

X = 主版本号（重大更新、不兼容改动）

Y = 次版本号（新功能、向下兼容）

Z = 修订版本号（Bug修复、小改动）

示例演进

四、versionCode 编码建议

方式1：简单递增

100 → 101 → 102 → 103

方式2：与 versionName 对应

versionName: 1.0.0 → versionCode: 10000

versionName: 1.0.1 → versionCode: 10001

versionName: 1.1.0 → versionCode: 10100

versionName: 2.0.0 → versionCode: 20000

公式：X * 10000 + Y * 100 + Z

方式3：日期编码

versionCode: 20241226 // 2024年12月26日发布

五、华为应用市场要求

强制规则

versionCode 必须递增 - 新版本必须大于已上架版本

不能回退 - 一旦上架 102，就不能再上架 101

整数类型 - versionCode 必须是正整数

建议规则

versionName 使用语义化版本（Semantic Versioning）

保持 versionCode 和 versionName 的对应关系

预留版本号空间（别从1开始，从100开始）

六、多渠道版本管理

如果同时发布 Android 和鸿蒙版本：

{
  "versionName": "1.0.0",
  "versionCode": 100,
  
  "app-plus": {
    "distribute": {
      "android": {
        "versionName": "1.0.0",
        "versionCode": 100
      }
    }
  },
  
  "app-harmony": {
    "versionName": "1.0.0",
    "versionCode": 100
  }
}

建议：Android 和鸿蒙使用相同的版本号，便于管理。

七、代码中获取版本号

// 获取版本信息
const getAppVersion = () => {
  // #ifdef APP-PLUS || APP-HARMONY
  return {
    versionName: plus.runtime.version,
    versionCode: plus.runtime.versionCode
  }
  // #endif
  
  // #ifdef H5
  return {
    versionName: '1.0.0',
    versionCode: 100
  }
  // #endif
}

// 使用
const version = getAppVersion()
console.log(`当前版本：${version.versionName} (${version.versionCode})`)

八、版本更新检测

// 检查更新
async function checkUpdate() {
  const currentCode = plus.runtime.versionCode
  
  // 从服务器获取最新版本
  const res = await uni.request({
    url: 'https://api.xxx.com/app/version'
  })
  
  const latestCode = res.data.versionCode
  const latestName = res.data.versionName
  const downloadUrl = res.data.downloadUrl
  
  if (latestCode > currentCode) {
    uni.showModal({
      title: '发现新版本',
      content: `新版本 ${latestName} 已发布，是否更新？`,
      success: (res) => {
        if (res.confirm) {
          // 跳转应用市场或下载
          plus.runtime.openURL(downloadUrl)
        }
      }
    })
  }
}

九、版本号管理最佳实践

1. 建立版本日志

版本记录

v1.0.1 (101) - 2024-12-26

• 修复：签到页面闪退问题
• 优化：首页加载速度

v1.0.0 (100) - 2024-12-20

• 首次发布
• 功能：健康记录、签到、知识库

1. 自动化版本管理

// package.json
{
  "version": "1.0.0",
  "scripts": {
    "version:patch": "npm version patch && node scripts/sync-version.js",
    "version:minor": "npm version minor && node scripts/sync-version.js",
    "version:major": "npm version major && node scripts/sync-version.js"
  }
}

1. 版本号同步脚本

// scripts/sync-version.js
const fs = require('fs')
const pkg = require('../package.json')
const manifest = require('../manifest.json')
const [major, minor, patch] = pkg.version.split('.').map(Number)
manifest.versionName = pkg.version
manifest.versionCode = major * 10000 + minor * 100 + patch
fs.writeFileSync('./manifest.json', JSON.stringify(manifest, null, 2))
console.log(`版本已同步: ${manifest.versionName} (${manifest.versionCode})`)

快速参考

核心原则：

versionCode 只能增不能减

versionName 用语义化版本

保持两者对应关系

预留版本号空间