前言

随着华为鸿蒙操作系统的快速演进，越来越多的开发者开始聚焦并投身于这个新兴的生态系统之中。作为开启鸿蒙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%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
del hyper-v.txt
Dism /online /enable-feature /featurename:Microsoft-Hyper-V -All /LimitAccess /ALL
pause

保存后，将文件名改为Hyper-V.bat，右键以管理员身份运行。重启系统后，Hyper-V将安装并自动启用。

---

总结

本文梳理了DevEco Studio从下载、安装到配置的完整流程，希望能为刚接触鸿蒙开发的朋友节省配置环境的时间。初次配置环境时，难免会遇到各种问题。

若你按教程操作仍遇问题，或在开发中有疑惑，随时可私信交流，让我们一同在鸿蒙开发之路上共同成长！