> ## 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>

<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 每月更新一次                 |
</Note>

## 默认版本

下表列出了目标设备操作系统对应的默认 Qualcomm AI Runtime SDK 版本。

| 操作系统         | 默认版本          |
| ------------ | ------------- |
| Ubuntu (x13) | 2.46.0.260424 |

## 直接下载

[下载 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>

<Steps>
  <Step title="登录 Qualcomm Package Manager">
    访问 [Qualcomm Package Manager](https://qpm.qualcomm.com/#/main/tools/find)，
    使用您的 Qualcomm ID 登录。
  </Step>

  <Step title="查找 Qualcomm AI Runtime SDK">
    前往 **Tools** 选项卡，在左侧窗格中搜索 *Qualcomm AI Runtime SDK*。
    从筛选后的结果中选择 **Qualcomm AI Runtime - Community Edition**。

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-prod/zh/AI-Developer-Workflow-Ubuntu/_images/snpe-qpm-location.png" alt="Qualcomm Package Manager - SDK 位置" />
  </Step>

  <Step title="选择版本并下载">
    从 **Version** 下拉列表中选择 `v2.47.0.260601`。

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

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

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-prod/zh/AI-Developer-Workflow-Ubuntu/_images/snpe-qpm-download.png" alt="Qualcomm Package Manager - 下载" />
  </Step>

  <Step title="使用 QPM CLI 工具安装 Qualcomm AI Runtime SDK">
    <Steps>
      <Step title="使用 QPM CLI 登录">
        ```shell theme={null}
        qpm-cli --login <username>
        ```

        预期输出：

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

      <Step title="激活您的 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]
        ```
      </Step>

      <Step title="下载、解压并安装 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
        ```
      </Step>
    </Steps>
  </Step>
</Steps>