---
tags: []
date created: 星期三, 十一月 19日 2025, 7:50:36 晚上
date modified: 星期三, 十一月 19日 2025, 7:51:09 晚上
---

# 1.4.5 产物输出与安装规则 (Artifact Output & Installation Rules)

**审计综述**：
项目采用了\*\*“集中式输出”**策略，极大地方便了开发阶段的调试与运行。然而，主构建脚本**完全缺失了安装规则 (`install`)\*\*，这意味着无法通过 `make install` 将产物打包或部署到系统目录，当前仅限于在构建目录（Build Tree）内运行。

**1. 输出目录布局 (Output Directory Layout)**

  - **关键性**：**P1**
  - **策略解析**：
      - **集中管理**：通过设置 `CMAKE_RUNTIME_OUTPUT_DIRECTORY` 等变量，强制将所有生成物归档到 `${CMAKE_BINARY_DIR}/bin` 和 `${CMAKE_BINARY_DIR}/lib`。
      - **优势**：
          - 避免了编译产物散落在源码目录深处（In-source build pollution）。
          - 简化了 `RPATH` 的管理，因为所有库都在同一个相对路径下。
          - 方便了 `numactl` 等工具的调用路径书写（如 1.3.3 中所示）。
  - **探测依据**：

    ```cmake
    set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
    ```

**2. 安装规则状态 (Installation Rule Status)**

  - **关键性**：**P2 (Missing)**
  - **策略解析**：
      - **现状**：`grep "install("` 显示主项目（`app` 和 `signal_lib`）**未定义任何安装规则**。仅有的安装指令来自第三方依赖（GTest）和 SDK 内部文件。
      - **影响**：运行 `make install` 将不会复制雷达主程序或库文件。对于目前的 Demo / 原型开发阶段，这是可接受的。
      - **改进建议**：若项目进入生产交付阶段，必须补充 `install(TARGETS main_app DESTINATION bin)` 等指令，以便生成发布包（RPM/DEB）。
  - **探测依据**：

    ```bash
    grep -r "install(" …
    # (无主项目相关输出)
    ```

**3. 调试符号与剥离策略 (Debug Symbol Strategy)**

  - **关键性**：**P2**
  - **策略解析**：
      - **物理状态**：`file` 命令显示 `not stripped`，说明符号表（Symbol Table）保留，可支持 `nm` 或 `gdb` 查看函数名堆栈。
      - **调试信息**：`readelf` 未找到 `.debug` 段。这是因为当前处于 **Release** 模式（`-O3 -DNDEBUG`），编译器默认不生成 DWARF 源码级调试信息。
      - **结论**：这是标准的 Release 构建产物，兼顾了性能（优化开启）和基础可维护性（崩溃时能看到函数名）。
  - **探测依据**：

    ```bash
    file …/main_app
    … not stripped
    ```

-----

### 1.4 章节最终总结：构建系统与工程配置

至此，我们完成了对 **1.4 构建系统** 的全方位审计。我们确立了该项目的\*\*“构建基线”\*\*：

1. **核心**：CMake 4.1 + Unix Makefiles。
2. **编排**：**Host(GCC) + Device(Clang) 显式分离**，禁用原生 CUDA 语言支持。
3. **标志**：适配了 CoreX SDK 的 `-x ivcore` 方言，但缺少 Host 端的架构优化 (`-march=armv8-a`)。
4. **布局**：产物集中输出到 `build/bin`，RPATH 自动注入，安装规则待补。