使用 xmake 工具编译 rt-thread 工程

发布于 2022-05-09 10:10:20 浏览：1021 订阅该版

[tocm]

在最新的 rt-thread 主仓库，支持使用 xmake 工具来编译 rt-thread 工程。

## xmake

### 介绍

xmake 是一个基于 Lua 的轻量级跨平台构建工具，使用 xmake.lua 维护项目构建，相比 makefile/CMakeLists.txt，配置语法更加简洁直观，对新手非常友好，短时间内就能快速入门，能够让用户把更多的精力集中在实际的项目开发上。

![xmake-basic-render.gif](https://oss-club.rt-thread.org/uploads/20220509/ca987543e6d97fd8d5e1e9de46040a03.gif)

### 安装

打开 powershell 管理员，输入下面的命令:

```powershell
Invoke-Expression (Invoke-Webrequest 'https://xmake.io/psget.text' -UseBasicParsing).Content
```

输入 xmake --version，查看 xmake 是否安装成功：

```powershell
PS C:\Users> xmake --version
xmake v2.6.5+master.1c4b7d59a, A cross-platform build utility based on Lua
Copyright (C) 2015-present Ruki Wang, tboox.org, xmake.io
                         _
    __  ___ __  __  __ _| | ______
    \ \/ / |  \/  |/ _  | |/ / __ \
     >  <  | \__/ | /_| |   <  ___/
    /_/\_\_|_|  |_|\__ \|_|\_\____|
                         by ruki, xmake.io

👉  Manual: https://xmake.io/#/getting_started
    🙏  Donate: https://xmake.io/#/sponsor

```

## 使用方法

下面介绍一下如何使用 xmake 工具来编译 rt-thread 工程。

#### 设置工具链路径

这里以 gcc-arm-none-eabi-10.3 为例：

```powershell
set RTT_EXEC_PATH=E:\download\idm\gcc-arm-none-eabi-10.3-2021.10
```

#### 生成工程文件

以 `stm32f407-st-discovery` 工程为例，在该 bsp 目录下打开 env 工具，输入命令 `scons --target=xmake` 生成 **xmake.lua** 文件：

![image-20220509095250495.png](https://oss-club.rt-thread.org/uploads/20220509/4fe4590ec5e5d2e0ff7ab3dfb2376421.png)

#### 编译工程

输入命令 `xmake -j 16` 编译工程:

![image-20220509095642463.png](https://oss-club.rt-thread.org/uploads/20220509/df9f8dc83cf619bf8238df0585118884.png)

##### 编译成功显示

![image-20220509095651651.png](https://oss-club.rt-thread.org/uploads/20220509/f3c7f48a8138570d405780837564b62a.png)

## 最后

- 关于 xmake.lua 的支持只是做了最基本的适配，如果社区开发者有自己的想法，欢迎提交 PR。

- 2022 开源之夏，xmake 与 rt-thread 提出了一个关于**<<基于xmake的面向RT-Thread Smart操作系统的系统构建工具>>**的项目，

各位有想法的同学，欢迎申请该项目。

## 相关资料

- [介绍 (xmake.io)](https://xmake.io/#/zh-cn/about/introduction)
- [Summer-2022 (summer-ospp.ac.cn)](https://summer-ospp.ac.cn/#/org/prodetail/220900222)
- [入门指南 (rt-thread.org)](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-smart/rt-smart-quickstart/rt-smart-quickstart