第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 StudioDevEco 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、HMLFA/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:passwordproxyserver:portnpmconfigsethttps-proxy http://user:passwordproxyserver:port# 设置国内镜像推荐npmconfigsetregistry https://mirrors.huaweicloud.com/repository/npm/# 验证配置npminfo expressGradle 代理设置在%userprofile%\.gradle\目录下创建gradle.properties文件systemProp.http.proxyHostproxy.server.com systemProp.http.proxyPort8080 systemProp.https.proxyHostproxy.server.com systemProp.https.proxyPort8080HarmonyOS 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管理模拟器和真机添加 ModuleFile → New → Module添加 Entry 或 Feature 模块SDK 管理Configure → Settings → HarmonyOS SDK下载/管理 SDK 包打开设置Ctrl Alt S打开 IDE 全局设置代码格式化Ctrl Alt L自动格式化代码与 Android/iOS 对比特性DevEco StudioAndroid StudioXcode基础IntelliJ IDEA CommunityIntelliJ IDEA Community自研目标平台HarmonyOS 全场景设备Android 设备Apple 设备预览器Java/JS 双预览器 多设备预览Layout Inspector / PreviewSwiftUI Preview模拟器远程模拟器 远程真机本地模拟器 (AVD)模拟器 真机构建工具Gradle (HarmonyOS 插件)Gradle (AGP)Xcode Build语言支持Java / JS / C / CJava / Kotlin / CSwift / 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 构建脚本的基本结构和自定义配置