# 创建软件包

Armory 支持通过 Web 端和客户端两种方式创建软件包。Web 端提供可视化操作界面，适合预设访问级别、标签及描述等元信息；客户端适用于本地开发场景，可快速生成符合规范的软件包目录结构，便于内容构建与版本发布。

# 操作须知

• Web 端创建：支持在界面中设置软件包类型、命名空间、访问级别、标签和描述等信息。创建完成后可直接配置成员权限，适合需要集中管理与协作的场景。
• 客户端创建：通过命令行创建包含 armory.json 且符合 目录结构规范 的软件包文件夹，适用于开发者在本地构建并发布软件包。发布后会自动在 Web 端生成对应的软件包并展示，便于后续管理。

# 前提条件

• 通过客户端创建软件包，需要先安装并 登录客户端。
• 组织软件包，只有组织所有者和组织管理员可以新建。关于软件包权限的详细说明请参见 权限概览。

# 操作步骤

# 通过 Web 端创建

1. 登录 Web 端。

2. 在 Armory 界面，单击页面右上角的，打开新建软件包对话框。

3. 在新建软件包对话框中，参考表 1 完成参数设置。

   

   表 1 新建软件包参数说明

   参数	描述	示例
   空间类型	选择软件包的归属类型，可选“组织”或“个人”	组织
   命名空间	软件包所属的命名空间。若为组织类型，可选择已有组织命名空间；若为个人类型，则默认使用个人命名空间	@example
   软件包名称	软件包的唯一标识。仅支持中文、小写字母、数字和特殊字符“-”、“_”，不得包含空格，且长度不能超过 50 个字符	package-name
   访问级别	设置软件包的可见范围，可选“私有”或“内部公开”。如需设置为“完全公开”，请在新建后联系系统管理员 切换访问级别，各级别详细介绍请参见 访问级别	私有
   标签	用于对软件包进行分类或标记，支持配置多个标签。每个标签不超过 50 个字符，总数量不超过 50 个	cloudnative
   描述	软件包的简要说明，建议概括其功能、用途等，最长不能超过 1024 个字符	-

4. 单击提交，完成软件包新建。页面右下角将显示新建成功提示，可通过该提示进入软件包详情页查看信息。新建的软件包初始为空，请参见 发布软件包 发布具体内容。

   

# 通过客户端创建

1. 在开始搜索框或任意文件夹地址栏输入“cmd”，打开终端。

2. 在终端执行如下命令，创建软件包。

   armory init <package-spec>
   

   其中 package-spec 为软件包 名称说明符，用于指定要创建的软件包名称和版本号，其格式为：[<@namespace/>]<package-name>[@<version>]。各参数说明如下：

   参数	是否必选	说明
   namespace	否	软件包 命名空间，包括用户、组织和全局空间。命名空间只能由中文、小写字母、数字和特殊字符“-”、“_”组成，不能包含空格，且长度不能超过 30 个字符。各类型软件包的 namespace 设置方法如下: 若要创建个人软件包，请将 namespace 设置为个人命名空间，一般为个人用户名（username），可在 Web 端个人信息页面查看或新建 若要创建组织软件包，请将 namespace 设置为组织名称（orgname） 若要创建全局软件包，可以不设置 namespace，系统会默认发布为全局软件包（global）
   package-name	是	软件包名称，只能由中文、小写字母、数字和特殊字符“-”、“_”组成，不能包含空格，且长度不能超过 50 个字符
   version	否	软件包版本号，版本号需遵循 Semantic Versioning open in new window 语义化版本规范。如果不指定版本号，则创建的软件包的 armory.json 中的"version"字段值默认为“1.0.0”

   下面以创建 namespace 为“software_factory”、package-name 为“armory-client”、版本号为“1.2.0”的组织软件包为例进行介绍。

   armory init @software_factory/armory-client@1.2.0
   
   

3. 创建完成后，进入命令行工作目录（如 D:\software\Armory），可以看到以 namespace 命名的文件夹，创建的软件包也包含在内。软件包目录结构如下图所示，可以参考 软件包规范 配置 armory.json 以及具体要发布的文件集，以快速发布软件包。