新增 `gen` 命令，实现SDF文件的自动化生成 · Pull Request !19 · openEuler/splitter

本次PR为 `splitter` 工具引入了一个全新的核心功能：`gen` 命令，旨在自动化地为openEuler的RPM软件包生成Slice Definition File (SDF) 的草稿。

这个工具的目标是将开发者从繁琐的手工编写SDF工作中解放出来，通过自动化的方式生成一个结构清晰的“基线SDF”。对于简单软件包，生成的SDF可直接使用；对于复杂软件包，它能提供一个高质量的起点，供社区专家进行功能性的微调。

#### 主要流程 (High-Level Workflow)

为了确保分析的准确性和环境的纯净，`gen`命令的执行流程被设计为以下几个阶段：

1.  **环境准备 (Prepare)**
    *   在一个`with`上下文中，工具首先记录当前系统的软件包快照，然后使用 `dnf` **自动安装**待分析包及其所有运行时依赖。这确保了后续分析所需的所有库文件都已存在。

2.  **静态分析 (Analyze)**
    *   工具**另外下载**一个干净的目标RPM包作为分析对象。
    *   通过解压这个RPM包，可以**精确地获取**只属于该包的文件列表。
    *   对这个纯净的文件列表进行**分类**、**依赖分析**（使用`readelf`，`rpm -qf`）等一系列处理。

3.  **产出与清理 (Generate & Cleanup)**
    *   根据分析结果，生成结构清晰的`SDF.yaml`文件。
    *   `with`上下文结束时，工具会**自动对比**之前的快照，并使用 `dnf` **精确地卸载**所有在准备阶段新安装的软件包，确保对系统环境的零污染。

这个“**安装依赖以备分析，分析纯净包以保准确，事后清理以保干净**”的流程，保证了SDF生成的高度自动化和可靠性。

#### 实现细节 (Implementation Details)

为了实现上述流程，我将整个功能解耦为多个独立的模块，并通过一个主编排器 (`SDFGenerator`) 进行调度：

1.  **环境管理器 (`environment.py`)**:
    *   实现为一个Python上下文管理器 (`with`语句)，负责自动化的环境准备与清理。它通过对比`rpm -qa`快照，来精确追踪和卸载新安装的依赖。

2.  **文件分类器 (`classifier.py`)**:
    *   负责将RPM包内的文件归类到`_bins`, `_libs`, `_config`, `_copyright`等slice中。采用数据驱动的规则引擎，易于扩展，并能智能处理版权文件的特例、过滤掉文档和IMA等无关文件。

3.  **依赖分析器 (`dependency_analyzer.py`)**:
    *   **外部依赖**：对ELF文件使用`readelf -d`分析其直接依赖库，再结合`ldconfig`缓存和`rpm -qf`反查，建立slice间的外部依赖。
    *   **内部依赖**：自动注入包内常见的依赖关系，例如`_bins`对`_config`的依赖。
    *   **智能过滤**：自动识别并排除非ELF文件（如shell脚本）对分析的干扰。

4.  **SDF写入器 (`writer.py`)**:
    *   负责将分析结果组装成最终的SDF YAML文件。
    *   实现了**路径压缩算法**，能将版本化的共享库路径自动合并为带通配符的格式（如`/usr/lib*/libfoo.so.1*`）。
    *   在写入时会自动忽略掉内容为空或通常不需要的slice（如`_files`）。

#### 命令使用示例 (Usage Example)

新的 `gen` 命令通过 `tools/cmd/gen.py` 文件集成到 `splitter` 的主入口。

**命令格式:**
```bash
splitter gen -r <release> -o <output_dir> -p <package_name> [-a <arch>]
```

**示例：**
下面是为`brotli`软件包生成SDF的示例命令：

```bash
splitter gen -r 24.03-LTS -o ./output -p brotli
```

**生成的SDF文件 (`./output/brotli.yaml`):**
```yaml
package: brotli
deps:
- brotli_copyright
slices:
  bins:
    deps:
    - glibc_libs
    contents:
      common:
      - /usr/bin/brotli
  copyright:
    contents:
      common:
      - /usr/share/licenses/brotli/LICENSE
  libs:
    deps:
    - glibc_libs
    contents:
      common:
      - /usr/lib64/libbrotlicommon.so.1*
      - /usr/lib64/libbrotlidec.so.1*
      - /usr/lib64/libbrotlienc.so.1*
```

为`bash`生成SDF的示例命令：

```bash
splitter gen -r 24.03-LTS -o ./output -p bash
```

**生成的SDF文件 (`./output/bash.yaml`):**

```yaml
package: bash
deps:
- bash_copyright
slices:
  bins:
    deps:
    - bash_config
    - glibc_libs
    - ncurses-libs_libs
    contents:
      common:
      - /usr/bin/bash
      - /usr/bin/sh
  config:
    contents:
      common:
      - /etc/profile.d/alias.sh
      - /etc/skel/.bash_logout
      - /etc/skel/.bash_profile
      - /etc/skel/.bashrc
  copyright:
    contents:
      common:
      - /usr/share/licenses/bash/COPYING
```

类型	指派人员	状态
审查	weibaohui openeuler-ci-bot Jimmie haozi007 zmr_2020 yangzhao_kl leon wang gaodaweiky xuxuepeng 鲁卫军	已完成 (0/0人)
测试	openeuler-ci-bot	已完成 (0/0人)

openEuler/splitter .gitee-modal { width: 500px !important; }

搜索帮助

openEuler/splitter