# 快速下载软件包

Armory 的 Web 端和客户端均提供了软件包下载功能，支持选择任意版本、平台或架构的软件包进行下载。本节将重点介绍如何快速通过 Web 端或客户端将软件包下载至本地计算机，您可以根据需求选择合适的方式进行下载。

# 前提条件

• 具备下载目标软件包的权限，关于软件包权限的详细内容请参见 权限管理。
• 在局域网环境下，需要先获取翼辉软件工厂账号和密码信息，具体可联系系统管理员获取。有关系统管理员的详细信息，请在 Armory Web 端登录页面获取。
• 在公网环境下，如果要 通过客户端下载，则必须先注册翼辉 ID 以获取账号密码信息。若尚未注册，可在登录页下方单击点击注册，并按提示完成注册。

# 操作步骤

# 通过 Web 端下载

1. 登录 Armory Web 端。

2. 在 Armory 主界面的顶部搜索框中，输入软件包名称、描述或关键字等信息搜索目标软件包。

   

3. 单击要下载的软件包名称，在软件包详情页，可以选择 在文件页签下载 或 在版本页签下载 所需软件包。如果是下载指定版本的软件包，则建议选择在版本页签下载。

# 在文件页签下载

1. 在软件包详情页，单击文件，进入软件包文件页签。

   
   说明：

   • 软件包详情页默认显示最新版本的软件包信息。
   • 在软件包文件页签，单击可以切换文件视图，支持平台视图和文件夹视图两种方式，默认为平台视图，可以按需切换。
     • 平台视图：指软件包包含文件按照平台和架构维度的逻辑结构展示。
     • 文件夹视图：指软件包包含文件按照实际发布的物理文件结构展示。

2. 在软件包文件页签，可以按需选择如下几种方式下载软件包：

   • 下载整个软件包：单击文件列表右上角的下载，下载整个软件包。

   • 下载某个平台或架构的软件包：此处以“平台视图”展示方式为例介绍。选择要下载的软件包平台，单击逐层展开文件夹，然后单击目标文件右侧的，选择下载，下载软件包。

3. 下载完成后，在浏览器的下载管理器中，可以查看软件包的存放路径，并检查已下载的软件包。

# 在版本页签下载

1. 在软件包详情页，单击版本，进入软件包版本页签。

   

2. 在软件包版本页签，选择要下载的软件包版本，单击其最右侧的，按需选择下载所有或下载指定平台架构的软件包。

   

3. 下载完成后，在浏览器的下载管理器中，可以查看软件包的存放路径，并检查已下载的软件包。

# 通过客户端下载

1. 参考 快速发布软件包 步骤 1 和 2 完成 Armory 客户端下载与安装。

2. 在终端执行如下命令，配置仓库地址。以下命令中的地址为当前环境的实际仓库地址，可直接复制使用。其中 default 为仓库别名，支持自定义。

   armory repo set default=protocol://host

   armory repo use default

   

3. 执行armory login按提示输入用户名密码，或直接执行armory login -u username -p password，登录 Armory 客户端。

   

4. 执行如下命令，通过关键词搜索目标软件包，并查看软件包的基本信息。

   armory search armory-cli
   
   

5. 执行如下命令，下载软件包至计算机本地。可通过如下两种方式下载：

   armory get @namespace/package-name [-v <version> | -t <tag>] [-P <platform>] [-A <arch>] [-s] [-d <directory>] [--no-dep] [--force] 
   

   armory get @namespace/package-name[@version | @tag][@platform@arch] [-d <directory>] [--no-dep] [--force]
   

   参数说明如下：

   参数	是否必选	说明
   @namespace/package-name	是	完整的软件包名称，包括命名空间和包名
   -v, --version	否	指定软件包版本，如 1.7.6 。version 和 tag 不能同时使用。如果不指定，则默认下载最新版本
   -t, --tag	否	指定软件包 Tag，如 latest 。使用 tag 时，不需要指定 version
   -P, --platform	否	指定软件包的平台，如 SylixOS、Windows、Linux 或 macOS。如果不指定，则默认下载所有平台的软件包
   -A, --arch	否	指定软件包的架构，如 noarch、arm64、x86-64 等。如果不指定，则默认下载某平台下所有架构的软件包
   -s, --suitable	否	适配当前运行环境的操作系统和架构，无需手动指定 platform 和 arch
   -d, --directory	否	指定软件包的下载路径。设置该选项时，软件包将下载至指定目录下，以 @namespace 命名的文件夹内；未设置时，默认下载至当前工作目录（如 D:\software\Armory），并存放在以 @namespace 命名的文件夹内
   --no-dep	否	设置是否禁止下载软件包依赖。如果设置了该选项，系统将不会下载该软件包的依赖包，仅下载指定的软件包本身；如果未设置该选项，则系统会默认下载该软件包的所有依赖包
   -f, --force	否	设置是否强制下载软件包。使用此选项则会忽略本地仓库缓存，直接从远程仓库下载，并覆盖目标路径下已存在的文件

   下面以下载“软件包名称为 @armory/armory-cli、版本为 1.7.6、平台为 Linux、架构为 x86-64”的软件包为例，介绍如何下载目标软件包，且不下载其依赖包。

   armory get @armory/armory-cli@1.7.6@linux@x86-64 --no-dep
   
   

6. 下载完成后，进入命令行工作目录（如 D:\software\Armory），可以查看已下载的软件包。所有下载的软件包会放置在以 @namespace 命名的文件夹内。