HarmonyOS鸿蒙Next中构建har包时如何剔除resources目录下面的资源文件

在鸿蒙（HarmonyOS）构建 HAR 包时，若需剔除resources目录下的资源文件（如图片、主题色等），需兼顾构建配置剔除资源和引用工程补充资源两个环节。直接剔除资源后界面异常（字体颜色、图片丢失）的核心原因是：HAR 包内的代码仍依赖这些资源的 ID，但资源被物理移除后，引用工程未提供对应的替代资源。以下是具体解决方案：

一、正确剔除 HAR 包中的资源文件

鸿蒙的 HAR 打包流程会默认将resources目录下的资源（element、media、profile等）编译并打包到 HAR 中。若需剔除，需通过Hvigor 构建脚本在打包前主动删除资源文件（而非仅在build-profile.json5中声明排除，后者可能不生效）。

步骤 1：在 HAR 模块中添加自定义 Hvigor 任务

在 HAR 模块的hvigorfile.js中，新增剔除资源的任务，在assembleHar任务执行前删除resources目录下的目标文件：

// AHar模块/hvigorfile.js
const { appTasks } = require('@ohos/hvigor-ohos-plugin');
const fs = require('fs');
const path = require('path');

// 定义需要剔除的资源目录（按需调整，如全部剔除则写'resources'）
const RESOURCES_TO_REMOVE = [
  'src/main/resources/media', // 剔除图片资源
  'src/main/resources/element' // 剔除主题色（color、string等）
];

// 剔除资源的任务
task('removeResources', () => {
  const moduleRoot = __dirname; // 当前HAR模块根目录
  RESOURCES_TO_REMOVE.forEach(resourcePath => {
    const fullPath = path.join(moduleRoot, resourcePath);
    if (fs.existsSync(fullPath)) {
      // 递归删除目录（谨慎操作，确保路径正确）
      const deleteDir = (dir) => {
        if (fs.existsSync(dir)) {
          fs.readdirSync(dir).forEach(file => {
            const curPath = path.join(dir, file);
            if (fs.statSync(curPath).isDirectory()) {
              deleteDir(curPath); // 递归删除子目录
            } else {
              fs.unlinkSync(curPath); // 删除文件
            }
          });
          fs.rmdirSync(dir); // 删除空目录
        }
      };
      deleteDir(fullPath);
      console.log(`已剔除资源：${fullPath}`);
    }
  });
});

// 重构assembleHar任务：先剔除资源，再打包
const originalAssembleHar = appTasks.assembleHar;
appTasks.assembleHar = task('assembleHar', async () => {
  await executeTask('removeResources'); // 执行资源剔除
  await originalAssembleHar.execute(); // 执行原打包任务
  console.log('HAR打包完成（已剔除指定资源）');
});

// 导出任务
exports.default = {
  ...appTasks,
  removeResources
};

步骤 2：验证 HAR 包是否已剔除资源

执行打包命令后，解压生成的 HAR 包（位于AHar/build/outputs/har/AHar.har），检查是否存在resources目录下的目标资源：

# 打包命令
hvigor run --module AHar assembleHar

# 解压验证（以zip命令为例）
unzip AHar.har -d AHar_unzip
# 检查AHar_unzip/resources目录下是否已无被剔除的资源

二、解决 “引用工程中资源丢失” 的问题

剔除 HAR 中的资源后，引用该 HAR 的工程（如主工程）必须提供与 HAR 中依赖的资源 ID 完全一致的资源，否则会出现 “字体颜色丢失、图片不显示” 的问题（因 HAR 内的代码仍通过资源 ID 引用，如$r('app.color.theme_color')）。

步骤 1：梳理 HAR 中依赖的资源 ID

需明确 HAR 模块的代码中引用了哪些资源（避免遗漏），例如：

• 图片资源：$r('app.media.logo')（对应media/logo.png）
• 主题色：$r('app.color.theme_primary')（对应element/color.json中的theme_primary）

可通过搜索 HAR 模块的代码，收集所有$r(...)形式的资源引用，整理成资源 ID 清单。

步骤 2：在引用工程中补充资源

在引用 HAR 的主工程（或其他模块）的resources目录下，创建与 HAR 中依赖的资源 ID 完全一致的资源：

主工程/
└── src/main/resources/
    ├── media/
    │   └── logo.png  # 与HAR中引用的app.media.logo对应
    └── element/
        └── color.json  # 包含theme_primary等主题色定义

示例color.json：

{
  "color": [
    {
      "name": "theme_primary",
      "value": "#FF007DFF" // 主工程定义的主题色（需与HAR预期一致）
    }
  ]
}

步骤 3：确保资源引用优先级正确

鸿蒙的资源引用遵循 “就近原则”：当主工程与 HAR 包含相同 ID 的资源时，主工程的资源会覆盖 HAR 中的资源。因此，即使 HAR 未剔除资源，主工程也可通过同名 ID 覆盖；若 HAR 已剔除资源，主工程的资源会被 HAR 中的代码直接引用。

三、注意事项

1. 不可剔除未被主工程覆盖的资源：若 HAR 中存在某些资源，主工程未提供对应的 ID，剔除后会导致运行时错误（Resource not found）。需确保所有被 HAR 引用的资源 ID 在主工程中都有定义。
2. 避免剔除profile等关键资源：resources/profile目录下的配置文件（如页面路由、权限配置）可能被 HAR 内部逻辑依赖，剔除前需确认无引用。
3. Hvigor 脚本路径准确性：RESOURCES_TO_REMOVE中的路径需与实际项目结构一致（如src/main/resources还是main/resources，取决于模块类型）。
4. 版本控制：若多人协作，需同步 HAR 的资源 ID 清单给主工程开发者，确保资源 ID 一致。

总结

剔除 HAR 中的资源需通过Hvigor 脚本主动删除，但核心是引用工程必须补充对应的资源 ID。这一方案适用于 “资源由主工程统一管理，HAR 仅提供业务逻辑” 的场景（如 SDK 分发）。若仅是为了减小 HAR 体积，更推荐通过资源压缩或仅剔除冗余资源（而非全部），避免因资源缺失导致界面异常。