【HarmonyOS 5开发入门】DevEco Studio安装配置完全指南
⭐本期内容：【HarmonyOS 5开发入门】DevEco Studio安装配置完全指南
🏆系列专栏：鸿蒙HarmonyOS：探索未来智能生态新纪元
文章目录
- 前言
- 下载开发工具
- 安装开发工具
- 配置开发环境
- 新建项目
- 项目结构概述
- 运行项目
- Preview预览
- 模拟器运行
- 报错处理
- “未开启Hyper-V”或“Hyper-V not enabled”
- 解决措施
- 总结
前言
随着华为鸿蒙OS的快速发展，越来越多的开发者开始关注并投入到这个新兴的生态系统中。作为开发鸿蒙OS应用的第一步，安装并配置好DevEco Studio开发环境至关重要。本文将详细介绍如何下载、安装和初步配置DevEco Studio，帮助你快速进入鸿蒙应用开发的世界。
下载开发工具
访问华为官方开发者网站，在HarmonyOS专区找到开发工具的下载页面。
鸿蒙官方网站：https://developer.huawei.com/consumer/cn/
根据操作系统类型，选择对应的安装包进行下载。
下载完成后，将安装包解压缩至您指定的目录中。
安装开发工具
打开解压后的文件夹，找到安装程序，双击运行。同意相关协议后，点击下一步继续安装。
选择安装目录，建议选择一个空间充足且易于管理的路径。
勾选创建快捷方式和添加环境变量到bin目录。
这里默认为Huawei，不用修改，点击install，等待安装完成~
安装完成后，桌面会有显示噢~
配置开发环境
安装完成后，打开开发工具。启动，这里我之前配置过，选择不导入配置选项继续。
环境配置可参考往期文章：【HarmonyOS 4+NEXT】开发工具安装指南
进入新建项目页面即安装完成。
新建项目
点击创建一个新的工程（Create Project），默认的是Empty Ability。选择合适的模板，点击NEXT。
在新建项目配置界面，需要填写项目的基本信息，包括：
- Project name：
项目名称，建议使用有意义的名称以便于识别。 - Bundle name：
域名倒置，包名，通常为公司域名倒置加上项目名，例如com.example.myapp。注意保持包名的唯一性，它是应用打包上架的唯一标识。 - Save location：项目
保存路径，选择合适的目录保存项目文件。
设置完成后，点击finish，项目创建完毕。
项目结构概述
创建项目后，IDE会自动生成项目的基本结构。对于鸿蒙应用项目，主要关注以下几个目录：
entry/src/main/ets/pages：存放页面代码，每个.ets文件代表一个页面。
entry/src/main/resources：存放资源文件，包括图片、字符串等。
entry/src/main/module.json5：配置文件，用于配置应用的权限、组件等信息。
重点关注entry，这是项目的入口模块（Ability）。
src文件夹是项目目录结构核心部分，它包含了项目的源代码和资源文件。在src文件夹内部，有一个main文件夹，这个文件夹进一步组织了项目的不同组成部分。
main文件夹中包含两个关键的子文件夹：ets和resources。
resources文件夹用于存放项目的所有资源文件，这些资源文件可能包括图片、图标、字符串常量、样式表等，它们为应用提供了必要的视觉和文本元素。
ets文件夹包含了应用的页面逻辑和界面布局。在ets文件夹中，pages子文件夹专门用于存放应用的页面文件。这些页面文件的后缀为.ets，用于定义应用的界面布局和用户交互逻辑。
运行项目
DevEco Studio提供了多种方式运行项目，包括预览、模拟器和真机运行。
Preview预览
Preview预览器用于查看应用的UI界面效果，方便开发者随时调整界面布局。只需打开需要预览的.ets文件，点击IDE右侧的Previewer即可查看预览效果。
点击预览中的切换图标，还可以实现横屏竖屏的切换，方便查看效果。
模拟器运行
初次使用模拟器需要先进行安装。点击“Tools” > “Device Manager”，在设备管理器中点击“Install”下载模拟器相关的SDK，并按照提示完成安装。安装完成后，启动模拟器，并在IDE右上角选择模拟器作为运行设备，点击运行按钮即可在模拟器中运行应用。
选择Tools->Device Manager。
同意相关协议。
进入镜像下载页面，先编辑目录，再下载对应的映像。
下载完成，点击Next。
保持默认选项，点击finish。
点击运行。
报错处理
“未开启Hyper-V”或“Hyper-V not enabled”
启动模拟器时，弹窗提示“未开启Hyper-V”或“Hyper-V not enabled”。
解决措施
先确认CPU型号是否支持虚拟化技术，如果不支持，则无法使用模拟器。
如果CPU支持虚拟化，打开控制面板 > 程序 > 程序和功能 > 启动或关闭Windows功能（Windows11系统中打开系统 > 可选功能 > 相关设置 > 更多Windows功能），检查功能“Hyper-V”、“Windows虚拟机监控程序平台”、“虚拟机平台”是否存在。
如果存在，勾选这三个功能，点击确定并重启电脑。
若勾选后启动模拟器仍报错，需以管理员权限打开命令行窗口并执行：
bcdedit /set hypervisorlaunchtype auto
如果不存在，说明系统未预装Hyper-V，则需要首先按以下方式配置。
创建一个文本文件，内容为：
pushd "%~dp0"
dir /b %SystemRoot%servicingPackages*Hyper-V*.mum >hyper-v.txt
for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%servicingPackages%%i"
del hyper-v.txt
Dism /online /enable-feature /featurename:Microsoft-Hyper-V -All /LimitAccess /ALL
pause
保存后，文件名改为Hyper-V.bat，右键以管理员身份运行。重启系统后，Hyper-V 就安装并自动启用。
总结
这篇文章算是把DevEco Studio从下载到安装再到配置的完整流程都梳理了一遍，希望能给刚接触鸿蒙开发的朋友省去不少折腾的时间。说实话，第一次配环境总是会遇到这样那样的问题。
如果你按照教程操作还是碰到什么问题，或者对开发中有什么困惑，随时可以私信我聊聊，咱们一起在这条路上共同成长！
