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
安装流程分为三个核心步骤：
下载DevEco Studio：
- 访问华为开发者联盟官网
- 在下载页面选择对应操作系统的5.0.4版本
- 建议下载校验文件验证安装包完整性
运行安装程序：
- Windows：双击.exe文件，按向导完成安装
- Mac：拖拽应用图标到Applications文件夹
首次启动配置：
- 选择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 |
配置流程：
- 打开DevEco Studio，进入"Configure > SDK Manager"
- 在"SDK Platforms"选项卡勾选API 9
- 在"SDK Tools"选项卡选择：
- HarmonyOS Emulator
- hdc工具
- OpenJDK 17
- 点击"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/binMac平台验证命令：
# 检查安装路径 ls -l /Applications/DevEco\ Studio.app # 验证SDK目录 ls -lh ~/Library/Huawei/Sdk/harmonyos/9性能优化建议：
内存配置：
- 修改
/Applications/DevEco Studio.app/Contents/bin/studio.vmoptions(Mac) - 或
安装目录/bin/studio64.exe.vmoptions(Windows) - 推荐参数：
-Xms2048m -Xmx4096m -XX:ReservedCodeCacheSize=1024m
- 修改
Gradle加速：
- 修改
gradle.properties：org.gradle.daemon=true org.gradle.parallel=true org.gradle.caching=true
- 修改
模拟器优化：
- 开启VT-x/AMD-V虚拟化支持
- 分配至少4GB内存给模拟器
4. 项目创建与运行
完成环境搭建后，创建第一个测试项目：
选择"File > New > New Project"
模板选择"Empty Ability"
配置项目：
- Name: HelloWorld
- Bundle name: com.example.helloworld
- Save location: 自定义路径
- Language: ArkTS
- API version: 9
- Model: Stage
等待项目初始化完成后：
- 打开
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)
