DevEco Studio 5.0.4 环境搭建：Windows/Mac 双平台 3 步配置与 SDK 9 安装

1. 环境准备与安装

在开始鸿蒙应用开发之前，确保您的开发环境满足以下基本要求：

Windows 平台最低配置 ：

• 操作系统：Windows 10 64位
• 内存：8GB（推荐16GB）
• 存储空间：10GB可用空间
• 分辨率：1280x800以上

Mac 平台最低配置 ：

• 操作系统：macOS 10.15及以上
• 芯片：Intel或Apple Silicon
• 内存：8GB（推荐16GB）
• 存储空间：10GB可用空间

提示：如果使用Mac M系列芯片，请确认下载对应ARM版本的JDK

安装流程分为三个核心步骤：

1. 下载DevEco Studio ：

   • 访问华为开发者联盟官网
   • 在下载页面选择对应操作系统的5.0.4版本
   • 建议下载校验文件验证安装包完整性

2. 运行安装程序 ：

   • Windows：双击.exe文件，按向导完成安装
   • Mac：拖拽应用图标到Applications文件夹

3. 首次启动配置 ：

   • 选择UI主题（推荐Darcula深色主题）
   • 接受用户协议
   • 设置SDK默认存储路径（建议非系统盘）

# Windows环境验证命令（管理员权限运行）
wmic os get osarchitecture
systeminfo | find "可用物理内存"

2. SDK配置与管理

SDK是开发鸿蒙应用的核心组件，5.0.4版本对SDK 9的支持进行了多项优化：

SDK组件选择建议 ：

组件名称	必装	功能说明	大小
JS/ArkTS	✓	应用开发语言支持	1.2GB
Previewer	✓	界面预览工具	800MB
Toolchains	✓	编译工具链	500MB
Docs	可选	开发文档	300MB

配置流程：

1. 打开DevEco Studio，进入"Configure > SDK Manager"
2. 在"SDK Platforms"选项卡勾选API 9
3. 在"SDK Tools"选项卡选择：
   • HarmonyOS Emulator
   • hdc工具
   • OpenJDK 17
4. 点击"Apply"开始下载（约需2-4小时，视网络情况）

常见问题解决方案：

• 下载中断 ：尝试切换网络或使用下载工具
• 空间不足 ：通过 df -h (Mac)或 wmic logicaldisk get size,freespace (Win)检查空间
• 权限问题 ：确保对安装目录有写入权限

注意：SDK路径不要包含中文或特殊字符，否则可能导致编译错误

3. 环境验证与调优

完成安装后，通过以下步骤验证环境配置：

Windows平台验证脚本 ：

# 检查环境变量
$env:PATH -split ';' | Select-String "DevEco"

# 验证JDK版本
java -version

# 检查hdc工具
hdc shell ls /system/bin

Mac平台验证命令 ：

# 检查安装路径
ls -l /Applications/DevEco\ Studio.app

# 验证SDK目录
ls -lh ~/Library/Huawei/Sdk/harmonyos/9

性能优化建议：

1. 内存配置 ：

   • 修改 /Applications/DevEco Studio.app/Contents/bin/studio.vmoptions (Mac)
   • 或 安装目录/bin/studio64.exe.vmoptions (Windows)
   • 推荐参数：

     -Xms2048m
     -Xmx4096m
     -XX:ReservedCodeCacheSize=1024m
     

2. Gradle加速 ：

   • 修改 gradle.properties ：

     org.gradle.daemon=true
     org.gradle.parallel=true
     org.gradle.caching=true
     

3. 模拟器优化 ：

   • 开启VT-x/AMD-V虚拟化支持
   • 分配至少4GB内存给模拟器

4. 项目创建与运行

完成环境搭建后，创建第一个测试项目：

1. 选择"File > New > New Project"

2. 模板选择"Empty Ability"

3. 配置项目：

   • Name: HelloWorld
   • Bundle name: com.example.helloworld
   • Save location: 自定义路径
   • Language: ArkTS
   • API version: 9
   • Model: Stage

4. 等待项目初始化完成后：

   • 打开 entry/src/main/ets/pages/Index.ets
   • 点击右上角"Previewer"预览界面
   • 或选择"Run > Run 'HelloWorld'"运行到模拟器

项目结构说明 ：

HelloWorld/
├── AppScope/          # 应用全局资源
│   └── app.json5      # 应用配置
├── entry/             # 主模块
│   ├── src/
│   │   ├── main/
│   │   │   ├── ets/   # ArkTS代码
│   │   │   ├── resources/ # 资源文件
│   │   │   └── module.json5 # 模块配置
│   └── build-profile.json5
├── build-profile.json5 # 项目构建配置
└── hvigorfile.ts      # 构建脚本

首次运行可能遇到的问题：

• 模拟器启动失败 ：检查BIOS中虚拟化是否开启
• 构建卡顿 ：关闭杀毒软件实时监控
• 预览白屏 ：清理缓存(File > Invalidate Caches)