鸿蒙 HarmonyOS 开发入门：从环境搭建到你的第一个 Hello World 应用

s4y3ici0

180人浏览 · 2026-05-04 16:49:39

s4y3ici0 · 2026-05-04 16:49:39 发布

在移动应用开发领域，鸿蒙 HarmonyOS 凭借其独特的分布式架构和全场景体验，吸引了越来越多的开发者。然而，对于新手来说，配置鸿蒙开发环境和创建第一个 Hello World 应用可能并非一帆风顺。本文将带你一步步搭建鸿蒙开发环境，并编写你的第一个 Hello World 应用，助你快速入门鸿蒙开发。

准备工作：必要的软硬件条件

首先，确保你的电脑满足以下基本要求：

操作系统： Windows 10 或 macOS
CPU： Intel Core i5 或 AMD Ryzen 5 及以上
内存： 8GB 及以上
硬盘： 50GB 及以上可用空间

其次，你需要下载并安装以下软件：

Java Development Kit (JDK)： 建议选择 JDK 8 或 JDK 11。配置环境变量 JAVA_HOME，指向 JDK 的安装目录。
DevEco Studio： 鸿蒙官方推荐的集成开发环境（IDE），可在 HarmonyOS 开发者联盟官网下载。

安装 DevEco Studio：图形界面与命令行双管齐下

下载与解压： 从 HarmonyOS 开发者联盟官网下载 DevEco Studio 安装包，并解压到你选择的目录。
安装： 运行解压目录下的 deveco-studio.exe（Windows）或 deveco-studio.app（macOS），按照提示完成安装。安装过程中，可以选择安装必要的 SDK 组件。
配置 SDK： 安装完成后，启动 DevEco Studio。如果 SDK 未自动配置，你需要手动指定 SDK 路径。可以在 File > Settings > Appearance & Behavior > System Settings > HarmonyOS SDK 中进行配置。

注意：国内开发者可以选择镜像站点来加速 SDK 的下载和更新。 例如：华为云镜像站点，或者清华大学开源软件镜像站，配置方式参考 DevEco Studio 官方文档。

创建 Hello World 项目：从模板开始，避免重复造轮子

新建项目： 在 DevEco Studio 中，选择 File > New > New Project，选择 Empty Ability 模板。
配置项目信息： 输入项目名称、包名等信息。选择项目存储路径。
编写代码： 在 entry/src/main/java/com/example/your_project_name/slice/MainAbilitySlice.java 文件中，找到 onAbilitySliceCreate 方法，添加以下代码：

package com.example.helloworld.slice;import ohos.aafwk.ability.AbilitySlice;import ohos.aafwk.content.Intent;import ohos.agp.components.Text;import ohos.agp.components.ComponentContainer;import ohos.agp.components.DirectionalLayout;public class MainAbilitySlice extends AbilitySlice {    @Override    public void onStart(Intent intent) {        super.onStart(intent);        DirectionalLayout layout = new DirectionalLayout(this);        layout.setWidth(ComponentContainer.LayoutConfig.MATCH_PARENT);        layout.setHeight(ComponentContainer.LayoutConfig.MATCH_PARENT);        Text text = new Text(this);        text.setText("Hello World"); // 设置文本内容        text.setTextSize(60); // 设置字体大小        layout.addComponent(text);        super.setUIContent(layout); // 设置布局    }    @Override    public void onForeground(Intent intent) {        super.onForeground(intent);    }}

*   `Text` 组件用于显示文本。*   `DirectionalLayout` 组件用于布局。

运行项目： 连接你的鸿蒙设备或模拟器，点击 DevEco Studio 工具栏上的 Run 按钮，选择你的设备或模拟器，即可运行 Hello World 应用。

解决常见问题：DevEco Studio 使用技巧与避坑指南

模拟器配置：避免卡顿，流畅运行

如果你的电脑配置不高，运行鸿蒙模拟器可能会出现卡顿现象。可以尝试以下方法优化：

降低模拟器分辨率： 在 DevEco Studio 的模拟器设置中，降低模拟器的分辨率。
分配更多内存： 在模拟器设置中，增加分配给模拟器的内存。
使用真机调试： 如果条件允许，建议使用真机进行调试，可以获得更好的性能体验。

SDK 更新问题：国内镜像加速

由于网络原因，从官方源下载 SDK 可能会很慢。可以配置国内镜像站点，加速 SDK 的下载和更新。

华为云镜像： 华为云提供了鸿蒙 SDK 镜像服务，可以在 DevEco Studio 的 SDK 管理器中配置。
其他镜像站点： 也可以使用其他国内镜像站点，例如清华大学开源软件镜像站。

调试技巧：日志输出与断点调试

日志输出： 使用 HiLog 类进行日志输出，可以方便地查看应用运行时的信息。

import ohos.hiviewdfx.HiLog;import ohos.hiviewdfx.HiLogLabel;private static final HiLogLabel LABEL = new HiLogLabel(HiLog.LOG_APP, 0x00201, "MY_TAG");HiLog.info(LABEL, "Hello World!");

断点调试： 在 DevEco Studio 中设置断点，可以逐步执行代码，查看变量的值，帮助你定位和解决问题。

工程编译慢？Gradle 配置优化

鸿蒙项目通常使用 Gradle 构建。如果编译速度慢，可以尝试以下优化方法：

开启 Gradle Daemon： Gradle Daemon 会在后台运行，减少每次构建的启动时间。可以在 gradle.properties 文件中添加 org.gradle.daemon=true。
使用离线模式： 如果你的项目依赖的库已经下载到本地，可以开启离线模式，避免每次构建都去远程仓库检查。可以在 Gradle 设置中开启离线模式。
配置 Gradle 镜像： 国内开发者可以配置 Gradle 镜像，加速依赖库的下载。常用的 Gradle 镜像包括阿里云 Maven 镜像、华为云 Maven 镜像等。需要在项目的 build.gradle 文件中配置。

allprojects {    repositories {        maven { url 'https://maven.aliyun.com/repository/public' }        mavenCentral()    }}

深入理解 HarmonyOS 应用架构：Ability 与 AbilitySlice

在鸿蒙 HarmonyOS 应用中，Ability 和 AbilitySlice 是两个核心概念。

Ability： 代表应用的功能单元，类似于 Android 中的 Activity。一个应用可以包含多个 Ability，每个 Ability 完成不同的任务。例如，一个新闻应用可以包含新闻列表 Ability、新闻详情 Ability 等。
AbilitySlice： 代表 Ability 的一个界面片段，类似于 Android 中的 Fragment。一个 Ability 可以包含多个 AbilitySlice，用于组合不同的界面元素。例如，一个新闻详情 Ability 可以包含新闻内容 AbilitySlice、评论列表 AbilitySlice 等。

通过合理的划分 Ability 和 AbilitySlice，可以更好地组织应用代码，提高代码的可维护性和可复用性。

掌握了上述基础知识和技巧，你就可以开始你的鸿蒙 HarmonyOS 开发之旅了。祝你学习顺利！