使用DevEco Studio搭建鸿蒙开发环境是进行鸿蒙应用开发的第一步,以下是详细的步骤指南:
一、准备工作
- 系统要求:
- Windows:Windows 10/11(64位),内存≥8GB,硬盘剩余空间≥10GB
- macOS:macOS 10.15及以上,内存≥8GB,硬盘剩余空间≥10GB
- 下载DevEco Studio:
从华为开发者联盟官网下载最新版本(推荐下载“Release”正式版)。
二、安装DevEco Studio
- 运行安装包:
- Windows:双击下载的
.exe文件,勾选“同意协议”,点击“Next”。 - macOS:双击
.dmg文件,将DevEco Studio拖入“Applications”文件夹。
- Windows:双击下载的
- 选择安装路径:
建议默认路径(或自定义非中文路径),避免后续出现兼容性问题。 - 安装选项:
勾选“Add launchers folder to the PATH”(Windows)或默认选项(macOS),方便命令行调用。 - 完成安装:
点击“Install”等待安装完成,最后点击“Finish”。
三、初始化配置(首次启动)
- 首次启动引导:
打开DevEco Studio,首次启动会提示“DevEco Studio Initial Setup”,点击“Next”。 - 同意隐私协议:
勾选同意华为开发者协议和隐私政策,点击“Next”。 - 配置Node.js环境:
- 推荐使用DevEco Studio内置的Node.js(默认勾选),无需额外安装。
- 若需使用自定义Node.js,需确保版本为14.19.0及以上,并手动指定路径。
- 安装HarmonyOS SDK:
- 系统会自动检测并提示安装SDK,选择需要的版本(建议勾选最新的“API Version”,如API 10)。
- 选择SDK安装路径(默认即可,需非中文路径),点击“Next”开始下载(约需5-10分钟,取决于网络)。
四、配置HDC工具(设备调试必备)
HDC(HarmonyOS Device Connector)是用于连接设备/模拟器的工具,需确保环境变量配置正确:
- 打开DevEco Studio,进入
File > Settings > System Settings > HDC(Windows)或DevEco Studio > Preferences > System Settings > HDC(macOS)。 - 确认HDC路径已自动配置(通常在SDK目录的
toolchains文件夹下)。 - 点击“Test HDC”验证是否正常,显示“Success”即为配置成功。
五、配置模拟器(可选,推荐)
若没有实体设备,可使用内置模拟器调试:
- 点击DevEco Studio顶部工具栏的“Device Manager”(📱图标)。
- 在弹出的窗口中,点击“New Device”,选择设备类型(如“Phone”)、型号(如“P50 Pro”)和API版本。
- 点击“Download”下载模拟器镜像(约1-2GB),完成后点击“Launch”启动模拟器。
六、验证开发环境
- 创建测试项目:
- 点击“Create Project”,选择“Application > Empty Ability”,点击“Next”。
- 填写项目信息:
- Project Name:自定义名称(如“MyFirstApp”)
- Save Location:项目保存路径(非中文)
- Language:选择“ArkTS”(推荐)
- Device Type:勾选“Phone”
- 点击“Finish”生成项目。
- 运行项目:
- 确保模拟器已启动(或已连接实体设备并开启开发者模式)。
- 点击工具栏的运行按钮(▶️),等待编译部署完成。
- 若模拟器/设备上成功显示默认页面,说明环境搭建成功。
七、常见问题解决
- SDK下载失败:
检查网络连接,或手动下载SDK后在Settings > HarmonyOS SDK中指定本地路径。 - 模拟器启动失败:
- 确保电脑开启虚拟化(在BIOS中开启VT-x/AMD-V)。
- 关闭电脑上的其他虚拟机(如VirtualBox、VMware)避免冲突。
- HDC连接失败:
实体设备需开启“USB调试”和“允许调试”,并安装对应驱动。
完成以上步骤后,你就可以开始进行鸿蒙应用开发了。如需进一步学习,可参考官方文档中的环境配置详细指南。