# 编译 QIR SDK
以下各节介绍了如何编译 QIR SDK。
Warning
不建议重新编译 QIR SDK，因为编译过程对于非专业人士来说比较复杂。仅当您了解流程并有以下需求时，才编译 QIR SDK：
- 为没有预编译镜像的设备编译镜像，例如 Qualcomm^®^ IQ-8 Beta 评估套件。更多详细信息，参见 [支持的平台](https://docs.qualcomm.com/doc/80-70022-265Y/topic/introduction.html#section-amr-ck3-5bc)。
- 向 QIR SDK 添加新功能。
- 更改目标镜像的内容。
- 修复 QIR SDK 中的错误。
- 优化 QIR SDK 的性能。
- 更改某些组件的版本。
## 选择最适合您的方法
要同步和编译 QIR SDK 和机器人镜像，请选择以下四个选项之一：
- 使用 [Qualcomm Software Center (QSC) Launcher GUI](https://docs.qualcomm.com/doc/80-70022-265Y/topic/qsc_launcher_gui.html#build-with-the-qsc-launcher)。
- 使用 [Qualcomm Software Center 命令行接口 (QSC-CLI)](https://docs.qualcomm.com/doc/80-70022-265Y/topic/qsc_cli.html#using-qsc-cli-3-1).
- 在您的电脑上使用 [GitHub 工作流](https://docs.qualcomm.com/doc/80-70022-265Y/topic/github_workflow.html#section-github-workflow)。**（推荐）**
- 使用 [Docker](https://docs.qualcomm.com/doc/80-70022-265Y/topic/docker_workflow.html#section-docker-workflow) 在您的电脑上进行编译。**（推荐）**
若仅编译机器人镜像，请使用 [支持的平台](https://docs.qualcomm.com/doc/80-70022-265Y/topic/introduction.html#section-amr-ck3-5bc) 中预编译的 eSDK，方法如下：
>
>
> [使用预编译的机器人 eSDK 编译机器人镜像](https://docs.qualcomm.com/doc/80-70022-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-70022-41/getting-started.html)。VM 上的代码编译是一个较慢的过程，可能需要几个小时。Qualcomm 建议使用 Ubuntu 主机进行编译。
Last Published: Nov 11, 2025
[Previous Topic
可选的开发者工作流](https://docs.qualcomm.com/bundle/publicresource/80-70022-265Y/topics/optional-workflows.md) [Next Topic
使用 QSC Launcher 编译](https://docs.qualcomm.com/bundle/publicresource/80-70022-265Y/topics/qsc_launcher_gui.md)