第2章_开发环境搭建

第2章 开发环境搭建

HarmonyOS 学习系统 | 阶段一：入门筑基期
建议学习时长：1-2 周

学习目标

核心图解

内容讲解

2.1 注册华为开发者账号

如果把开发 HarmonyOS 应用比作开一家餐厅，那么：

• 华为开发者账号= 你的营业执照（没有它你连门都进不了）
• DevEco Studio= 你的中央厨房（锅碗瓢盆、案板刀具一应俱全）
• HarmonyOS SDK= 食材供应商（提供各种原材料和调料）
• Node.js= 一台特殊的榨汁机（只有做 JS UI 菜品时才需要）
• 模拟器= 试吃台（不用真的端给客人就能先尝味道）

要进行 HarmonyOS 应用开发，首先需要注册华为开发者联盟账号并完成实名认证。个人开发者需要准备：手机号码/邮箱、身份证正反面照片、个人银行卡号。

注册流程

华为商城账号、华为云账号和花粉论坛账号均可登录联盟。实名认证有两种方式：个人银行卡认证（适合上架非敏感应用）和身份证人工审核认证（1-3 个工作日发送结果至邮箱）。

2.2 安装 DevEco Studio

DevEco Studio 是基于 IntelliJ IDEA Community 打造的一站式集成开发环境，为 HarmonyOS 应用提供从创建、开发、编译、调试到发布的端到端服务。

运行环境要求

• 操作系统：Windows 10 64 位（或 macOS）
• 内存：8GB 及以上
• 硬盘：100GB 及以上
• 分辨率：1280×800 像素及以上

安装步骤

1. 进入 DevEco Studio 产品页下载安装包
2. 双击deveco-studio-xxxx.exe进入安装向导
3. 勾选 DevEco Studio launcher 后单击 Next 直至完成
4. 首次启动选择 “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 express

Gradle 代理设置

在%userprofile%\.gradle\目录下创建gradle.properties文件：

systemProp.http.proxyHost=proxy.server.com systemProp.http.proxyPort=8080 systemProp.https.proxyHost=proxy.server.com systemProp.https.proxyPort=8080

HarmonyOS 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 代理：

1. 打开File → Settings → Appearance & Behavior → System Settings → HTTP Proxy
2. 选择 “Manual proxy configuration”
3. 填入代理服务器地址和端口
4. 点击 “Check connection” 验证代理是否可用

Node.js 安装（仅 JS 开发需要）

如果需要使用 JS 语言开发 UI，还需要安装 Node.js：

1. 下载 Node.js LTS 版本（推荐 12.x 或 14.x）
2. 安装时勾选 “Add to PATH”
3. 验证安装：在命令行输入node -v和npm -v
4. 配置 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 属性配置

代码速查卡

与 Android/iOS 对比

⚠️ 踩坑回忆录

第一次安装 DevEco Studio 时，我犯了一个经典错误——把项目路径设在了桌面的"鸿蒙开发"文件夹下。结果 Gradle 同步时报了一堆乱码错误。折腾了半天才在官方文档的一角落看到"路径不能包含中文字符"。切记：所有路径用纯英文！

还有一个坑：安装完 DevEco Studio 后直接点 Run，报错 “Select a device first”。原来需要先在 Device Manager 里启动模拟器，而且还要用华为账号登录授权。这些步骤在教程里经常被一笔带过，但对新手来说每一步都是坎。

另外，Node.js 只有在使用 JS 语言开发时才需要安装，如果你只用 Java 开发，完全可以跳过 Node.js 的安装步骤，不必浪费时间。

必做实操任务

学习检查清单

• 已完成华为开发者实名认证
• DevEco Studio 能正常创建工程
• 能在远程模拟器上运行 Hello World
• 能使用预览器查看 UI 效果
• 理解 Project Name、Package Name、Device Type 的含义
• 知道 SDK Manager 在哪里以及如何管理 SDK
• 了解 Gradle 代理和 npm 代理的配置方法

进阶方向

• 尝试使用远程真机运行应用（需完成应用签名）
• 配置 DevEco Studio 代码模板和 Live Templates 提高编码效率
• 了解 Gradle 构建脚本的基本结构和自定义配置