名称规范
完整的软件包名称由 命名空间(namespace)和软件包名(package-name)组成,格式为:@namespace/package-name
。为确保软件包的可用性和可维护性,包名称需满足以下规范。
包名规范
- 软件包名(package-name)只能由小写字母、数字和特殊字符“-”、“_”组成,不能包含空格,且长度不能超过 50 个字符。
- 为提高软件包的辨识度并帮助用户快速了解其用途,包名应清晰体现其功能或目的,建议用“-”连接多个单词,如 armory-cli。
- 包名中不应包含版本号信息,版本号需在
armory.json
文件的version
字段中定义。
包名称说明符
包名称说明符(Package name specifier 简称package-spec
)用于唯一标识制品仓库中的软件包或其版本。它通常包括命名空间、包名、版本号或标签。通过package-spec
,可以在制品仓库中精确定位和管理不同的软件包及其版本。支持的格式如下:
[<@namespace/>]<package-name>
:指定软件包名称。[<@namespace/>]<package-name>@<tag>
:指定软件包标签。[<@namespace/>]<package-name>@<version>
:指定软件包版本。
其中<@namespace/>
为可选项,未指定时默认为 global(全局包)。