# 搜索软件包

Armory 客户端和 Web 端均提供了搜索软件包功能。在客户端，您可以进行单个或多个软件包的搜索，且支持指定分页与每页要显示的软件包数量。在 Web 端，您可以通过包名、描述和关键字等信息搜索指定软件包。

# 前提条件

• 已在目标仓库 发布软件包。
• 如果是通过客户端搜索，则需要先 配置仓库地址。

# 操作步骤

# 通过 Web 端搜索

1. 登录 Web 端。

2. 在 Armory 主界面，通过如下方式搜索软件包：

   • 通过标签（对应 labels 字段）搜索：在发现区域，单击软件包标签（如 armv7-sylixos-qt5），根据标签筛选相关软件包，然后在搜索结果列表中选择目标软件包。

   • 通过关键词搜索：在顶部搜索框中，输入软件包名称、描述或关键字等信息快速搜索指定软件包。

# 通过客户端搜索

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

2. 在终端执行如下命令，查看当前生效的仓库地址是否为目标仓库。

    armory repo ls
   
   

   如果是目标仓库，则继续执行步骤 3；如果非目标仓库，则可以执行armory repo use ${仓库名称} ，切换至目标仓库。

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

4. 登录成功后，按需执行以下命令，搜索软件包。

   • 搜索指定软件包，此处以搜索 armory-client 软件包为例介绍。

     armory search armory-client
     
     

   • 搜索多个软件包，且不指定分页和每页要展示的软件包个数。此时默认展示第 1 页，每页最多展示 10 条搜索结果。

     armory search
     
     

   • 搜索多个软件包，并指定分页和每页展示的软件包数量。

     armory search  --page-num 2 --page-size 2
     

     参数说明如下：

     参数	是否必选	说明
     --page-num	否	设置分页。如果设置为 2 ，则表示展示第 2 页；如果不设置，则默认按第 1 页展示。 page-num 和 page-size 可以设置其一，也可以均不设置
     --page-size	否	设置每页要展示的软件包数量。如果设置为 2，则表示每页展示 2 条数据；如果不设置，则每页默认最多展示 10 条数据

     
   说明：

   执行armory search --help命令，可以查看 armory search 命令相关的帮助文档。