还在为不同IDE之间切换工程而头疼？这个Python神器让你一键生成Keil、IAR、GCC等多种工程！

你有没有遇到过这样的痛苦：

客户要求提供不同IDE的工程版本
开源项目需要支持多种开发环境
维护多个IDE工程版本，工作量翻倍

今天就来分享一个超级实用的工具——project_generator，让你彻底摆脱这些烦恼！

project_generator：项目生成的魔法师

什么是project_generator？

project_generator（简称progen） 是一个基于Python的嵌入式项目生成器。

核心理念：

编写一个YAML配置文件
定义项目的源码、头文件、编译选项
一键生成多种IDE的工程文件

官方地址：

https://pypi.org/project/project-generator/

支持的开发环境

IDE支持：

Keil uVision4/5：ARM开发的经典选择
IAR EWARM：工业级开发环境
GCC ARM Makefile：开源工具链
ARMCC Makefile：ARM官方编译器
CMake：现代构建系统
CoIDE：国产IDE支持
Eclipse：开源IDE
Sublime Text：轻量级编辑器
Visual Studio：微软开发环境

一份配置，十种工程！

安装和环境配置

第一步：安装Python环境

# 支持Python 2.7.x 或 3.x.x
python --version

第二步：安装project_generator

pip install project-generator

安装完成后你会得到：

progen 命令行工具
完整的项目生成库
丰富的目标平台支持

实战演示：一键生成多IDE工程

项目结构示例

我们以官方的GPIO演示项目为例：

project_root/
├── projects.yaml          # 主配置文件
├── records/               # 子配置文件夹
│   ├── frdm_k64f.yaml    # K64F板配置
│   ├── frdm_kl25z.yaml   # KL25Z板配置
│   └── frdm_kl46z.yaml   # KL46Z板配置
└── source/               # 源码文件
    ├── main.c
    ├── gpio.c
    └── gpio.h

配置文件解析

主配置文件 projects.yaml

projects:
  gpio_demo_frdmk64f:
    - records/frdm_k64f.yaml
  gpio_demo_frdmkl25z:
    - records/frdm_kl25z.yaml
  gpio_demo_frdmkl46z:
    - records/frdm_kl46z.yaml

作用：定义项目名称和对应的配置文件

详细配置文件示例

# frdm_k64f.yaml
common:
    sources:
        - source/main.c
        - source/gpio.c
    includes:
        - source/
    
target:
    name: frdmk64f
    core: Cortex-M4F
    
tool_specific:
    uvision:
        misc:
            optimization: O2
    iar_arm:
        misc:
            optimization: high

一键生成多种工程

生成Keil工程

progen generate -f projects.yaml -p gpio_demo_frdmk64f -t uvision

结果：

自动生成 .uvprojx 工程文件
配置好源码路径和编译选项
设置好目标芯片和调试器
可以直接在Keil中打开使用

生成IAR工程

progen generate -f projects.yaml -p gpio_demo_frdmk64f -t iar_arm

结果：

自动生成 .ewp 和 .eww 文件
配置好IAR特有的编译选项
设置好调试配置
可以直接在IAR中打开

生成GCC Makefile

progen generate -f projects.yaml -p gpio_demo_frdmk64f -t gcc_arm

结果：

生成标准的Makefile
配置好GCC编译选项
支持命令行编译
适合CI/CD自动化

高级功能：自定义目标平台

扩展芯片支持

progen的芯片支持库位于：

Python安装路径/Lib/site-packages/project_generator_definitions/target/

添加新芯片支持

# 新芯片配置文件
name: my_custom_chip
core: Cortex-M4
ram:
    start: 0x20000000
    size: 0x20000
flash:
    start: 0x08000000
    size: 0x100000

自定义编译选项

tool_specific:
    uvision:
        misc:
            - c_flags: ["-O2", "-g"]
            - asm_flags: ["-g"]
            - ld_flags: ["--map"]
    gcc_arm:
        misc:
            - c_flags: ["-Wall", "-Wextra"]
            - ld_flags: ["-Wl,--gc-sections"]

实际应用场景

场景一：多人协作开发

痛点：团队成员使用不同的IDE

解决方案：

# 每个人生成自己的IDE工程
progen generate -f project.yaml -p main_project -t uvision   
progen generate -f project.yaml -p main_project -t iar_arm   
progen generate -f project.yaml -p main_project -t gcc_arm

场景二：开源项目发布

需求：为开源项目提供多种IDE支持

解决方案：

# 批量生成所有支持的IDE工程
for ide in uvision iar_arm gcc_arm cmake; do
    progen generate -f project.yaml -p opensource_project -t $ide
done

场景三：客户定制需求

情况：不同客户使用不同的开发环境

解决方案：

维护一份YAML配置
根据客户需求生成对应IDE工程
大大减少维护工作量

进阶使用技巧

条件编译支持

common:
    macros:
        - DEBUG=1
        - USE_HAL_DRIVER
    
target_specific:
    uvision:
        macros:
            - KEIL_BUILD=1
    iar_arm:
        macros:
            - IAR_BUILD=1

多配置管理

# debug配置
debug:
    macros:
        - DEBUG=1
        - LOG_LEVEL=3
    c_flags:
        - "-O0"
        - "-g3"

# release配置  
release:
    macros:
        - NDEBUG=1
        - LOG_LEVEL=1
    c_flags:
        - "-O2"
        - "-DNDEBUG"

脚本自动化

#!/usr/bin/env python
# 自动生成所有IDE工程的脚本

import subprocess
import os

ides = ['uvision', 'iar_arm', 'gcc_arm', 'cmake']
projects = ['project_a', 'project_b', 'project_c']

for project in projects:
    for ide in ides:
        cmd = f"progen generate -f projects.yaml -p {project} -t {ide}"
        subprocess.run(cmd, shell=True)
        print(f"Generated {project} for {ide}")

优缺点分析

优势

效率提升：一次配置，多次生成
维护简单：只需维护一份配置文件
标准化：统一的项目结构和配置
自动化：支持CI/CD集成
开源免费：无使用成本

局限性

学习成本：需要学习YAML语法
平台限制：支持的芯片有限
IDE特性：无法完全利用IDE特有功能
调试配置：复杂的调试配置可能需要手动调整

使用建议

适合使用的场景

多人协作项目
开源项目发布
标准化开发流程
CI/CD自动化构建

不太适合的场景

单人小项目
IDE特有功能依赖重
复杂的项目配置
快速原型开发

最佳实践

配置文件组织

project_configs/
├── common/              # 通用配置
│   ├── base.yaml       # 基础配置
│   └── debug.yaml      # 调试配置
├── targets/            # 目标平台配置
│   ├── stm32f4.yaml   # STM32F4系列
│   └── stm32f7.yaml   # STM32F7系列
└── projects/           # 项目配置
    ├── bootloader.yaml # 引导程序
    └── application.yaml # 应用程序

总结

project_generator 虽然不是最知名的工具，但绝对是嵌入式项目管理的一个宝藏工具！

你的看法

你觉得这种"一次配置，多次生成"的理念怎么样？

在多IDE协作中还遇到过哪些问题？

还知道哪些类似的项目管理工具？

如果你也被多IDE工程管理困扰过，一定要试试project_generator！

觉得这个工具有用的话，记得点赞分享，让更多嵌入式工程师看到这个效率神器！

关注我，分享更多嵌入式开发效率提升技巧！

北屋教程网

专注编程知识分享，从入门到精通的编程学习平台

嵌入式项目管理神器:一键生成多IDE工程的工具!

project_generator：项目生成的魔法师

什么是project_generator？

支持的开发环境

安装和环境配置

第一步：安装Python环境

第二步：安装project_generator

实战演示：一键生成多IDE工程

项目结构示例

配置文件解析

主配置文件 projects.yaml

详细配置文件示例

一键生成多种工程

生成Keil工程

生成IAR工程

生成GCC Makefile

高级功能：自定义目标平台

扩展芯片支持

添加新芯片支持

自定义编译选项

实际应用场景

场景一：多人协作开发

场景二：开源项目发布

场景三：客户定制需求

进阶使用技巧

条件编译支持

多配置管理

脚本自动化

优缺点分析

优势

局限性

使用建议

适合使用的场景

不太适合的场景

最佳实践

配置文件组织

总结

你的看法