# 编译 QIR SDK
以下部分介绍如何编译 QIR SDK。
Warning
不建议重新编译 QIR SDK，因为此过程对于非专业人士来说非常复杂。除非您遇到以下情况并知道自己在做什么：
- 您使用的设备列在 [支持的平台](https://docs.qualcomm.com/doc/80-70020-265Y/topic/introduction.html#section-amr-ck3-5bc) 中，但没有可用的预编译镜像文件；例如，IQ-8 Beta 评估套件。
- 您想为 QIR SDK 添加新功能。
- 您想更改目标镜像的内容。
- 您想修复 QIR SDK 中的错误。
- 您想优化 QIR SDK 的性能。
- 您想更改某些组件的版本。
## 选择最适合您的方法
要同步和编译 QIR SDK 和机器人镜像，您可以选择以下四个选项之一：
- 使用 [Qualcomm Software Center (QSC) Launcher GUI](https://docs.qualcomm.com/doc/80-70020-265Y/topic/qsc_launcher_gui.html#build-with-the-qsc-launcher)。
- 使用 [Qualcomm Software Center 命令行界面 (QSC-CLI)](https://docs.qualcomm.com/doc/80-70020-265Y/topic/qsc_cli.html#using-qsc-cli-3-1)。
- 在您的 PC 上使用 [GitHub 工作流](https://docs.qualcomm.com/doc/80-70020-265Y/topic/github_workflow.html#section-github-workflow)。**（推荐）**
- 在您的 PC 上使用 [Docker](https://docs.qualcomm.com/doc/80-70020-265Y/topic/docker_workflow.html#section-docker-workflow) 进行编译。**（推荐）**
如果您只想编译机器人镜像，您可以使用 [支持的平台](https://docs.qualcomm.com/doc/80-70020-265Y/topic/introduction.html#section-amr-ck3-5bc) 中预编译的 eSDK，方法如下：
>
>
> [使用预编译的机器人 eSDK 编译机器人镜像](https://docs.qualcomm.com/doc/80-70020-265Y/topic/esdk_gen_image.html#section-esdk-gen-image)
## 主机要求
编译 QIR SDK 的主机需满足以下要求：
| **硬件** | x86 计算机
四核 CPU，例如 Intel i7-2600，3.4 GHz（同等或更高配置）
≥ 450 GB 可用磁盘空间（交换分区 ≥ 32 GB）
≥ 16 GB RAM |
| --- | --- |
| **软件** | Git 1.8.3.1 或更高版本
Tar 1.28 或更高版本
Python 3.10.2 或更高版本
GCC 7.5 或更高版本
GNU Make 4.0 或更高版本
运行部分命令需要 sudo 权限 |
Note
要在 Microsoft Windows 或 Apple® macOS® 上搭建运行 Ubuntu 22.04 的虚拟机 (VM)，请参阅 [Qualcomm Linux 虚拟机搭建指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-41/getting-started.html)。VM 上的代码编译是一个较慢的过程，可能需要几个小时。Qualcomm 建议使用 Ubuntu 主机进行编译。
Last Published: Oct 13, 2025
[Previous Topic
可选的开发者工作流](https://docs.qualcomm.com/bundle/publicresource/80-70020-265Y/topics/optional-workflows.md) [Next Topic
使用 QSC Launcher 编译](https://docs.qualcomm.com/bundle/publicresource/80-70020-265Y/topics/qsc_launcher_gui.md)