uniapp 获取app版本信息（兼容鸿蒙）

雪芽蓝域zzs2026-01-06 11:31

1. uniapp 获取app版本信息

参考文档：uni.getAppBaseInfo | uni.getSystemInfo

1.1. android和ios获取app版本信息

在uniapp中获取当前应用的版本号，android和ios可以通过plus.runtime.getProperty方法来实现。以下是详细的步骤和代码示例：

（1）首先，你需要在uniapp的页面或其他合适的地方调用以下代码来获取应用的版本号。

javascript 复制代码

plus.runtime.getProperty(plus.runtime.appid, (inf) => {
    console.log(JSON.stringify(inf)); // 这里的inf包含了应用的各种信息，包括版本号
});

（2）上述代码会在控制台输出应用的信息，你可以从中获取到版本号。如果你想要更直接地获取版本号，可以稍微修改一下代码。

javascript 复制代码

plus.runtime.getProperty(plus.runtime.appid, (inf) => {
    console.log(inf.version); // 直接输出版本号
});

请注意，plus.runtime.getProperty方法只能在app环境中使用，如果在h5或小程序中使用可能会报错。因此，在实际开发中，你可能需要根据运行环境来决定是否调用这段代码。

1.2. 鸿蒙获取app版本信息

在鸿蒙平台上获取应用版本号，应使用 uni-app 的跨平台 API，而非 plus.runtime 相关方法（鸿蒙不支持 app-plus）。

推荐两种方式：

1.2.1. 使用 uni.getAppBaseInfo() 获取应用基本信息：

javascript 复制代码

uni.getAppBaseInfo({
  success: (res) => {
    console.log('应用版本号(整数):', res.appVersionCode); // 对应 manifest.json 中的 versionCode
    console.log('应用版本名称:', res.appVersion);         // 对应 manifest.json 中的 versionName
  }
});

1.2.2. 使用 uni.getSystemInfo() 获取系统信息：

javascript 复制代码

uni.getSystemInfo({
  success: (res) => {
    console.log('应用版本号:', res.appVersionCode);
    console.log('应用版本名称:', res.appVersion);
    // 如需 wgt 资源包版本（uni-app 3.4.15+）:
    console.log('wgt版本:', res.appWgtVersion);
  }
});

1.2.3. 注意事项：

（1）appVersionCode 是 manifest.json 中配置的内部版本号（整数值）

（2）appVersion 是 manifest.json 中配置的应用显示版本（如"1.0.0"）

（3）鸿蒙平台需通过 HBuilderX 4.61+ 版本进行开发

（3）确保在 manifest.json 的基础配置中正确设置了版本信息

参考文档：uni.getAppBaseInfo | uni.getSystemInfo