概述与环境搭建

1. HarmonyOS 概述

1.1 什么是 HarmonyOS

HarmonyOS（鸿蒙操作系统）是华为开发的全场景分布式操作系统，基于微内核架构设计，支持多设备协同、一次开发多端部署。其核心设计理念是”1+8+N”全场景战略：

1.2 HarmonyOS 发展历程

1.3 核心特性

2. 系统架构

2.1 分层架构

┌─────────────────────────────────────────────┐
│              应用层 (Application)             │
│   系统应用  │  第三方应用  │  原子化服务       │
├─────────────────────────────────────────────┤
│              框架层 (Framework)               │
│  ArkUI  │  Ability  │  AI  │  分布式软总线    │
├─────────────────────────────────────────────┤
│              系统服务层 (System Service)       │
│  基础服务 │ 硬件服务 │ 数据管理 │ 安全隐私    │
├─────────────────────────────────────────────┤
│              内核层 (Kernel)                  │
│  Linux Kernel │ LiteOS │ 安全增强 │ HDF      │
└─────────────────────────────────────────────┘

2.2 内核层详解

3. FA 模型与 Stage 模型

3.1 FA 模型（Feature Ability）

FA 模型是 HarmonyOS 早期版本的应用开发模型，基于 Ability 作为基本单元：

3.2 Stage 模型

Stage 模型是 HarmonyOS 3.0+ 推荐的应用开发模型，设计更加现代化：

3.3 两种模型对比

3.4 Stage 模型应用结构

MyApplication/
├── AppScope/                    # 应用全局配置
│   ├── app.json5                # 应用配置（版本号、图标等）
│   └── resources/               # 全局资源
├── entry/                       # 主模块
│   ├── src/main/
│   │   ├── ets/                 # ArkTS 源码
│   │   │   ├── entryability/    # UIAbility
│   │   │   │   └── EntryAbility.ets
│   │   │   └── pages/           # 页面
│   │   │       └── Index.ets
│   │   ├── resources/           # 模块资源
│   │   └── module.json5         # 模块配置
│   ├── build-profile.json5      # 构建配置
│   └── oh-package.json5         # 包依赖
└── build-profile.json5          # 项目构建配置

4. DevEco Studio 安装配置

4.1 系统要求

4.2 下载与安装

1. 访问华为开发者官网：https://developer.huawei.com
2. 注册华为开发者账号
3. 下载 DevEco Studio 最新版本
4. 运行安装程序，选择安装路径
5. 首次启动会自动下载 SDK 和工具链

4.3 SDK 管理

# SDK 路径配置
# File → Settings → SDK → HarmonyOS SDK Location

# SDK 版本管理
# File → Settings → SDK → HarmonyOS → 选择 API 版本

4.4 模拟器配置

# 创建模拟器
# Tools → Device Manager → New Emulator

# 推荐配置
# Phone: API 12, 8GB RAM, 1080x2340
# Tablet: API 12, 8GB RAM, 2560x1600
# Wearable: API 12, 1GB RAM, 466x466

5. 第一个 Hello World 应用

5.1 创建项目

1. 打开 DevEco Studio → File → New → Create Project
2. 选择 Empty Ability 模板
3. 填写项目信息：

5.2 项目入口代码

// entry/src/main/ets/entryability/EntryAbility.ets
import { UIAbility, AbilityConstant, Want } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    console.info('[EntryAbility] onCreate');
  }

  onDestroy(): void {
    console.info('[EntryAbility] onDestroy');
  }

  onWindowStageCreate(windowStage: window.WindowStage): void {
    console.info('[EntryAbility] onWindowStageCreate');
    // 加载主页面
    windowStage.loadContent('pages/Index', (err, data) => {
      if (err.code) {
        console.error(`Failed to load content: ${JSON.stringify(err)}`);
        return;
      }
      console.info('Succeeded in loading content');
    });
  }

  onWindowStageDestroy(): void {
    console.info('[EntryAbility] onWindowStageDestroy');
  }

  onForeground(): void {
    console.info('[EntryAbility] onForeground');
  }

  onBackground(): void {
    console.info('[EntryAbility] onBackground');
  }
}

5.3 页面代码

// entry/src/main/ets/pages/Index.ets
@Entry
@Component
struct Index {
  @State message: string = 'Hello HarmonyOS!';

  build() {
    Column() {
      // 标题文本
      Text(this.message)
        .fontSize(32)
        .fontWeight(FontWeight.Bold)
        .fontColor('#1a73e8')
        .margin({ top: 100 })

      // 副标题
      Text('欢迎使用鸿蒙开发')
        .fontSize(18)
        .fontColor('#666666')
        .margin({ top: 16 })

      // 按钮
      Button('点击问候')
        .width('60%')
        .height(48)
        .fontSize(18)
        .backgroundColor('#1a73e8')
        .borderRadius(24)
        .margin({ top: 40 })
        .onClick(() => {
          this.message = '你好，鸿蒙！';
        })
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Start)
    .alignItems(HorizontalAlign.Center)
  }
}

5.4 应用配置

// entry/src/main/module.json5
{
  module: {
    name: 'entry',
    type: 'entry',
    description: '$string:module_desc',
    mainElement: 'EntryAbility',
    deviceTypes: ['phone', 'tablet', '2in1'],
    deliveryWithInstall: true,
    installationFree: false,
    pages: '$profile:main_pages',
    abilities: [
      {
        name: 'EntryAbility',
        srcEntry: './ets/entryability/EntryAbility.ets',
        description: '$string:EntryAbility_desc',
        icon: '$media:layered_image',
        label: '$string:EntryAbility_label',
        startWindowIcon: '$media:startIcon',
        startWindowBackground: '$color:start_window_background',
        exported: true,
        skills: [
          {
            entities: ['entity.system.home'],
            actions: ['action.system.home'],
          },
        ],
      },
    ],
  },
}

5.5 运行与调试

# 构建项目
# Build → Build Hap(s)/APP(s) → Build Hap(s)

# 运行到模拟器
# Run → Run 'entry'

# 运行到真机
# 1. 开启开发者模式
# 2. USB 连接设备
# 3. Run → Run 'entry'

# 日志查看
# HiLog 工具窗口
console.info('[MyTag] This is an info log');
console.error('[MyTag] This is an error log');
console.warn('[MyTag] This is a warning log');

6. 常见开发工具

7. 学习路线建议

概述与环境搭建 → ArkTS 与 ArkUI → UI 组件与动画 → 网络与数据持久化 → 多媒体与设备能力
     ↓                ↓               ↓                ↓                  ↓
  理解架构        掌握语法         构建界面         数据交互           完整应用