49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
|
---
|
|||
|
|
name: CSCI构建规程编写规范
|
|||
|
|
description: 编写符合军用软件标准的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 编译/建立规程”章节内容，包含上述全部要素。
|