Files
linux_format_docs_check/GJB438C-2021_prd_skills/csci-build-procedure-specification/SKILL.md
2026-05-18 13:54:23 +08:00

2.1 KiB
Raw Blame History

name, description
name description
CSCI构建规程编写规范 编写符合军用软件标准的CSCI计算机软件配置项编译与构建规程文档。当需要详细描述如何从源代码构建可执行软件、确保构建过程可重现、并满足软件产品规范(SPS)要求时使用此技能。

CSCI构建规程编写规范

何时使用

  • 需要为CSCI编写完整的编译/构建规程文档如软件设计说明SDS第5.2条)
  • 要求构建过程具备可重现性,使具备资质人员能从源文件生成一致的可执行文件
  • 构建涉及多个目标环境、配置或版本
  • CSCI属于更大系统需引用或整合系统级构建规程

不适用场景:仅使用预编译二进制文件、无需从源码构建的情况。

执行步骤

  1. 明确编译/汇编工具

    • 指定编译器或汇编器的名称及完整版本号例如GCC 11.2.0
  2. 列出构建依赖资源

    • 包括链接器、静态/动态库、操作系统版本、硬件平台等软硬件资源及其版本
  3. 定义编译与链接选项

    • 详细说明使用的设置、开关和约定,例如:
      • 优化级别(-O2
      • 调试信息开关(-g
      • 宏定义(-DDEBUG
      • 警告级别与错误处理策略
  4. 提供完整构建流程

    • a) 编译/汇编各源文件的顺序与命令
    • b) 链接生成最终可执行文件的步骤
    • c) 准备将可执行文件加载至固件或分发介质的操作
  5. 处理多配置变更

    • 描述如何支持不同现场环境、硬件变体或软件版本,例如:
      • 使用条件编译(#ifdef
      • 切换配置文件或构建脚本参数
      • 管理配置标识符如target_configurations
  6. 引用系统级规程(如适用)

    • 若CSCI隶属于更大系统可在软件产品规范(SPS)中定义系统级构建规程,并在此处明确引用
  7. 确保可重现性

    • 所有步骤必须足够清晰、完整,使具备资质的开发人员能独立复现完全相同的构建结果

输出要求

生成符合军用软件文档标准的“5.2 编译/建立规程”章节内容,包含上述全部要素。