第2章 开发环境搭建
HarmonyOS 学习系统 | 阶段一：入门筑基期
建议学习时长：1-2 周
学习目标
| 序号 | 能力 |
|---|---|
| 1 | 完成华为开发者联盟账号注册与实名认证 |
| 2 | 成功安装并配置 DevEco Studio 开发环境 |
| 3 | 掌握 IDE 常用操作与功能区域 |
| 4 | 理解模拟器、预览器、真机运行的区别与适用场景 |
核心图解
内容讲解
2.1 注册华为开发者账号
如果把开发 HarmonyOS 应用比作开一家餐厅，那么：
- 华为开发者账号= 你的营业执照（没有它你连门都进不了）
- DevEco Studio= 你的中央厨房（锅碗瓢盆、案板刀具一应俱全）
- HarmonyOS SDK= 食材供应商（提供各种原材料和调料）
- Node.js= 一台特殊的榨汁机（只有做 JS UI 菜品时才需要）
- 模拟器= 试吃台（不用真的端给客人就能先尝味道）
要进行 HarmonyOS 应用开发，首先需要注册华为开发者联盟账号并完成实名认证。个人开发者需要准备：手机号码/邮箱、身份证正反面照片、个人银行卡号。
注册流程
| 步骤 | 操作 | 耗时 |
|---|---|---|
| 1. 注册 | developer.huawei.com → 注册 → 邮箱/手机验证 | 5 分钟 |
| 2. 实名认证 | 管理中心 → 个人开发者 → 银行卡/身份证认证 | 1-3 个工作日 |
| 3. 创建项目 | AppGallery Connect → 创建项目 + 应用 | 5 分钟 |
华为商城账号、华为云账号和花粉论坛账号均可登录联盟。实名认证有两种方式：个人银行卡认证（适合上架非敏感应用）和身份证人工审核认证（1-3 个工作日发送结果至邮箱）。
2.2 安装 DevEco Studio
DevEco Studio 是基于 IntelliJ IDEA Community 打造的一站式集成开发环境，为 HarmonyOS 应用提供从创建、开发、编译、调试到发布的端到端服务。
运行环境要求
- 操作系统：Windows 10 64 位（或 macOS）
- 内存：8GB 及以上
- 硬盘：100GB 及以上
- 分辨率：1280×800 像素及以上
安装步骤
- 进入 DevEco Studio 产品页下载安装包
- 双击
deveco-studio-xxxx.exe进入安装向导 - 勾选 DevEco Studio launcher 后单击 Next 直至完成
- 首次启动选择 “Do not import Settings”
DevEco Studio 的核心特点：
- 多设备统一开发环境：支持 Phone、Tablet、Car、TV、Wearable、LiteWearable、Smart Vision
- 多语言支持：Java、XML、C/C++、JS、CSS、HML
- FA/PA 快速开发：通过工程向导快速创建模板，一键打包成 HAP
- 分布式多端开发：一个工程、一份代码跨设备运行
- 多设备预览器：Java/JS 双预览器，支持多设备同时预览
2.3 配置开发环境
DevEco Studio 首次使用需要配置 HarmonyOS SDK。如果网络环境需要代理，还需配置 npm 代理、Gradle 代理和 IDE 代理。
npm 设置（仅 JS 开发需要）
如果需要使用 JS 语言开发且不能直接访问互联网，需要配置 npm 代理：
# 无认证代理npmconfigsetproxy http://proxyserver:portnpmconfigsethttps-proxy http://proxyserver:port# 有认证代理npmconfigsetproxy http://user:password@proxyserver:portnpmconfigsethttps-proxy http://user:password@proxyserver:port# 设置国内镜像（推荐）npmconfigsetregistry https://mirrors.huaweicloud.com/repository/npm/# 验证配置npminfo expressGradle 代理设置
在%userprofile%\.gradle\目录下创建gradle.properties文件：
systemProp.http.proxyHost=proxy.server.com systemProp.http.proxyPort=8080 systemProp.https.proxyHost=proxy.server.com systemProp.https.proxyPort=8080HarmonyOS SDK 下载
通过Configure → Settings → HarmonyOS SDK打开 SDK Manager，设置 SDK 存储路径（不能包含中文），勾选需要的 SDK 包进行下载。Java SDK 为默认下载，JS 和 C/C++ SDK 需要手动勾选。
2.4 IDE 功能介绍
DevEco Studio 的工作台布局包含以下核心区域：
- 菜单栏：File、Edit、View、Navigate、Code、Analyze、Refactor、Tools、Run
- 工具栏：运行按钮、设备选择、预览器快捷入口
- Project 面板：项目目录结构，展示 entry/src/main/java/、resources/、config.json 等
- 代码编辑区：支持 Java/XML/JS/CSS/HML 语法高亮和智能补全
- Previewer 面板：实时预览 UI 布局效果
- Device Manager 面板：管理模拟器和真机设备
- 底栏：Build 输出、日志信息、SDK 版本等
IDE 代理设置
如果网络环境需要代理，还需配置 IDE 代理：
- 打开
File → Settings → Appearance & Behavior → System Settings → HTTP Proxy - 选择 “Manual proxy configuration”
- 填入代理服务器地址和端口
- 点击 “Check connection” 验证代理是否可用
Node.js 安装（仅 JS 开发需要）
如果需要使用 JS 语言开发 UI，还需要安装 Node.js：
- 下载 Node.js LTS 版本（推荐 12.x 或 14.x）
- 安装时勾选 “Add to PATH”
- 验证安装：在命令行输入
node -v和npm -v - 配置 npm 镜像源：
npm config set registry https://mirrors.huaweicloud.com/repository/npm/
如果你只用 Java 开发，可以跳过 Node.js 的安装，不必浪费时间在这上面。
工程目录结构概览
创建完工程后，Project 面板中会展示以下核心目录：
MyApplication/ ├── entry/ # 主模块（entry HAP） │ ├── src/main/ │ │ ├── java/ # Java 源代码 │ │ │ └── com/example/myapp/ │ │ │ ├── MainAbility.java # 应用入口 │ │ │ └── slice/ │ │ │ └── MainAbilitySlice.java # 默认页面 │ │ ├── resources/ # 资源文件 │ │ │ ├── base/layout/ # 布局文件 │ │ │ ├── base/media/ # 媒体资源 │ │ │ ├── base/element/ # 字符串、颜色等 │ │ │ └── rawfile/ # 原始文件 │ │ └── config.json # 应用配置 │ └── build.gradle # 模块构建配置 ├── build.gradle # 工程级构建配置 ├── settings.gradle # 工程设置 └── gradle.properties # Gradle 属性配置代码速查卡
| 操作 | 快捷键/方式 | 说明 |
|---|---|---|
| 创建新工程 | File → New → New Project | 选择设备类型和 Ability 模板 |
| 运行应用 | Shift + F10 | 需先启动模拟器或连接真机 |
| 打开预览器 | View → Tool Windows → Previewer | 实时预览 UI 布局效果 |
| 打开设备管理器 | Tools → Device Manager | 管理模拟器和真机 |
| 添加 Module | File → New → Module | 添加 Entry 或 Feature 模块 |
| SDK 管理 | Configure → Settings → HarmonyOS SDK | 下载/管理 SDK 包 |
| 打开设置 | Ctrl + Alt + S | 打开 IDE 全局设置 |
| 代码格式化 | Ctrl + Alt + L | 自动格式化代码 |
与 Android/iOS 对比
| 特性 | DevEco Studio | Android Studio | Xcode |
|---|---|---|---|
| 基础 | IntelliJ IDEA Community | IntelliJ IDEA Community | 自研 |
| 目标平台 | HarmonyOS 全场景设备 | Android 设备 | Apple 设备 |
| 预览器 | Java/JS 双预览器 + 多设备预览 | Layout Inspector / Preview | SwiftUI Preview |
| 模拟器 | 远程模拟器 + 远程真机 | 本地模拟器 (AVD) | 模拟器 + 真机 |
| 构建工具 | Gradle (HarmonyOS 插件) | Gradle (AGP) | Xcode Build |
| 语言支持 | Java / JS / C / C++ | Java / Kotlin / C++ | Swift / Obj-C |
| 签名方式 | AppGallery Connect 签名 | keystore 签名 | Apple 证书签名 |
⚠️ 踩坑回忆录
第一次安装 DevEco Studio 时，我犯了一个经典错误——把项目路径设在了桌面的"鸿蒙开发"文件夹下。结果 Gradle 同步时报了一堆乱码错误。折腾了半天才在官方文档的一角落看到"路径不能包含中文字符"。切记：所有路径用纯英文！
还有一个坑：安装完 DevEco Studio 后直接点 Run，报错 “Select a device first”。原来需要先在 Device Manager 里启动模拟器，而且还要用华为账号登录授权。这些步骤在教程里经常被一笔带过，但对新手来说每一步都是坎。
另外，Node.js 只有在使用 JS 语言开发时才需要安装，如果你只用 Java 开发，完全可以跳过 Node.js 的安装步骤，不必浪费时间。
必做实操任务
| 序号 | 任务 | 难度 |
|---|---|---|
| 1 | 注册华为开发者账号并完成实名认证 | ★☆☆ |
| 2 | 安装 DevEco Studio 并成功配置 HarmonyOS SDK | ★★☆ |
| 3 | 创建一个 Empty Ability(Java) 工程并成功运行到模拟器 | ★★☆ |
| 4 | 打开预览器，尝试修改布局文件后观察实时预览效果 | ★★☆ |
| 5 | 配置 npm 镜像源（即使不用 JS 开发，也建议配置备用） | ★☆☆ |
学习检查清单
- 已完成华为开发者实名认证
- DevEco Studio 能正常创建工程
- 能在远程模拟器上运行 Hello World
- 能使用预览器查看 UI 效果
- 理解 Project Name、Package Name、Device Type 的含义
- 知道 SDK Manager 在哪里以及如何管理 SDK
- 了解 Gradle 代理和 npm 代理的配置方法
进阶方向
- 尝试使用远程真机运行应用（需完成应用签名）
- 配置 DevEco Studio 代码模板和 Live Templates 提高编码效率
- 了解 Gradle 构建脚本的基本结构和自定义配置
