RT-Thread-rt-thread 工具讲解系列（三）之 env scons 命令初探RT-Thread问答社区

rt-thread 工具讲解系列（三）之 env scons 命令初探

发布于 2021-09-10 15:01:33 浏览：1861 订阅该版

[tocm]

##  前言

工欲善其事必先利其器。我们每天用的工具，你知道他有多厉害吗？
有时候我们苦恼，scons 生成的项目工程配置文件，里面自带的默认配置不合适，每次执行 "scons --target=xxx" 之后还得特意修改一下，忘记修改一次至少 rebuild 两次。能不能让生成的配置就是我们想要的呢？下面我们尝试解密它。

### 命令追踪

#### env

运行的是 "env/tools/scripts/env.py" 这个 python 脚本

#### menuconfig

运行的是 "env/tools/scripts/env.py menuconfig"
进而执行的 "env/tools/scripts/cmds/cmd_menuconfig.py" cmd 函数。

#### pkgs

运行的是 "env/tools/scripts/env.py pkgs"
进而执行的 "env/tools/scripts/cmds/cmd_package/__init__.py" run_env_cmd 函数。
pkgs 的命令行选项 update list 等等，分别对应 cmd_package_update.py cmd_package_list.py 等文件实现。

#### scons

scons 是一个基于 py 脚本实现的通用开发环境，类似 make。它的实现比较复杂。
但是最终，它执行的 bsp 下的 "SConstruct" 这个 py 脚本文件。
通过执行 "scons -h" 命令，我们可以查看 scons 命令的帮助信息。其中，"SCons Options:" 部分是 scons 默认自带的选项；"Local Options:" 是 rt-thread 添加的。"Local Options:" 部分的实现请移步到 rt-thread 仓库下 "tools/building.py" 文件内的 "PrepareBuilding" 函数。

下面我们详细看看 "scons --target=xxx"，因为它是我们今天的关注点。

#### scons targets

"PrepareBuilding" 函数里使用一个字典 tgt_dict 定义了 IDE、交叉编译链工具、编译器的对应关系。
"GenTargetProject" 函数根据 "target" 选项参数选择调用哪个版本 IDE 的生成项目文件的入口函数。

以 "mdk5" 为例，调用的同目录下 "keil.py" 文件 "MDK5Project" "MDK45Project" 函数。

"SConstruct" 文件负责配置， "keil.py" 文件负责生成文件。

其它的 iar vs 都可以找到对应的 py 文件。

注：对于 MDK 项目都有个 template 文件，在 bsp 目录下。

### 修改 MDK5 工程文件

首先，用 notpad++ 或者其它文本编辑器打开 "keil.py" 文件，"MDK4AddGroup" 函数里的 for 循环中有一句 
```
files = SubElement(group, 'Files')
file = SubElement(files, 'File')
```

将第一句挪到 for 语句前边，同时修改变量名字为 files_x。
```
    files_x = SubElement(group, 'Files')
    for f in files:
        ...
        file = SubElement(files_x, 'File')
```

这个修改虽然没多少影响，但是 xml 结点结构和 keil 编辑过的不一样。

然后，
1. 启用 "Use MicroLIB"。编辑 "template.uvprojx" 文件，修改其中的
    ```
    "<useUlib>0</useUlib>" 为 "<useUlib>1</useUlib>"
    ```
2. 启用 "Browse Information"。编辑 "template.uvprojx" 文件，修改其中的
    ```
    "<BrowseInformation>0</BrowseInformation>" 为 "<BrowseInformation>1</BrowseInformation>"
    ```
3. 启用 "GNU extensions"。编辑 "template.uvprojx" 文件，修改其中的
    ```
    "<uGnu>0</uGnu>" 为 "<uGnu>1</uGnu>"。
    ```

我对这三个感兴趣，所以只修改了这三个，其它的，如果需要自行修改。

## 结语

有些脚本还不完善，比如生成 vscode 配置的脚本。这个超级编辑器当 IDE 还有很多路要走。
也有不需要工程模版文件的，需要到 py 脚本里直接修改 py 代码。

相关文章：
[rt-thread 工具讲解系列（一） 之 CmBacktrace](https://club.rt-thread.org/ask/article/3019.html)
[rt-thread 工具讲解系列（二） 之 如何排查系统 bug](https://club.rt-thread.org/ask/article/3027.html)
[rt-thread 工具讲解系列（三） 之 env scons 命令初探](https://club.rt-thread.org/ask/article/3036.html)