> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装 Qualcomm AI Runtime SDK

> 使用直接下载或 Qualcomm Package Manager，在 Ubuntu 22.04 主机上下载并安装 Qualcomm AI Runtime（QAIRT）SDK。

Qualcomm AI Runtime SDK 需要 Ubuntu 22.04 主机。

<Note>
  如果主机使用 Windows 或 macOS 操作系统软件，
  请安装虚拟机。
  后续步骤必须在运行 Ubuntu
  22.04 LTS 的虚拟机中执行。
</Note>

Qualcomm AI Runtime SDK 工作流程已在以下配置中通过
裸机或虚拟机内运行的 Ubuntu 22.04 进行验证。

<Note>
  不支持在基于 Arm® 架构的 macOS 上的虚拟机中运行 Ubuntu 22.04。
</Note>

| 下载方式                                                                                                                                      | 前提条件                                          | 可用版本                     |
| ----------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ------------------------ |
| [直接下载](https://softwarecenter.qualcomm.com/api/download/software/sdks/Qualcomm_AI_Runtime_Community/All/2.47.0.260601/v2.47.0.260601.zip) | 下载无前提条件                                       | 2.47.0.260601（SDK 每季度更新） |
| [Qualcomm Package Manager](#qairt-qpm)                                                                                                    | 有效的 Qualcomm ID 和 Qualcomm Package Manager 工具 | SDK 每月更新                 |

## 默认版本

下表列出了适用于您的目标设备操作系统的默认 Qualcomm AI Runtime SDK 版本。

| 操作系统                   | 默认版本          |
| ---------------------- | ------------- |
| Qualcomm Linux（GA 2.0） | 2.47.0.260601 |

## 直接下载

[下载 Qualcomm AI Runtime SDK](https://softwarecenter.qualcomm.com/api/download/software/sdks/Qualcomm_AI_Runtime_Community/All/2.47.0.260601/v2.47.0.260601.zip)。
下载完成后，提取或解压 SDK。

<Note>
  本示例使用 SDK 的 `2.47.0.260601` 版本。要使用其他版本的
  QAIRT SDK，请使用您所用的版本更新以下步骤。
</Note>

<Note>
  上述链接托管的 SDK 版本每季度更新一次。
</Note>

```shell theme={null}
unzip v2.47.0.260601.zip 
```

```shell theme={null}
cd qairt/2.47.0.260601
```

```shell theme={null}
export QAIRT_ROOT=`pwd`
```

完成后，继续[设置 Qualcomm AI Runtime SDK](../topic/qairt-setup)。

<h2 id="qairt-qpm">
  Qualcomm Package Manager
</h2>

Qualcomm AI Runtime SDK 可通过
Qualcomm Package Manager（QPM）下载。本节演示如何
使用 QPM 下载 Qualcomm AI Runtime SDK。

要下载 QPM3，请从 [Qualcomm Package Manager](https://qpm.qualcomm.com/#/main/tools/details/QPM3) 安装 QPM3

<Note>
  要从 Qualcomm Package Manager 下载 Qualcomm AI Runtime SDK，
  请确保您已注册 Qualcomm ID。
  如果您没有 Qualcomm ID，系统会提示您注册。
  然后按照以下说明下载并安装 SDK。
</Note>

<Note>
  本示例使用 SDK 的 `2.47.0.260601` 版本。要使用其他版本的
  QAIRT SDK，请使用您所用的版本更新以下步骤。
</Note>

1. 前往 [Qualcomm Package Manager](https://qpm.qualcomm.com/#/main/tools/find)
   并使用您的 Qualcomm ID 登录。

2. 转到 **Tools** 选项卡，在左侧窗格中搜索 *Qualcomm AI Runtime SDK*。
   从筛选结果中选择 **Qualcomm AI Runtime - Community Edition**。

   <img src="https://mintcdn.com/qualcomm-prod/WwC9kmcnKl9Ef7de/Key-Documents/AI-Developer-Workflow/_images/snpe-qpm-location.png?fit=max&auto=format&n=WwC9kmcnKl9Ef7de&q=85&s=7d1f2e85c64d63b61b9273066bceb16d" alt="Qualcomm Package Manager - SDK 位置" width="1651" height="684" data-path="Key-Documents/AI-Developer-Workflow/_images/snpe-qpm-location.png" />

3. 从 **Version** 下拉列表中选择 `v2.47.0.260601`。

   如果使用 Qualcomm Package Manager 桌面工具，
   则显示的是 **Extract** 按钮而非 **Download**。
   这会自动安装 Qualcomm AI Runtime SDK。

   如果您使用的是 Web 界面，**Download** 按钮
   将下载 Qualcomm AI Runtime SDK zip 文件。

   <img src="https://mintcdn.com/qualcomm-prod/WwC9kmcnKl9Ef7de/Key-Documents/AI-Developer-Workflow/_images/snpe-qpm-download.png?fit=max&auto=format&n=WwC9kmcnKl9Ef7de&q=85&s=512e3cb7c680fe7ab9e705ce752c144c" alt="Qualcomm Package Manager - 下载" width="1876" height="934" data-path="Key-Documents/AI-Developer-Workflow/_images/snpe-qpm-download.png" />

4. 使用 QPM CLI 工具安装 Qualcomm AI Runtime SDK。

   a. 使用 QPM CLI 登录。

   ```shell theme={null}
   qpm-cli --login <username>
   ```

   预期输出：

   ```
   Password:
   [Info] : Login is successful
   [Info] : Fetching product catalog ....
   [Info] : Product catalog refreshed successfully
   ```

   b. 激活您的 SDK 许可证。

   ```shell theme={null}
   qpm-cli --license-activate qualcomm_ai_runtime_sdk
   ```

   预期输出：

   ```
   [Info] : Activating license : qualcomm_ai_runtime_sdk
   [Info] : License activation is successful ActivationId=[f██████████b]
   ```

   c. 下载、提取并安装 SDK。

   ```shell theme={null}
   qpm-cli --install qualcomm_ai_runtime_sdk --version 2.47.0.260601
   ```

   预期输出：

   ```
   [Info] : Current logged in user is <user name>
   [Info] : Downloading qualcomm_ai_runtime_sdk 2.47.0.260601 ....
   ...
   [Info] : SUCCESS: Installed qualcomm_ai_runtime_sdk.Core at /opt/qcom/aistack/qairt/2.47.0.260601
   ```