> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.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-staging/uWQLnBcS9sxlZhgB/Key-Documents/AI-Developer-Workflow/_images/snpe-qpm-location.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=c1f98a05756c76c33c2af9c8d427260c" 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-staging/uWQLnBcS9sxlZhgB/Key-Documents/AI-Developer-Workflow/_images/snpe-qpm-download.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=4f24dc45f8eeacef58d49668302c4aef" 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
   ```