使用DevEcoStudio 开发、编译鸿蒙 NEXT_APP 以及使用中文插件 #鸿蒙开发工具 #DevEco Studio

1. 概述

DevEco Studio 是华为提供的一站式集成开发环境（IDE），专为鸿蒙操作系统（HarmonyOS Next）应用和服务开发设计 DevEco Studio，掌握基本操作和开发流程。

2. 安装与配置

1. 访问华为开发者联盟官网 下载 DevEco Studio 安装包
2. 运行安装程序，按照向导完成安装
3. 启动 DevEco Studio，首次启动会自动下载并安装 SDK 组件

3. 创建新项目

3.1 启动向导

1. 启动 DevEco Studio，选择 Start a new HarmonyOS project
2. 选择应用模板（如 Empty Ability、Native C++ 等）

3.2 项目结构

创建完成后，DevEco Studio 会生成标准的鸿蒙应用项目结构：

myapplication/
├── AppScope/
│   ├── resources/
│   └── app.json5              # 版本号等内容
├── entry/                  # 主模块
│   ├── src/
│   │   ├── main/
│   │   │   ├── ets/               # ArkTS 代码
│   │   │   ├── resources/        # 资源文件
│   │   │   └── module.json5
│   │   ├── test/                  # 测试代码
│   │   ├── mock/
│   │   ├── ohosTest/
│   │   ├── build-profile.json5
│   │   ├── hvigorfile.ts
│   │   ├── obfuscation-rules.txt
│   │   └── oh-package.json5
│   └── build/              # 编译后测试包
├── hvgor/
│   └── hvigor-config.json5
├── build/          # 编译后正式包
└── build-profile.json5                  # 项目构建配置文件

4 代码方式布局

使用 ArkTS 声明式语法：

@Entry
@Component
export struct Index {
  @State message: string = 'Hello World'

  build() {
    Column() {
      Text(this.message)
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
      Button('Click Me')
        .onClick(() => {
          this.message = 'Hello HarmonyOS!'
        })
    }
    .width('100%')
  }
}

5. 应用调试

5.1 模拟器调试

1. 点击工具栏中的 Tools > Device Manager 图标
2. 在弹出窗口中点击 New Emulator
3. 选择设备类型和系统版本，点击 Next 完成创建
4. 点击工具栏中的运行按钮，选择模拟器启动应用

5.2 真机调试

1. 用 USB 线将鸿蒙设备连接到电脑
2. 在设备上多次点击版本号开启 开发者选项 和 USB 调试 功能
3. 在 DevEco Studio 中选择设备并点击运行按钮，选择已连接的设备
4. 如设备未识别，检查 USB 驱动是否正确安装

6. 代码编辑与辅助功能

6.1 代码补全

DevEco Studio 支持智能代码补全，输入代码时会自动提示可能的选项：

• 输入组件名称时提示可用组件
• 输入属性名时提示可用属性
• 支持方法参数提示和类型检查

6.2 代码导航

• Ctrl + 左键点击：跳转到变量、方法或类的定义处
• Shift + Shift：快速打开文件
• Alt + 左/右箭头：在编辑历史中导航

7. 构建与打包

7.1 构建应用

1. 点击 Build > Build Hap(s)/App(s) 构建 APP 包
2. 构建完成后，APK 文件位于 build/outputs/default 目录下

7.2 签名配置

1. 点击 File > Project Structure > Project > Signing Configs
2. 选择已有的签名密钥
3. 配置签名信息并生成签名

8. 中文插件

切换中文版不是选择语言，而是需要下载插件

1. 点击File > Settings > Plugins
2. 搜索Chinese(Simplified)
3. 下载并应用
4. 重启 DevEcoStudio

9. 常见问题与解决方法

9.1 模拟器无法启动

• 尝试删除并重新创建模拟器
• 降低模拟器系统版本
• 检查内存

9.2 代码报错 “arkts-no-props-by-index”

• 错误原因：ArkTS 不支持通过索引访问对象属性
• 解决方法：使用点号表示法或 Map 结构替代