> ## 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.50.0.260828/v2.50.0.260828.zip) | 下载无前提条件 | 2.50.0.260828(SDK 每季度更新) |
| [Qualcomm Package Manager](#qairt-qpm) | 有效的 Qualcomm ID 和 Qualcomm Package Manager 工具 | SDK 每月更新 |

## 默认版本

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

| 操作系统 | 默认版本 |
| - | - |
| Qualcomm Linux (GA 2.1) | 2.50.0.260828 |

## 直接下载

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

<Note>
  本示例使用 SDK 的 `2.50.0.260828` 版本。要使用其他版本的
  QAIRT SDK,请将以下步骤更新为您使用的版本。
</Note>

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

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

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

```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.50.0.260828` 版本。要使用其他版本的
  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://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" />
  </Step>

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

    如果使用 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" />
  </Step>

  <Step title="使用 QPM CLI 安装 SDK">
    使用 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.50.0.260828
        ```

        预期输出:

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