创建软件包
发布软件包至 Armory 仓库前,可以通过 init 命令自动创建一个包含 armory.json 且符合 目录结构规范 的软件包文件夹,无需手动创建,从而提高发布效率。
前提条件
已安装并 登录客户端。
操作步骤
在开始搜索框或任意文件夹地址栏输入“cmd”,打开终端。
在终端执行如下命令,创建软件包。
armory init <package-spec>
其中 package-spec 为软件包 名称说明符,用于指定要创建的软件包名称和版本号,其格式为:
[<@namespace/>]<package-name>[@<version>]
。各参数说明如下:参数 是否必选 说明 namespace 否 软件包 命名空间,包括用户、组织和全局空间。命名空间只能由小写字母、数字和特殊字符“-”、“_”组成,不能包含空格,且长度不能超过 30 个字符。各类型软件包的 namespace 设置方法如下: - 若要创建个人软件包,请将 namespace 设置为个人用户名(username),若存在同名用户,系统会自动区分命名空间,具体请参见 Web 端个人信息页面个人头像下的“@xxx”信息
- 若要创建组织软件包,请将 namespace 设置为组织名称(orgname)
- 若要创建全局软件包,可以不设置 namespace,系统会默认发布为全局软件包(global)
package-name 是 软件包名,只能由小写字母、数字和特殊字符“-”、“_”组成,不能包含空格,且长度不能超过 50 个字符 version 否 软件包版本号,版本号需遵循 Semantic Versioning 语义化版本规范。如果不指定版本号,则创建的软件包的 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
创建完成后,进入命令行工作目录(如 D:\software\Armory),可以看到以 namespace 命名的文件夹,创建的软件包也包含在内。软件包目录结构如下图所示,可以参考 软件包规范 定义 armory.json 以及具体要发布的文件集,以快速发布软件包。