2.1 KiB
2.1 KiB
name, description
| name | description |
|---|---|
| CSCI构建规程编写规范 | 编写符合军用软件标准的CSCI(计算机软件配置项)编译与构建规程文档。当需要详细描述如何从源代码构建可执行软件、确保构建过程可重现、并满足软件产品规范(SPS)要求时使用此技能。 |
CSCI构建规程编写规范
何时使用
- 需要为CSCI编写完整的编译/构建规程文档(如软件设计说明SDS第5.2条)
- 要求构建过程具备可重现性,使具备资质人员能从源文件生成一致的可执行文件
- 构建涉及多个目标环境、配置或版本
- CSCI属于更大系统,需引用或整合系统级构建规程
不适用场景:仅使用预编译二进制文件、无需从源码构建的情况。
执行步骤
-
明确编译/汇编工具
- 指定编译器或汇编器的名称及完整版本号(例如:GCC 11.2.0)
-
列出构建依赖资源
- 包括链接器、静态/动态库、操作系统版本、硬件平台等软硬件资源及其版本
-
定义编译与链接选项
- 详细说明使用的设置、开关和约定,例如:
- 优化级别(-O2)
- 调试信息开关(-g)
- 宏定义(-DDEBUG)
- 警告级别与错误处理策略
- 详细说明使用的设置、开关和约定,例如:
-
提供完整构建流程
- a) 编译/汇编各源文件的顺序与命令
- b) 链接生成最终可执行文件的步骤
- c) 准备将可执行文件加载至固件或分发介质的操作
-
处理多配置变更
- 描述如何支持不同现场环境、硬件变体或软件版本,例如:
- 使用条件编译(#ifdef)
- 切换配置文件或构建脚本参数
- 管理配置标识符(如target_configurations)
- 描述如何支持不同现场环境、硬件变体或软件版本,例如:
-
引用系统级规程(如适用)
- 若CSCI隶属于更大系统,可在软件产品规范(SPS)中定义系统级构建规程,并在此处明确引用
-
确保可重现性
- 所有步骤必须足够清晰、完整,使具备资质的开发人员能独立复现完全相同的构建结果
输出要求
生成符合军用软件文档标准的“5.2 编译/建立规程”章节内容,包含上述全部要素。