)
HarmonyOS Dev Assistant for VS CodeHarmonyOS Dev Assistant 插件简介HarmonyOS Dev Assistant 是一款面向鸿蒙HarmonyOS开发者的 AI 编码助手 VS Code 扩展。插件以自然语言对话为核心交互方式提供一站式生成元服务小程序转元服务以及三方库鸿蒙化能力帮助您更高效地完成鸿蒙元服务开发。安装环境要求操作系统— 支持Windows、macOS12Intel/ Apple SiliconVSCode— 最低版本 VS Code 1.85.0推荐版本 VSCode 1.90建议使用近半年内的稳定版;Node.js—最低版本Node.js 18.x推荐版本Node.js 20.x LTS;核心特性智能代码生成— 与 AI 对话式生成ArkTS/HarmonyOS 代码覆盖项目创建、UI 开发、状态管理、网络请求、数据存储等完整开发流程。元服务研发问答— 基于项目上下文的实时技术问答快速解决鸿蒙元服务开发中的 API 使用、设计指南、华为登录/支付接入等问题。构建与调试— 集成hvigor 构建、模拟器调试、HAP 签名与真机部署覆盖从开发到验证的全流程。一键式签名— 在插件设置中绑定元服务并完成签名简化元服务打包与调试流程。内置元服务skill技能—提供元服务开发、转换、续写、备案上架等面向鸿蒙场景的专属技能skills连接 Agent后自动加载。上架发布辅助— 覆盖元服务备案、AGC 上架检测等发布全流程指导。功能介绍一站式生成元服务— 在输入区的模式下拉框中切换至「元服务生成」输入自然语言描述你的需求即可一键生成可运行的元服务工程与代码。小程序转元服务— 在输入区的模式下拉框中切换至「元服务转换」输入需要转换的小程序描述即可自动将微信/支付宝小程序源代码转换为 ASCF 元服务代码。三方库鸿蒙化— 在输入区的模式下拉框中切换至「三方库鸿蒙化」模式通过对话描述需要适配的三方库即可快速生成鸿蒙平台的适配产物。多平台支持除 VS Code 外HarmonyOS DevAssistant 还以插件层形式支持HBuilderX—面向uni-app 与鸿蒙混合开发场景DevEcoStudio— 面向鸿蒙原生语言开发的 IDE使用指南登录插件使用HarmonyOS开发助手需要使用已实名认证的华为开发者账号登录。点击插件主界面“华为账号登录”按钮。在弹出的账号登录页面输入已实名认证的华为开发者账号信息。返回编辑器此时若当前账号团队尚未签署插件相关隐私声明与使用条款点击蓝色链接阅读协议内容后点击“同意”即可进入主界面。配置插件在正式使用插件前您需要先配置AI模型与DevEco Studio安装路径。配置AI模型。首次登录插件界面会提示您当前未配置模型点击提示框中的“去配置”链接前往模型配置界面。后续如需修改模型配置可点击插件右上角设置按钮进入模型配置界面操作。在“模型”页签点击“添加模型”。在“添加模型”窗口在“供应商”栏选择模型并输入对应的API Key点击“保存”。配置DevEco Studio安装路径。点击插件右上角设置按钮。在“基础配置 安装路径”栏设置本地DevEcoStudio的安装路径。一站式生成元服务生成元服务。在VS Code中打开一个空目录。进入插件界面在左下角切换模式为“元服务生成”并在对话框中输入类似“生成一个元服务”的提示语并添加对元服务功能、布局详细要求的提示词。等待“待办清单”中各任务执行完成后进入资源管理器界面查看生成的元服务。将生成的元服务工程与AGC上的元服务关联。支持关联已有的元服务或者新建一个元服务进行关联。关联已有的元服务点击插件右上角设置按钮进入“关联元服务”页签点击“关联元服务”。在“选择元服务”窗口选择AGC上元服务所属的团队以及元服务名称点击“关联”。元服务成功关联后“当前元服务”区域将展示元服务的详细信息。关联新建的元服务点击插件右上角设置按钮进入“关联元服务”页签点击“关联元服务”。在“选择元服务”窗口点击“创建元服务”浏览器将打开AGC控制台页面。在“应用开发基础信息”页面填写待创建的元服务名称分类仅支持选择“应用”完成后点击“下一步”。进入“所属项目信息”页面为元服务选择所属的项目后点击“下一步”。如需将元服务添加到已有项目点击下拉框进行选择如需将元服务添加到新项目直接在框中填写新项目名称。进入“云开发数据处理位置”页面设置或管理项目的数据处理位置。如项目尚未设置数据处理位置点击“数据处理位置”栏的“启用”之后在“启用”栏为您的项目勾选一个或多个数据处理位置并在“设为默认”栏将其中一个设置为默认数据处理位置。如项目已设置过数据处理位置可点击“数据处理位置”栏的“管理”来启用新的数据处理位置、取消已启用的数据处理位置或修改默认数据处理位置。点击“确认”元服务创建完成。返回HarmonyOS开发助手界面再次点击“关联元服务”选择正确的团队和刚刚创建的元服务点击“关联”。元服务成功关联后“当前元服务”区域将展示元服务的详细信息。在模拟器上运行元服务。在操作前请确保DevEco Studio已安装所需版本的模拟器。在插件对话框中输入类似“运行到模拟器”的提示语插件将拉起DevEco Studio中的模拟器运行元服务。在真机上运行元服务。将真机与PC连接。打开插件配置界面在“关联元服务”页签点击“添加签名”在“创建元服务签名”窗口输入签名信息点击“确认”。在对话框中输入类似“将当前项目推包到手机运行”的提示语插件将元服务推送到连接的真机上运行。执行上架自检。为元服务配置发布签名。打开插件配置界面在“关联元服务”页签点击“添加签名”在“创建元服务签名”窗口输入签名信息点击“确认”。在插件对话框中输入类似“帮我打包用于最终上架”的提示语。等待“待办清单”中各任务执行完成后进入资源管理器界面在“buildoutputs”目录下获取带签名的元服务软件包。打开插件配置界面在“关联元服务”页签的“上架自检”区域点击文件选择按钮选择刚刚编译生成的带签名的元服务软件包点击“提交自检”。等待自检结果。报告生成后在“自检结果”栏点击“报告”查看详细信息。小程序转换元服务转换元服务。在VS Code中打开待转换的工程。进入插件界面在左下角切换模式为“元服务转换”并在对话框中输入类似“当前是一个XXX小程序帮我转换为ASCF元服务工程”的提示语。等待“待办清单”中各任务执行完成后进入资源管理器界面查看转换生成的元服务。将生成的元服务工程与AGC上的元服务关联。支持关联已有的元服务或者新建一个元服务进行关联。关联已有的元服务点击插件右上角设置按钮进入“关联元服务”页签点击“关联元服务”。在“选择元服务”窗口选择AGC上元服务所属的团队以及元服务名称点击“关联”。“当前元服务”区域将展示元服务的详细信息表示元服务已成功关联。关联新建的元服务点击插件右上角设置按钮进入“关联元服务”页签点击“关联元服务”。在“选择元服务”窗口点击“创建元服务”浏览器将打开AGC控制台页面。在“应用开发基础信息”页面填写待创建的元服务名称分类仅支持选择“应用”完成后点击“下一步”。进入“所属项目信息”页面为元服务选择所属的项目后点击“下一步”。如需将元服务添加到已有项目点击下拉框进行选择如需将元服务添加到新项目直接在框中填写新项目名称。进入“云开发数据处理位置”页面设置或管理项目的数据处理位置。如项目尚未设置数据处理位置点击“数据处理位置”栏的“启用”之后在“启用”栏为您的项目勾选一个或多个数据处理位置并在“设为默认”栏将其中一个设置为默认数据处理位置。如项目已设置过数据处理位置可点击“数据处理位置”栏的“管理”来启用新的数据处理位置、取消已启用的数据处理位置或修改默认数据处理位置。点击“确认”元服务创建完成。返回HarmonyOS开发助手界面再次点击“关联元服务”选择正确的团队和刚刚创建的元服务点击“关联”。“当前元服务”区域将展示元服务的详细信息表示元服务已成功关联。在模拟器上运行元服务。在操作前请确保DevEco Studio已安装所需版本的模拟器。在插件对话框中输入类似“将包推送到模拟器上运行调试”的提示语插件将拉起DevEcoStudio中的模拟器运行元服务。在真机上运行元服务。将真机与PC连接。打开插件配置界面在“关联元服务”页签点击“添加签名”在“创建元服务签名”窗口输入签名信息点击“确认”。在对话框中输入类似“已完成签名帮我运行到真机上”的提示语插件将元服务推送到连接的真机上运行。执行上架自检。为元服务配置发布签名。打开插件配置界面在“关联元服务”页签点击“添加签名”在“创建元服务签名”窗口输入签名信息点击“确认”。在插件对话框中输入类似“帮我打包用于最终上架”的提示语。等待“待办清单”中各任务执行完成后进入资源管理器界面在“buildoutputs”目录下可获取带签名的元服务软件包。打开插件配置界面在“关联元服务”页签的“上架自检”区域点击文件选择按钮选择刚刚编译生成的带签名的元服务软件包点击“提交自检”。等待自检结果。报告生成后在“自检结果”栏点击“报告”查看详细信息。三方库鸿蒙化获取待转换的三方库文件并根据三方库类型完成Flutter环境搭建 |完成ReactNative环境搭建 | 完成DevEcoStudio环境搭建。转换三方库。在VS Code中打开待转换的三方库工程。进入插件界面在左下角切换模式为“三方库鸿蒙化”并在对话框中输入类似“将当前工程进行鸿蒙化适配”的提示语。等待各阶段任务执行完成后进入资源管理器界面查看鸿蒙化后的三方库工程。“ohos”目录下即为鸿蒙化三方库供项目后续调用。“example ohos”目录下还提供了鸿蒙化三方库的Demo样例供您查看转换效果。在模拟器上运行鸿蒙化三方库Demo。使用DevEco Studio打开“exampleohos”目录下的Demo工程。在模拟器中运行Demo具体请参考使用模拟器运行应用。在真机上运行鸿蒙化三方库Demo。使用DevEco Studio打开“exampleohos”目录下的Demo工程。将Demo推送到连接的真机上运行具体请参考使用本地真机运行应用。本文参考鸿蒙官方文档