使用脚本编译

SiFli Technology2025/6/6大约 2 分钟

使用 ENV 工具进行编译比较繁琐，在 SiFli-SDK 2.4.0 版本之后，我们提供了一种更简单的方式来进行编译，并且对于 Linux 和 macOS 以及 Windows 都适用。

准备工作

该步骤的前置准备是你安装了 git 工具，如何安装不多赘述。

目前源码托管在 GitHub 上，仓库链接为：https://github.com/78/xiaozhi-sf32

使用 gitee 加速

如果在国内访问 GitHub 可能比较困难，那么可以尝试使用 gitee 镜像仓库：https://gitee.com/SiFli/xiaozhi-sf32。下述的所有 github 的链接都可以替换为 gitee 的链接。

但是需要注意的是，gitee 中的子模块存在一些问题，所以 clone 的时候不需要添加--recursive参数，但是需要 clone 下来之后修改仓库根目录下的.gitmodules 文件，将

[submodule "sdk"]
	path = sdk
	url = ../../OpenSiFli/SiFli-SDK.git

修改为

[submodule "sdk"]
    path = sdk
    url = https://gitee.com/SiFli/sifli-sdk.git

然后手动执行 submoudle 初始化

git submodule update --init --recursive

使用以下命令克隆源码：

git clone --recursive https://github.com/78/xiaozhi-sf32.git

提示

需要注意的是，--recursive 参数是必须的，因为我们使用了子模块来管理依赖库。如果你忘记添加这个参数 clone 的话，请使用下面的命令重新拉取子模块 (submodule)：

git submodule update --init --recursive

xiaozhi 工程默认将 SiFli-SDK 作为一个子模块来引入。编译之前我们需要先安装 SiFli-SDK 工具，如果你之前已经安装过 SiFli-SDK 工具，可以跳过此步骤。

切换到 sdk 目录下，执行以下命令：

windows

cd sdk
.\install.ps1

macOS/Linux

cd sdk
./install.sh

安装完成之后，我们还需要设置环境变量，同样切换到 sdk 目录下，执行以下命令：

windows

cd sdk
.\export.ps1

macOS/Linux

cd sdk
. ./export.sh

我们的工程在app/project目录下，因此进入该目录下，执行以下命令：

cd app/project
scons --board=sf32lb52-lcd_n16r8 -j8

需要注意的是，这一步必须要在设置环境变量完成之后才能进行。

提示

在 scons 命令中，--board 参数指定了编译的目标板子，-j8 参数指定了编译的线程数，可以根据自己的电脑性能进行调整。

编译成功之后会出现以下提示：

保持开发板与电脑的USB连接，运行以下脚本下载程序到开发板：

windows

.\build_sf32lb52-lcd_n16r8_hcpu\uart_download.bat

macOS/Linux

./build_sf32lb52-lcd_n16r8_hcpu/uart_download.sh