Auto Build Marlin 使用教程

1. 项目介绍

Auto Build Marlin 是一个为 Marlin 固件构建过程提供简化界面的 Visual Studio Code 扩展。它能够自动检测正确的环境来构建 Marlin 固件，并提供了配置编辑器来增强配置编辑的体验。此项目旨在简化固件构建流程，让用户无需手动编辑 platformio.ini 文件或浏览长的环境列表。

2. 项目快速启动

快速启动 Auto Build Marlin：

1. 打开 Visual Studio Code。
2. 打开包含 Marlin 固件版本 2.0 或更高版本的工程文件夹。确保打开的是包含 platformio.ini 文件的文件夹，而不是固件内部的 "Marlin" 文件夹。
3. 安装 PlatformIO 扩展，因为它是构建过程所必需的。
4. 点击 Visual Studio Code 活动栏上的 Auto Build Marlin 图标，打开侧边栏。
5. 使用 "Show ABM Panel" 按钮或点击工具栏上的任何按钮打开 Auto Build Marlin 面板。
6. 如果您的板上有多个目标环境，您需要选择一个特定的环境来进行构建。

# 构建和上传固件

- 使用 "Marlin Build" 按钮来测试您的 Marlin 构建。
- 使用 "Marlin Upload" 按钮来安装固件到您的板上。
- 使用 "Marlin Upload (traceback)" 按钮来安装 Marlin 并启用调试。
- 使用 "Marlin Clean" 按钮来删除旧的构建文件。

3. 应用案例和最佳实践

配置编辑器使用

• 通过右键点击 VSCode 文件资源管理器中的文件并选择 "Open With… > Config Editor" 来打开配置编辑器。
• 使用导航侧边栏查看单独的配置部分或全部。
• 使用 "Filter" 字段按名称查找选项。
• 点击 "Show/Hide Disabled" 按钮显示或隐藏禁用的选项。
• 点击 "Show/Hide Comments" 按钮显示或隐藏注释。

代码格式化

• 打开命令面板并选择 "Format Marlin Code" 来根据 Marlin 标准格式化代码。

4. 典型生态项目

Auto Build Marlin 作为 Marlin 固件构建的辅助工具，是 3D 打印爱好者常用的扩展之一。它的生态系统包括了与 Marlin 固件兼容的多种项目和插件，例如：

• Marlin Configuration Editor：一个用于编辑 Marlin 配置文件的图形界面工具。
• PlatformIO：一个跨平台的开发环境，用于编译和上传固件到微控制器。
• Visual Studio Code：一个功能强大的代码编辑器，通过扩展支持多种编程语言和开发任务。

通过结合这些项目，开发者可以更加高效地开发、测试和部署固件到他们的 3D 打印机。