鸿蒙开发入门:Hello World(开发环境及IDE搭建)

开发环境准备

鸿蒙应用开发支持Windows和Mac操作系统。Windows需确保系统版本为Win10及以上,Mac需为10.15及以上版本。硬件建议配置8GB以上内存和20GB可用存储空间。

开发工具链依赖Node.js(推荐16.x LTS版本)和Java JDK(推荐OpenJDK 11)。需提前安装并配置环境变量,可通过命令行验证:

node -v
java -version
安装DevEco Studio

DevEco Studio是鸿蒙官方IDE,基于IntelliJ IDEA定制。从官网下载最新版本(如4.1版本),安装时勾选HarmonyOS SDK。安装完成后启动IDE,SDK Manager会自动下载必要组件:

  • JS/SDK:JS应用开发基础包
  • Toolchains:编译工具链
  • Platform SDK:API版本包
创建Hello World项目

打开DevEco Studio选择"Create HarmonyOS Project",模板选择"Empty Ability"(JS语言)。配置项目时注意:

  • Project Type:Application(应用)或Atomic Service(元服务)
  • API Version:建议选择最新稳定版(如API 9)
  • Device Type:勾选Phone或Tablet
项目结构解析

生成的JS项目主要目录结构:

entry/src/main
├── js/
│   └── default/
│       ├── pages/
│       │   └── index/  # 页面目录
│       │       ├── index.js  # 逻辑文件
│       │       ├── index.hml  # 布局文件
│       │       └── index.css  # 样式文件
├── resources/  # 静态资源
└── config.json  # 应用配置
编写基础代码

修改index.hml实现文本展示:

<div class="container">
    <text class="hello-text">Hello HarmonyOS</text>
</div>

添加样式到index.css:

.container {
    flex-direction: column;
    justify-content: center;
    align-items: center;
}
.hello-text {
    font-size: 38px;
    color: #000000;
}
运行与调试

连接真机或使用Previewer预览:

  1. 真机需开启开发者模式,通过USB连接后签名运行
  2. Previewer可实时查看布局效果,支持热重载

点击运行按钮后,首次构建会下载依赖包。成功后在设备上会显示白色背景的黑色文字"Hello HarmonyOS"。

常见问题解决

构建失败时检查:

  • 网络是否通畅,Gradle可能需代理
  • SDK路径是否包含中文或特殊字符
  • 设备是否授权了安装权限

日志查看方式:

  • Log窗口过滤"HiLog"查看应用日志
  • 命令行运行hdc shell hilog -r查看系统级日志
进阶配置建议

提升开发效率可配置:

  • 代码模板:Settings → Editor → Live Templates
  • 快捷键映射:支持VS Code键位方案
  • 静态检查:开启ArkTS编译器严格模式

这个示例完整展示了从环境搭建到首个应用运行的闭环流程。后续可继续学习组件开发、状态管理等进阶内容。

Logo

社区规范:仅讨论OpenHarmony相关问题。

更多推荐