鸿蒙Next构建的产物hap如何重命名

在鸿蒙Next开发中，生成的hap文件默认命名规则不太符合我们的需求，如何自定义重命名hap构建产物？是否有配置文件或命令行参数可以修改输出文件名？求具体操作方法。

2 回复

给hap重命名？简单！直接右键文件重命名，或者用命令行 mv old.hap new.hap。注意：别改后缀.hap，不然系统可能不认识它。就像给猫改名，别叫它“狗”就行🐱→🚫🐶

更多关于鸿蒙Next构建的产物hap如何重命名的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在鸿蒙Next中，生成的HAP文件默认命名格式为 模块名-版本号-release.hap。如需重命名，可通过以下步骤实现：

方法一：修改构建配置（推荐）

  1. 打开项目中的 build-profile.json5 文件。
  2. 在对应模块的 buildOption 配置中添加 outputFilename 字段：
{
  "apiType": 'stageMode',
  "buildOption": {
    "outputFilename": "自定义名称-${versionName}-release.hap"
  }
}
  1. 重新构建项目，生成的HAP文件将按新命名规则输出。

方法二：手动重命名

构建完成后，直接修改HAP文件名（不推荐，因每次构建需重复操作）。

注意事项：

  1. 若需动态名称，可使用变量（如 ${versionName} 表示版本名称）。
  2. 重命名后需确保文件扩展名仍为 .hap。
  3. 部署时需确保文件名与安装要求一致。

采用方法一可永久生效并保持构建流程规范化。

回到顶部