鸿蒙原生应用开发环境搭建指南

本指南详细讲解如何从零配置 HarmonyOS 原生应用开发环境，包含 DevEco Studio 安装、SDK 设置、模拟器搭建以及真机调试等全流程操作步骤。

1. 环境要求

CPU：64 位处理器（推荐 Intel Core i5 及以上或同等 AMD 处理器）

内存：8 GB 及以上（推荐 16 GB）

硬盘：固态硬盘，预留至少 30 GB 可用空间

显示器：分辨率 1920×1080 及以上

操作系统要求

操作系统	版本要求
Windows	Windows 10/11 64 位
macOS	macOS 11.0 及以上（Intel 或 Apple Silicon）

---

2. 下载与安装 DevEco Studio

下载安装包

访问华为开发者联盟官网下载页面：

• 选择对应操作系统的安装包：（建议使用Release版本）

• Windows：.exe 安装程序

• macOS：.dmg 磁盘映像

Windows 安装步骤

1. 双击运行 deveco-studio-xxxx.exe，启动安装向导。

2. 点击 Next，选择安装路径（避免包含中文或空格）。

3. 勾选创建桌面快捷方式等选项，点击 Next。

4. 点击 Install，等待安装完成。

5. 首次启动时，若弹出“导入设置”窗口，选择 Do not import settings。

---

3. 配置开发环境

首次启动 DevEco Studio 后，需完成 SDK 及工具链的下载配置。

初始化向导

1. 启动后进入 DevEco Studio Setup Wizard。

2. 点击 Next，选择 Standard 安装类型（推荐）。

3. 接受许可协议，点击 Next。

4. 确认安装配置后，点击 Next，开始下载 SDK 及核心工具。

5. 下载完成后点击 Finish。

1. 创建并运行第一个项目

新建工程步骤：

1. 点击 Create Project（或通过菜单 File → New → Create Project）
2. 选择 Empty Ability 模板，点击 Next
3. 填写项目配置信息：
   • Project name（如 Start）
   • Bundle name（应用包名，如 com.goway.start）
   • Save location（项目保存路径）
   • Compile SDK（选择 API 20 或更高版本）
   • Model（推荐选择 entry）
4. 点击 Finish 完成创建

运行项目方法： 在模拟器上运行：

1. 确保模拟器已启动并在 Device Manager 中显示为在线状态
2. 点击工具栏运行按钮（绿色三角形）旁的设备选择器，选择目标模拟器
3. 点击运行按钮，等待编译安装完成后应用将自动启动

在真机上运行（推荐方式）：

1. 使用 USB 连接 HarmonyOS 设备
2. 确保手机已开启"开发者模式"并启用"USB调试"
3. 首次连接时需在手机上授权调试请求
4. 在 DevEco Studio 设备列表中选择已连接的手机
5. 点击运行按钮

创建模拟器流程：

1. 点击工具栏的 Device Manager 图标（或通过菜单 View → Tool Windows → Device Manager）
2. 在 Device Manager 面板中点击 ＋ 按钮，选择 Create Emulator
3. 选择设备模板（如 Phone），点击 Next
4. 下载系统镜像：
   • 选择与项目 SDK 匹配的 API Version
   • 点击下载图标等待完成
5. 为模拟器命名并调整配置参数（内存、分辨率等）
6. 点击 Finish 完成创建

启动模拟器：

1. 在 Device Manager 中找到目标模拟器
2. 点击右侧的启动按钮
3. 启动完成后即可作为运行目标使用

---

恭喜！现在你已经成功搭建好鸿蒙原生应用开发环境。接下来可以开始深入学习 ArkTS 和 ArkUI，开启你的鸿蒙应用开发之旅了！