【HarmonyOS 5开发入门】DevEco Studio安装配置完全指南

⭐本期内容:【HarmonyOS 5开发入门】DevEco Studio安装配置完全指南

🏆系列专栏:鸿蒙HarmonyOS:探索未来智能生态新纪元


前言

随着华为鸿蒙OS的快速发展,越来越多的开发者开始关注并投入到这个新兴的生态系统中。作为开发鸿蒙OS应用的第一步,安装并配置好DevEco Studio开发环境至关重要。本文将详细介绍如何下载、安装和初步配置DevEco Studio,帮助你快速进入鸿蒙应用开发的世界。


下载开发工具

访问华为官方开发者网站,在HarmonyOS专区找到开发工具的下载页面。 鸿蒙官方网站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虚拟机监控程序平台""虚拟机平台"是否存在。 如果存在,勾选这三个功能,点击确定并重启电脑。

勾选后启动模拟器仍报错,需以管理员权限打开命令行窗口并执行:

powershell 复制代码
bcdedit /set hypervisorlaunchtype auto

如果不存在,说明系统未预装Hyper-V,则需要首先按以下方式配置。

创建一个文本文件,内容为:

powershell 复制代码
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从下载到安装再到配置的完整流程都梳理了一遍,希望能给刚接触鸿蒙开发的朋友省去不少折腾的时间。说实话,第一次配环境总是会遇到这样那样的问题。

如果你按照教程操作还是碰到什么问题,或者对开发中有什么困惑,随时可以私信我聊聊,咱们一起在这条路上共同成长!

相关推荐
周末程序猿15 分钟前
技术总结|如何使用提升 strlen 的性能?
后端·算法
tang_jian_dong37 分钟前
springboot + vue3 拉取海康视频点位及播放
spring boot·后端·音视频
程序员爱钓鱼1 小时前
Go语言实战案例-括号匹配算法
后端·google·go
程序员爱钓鱼1 小时前
Go语言实战案例-判断字符串是否由另一个字符串的字母组成
后端·google·go
郝学胜-神的一滴3 小时前
SpringBoot实战指南:从快速入门到生产级部署(2025最新版)
java·spring boot·后端·程序人生
爷_8 小时前
字节跳动震撼开源Coze平台!手把手教你本地搭建AI智能体开发环境
前端·人工智能·后端
不过普通话一乙不改名11 小时前
第一章:Go语言基础入门之函数
开发语言·后端·golang
豌豆花下猫12 小时前
Python 潮流周刊#112:欢迎 AI 时代的编程新人
后端·python·ai
Electrolux12 小时前
你敢信,不会点算法没准你赛尔号都玩不明白
前端·后端·算法
whhhhhhhhhw12 小时前
Go语言-fmt包中Print、Println与Printf的区别
开发语言·后端·golang