名称规范

更新时间:
2024-12-27

名称规范

完整的软件包名称由 命名空间(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(全局包)。

文档内容是否对您有所帮助?
有帮助
没帮助