
DevEco Studio 4.0安装与配置指南 - 开启HarmonyOS 5开发之旅
安装前准备
系统要求:
Windows 10 64位 (推荐1903版本或更新)
8GB RAM或更高(推荐16GB)
10GB可用硬盘空间(推荐SSD)
确保已安装OpenJDK 11,配置好JAVA_HOME环境变量
安装步骤
-
下载DevEco Studio 4.0
访问HarmonyOS开发者官网下载最新版本安装包 -
安装DevEco Studio
双击下载的安装包,按向导进行安装:
推荐安装路径:C:\DevEcoStudio
勾选创建桌面快捷方式
勾选"Add bin to PATH"选项
3. 首次启动配置
启动DevEco Studio后,按向导进行配置:
bash
复制
选择标准安装(Standard)
同意许可证协议
配置HarmonyOS SDK路径(默认即可)
选择需要安装的SDK版本(至少选择HarmonyOS 5.0)
等待安装完成
4. 设置模拟器
在Tools > Device Manager中配置本地模拟器:
安装HUAWEI Device Manager
下载需要的设备镜像
创建第一个HarmonyOS应用
现在我们来创建一个简单的"Hello HarmonyOS!"应用
步骤1:创建新项目
选择"Empty Ability"模板,配置如下:
Project Name: MyFirstApp
Package Name: com.example.myfirstapp
Save Location: C:\HarmonyOSProjects\MyFirstApp
Language: eTS (推荐) 或 Java
Compatible SDK: API 9+ (HarmonyOS 5.0)
步骤2:编辑主页代码
打开entry/src/main/ets/pages/Index.ets,添加以下代码:
typescript
复制
@Entry
@Component
struct Index {
@State message: string = ‘Hello HarmonyOS!’
build() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.fontColor(‘#007DFF’)
.margin({ bottom: 20 })
Button('点我')
.onClick(() => {
this.message = '你好,鸿蒙!';
})
.fontSize(20)
.width(200)
.height(60)
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
.padding(20)
}
}
步骤3:运行应用
在工具栏选择模拟器设备(如Phone)
点击绿色的运行按钮 (或Shift+F10)
等待编译完成,模拟器将自动启动并运行应用
完整应用截图

开发环境配置关键点总结
配置项 推荐设置 说明
JDK版本 OpenJDK 11 HarmonyOS开发专用JDK
SDK安装目录 C:\Users\用户名\AppData\Local\Huawei 默认即可
SDK组件 JS/Java SDK, Toolchains 必须安装
Gradle版本 适配的7.x版本 开发工具管理
Node.js v16.x LTS 开发eTS应用需要
常见问题解决
模拟器无法启动:
确保BIOS中启用虚拟化技术(VT-x)
禁用Hyper-V(Windows功能中关闭)
以管理员身份运行DevEco Studio
依赖下载失败:
gradle
复制
// 修改项目下的build.gradle
repositories {
// 添加阿里云镜像
maven { url ‘https://repo.huaweicloud.com/repository/maven/’ }
mavenCentral()
}
SDK组件安装缓慢:
尝试使用全局代理
手动下载SDK包并导入
通过完成上述步骤,你已经成功搭建了HarmonyOS 5的开发环境并创建了第一个应用!HarmonyOS为开发者提供了强大的分布式能力,接下来可以尝试开发多设备协同的应用。
