# arkTS **Repository Path**: blueskycs2c/arkTS ## Basic Information - **Project Name**: arkTS - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: next - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-11-03 - **Last Updated**: 2025-11-03 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
# Naily's ArkTS Support [English](./README-en.md) | 简体中文 ![GitHub Repo stars](https://img.shields.io/github/stars/ohosvscode/arkTS?style=flat)  [![VSCode Marketplace version](https://img.shields.io/visual-studio-marketplace/v/NailyZero.vscode-naily-ets?style=flat&label=vscode%20marketplace%20version)](https://marketplace.visualstudio.com/items?itemName=NailyZero.vscode-naily-ets)  [![@arkts/declarations NPM version](https://img.shields.io/npm/v/%40arkts%2Fdeclarations?logo=npm&logoColor=red&label=arkts%2Fdeclarations)](https://www.npmjs.com/package/@arkts/declarations)  [![@arkts/language-server NPM version](https://img.shields.io/npm/v/%40arkts%2Flanguage-server?logo=npm&logoColor=red&label=arkts%2Flanguage-server)](https://www.npmjs.com/package/@arkts/language-server)  ![GitHub commit activity](https://img.shields.io/github/commit-activity/m/ohosvscode/arkTS)  ![GitHub repo size](https://img.shields.io/github/repo-size/ohosvscode/arkTS)  [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ohosvscode/arkTS)  ![GitHub last commit (branch)](https://img.shields.io/github/last-commit/ohosvscode/arkTS/main?label=Main%20Branch%20Last%20Commit) 
> 刚建了一个QQ群，欢迎加入一起交流学习 (群号: 746153004) 这是一个基于Volar开发的ArkTS VSCode扩展。🌹为似乎到现在还没有支持VSCode，现有的VSCode市场中的ArkTS扩展大都非常简陋，所以决定自己写一个。 ## Features - 🌹 1.x版本开始具备完整的`ArkTS`语言支持，全量支持所有`ArkTS`语法。 - 🖊️ 完善的JSON Schema支持。支持以下文件的JSON Schema： - `build-profile.json5` 模块级别/项目级别配置 - `oh-package.json5` 模块级别/项目级别配置 - `module.json5` 模块级别/项目级别配置 - `code-linter.json5` 模块级别/项目级别配置 - `resources/element/`下所有的`color.json`、`string.json`等的kv值配置 - `main_pages.json5` - 📦 1.x版本开始支持安装和管理`OpenHarmony SDK`，并且支持根据当前打开的项目自动探测`API版本`，发出弹窗提示`下载`或`切换` - 🥇 1.1.6+ 版本开始支持完美的 `$r` 函数补全和跳转、支持 `module.json5` 文件的补全和跳转、`resources/element/` 下所有`json`文件点击查询全局引用；由 [@arkts/project-detector](https://github.com/ohosvscode/project-detector) hvigor项目分析器提供强力支撑 ✊ - 🍞 1.1.8+ 版本开始支持 `module.json5` 文件路径补全和跳转、引用表达式错误诊断、`requestPermissions` 权限补全等一系列 new feature ✨ ![截图](./screenshots/edit.gif) ## 插件安装 📦 - Marketplace安装: [https://marketplace.visualstudio.com/items?itemName=NailyZero.vscode-naily-ets](https://marketplace.visualstudio.com/items?itemName=NailyZero.vscode-naily-ets) - Open VSX安装：[https://open-vsx.org/extension/NailyZero/vscode-naily-ets](https://open-vsx.org/extension/NailyZero/vscode-naily-ets) 或者直接在VSCode中搜索`ArkTS Support`即可。 ## 食用方法 📖 ### 有装过`DevEco Studio`的情况下 安装本插件之后配置`OpenHarmony SDK`路径和`HMS SDK`路径（可选），然后重启IDE即可。这两个`SDK路径`一般都在`DevEco Studio`的安装目录下有个叫`sdk`的文件夹里可找到。 在MacOS下，一般右键`DevEco Studio`本身，选择`显示包内容`，然后就能看到包里面就有一个`sdk`的文件夹，里面就包含`OpenHarmony SDK`和`HMS SDK`。 一般情况下，`OpenHarmony SDK`基本都具备如下目录结构（参考自版本`DevEco Studio 6.0 Beta 2`）： ``` ets/ js/ native/ previewer/ toolchains/ ``` `HMS SDK`基本都具备如下目录结构（参考自版本`DevEco Studio 6.0 Beta 2`）： ``` ets/ native/ previewer/ toolchains/ ``` ### 没有装过`DevEco Studio`的情况下 目前本插件仍然不能完全替代鸿蒙开发，建议您还是装一个`DevEco Studio`为好；如果实在是不想装那么插件内也提供`OpenHarmony SDK`的`下载`、`解压安装`、`无缝切换`功能，您可以在安装此插件之后，在`命令面板`中搜索`> ETS: Install OpenHarmony SDK`，按照提示一步步来即可。 另外，目前暂时插件不支持`HMS SDK`的`下载`、`解压安装`、`无缝切换`功能，请您自行下载`DevEco Studio`或下载鸿蒙的`Command Line Tool`进行安装。 ## 关于`ets.baseSdkPath` ⚠️ 此设置是用来配置`OpenHarmony SDK`的`基础路径`，所有版本的`OpenHarmony SDK`都会安装在此路径下。 假如该路径配置为`${os.homedir}/OpenHarmony`，那么插件会自动在`~/OpenHarmony/[API版本，数字]`文件夹下安装`OpenHarmony SDK`，并且会自动探测当前项目所使用的`API版本`，并自动切换到对应的`OpenHarmony SDK`。如你现在想安装`API20`的`OpenHarmony SDK`，那么插件会自动在`~/OpenHarmony/20`文件夹下安装`OpenHarmony SDK`： ``` ~/OpenHarmony ├── 10 ├── 18 └── 20 └── ets/ └── js/ └── native/ └── previewer/ └── toolchains/ ``` 该行为和`DevEco Studio`中的`设置 -> OpenHarmony SDK`功能是完全一致的。 ## VSCode 文件图标包 🖼️ 推荐使用[Material Icon Theme](https://marketplace.visualstudio.com/items?itemName=PKief.material-icon-theme)，我已经给`Material Icon Theme`提交了PR，目前将`.ets`、`.d.ets`直接用上了`TypeScript官方的文件图标包`，升级到`v5.22.0`之后的版本都可用，这样至少好看一些了 👇 ![Material icon theme](./screenshots/icon-theme.png) PR地址: [https://github.com/material-extensions/vscode-material-icon-theme/pull/2966](https://github.com/material-extensions/vscode-material-icon-theme/pull/2966) ## 配置 | Key | Description | Type | Default | Example | | ------------------ | ---------------------------------------------------------------------------------------------------------- | --------- | ----------------------------- | --------------------------------------------------------------- | | `ets.sdkPath` | %configuration.ets.sdkPath.description% | `string` | `""` | ```${os.homedir}/AppData/Local/OpenHarmony/20``` | | `ets.baseSdkPath` | %configuration.ets.baseSdkPath.description% | `string` | `"${os.homedir}/OpenHarmony"` | `"${os.homedir}/AppData/Local/OpenHarmony"` | | `ets.hmsPath` | %configuration.ets.hmsPath.description% | `string` | `""` | | | `ets.lspDebugMode` | %configuration.ets.lspDebugMode.description% | `boolean` | `false` | `true` | | `ets.hdcPath` | %configuration.ets.hdcPath.description% | `string` | `""` | | | `ets.sdkList` | A list of installed OpenHarmony SDK paths. Keys should follow the pattern API[number] (e.g., API9, API10). | `object` | `{}` | `{"API20": "${os.homedir}/OpenHarmony/20", "API18": "/opt/OpenHarmony/18"}` | ## 命令 | Command | Title | | ------------------- | ---------------------------- | | `ets.restartServer` | ETS: %command.restartServer% | | `ets.installSDK` | ETS: %command.installSDK% | ## 推荐食用搭配 ArkTs-X 组织有维护一个官方的跨平台arkts项目构建管理cli,可用于build和烧录 可以参考以下链接进行安装 [命令行工具](https://gitcode.com/arkui-x/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7ace-tools) 参考使用方式： ```bash ohos@user Desktop % ace create demo ? Enter the project name(demo): # 输入工程名称，不输入默认为文件夹名称 ? Enter the bundleName (com.example.demo): # 输入包名，不输入默认为com.example.工程名 ? Enter the runtimeOS (1: OpenHarmony, 2: HarmonyOS): 1 # 输入RuntimeOS系统 ? Please select the Complie SDK (1: 10, 2: 11, 3: 12): 2 # 输入编译SDK版本 Signing iOS app for device deployment using developer identity: "Apple Development: xxxxx" Project created. Target directory: ${当前目录}/demo. In order to run your app, type: $ cd demo $ ace run Your app code is in demo/entry. ``` ## Star History 🌟 [![Star History Chart](https://api.star-history.com/svg?repos=ohosvscode/arkTS&type=Date)](https://star-history.com/#ohosvscode/arkTS&Date) ![Alt](https://repobeats.axiom.co/api/embed/03ffa3957a86b00b0a96b449852ce4e5518850cf.svg "Repobeats analytics image") ## Contact to Author 📧 - Telegram: [@GCZ_Zero](https://t.me/GCZ_Zero) - X (Twitter): [@GCZ_Zero](https://x.com/GCZ_Zero) - QQ: 1203970284，QQ群: 746153004 - WeChat: gcz-zero ### Coffee ☕️ 如果觉得这个项目对你有帮助，可以请作者喝杯咖啡 ☕️ 也可以加入QQ群，一起交流学习 (群号: 746153004)
## License 📝 [MIT](./LICENSE)