[Feature]: v2 编译支持

[sanchuanhehe]

请描述您想要的功能

No response

我愿意为此功能贡献代码

None

[sanchuanhehe]

添加获取编译用工具包的方式

[sanchuanhehe]

https://code.visualstudio.com/api/references/vscode-api#EnvironmentVariableCollection
参考文档，添加对编译工具等命令行工具的环境变量PATH支持

[sanchuanhehe]

目前ci中的实现方式是调用command-line的hvigorw

hvigorw clean --no-daemon
hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon

[sanchuanhehe]

hvigorw的文档在这里
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-commandline

[sanchuanhehe]

需要注意hvigor守护进程
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-daemon

[sanchuanhehe]

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-command-line-building-app
环境变量配置指南参考

[sanchuanhehe]

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-common-commands
还需要集成ohpm

[sanchuanhehe]

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpmrc

[sanchuanhehe]

HarmonyOS v2 编译支持功能设计方案

概述

基于 #58 的需求，我们将为 VS Code 扩展添加 HarmonyOS v2 编译支持功能，包括自动检测构建工具、配置环境变量和集成构建任务。

功能目标

1. 自动检测 HarmonyOS 开发环境（Command-line-tools 或 DevEco Studio）
2. 统一配置 替代现有的分散配置项（ets.sdkPath, ets.hmsPath 等）
3. 环境变量管理 自动配置 PATH 和相关环境变量
4. 构建任务集成 提供 hvigorw、ohpm 等构建任务
5. 向后兼容 平滑迁移现有配置

两种安装环境分析

Command-line-tools 独立安装

/opt/harmony/command-line-tools/
├── bin/                    # 工具入口
│   ├── codelinter, hstack, hvigorw, ohpm
├── codelinter/, hstack/, hvigor/, ohpm/  # 工具实现
├── sdk/default/openharmony/              # OpenHarmony SDK
└── tool/node/                            # Node.js 运行时

DevEco Studio 集成安装

DevEco Studio安装目录/
├── sdk/default/
│   ├── openharmony/       # OpenHarmony SDK
│   └── harmony/          # HMS SDK (独有)
└── tool/                 # 所有工具在此目录
    ├── codelinter/, hstack/, hvigor/, ohpm/
    └── node/

配置设计

新配置结构

{
  "ets.buildTools": {
    "autoDetect": true,
    "commandLineToolsPath": "",     // Command-line-tools 路径
    "devEcoStudioPath": "",         // DevEco Studio 路径  
    "overrides": {                  // 高级用户手动覆盖
      "openHarmonySdkPath": "",
      "hmsSdkPath": "", 
      "hvigorPath": "",
      "ohpmPath": ""
    }
  }
}

废弃配置项

• ets.sdkPath → 自动从检测到的环境推断
• ets.hmsPath → 自动从检测到的环境推断
• ets.hdcPath → 统一到 buildTools 配置中

核心实现

1. 环境检测引擎

class HarmonyToolsDetector {
  detectEnvironment(): ToolsEnvironment | null {
    // 1. 检测 Command-line-tools 安装
    // 2. 检测 DevEco Studio 安装（通过环境变量）
    // 3. 验证目录结构完整性
  }
}

2. 配置解析器

class ConfigurationResolver {
  resolveConfiguration(): ResolvedConfig {
    // 优先级：自动检测 → 用户配置 → 兼容旧配置
  }
}

3. 环境变量管理

class EnvironmentManager {
  setupEnvironment(config: ResolvedConfig) {
    // 使用 VS Code EnvironmentVariableCollection API
    // 设置 DEVECO_NODE_HOME, DEVECO_SDK_HOME
    // 配置 PATH 环境变量
  }
}

4. 构建任务提供器

class HarmonyTaskProvider implements vscode.TaskProvider {
  provideTasks(): vscode.Task[] {
    // 提供 hvigorw clean, assembleHap, assembleApp 等任务
    // 提供 ohpm install, update 等任务
  }
}

用户体验

首次使用流程

1. 扩展激活时自动检测环境
2. 如果检测成功，显示确认提示
3. 如果检测失败，提供配置向导
4. 支持一键配置和手动配置

状态显示

• 状态栏显示工具检测状态
• 工具提示显示详细路径信息
• 配置问题时显示警告和建议

配置迁移

• 检测现有 ets.sdkPath 等配置
• 提示用户迁移到新配置系统
• 保持向后兼容，渐进式升级

命令和界面

新增命令

• ets.buildTools.autoDetect - 自动检测构建工具
• ets.buildTools.configure - 配置向导
• ets.buildTools.healthCheck - 健康检查

配置界面

• Quick Pick 选择配置方式
• 文件浏览器选择路径
• 检测结果展示和确认

国际化支持

中文配置描述

{
  "configuration.ets.buildTools.autoDetect.description": "自动检测 HarmonyOS 开发环境",
  "configuration.ets.buildTools.commandLineToolsPath.description": "HarmonyOS command-line-tools 安装路径",
  "configuration.ets.buildTools.devEcoStudioPath.description": "DevEco Studio 安装路径",
  "buildTools.autoDetect.success": "成功检测到 {0} 环境：{1}",
  "buildTools.migration.prompt": "检测到旧配置，是否迁移到新配置系统？"
}

实现优势

1. 零配置体验 - 大多数情况下自动检测成功
2. 统一管理 - 所有构建工具配置集中管理
3. 智能推断 - 根据环境类型自动推断路径
4. 平滑迁移 - 兼容现有配置，逐步升级
5. 灵活覆盖 - 支持高级用户自定义路径
6. 实时验证 - 持续检查配置有效性

技术要点

• 使用 VS Code EnvironmentVariableCollection API 管理环境变量
• 基于 vscode-ext-gen 的配置系统扩展
• 跨平台路径处理（Windows/macOS/Linux）
• 与现有 unioc 依赖注入系统集成

---

讨论点：

1. 配置项命名是否合适？
2. 自动检测策略是否全面？
3. 迁移方案是否平滑？
4. 还需要支持哪些构建工具？

请大家review这个设计方案，提出意见和建议！ 🚀

[sanchuanhehe]

DevEco Studio安装会添加DevEco Studio这个环境变量,位于DevEco Studio安装位置/bin
这是实现检测 DevEco Studio 安装（通过环境变量）的基础,更加用户无感