DevEco 26 / uni-app 鸿蒙包 pack.info 仍为 Beta1 的定位与修复

一、问题背景：从鸿蒙生态的版本演进说起在鸿蒙（HarmonyOS）应用开发中，pack.info 文件是描述应用包元信息的关键配置文件，它定义了应用的版本号、目标 API 级别、设备类型等核心属性。对于使用 uni-app 框架开发跨平台应用的开发者而言，当将项目打包为鸿蒙包（HAP）时，pack.info 中的 version 字段常被标记为 Beta1，而非预期的稳定版本号。这一问题在 DevEco Studio 26 版本的上下文中尤为突出，可能导致应用在鸿蒙设备上无法正确识别版本或触发兼容性警告。本文将循序渐进地解析该问题的根源，并提供从定位到修复的完整方案。我们将从基础概念入手，逐步深入到代码级别的调试与修复。## 二、基础概念：理解 pack.info 与版本标记### 1. pack.info 的结构与作用pack.info 是鸿蒙应用包（HAP）的元数据文件，通常位于 entry/src/main/resources/ 目录下。其内容采用 JSON 格式，核心字段包括：- app：应用级别的配置，如 bundleName（包名）、version（版本号）。- deviceConfig：设备兼容性配置。- module：模块信息，如 name、type（entry 或 feature）。示例 pack.info 文件内容（简化版）：json{ "app": { "bundleName": "com.example.myapp", "version": { "code": 1, "name": "1.0.0" } }, "deviceConfig": {}, "module": { "name": "entry", "type": "entry" }}### 2. Beta1 标记的由来在 uni-app 的鸿蒙打包流程中，构建工具（如 @huawei/harmony-uni-app）默认将 version.name 字段设置为 Beta1，这是因为：- 开发阶段默认值：为区分开发版与正式版，工具链会为未明确指定版本号的包自动添加 Beta 前缀。- 版本规范未对齐：uni-app 项目的 manifest.json 中的版本号可能未被正确映射到鸿蒙包的 pack.info。## 三、问题定位：从项目配置到打包日志### 1. 检查 uni-app 项目配置首先，在 uni-app 项目的根目录找到 manifest.json，确认 versionName 和 versionCode 是否正确设置。例如：json{ "name": "myApp", "versionName": "1.0.0", "versionCode": 100, "app-plus": { /* 其他配置 */ }}### 2. 定位打包日志中的错误在 DevEco Studio 26 中执行打包操作时，查看构建日志（Build Output 面板）。搜索关键词 pack.info 或 Beta1，通常会看到类似以下信息：[Info] 生成 pack.info 文件，版本名：Beta1，版本码：1这表示打包工具未从 manifest.json 中读取到正确的版本号。### 3. 深入排查：uni-app 的鸿蒙适配插件uni-app 项目依赖 uni-app-harmony 插件（通过 npm install @huawei/uni-app-harmony 安装）。该插件负责将 manifest.json 的配置转换为鸿蒙所需的格式。检查插件的配置文件（如 harmony.config.js）是否启用了版本号映射：javascript// harmony.config.js 示例module.exports = { pack: { version: { code: 100, // 对应 versionCode name: "1.0.0" // 对应 versionName } }};## 四、修复方案：手动覆盖与自动化脚本### 方案一：在 harmony.config.js 中显式定义版本号直接在 harmony.config.js 中固定版本号，确保打包时覆盖默认的 Beta1：javascript// harmony.config.jsmodule.exports = { pack: { version: { code: 100, // 从 manifest.json 的 versionCode 读取 name: "1.0.0" // 从 manifest.json 的 versionName 读取 } }};注意：此方法需要手动同步版本号，适合快速修复。### 方案二：使用构建脚本自动读取 manifest.json通过 Node.js 脚本在打包前自动解析 manifest.json，并写入 pack.info。以下是一个可运行的示例代码：python#!/usr/bin/env python3# -*- coding: utf-8 -*-"""鸿蒙 pack.info 版本号修复脚本功能：从 uni-app 的 manifest.json 读取版本号，并更新 pack.info"""import jsonimport os# 1. 读取 manifest.json 文件manifest_path = "./manifest.json"if not os.path.exists(manifest_path): raise FileNotFoundError(f"未找到 manifest.json 文件: {manifest_path}")with open(manifest_path, "r", encoding="utf-8") as f: manifest_data = json.load(f)# 2. 提取版本号version_name = manifest_data.get("versionName", "1.0.0") # 默认值version_code = manifest_data.get("versionCode", 1)print(f"从 manifest.json 读取到版本信息: name={version_name}, code={version_code}")# 3. 更新 pack.info 文件（假设路径为 entry/src/main/resources/pack.info）pack_info_path = "./entry/src/main/resources/pack.info"with open(pack_info_path, "r", encoding="utf-8") as f: pack_data = json.load(f)# 4. 修改版本字段pack_data["app"]["version"]["name"] = version_namepack_data["app"]["version"]["code"] = version_code# 5. 写回文件with open(pack_info_path, "w", encoding="utf-8") as f: json.dump(pack_data, f, indent=2, ensure_ascii=False)print(f"已成功更新 {pack_info_path}，版本名: {version_name}")### 方案三：在 uni-app 构建钩子中集成修复若使用 uni-app 的 vue.config.js 或自定义构建流程，可在打包前执行上述脚本。以下是一个 Node.js 版本的钩子示例：javascript// vue.config.js（或 uni-app 的自定义构建脚本）const fs = require('fs');const path = require('path');module.exports = { configureWebpack: { plugins: [ { apply: (compiler) => { compiler.hooks.beforeRun.tap('FixPackInfo', () => { // 读取 manifest.json const manifestPath = path.resolve(__dirname, './manifest.json'); const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8')); const versionName = manifest.versionName || '1.0.0'; const versionCode = manifest.versionCode || 1; // 更新 pack.info const packInfoPath = path.resolve(__dirname, './entry/src/main/resources/pack.info'); const packInfo = JSON.parse(fs.readFileSync(packInfoPath, 'utf-8')); packInfo.app.version.name = versionName; packInfo.app.version.code = versionCode; fs.writeFileSync(packInfoPath, JSON.stringify(packInfo, null, 2)); console.log(`已修复 pack.info: ${versionName} (${versionCode})`); }); } } ] }};## 五、验证与注意事项### 1. 验证修复效果执行打包后，直接查看生成的 HAP 包内的 pack.info（可通过解压 HAP 文件查看），或使用 DevEco Studio 的 App Inspector 工具检查版本号是否已更改为预期值（如 1.0.0）。### 2. 常见问题- 版本号未更新：检查 manifest.json 的编码格式（推荐 UTF-8），以及脚本是否有执行权限。- Beta1 残留：确认是否使用了多个打包工具（如 CLI 和 IDE 插件），需要统一配置。## 六、总结本文从鸿蒙应用包的基础配置 pack.info 出发，分析了 uni-app 打包时版本号被标记为 Beta1 的根源，并提供了三种修复方案：手动配置 harmony.config.js、使用 Python 脚本自动更新、以及集成到构建流程。核心要点是确保 manifest.json 的版本号能够正确映射到鸿蒙包的元数据中。对于 DevEco 26 版本，建议优先采用自动化脚本方式，以减少人为错误。希望本文能帮助开发者快速定位并解决这一常见问题，提升鸿蒙应用的发布效率。