2. 开发环境搭建：Keil MDK / IAR 环境配置、FreeType 库移植、Python 脚本环境准备

说实话，做嵌入式 GUI 字体处理，最怕的不是算法难，而是环境搭到一半卡住。我早年带团队时，有个同事花了两天时间折腾 FreeType 移植，最后发现是编译器版本不匹配。所以这一章，咱们把地基打牢。

2.1 Keil MDK 环境配置

Keil MDK 是我个人最常用的 IDE，尤其在 ARM Cortex-M 系列上。它的工程管理很直观，但有几个坑你得提前知道。

2.1.1 安装与激活

• 从 ARM 官网下载 MDK-ARM 最新版（当前推荐 5.38 或更高）
• 安装时勾选 CMSIS Core 和 Device Family Packs
• 激活 License：我建议用正版评估版，或者公司采购的浮动 License

2.1.2 新建工程与配置

1. 点击 Project → New μVision Project
2. 选择目标芯片（比如 STM32F429IG）
3. 在 Manage Run-Time Environment 中勾选：
   • CMSIS → CORE
   • Device → Startup
   • Compiler → ARM Compiler 6（默认）
4. 配置 Target 选项卡：
   • ARM Compiler：选 Version 6
   • Optimization：调试阶段选 -O0，发布阶段选 -Os
5. 在 C/C++ 选项卡中添加宏定义：

   __FPU_PRESENT=1
   ARM_MATH_CM4
   USE_HAL_DRIVER
   STM32F429xx

2.2 IAR Embedded Workbench 环境配置

IAR 的编译器优化能力很强，尤其对代码体积的控制。我有个项目用 Keil 编译出来 128KB，换 IAR 直接压到 96KB。但它的界面逻辑和 Keil 不太一样，你得适应一下。

2.2.1 安装要点

• 下载 IAR for ARM 最新版（推荐 9.40 以上）
• 安装时选择 Full Installation，包含所有器件支持包
• 激活 License：IAR 的 License Server 模式适合团队使用

2.2.2 工程配置对比

配置项	Keil MDK	IAR EWARM
编译器	ARM Compiler 5/6	IAR C/C++ Compiler
优化等级	-O0 / -Os	None / High (Size)
宏定义位置	C/C++ → Preprocessor	Options → C/C++ Compiler → Preprocessor
链接脚本	.sct 文件	.icf 文件
调试器	ULINK / J-Link	J-Link / I-jet

嗯，这里要注意：IAR 的 .icf 链接脚本语法和 Keil 的 .sct 完全不同。如果你从 Keil 迁移过来，别直接复制粘贴，得重新写。

2.3 FreeType 库移植

FreeType 是字体渲染的工业标准库。但它是为桌面系统设计的，移植到嵌入式环境需要动点手脚。我最早移植 FreeType 到 STM32 时，光是内存分配就折腾了两天。

2.3.1 源码获取与精简

• 从 freetype.org 下载源码包（推荐 2.13.x 稳定版）
• 只保留必要模块：

  freetype/
  ├── include/          # 头文件（全部保留）
  ├── src/
  │   ├── base/         # 基础模块（必须）
  │   ├── sfnt/         # TrueType/OpenType 解析（必须）
  │   ├── truetype/     # TrueType 驱动（必须）
  │   ├── smooth/       # 抗锯齿渲染（推荐）
  │   └── raster/       # 位图渲染（可选）
  └── builds/           # 构建系统（我们不用，参考即可）

2.3.2 配置嵌入式内存管理

FreeType 默认使用 malloc/free，但嵌入式环境往往没有标准堆。你需要重写内存接口：

/* 在 ftconfig.h 中修改 */
#include "my_memory.h"  // 你的内存管理头文件

#define FT_MALLOC(size)     my_malloc(size)
#define FT_FREE(ptr)        my_free(ptr)
#define FT_REALLOC(ptr, sz) my_realloc(ptr, sz)

2.3.3 编译配置

在 Keil 或 IAR 中添加以下宏定义：

FT_CONFIG_OPTION_SYSTEM_ZLIB=0   // 禁用 zlib 压缩
FT_CONFIG_OPTION_USE_PNG=0       // 禁用 PNG 支持
FT_CONFIG_OPTION_USE_HARFBUZZ=0  // 禁用 HarfBuzz 排版
TT_CONFIG_OPTION_BYTECODE_INTERPRETER=1  // 启用字节码解释器（用于 hinting）

说白了，把不需要的功能全关掉。嵌入式环境寸土寸金，别浪费。

2.4 Python 脚本环境准备

Python 用于字体数据的离线预处理——比如从 TTF 文件中提取字形轮廓、生成点阵位图、压缩数据。这部分在 PC 上完成，不跑在嵌入式设备上。

2.4.1 安装 Python 与虚拟环境

• 下载 Python 3.10+（推荐 3.11，兼容性最好）
• 创建虚拟环境：

  python -m venv font_tools_env
  font_tools_env\Scripts\activate  # Windows
  source font_tools_env/bin/activate  # Linux/Mac

2.4.2 安装依赖库

pip install freetype-py    # Python 版 FreeType 绑定
pip install numpy          # 数值计算
pip install pillow         # 图像处理（用于位图验证）
pip install matplotlib     # 可视化调试（可选）

2.4.3 验证环境

写一个简单的测试脚本，确保 FreeType 能正确加载字体：

import freetype

face = freetype.Face("path/to/your/font.ttf")
face.set_char_size(48 * 64)  # 48pt
face.load_char('A')
bitmap = face.glyph.bitmap
print(f"Glyph size: {bitmap.width}x{bitmap.rows}")
print("Environment OK!")

你想想看，如果这一步跑不通，后面所有字体处理脚本都没法用。所以务必先验证。

2.5 整体环境架构

下面这张图展示了三套环境之间的关系。我习惯把 Python 环境称为「预处理工厂」，Keil/IAR 是「嵌入式装配线」。

2.6 常见问题与避坑

• Keil 编译 FreeType 报错 "unknown type name 'size_t'"：在 ftconfig.h 前加上 #include <stddef.h>
• IAR 链接时提示 "out of memory"：检查 .icf 文件的堆栈大小，至少给 FreeType 分配 16KB 堆空间
• Python 环境找不到 freetype-py：确认虚拟环境已激活，用 pip list 查看已安装包

好了，环境搭建就到这里。这三套环境配好之后，后面的章节就可以直接上手实战了。记住：环境配得稳，后面少折腾。