关于apm使用./waf编译的笔记

### WAF 编译命令列表及配置说明 #### 基础概念 WAF 是一种用于构建和编译系统的工具，能够简化复杂项目的编译流程[^1]。 #### 目录结构概述 对于典型的 WAF 项目而言，其基本目录结构通常包括源码文件夹 `src` 和根级别的 `wscript` 文件。其中 `wscript` 负责定义整个工程的构建逻辑以及如何处理各个子模块。 #### 配置与编译过程 针对特定硬件平台（如 ESP32 或 ChibiOS），可以通过修改配置来适应不同需求。这涉及到目标设备的选择及其配套组件的支持情况。具体来说，在 ArduPilot 这样的开源飞行控制系统中，通过调整 `Tools/ardupilotwaf/boards.py` 文件内的设置项可以实现这一点[^2]。 #### 条件编译控制 为了启用某些特性（例如实时钟支持），可以在上述提到的 Python 脚本里寻找相应的宏定义并将其设为真值状态。“AP_RTC_ENABLED” 就是用来开启这一功能的关键字之一[^3]。 #### 自定义打包名称 当希望改变最终生成档案的名字时，可在主 `wscript` 文件顶部声明两个变量：一个是应用程序名 (`APPNAME`)；另一个则是版本号(`VERSION`)。这样做之后，默认创建出来的 tarball 将会依据这两个参数来进行命名而不是采用预设的形式[^4]。 ```python #! /usr/bin/env python # encoding: utf-8 APPNAME = 'custom_name' VERSION = '2.0.0' top = '.' out = 'build' def configure(ctx): print(' -> configuring the project in ' + ctx.path.abspath()) def build(ctx): pass ``` #### 主要编译指令汇总 以下是几个常用的 WAF 操作： - **初始化环境** 使用 `./waf distclean` 清除所有之前产生的中间产物以便重新开始。 - **配置项目** 执行 `./waf configure` 对当前工作区进行必要的准备工作，比如检测依赖库是否存在等。 - **实际编译** 输入 `./waf` 即可启动完整的编译链路直至产出二进制成果物。 - **清理临时数据** 若想移除由上一轮操作遗留下来的缓存资料，则应运行 `./waf clean`。