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.2GBPreviewer✓界面预览工具800MBToolchains✓编译工具链500MBDocs可选开发文档300MB配置流程打开DevEco Studio进入Configure SDK Manager在SDK Platforms选项卡勾选API 9在SDK Tools选项卡选择HarmonyOS Emulatorhdc工具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:ReservedCodeCacheSize1024mGradle加速修改gradle.propertiesorg.gradle.daemontrue org.gradle.paralleltrue org.gradle.cachingtrue模拟器优化开启VT-x/AMD-V虚拟化支持分配至少4GB内存给模拟器4. 项目创建与运行完成环境搭建后创建第一个测试项目选择File New New Project模板选择Empty Ability配置项目Name: HelloWorldBundle name: com.example.helloworldSave location: 自定义路径Language: ArkTSAPI version: 9Model: 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)
