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

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

相关推荐
uzong4 小时前
技术故障复盘模版
后端
GetcharZp4 小时前
基于 Dify + 通义千问的多模态大模型 搭建发票识别 Agent
后端·llm·agent
桦说编程5 小时前
Java 中如何创建不可变类型
java·后端·函数式编程
IT毕设实战小研5 小时前
基于Spring Boot 4s店车辆管理系统 租车管理系统 停车位管理系统 智慧车辆管理系统
java·开发语言·spring boot·后端·spring·毕业设计·课程设计
wyiyiyi5 小时前
【Web后端】Django、flask及其场景——以构建系统原型为例
前端·数据库·后端·python·django·flask
阿华的代码王国6 小时前
【Android】RecyclerView复用CheckBox的异常状态
android·xml·java·前端·后端
Jimmy6 小时前
AI 代理是什么,其有助于我们实现更智能编程
前端·后端·ai编程
zhanshuo6 小时前
在鸿蒙里优雅地处理网络错误:从 Demo 到实战案例
harmonyos
zhanshuo6 小时前
在鸿蒙中实现深色/浅色模式切换:从原理到可运行 Demo
harmonyos
AntBlack7 小时前
不当韭菜V1.1 :增强能力 ,辅助构建自己的交易规则
后端·python·pyqt