Naily's ArkTS Support

English | 简体中文

刚建了一个QQ群，欢迎加入一起交流学习 (群号: 746153004)

这是一个基于Volar开发的ArkTS VSCode扩展。🌹为似乎到现在还没有支持VSCode，现有的VSCode市场中的ArkTS扩展大都非常简陋，所以决定自己写一个。

功能 ✨

• 🌹 具备完整的ArkTS语言的语法高亮、补全、跳转、诊断等基础功能 (1.x)
• 🎨 ArkTS支持右键一键快速格式化，格式化支持由 oxk 工具链提供, 工具链采用 Rust编写，由 oxc project 项目 Fork 修改而来，速度极快 ⚡️ 独立使用Demo仓库地址: https://github.com/ohos-rs/oxc-ark 感谢 GitHub @richerfu 大佬的贡献！ (1.2.12+)
• 💿 支持和 DevEco Studio 一致的模拟器镜像管理器，支持创建/删除设备以及下载/删除模拟器镜像，由 @arkts/image-manager 提供强力支撑 ✊ (1.3.0+)
• 🚀 支持任务 tasks.json 和启动配置 launch.json，配置后可一键运行 hvigor 任务编译项目，并通过 hdc 命令运行或调试到模拟器/真机 (1.3.0+)
• 📦 支持安装和管理OpenHarmony SDK，并且支持根据当前打开的项目自动探测API版本，发出弹窗提示下载或切换 (1.x)
• ✂️ 支持和TypeScript基本一致的snippets，并且添加了Struct Declaration等ArkTS独有的Snippets
• 🥇 支持完美的 $r 函数补全和跳转、支持 module.json5 文件的补全和跳转、resources/element/ 下所有json文件点击查询全局引用；由 Rust 编写的 @arkts/project-detector hvigor项目分析器提供强力支撑 ✊ (1.1.6+)
• 🍞 支持 module.json5 文件路径补全和跳转、引用表达式错误诊断、requestPermissions 权限补全等一系列 new feature ✨ (1.1.8+)
• 🌾 hvigor 资源管理器面板，支持资源限定符文件夹创建、资源引用索引等功能 （基于 @arkts/project-detector 项目分析器打造） (1.2.10+)
• 🎨 内置文件图标主题：提供ArkTS Icons主题，支持ArkTS文件类型（.ets、.json5等）和常见Web项目文件（JavaScript、React、CSS、Markdown等），适用于Nx monorepo等混合项目。
• 🖊️ 完善的JSON Schema支持。支持以下文件的JSON Schema：
  • build-profile.json5 模块级别/项目级别配置
  • oh-package.json5 模块级别/项目级别配置
  • code-linter.json5 模块级别/项目级别配置
  • resources/element/下所有的color.json等的kv值配置
  • module.json5 配置
  • mock-config.json5配置
  • hvigor-config.json5配置
  • main_pages.json5配置
  • AppScope/app.json5配置
  • ...未来会支持更多文件的JSON Schema

更多使用技巧和常见问题 📖

如果遇到未知问题，详情请先阅读 Arkcode 组织文档，或者添加QQ群 746153004 一起交流学习。

VSCode 文件图标主题 🖼️

内置 ArkTS Icons 主题

本扩展内置了ArkTS Icons文件图标主题，提供对ArkTS和Web开发文件的完整支持：

支持的文件类型：

• ArkTS文件：.ets、.hml、.json5配置文件
• Web开发：JavaScript (.js、.jsx)、TypeScript (.ts、.tsx)、React
• 样式文件：CSS、SCSS、SASS、LESS、HTML
• 文档：Markdown (.md、.mdx)、文本文件
• 配置文件：.gitignore、.env、.eslintrc、package.json、next.config.js等
• 常见文件夹：node_modules、src、components、pages、app等

启用方式：

1. 打开命令面板 (Cmd+Shift+P / Ctrl+Shift+P)
2. 输入 "Preferences: File Icon Theme"
3. 选择 "ArkTS Icons"

或在 settings.json 中设置：

{
  "workbench.iconTheme": "arkts-icons"
}

Material Icon Theme

也可以使用Material Icon Theme，我已经给Material Icon Theme提交了PR，目前将.ets、.d.ets直接用上了TypeScript官方的文件图标包，升级到v5.22.0之后的版本都可用 👇

PR: https://github.com/material-extensions/vscode-material-icon-theme/pull/2966

配置

在 MacOS 下, 默认路径为 ~/Library/Huawei/Sdk; 在 Windows 下, 默认路径为 %APPDATA%\Local\Huawei\Sdk. | string | `` | | ets.imageConfigPath | HarmonyOS 配置文件存放位置。

在 MacOS 下, 默认路径为 ~/Library/Application Support/Huawei/DevEcoStudio6.0; 在 Windows 下, 默认路径为 %APPDATA%\Roaming\Huawei\DevEcoStudio6.0; 在其他平台, 默认路径为 ~/.huawei/DevEcoStudio6.0. | string | `` | | ets.deployedEmulatorPath | 部署的模拟器存放位置。

在 Windows 下, 默认路径为 %APPDATA%\Local\Huawei\Emulator\deployed; 在其他平台下, 默认路径为 ~/.huawei/Emulator/deployed. | string | `` | | ets.emulatorLogPath | 模拟器日志存放位置。

在 MacOS 下, 默认路径为 ~/Library/Logs/Huawei/DevEcoStudio6.0; 在 Windows 下, 默认路径为 %APPDATA%\Local\Huawei\DevEcoStudio6.0\log; 在其他平台, 默认路径为 ~/.huawei/DevEcoStudio6.0/log. | string | `` |

命令