> 技术文档 > 鸿蒙代码入门:开启万物互联的开发之旅

鸿蒙代码入门:开启万物互联的开发之旅


本文以 HarmonyOS SDK API 10 为基础,使用 DevEco Studio 4.1 进行开发。

鸿蒙(HarmonyOS)作为华为推出的分布式操作系统,为开发者提供了构建全场景智慧体验的能力。其独特的分布式架构和声明式UI开发方式,让入门变得直观且高效。本文将带你快速上手鸿蒙应用开发。


一、环境准备:构建你的开发基石

  1. 安装 DevEco Studio

    • 访问 HarmonyOS 开发者官网 下载对应操作系统的 IDE

    • 安装时勾选 HarmonyOS SDK(至少包含 JS/eTS 和 Previewer)

  2. 配置基础环境

    bash

    # 检查 Node.js 版本 (需 >= 14.19.1)node -v# 检查 ohpm 包管理器ohpm -v

二、创建首个鸿蒙项目

  1. 打开 DevEco Studio → 选择 Create Project

  2. 模板选择:Application → Empty Ability (eTS)

  3. 配置项目:

    • Project Name: FirstHarmonyApp

    • Bundle Name: com.example.firstapp

    • Compile API: 10

    • Model: Stage (推荐模型)


三、核心代码解析:构建你的第一个页面

项目结构概览

text

FirstHarmonyApp/ ├── entry/src/main/ │ ├── ets/ │ │ ├── Application/ │ │ ├── pages/ │ │ │ └── Index.ets // 主页面代码 │ ├── resources/ // 静态资源 │ └── module.json5 // 模块配置
修改 Index.ets 实现计数器功能

typescript

// Index.ets@Entry@Componentstruct Index { @State count: number = 0 // @State 标记可变状态 build() { Column({ space: 20 }) { // 纵向布局容器 Text(\'Hello HarmonyOS!\') .fontSize(30) .fontWeight(FontWeight.Bold)m.yczb.info Text(`Count: ${this.count}`) .fontSize(24) .fontColor(Color.Blue) Button(\'Click Me!\', { type: ButtonType.Capsule }) .width(\'40%\')m.yczbjsty.com .height(50) .onClick(() => { this.count++ m.yczbml.com // 点击时更新状态 }) } .width(\'100%\') .height(\'100%\') .justifyContent(FlexAlign.Center) //m.yczbngpt.com 垂直居中 }}
关键概念解析:
  1. @Entry:标记应用入口组件

  2. @Component:声明自定义组件

  3. @State:管理组件内部状态,数据变化自动触发UI更新

  4. 声明式UI:通过build()函数描述UI布局,无需手动操作DOM

  5. 布局容器:Column(纵向)、Row(横向)、Stack(层叠)等


四、运行与预览

  1. 本地模拟器运行

    • 点击右上角 Previewer 按钮实时预览

    • 或选择 Tools → Device Manager 创建模拟器后运行

  2. 真机调试

    • 手机开启开发者模式 + USB调试

    • 签名配置:File → Project Structure → Signing Configs


五、掌握鸿蒙特有能力:跨设备流转

在 module.json5 中添加分布式权限:

json

\"requestPermissions\": [ { \"name\": \"ohos.permission.DISTRIBUTED_DATASYNC\" }]

实现设备发现代码片段:

typescript

import deviceManager from \'@ohos.distributedDeviceManager\';// 发现附近设备const dmClass = deviceManager.createDeviceManager(\'com.example.firstapp\');dmClass.on(\'deviceStateChange\', (data) => { console.log(`发现设备: ${JSON.stringify(data)}`);});

六、下一步学习路径

学习方向 推荐资源 难度 UI开发 ArkTS语法、声明式布局 ★★☆ 分布式能力 跨设备数据同步、流转 ★★★ 原生功能 相机、位置、传感器等API ★★☆ 原子化服务 卡片开发、服务免安装 ★★★

官方推荐学习站

  • HarmonyOS 开发者学堂

  • ArkTS 语言文档


常见问题解答

Q:鸿蒙应用只能用 ArkTS 开发吗?
A:目前推荐使用 ArkTS(TypeScript超集),同时支持 JS 和 C++ 开发 Native 能力。

Q:与安卓开发有何主要区别?
A:核心差异在分布式架构设计、声明式UI范式、以及面向多设备的原子化服务理念。

Q:真机调试需要华为手机吗?
A:是的,目前仅华为/荣耀部分机型支持 HarmonyOS 3.0+ 的开发者模式调试。

“鸿蒙不是另一个安卓,它是面向万物互联时代的操作系统。”—— 华为技术专家

通过本文,你已完成从环境搭建到首个功能实现的完整流程。下一步可尝试实现多设备数据同步或开发一个服务卡片,深入体验鸿蒙的分布式魅力。http://m.yczb178.com