前言

在掌握了 DevEco Studio 的基本界面与设置之后，今天我们正式迈出 HarmonyOS 应用开发的第一步——创建并运行你的第一个 “Hello World” 应用。这个看似简单的项目，实则涵盖了从项目创建、结构理解、代码编写到真机/模拟器部署的完整开发流程。通过本节实战，你将建立起对鸿蒙应用工程架构的初步认知，并掌握基础的调试与修改能力。

一、创建 Hello World 项目

1. 启动 DevEco Studio，在欢迎界面点击 “Create Project”。
2. 在模板选择页面，选择 “Application” → “Empty Ability”（空能力模板），点击 Next。
3. 填写项目基本信息：
4. 点击 Finish，等待项目初始化完成（首次创建可能需要下载依赖）。

⏱️ 提示：若网络较慢，可提前在 Settings → HarmonyOS SDK 中安装所需 API 版本（如 API 10 或 11）。

二、项目结构解析

项目创建成功后，左侧 Project Explorer 将展示如下关键目录结构：

HelloWorldApp/
├── entry/
│   ├── src/
│   │   └── main/
│   │       ├── ets/                # ArkTS 代码目录
│   │       │   └── pages/
│   │       │       └── Index.ets   ← 主页面文件
│   │       ├── resources/          # 资源文件（字符串、媒体、布局等）
│   │       └── module.json5        ← 模块配置文件
│   └── build-profile.json5
├── hvigorfile.ts                   # 构建脚本
└── oh-package.json5                # 项目依赖与配置

关键文件说明：

1. Index.ets —— 主页面逻辑与UI

这是应用启动后默认显示的页面，使用 声明式 UI 语法（ArkTS） 编写。默认内容如下：

// entry/src/main/ets/pages/Index.ets
@Entry
@Component
struct Index {
  build() {
    Row() {
      Column() {
        Text('Hello World')
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
      .height('100%')
    }
  }
}

• @Entry：标记该组件为应用入口；
• @Component：定义一个可复用的 UI 组件；
• Text()：显示文本的组件；
• .fontSize()、.fontWeight()：链式调用设置样式。

2. main_pages.json —— 页面路由配置

位于 entry/src/main/resources/base/profile/ 目录下（部分版本路径可能略有不同），其内容为：

{
  "src": [
    "pages/Index"
  ]
}

该文件告诉系统：应用启动时应加载 Index.ets 页面。若后续新增页面（如 About.ets），需在此数组中添加 "pages/About" 才能被导航访问。

3. module.json5 —— 模块级配置

定义模块的设备类型、权限、组件声明等。例如：

{
  "module": {
    "name": "entry",
    "type": "entry",
    "mainElement": "Index", // 入口组件名
    "deviceTypes": ["phone"],
    "requestPermissions": []
  }
}

三、运行项目到模拟器或真机

方式一：使用本地模拟器（Local Emulator）

1. 点击顶部工具栏 Device Manager（设备管理器图标）；
2. 切换到 Local Emulator 标签；
3. 若尚未创建设备，点击 + New Emulator，选择 Phone 类型和对应 API 版本；
4. 创建完成后，点击 ▶ Start 启动模拟器；
5. 返回主界面，在运行目标下拉菜单中选择该模拟器；
6. 点击绿色 Run 按钮（或按 Shift + F10），应用将自动编译并安装到模拟器。

方式二：连接真机调试（推荐）

1. 手机开启 开发者模式：进入 设置 → 关于手机 → 连续点击“版本号”7次；
2. 返回设置，进入 系统和更新 → 开发人员选项，开启 USB 调试 和 HDC 调试；
3. 使用 USB 线连接电脑，手机端授权调试；
4. 在 DevEco Studio 中，点击 Tools → Device Manager，应能看到已连接设备；
5. 选择该设备，点击 Run 即可部署应用。

✅ 真机运行速度更快，体验更真实，强烈建议开发者配备一台鸿蒙设备用于测试。

四、修改代码：实现个性化文字展示

现在，我们对默认的 “Hello World” 进行简单改造，让它更具个性。

修改目标：

• 将文字改为 “Welcome to HarmonyOS!”
• 添加副标题 “Day5: My First App”
• 调整字体颜色和对齐方式

修改后的 Index.ets 代码：

@Entry
@Component
struct Index {
  build() {
    Column() {
      Text('Welcome to HarmonyOS!')
        .fontSize(32)
        .fontWeight(FontWeight.Bold)
        .fontColor('#0A5FCC') // 蓝色
        .margin({ bottom: 20 })

      Text('Day5: My First App')
        .fontSize(20)
        .fontColor('#666666')
        .opacity(0.8)
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Center) // 垂直居中
    .backgroundColor('#F8F9FA')
  }
}

保存文件后，无需重新编译整个项目，DevEco Studio 支持 热重载（Hot Reload）：只需再次点击 Run，修改内容会快速同步到设备上（部分场景需手动触发）。

运行效果：屏幕中央将显示蓝色主标题与灰色副标题，背景为浅灰，整体简洁清晰。

五、常见问题排查

• 模拟器无法启动？ 检查是否启用虚拟化（BIOS 中开启 Intel VT-x/AMD-V），或尝试使用远程模拟器（Remote Emulator）。
• 真机未识别？ 确保安装了最新版 HUAWEI Mobile Services (HMS) 和 HDC 工具（DevEco 自带）。
• 代码修改未生效？ 检查是否保存文件（Ctrl+S），或尝试 Clean & Rebuild（Build → Clean Project）。