Skip to content

STM32 工程助手 · VS Code 扩展 v1.0.3

Choose a tag to compare

View all tags
@MYFSillyBa MYFSillyBa released this 13 Oct 14:57
vscode-v1.0.3
ee947ac

版本概述

STM32 工程助手 VS Code 扩展 v1.0.3 面向本地 Windows x64 工程，在编辑器内提供工程配置、源文件管理、工程转换、工具管理与修改恢复。安装包约 8.5 MB，较初版约 32.2 MB 减少约 74%，内置后台运行时和 OpenOCD 脚本，无需另行安装 .NET。

本版本为 VS Code 扩展独立发行版。桌面程序继续通过 桌面版本下载页 获取，桌面版本与扩展版本分别编号。

下载与环境要求

项目 说明
安装文件 stm32-project-helper-1.0.3-win32-x64.vsix
文件大小 8539085 字节，约 8.5 MB / 8.14 MiB
操作系统 本地 Windows x64
VS Code 1.95 或更新版本
.NET 安装包自带，无需另行安装
工程构建 需要 CMake、Ninja 和 ARM GCC，可通过工具管理选择或修复
OpenOCD 执行程序需要安装；Target、CMSIS-DAP 接口和 Tcl 脚本已内置

安装方法

  1. 下载上述 .vsix 文件。
  2. 在 VS Code 中按 Ctrl+Shift+X 打开扩展面板。
  3. 点击面板右上角 …，选择“从 VSIX 安装…”，选中下载的文件。
  4. 安装完成后重新加载窗口。若没有提示，可在命令面板执行“Developer: Reload Window”，或关闭并重新打开 VS Code。
  5. 打开并信任包含 CMakeLists.txt、.ioc 或 .uvprojx 的本地工程文件夹。
  6. 工程工作台默认自动打开，也可点击活动栏蓝色芯片图标或执行“STM32 工程助手：打开”。

更新方法

再次执行“从 VSIX 安装…”并选择新版文件，覆盖已有扩展后重新加载窗口，无需先卸载。扩展标识为 myfsillyba.stm32-project-helper，保留已有工作区工具设置和修改记录。

功能与改进

  • 当前工程工作台：提供工程配置、添加源文件、加入文件、工程转换、工具管理和修改记录六个入口，支持多个工作区文件夹切换。
  • 直接确认写入：工程配置、源文件注册和工程转换均提供“确认写入…”主按钮；弹窗列出受影响文件后保存，详细文件差异可以按需预览。
  • 软件构建检查：先保存所需任务，再执行 CMake 配置、实际编译和 OpenOCD 脚本解析；构建问题显示在 VS Code 问题面板和输出频道。
  • 构建目标与固件：使用当前构建配置的实际 ELF，支持多个固件目标选择，保留用户任务、JSONC 注释及原始工程工具链配置。
  • 源文件与文件管理：扫描并逐项选择 C/C++、汇编及头文件，维护目标源文件和包含目录；支持创建文件夹、复制文件、同名处理和修改恢复。
  • CubeMX 工程转换：支持 STM32CubeMX MDK-ARM 与 ARM GCC CMake 双向转换，不安装或调用 CubeMX。
  • 工具版本与路径：检测多个工具安装，按版本和完整路径选择；所选 CMake、Ninja 和 ARM GCC 使用绝对路径。工程迁移或工具变化时备份旧缓存后重新配置。
  • 工作区配置独立：修复缺失工具时保留工作区已选的有效工具，不将其替换为桌面程序默认路径，也不改写桌面工具路径设置。
  • 安装包精简：裁剪未使用的后台运行库，保留功能代码、JSON 模型和内置 OpenOCD 脚本，保持无需另装 .NET 的安装方式。

推荐使用流程

  1. 在“工程配置”中核对芯片、配置预设、构建目录、Target 和工具版本。
  2. 点击“确认写入…”，在弹窗中确认工程与文件清单，保存 VS Code 任务。
  3. 点击“运行软件检查”，查看编译结果、问题位置和实际 ELF。
  4. 多固件工程选择需要使用的 ELF，并确认烧录任务绑定。
  5. 在“终端 → 运行任务”中执行“一键编译”或“一键烧录(DAPLINK)”。

编译未通过时保留已写入任务，可修正工程后重新执行。扩展的软件检查不确认探针连接，不烧录硬件；烧录由使用者明确运行任务执行。

支持范围与说明

  • 使用本地 Windows x64、文件系统工作区和工作区信任；远程或虚拟工作区不在当前支持范围内。
  • 工程转换限于保留 .ioc 与生成源码的 STM32CubeMX 单核 STM32 工程。
  • 自动启动与内存布局转换限于可可靠解析的标准结构和实际使用一个 FLASH、一个 RAM 的布局。
  • 复杂内存分区、双核、无法匹配的专用库及不能确认语法或版本的 FreeRTOS 移植层会提供具体补全说明。
  • 扩展不上传工程，不保存最近工程列表，不生成 .ps1 文件。

完整安装、更新、逐项操作、扩展设置与常见问题见 扩展操作指南。工程兼容性说明与桌面方法见 项目文档。

验证与校验

发布前完成解决方案构建、扩展 JavaScript 检查、正常软件流程和隔离 VS Code 安装使用检查，覆盖任务写入、真实 ARM 编译、工具选择与修复、源文件注册、文件复制和恢复、MDK/CMake 双向转换及工程迁移缓存处理。检查不连接硬件。

安装包 SHA-256：

AB8363E649D33C91DFB88C2AB6C1D1EAAFFE1A22202B137E591C98285A20168C

对应源码提交：发布源码。

应用源码采用 MIT 许可证。内置 OpenOCD 脚本保留原始版权与许可证声明；第三方工具遵循各自许可证。

Assets 3
Loading