第一章：开发环境搭建——DevEco Studio安装与配置、HarmonyOS SDK下载、模拟器与真机准备、项目创建与基础工程结构
大家好，我是你们的老朋友。今天咱们正式进入《鸿蒙AI框架集成与端侧推理实战》的第一章。说实话，每次带新人入门，我最怕的就是环境搭建这一步——看着简单，但坑是真不少。我自己就曾经因为SDK版本没对齐，折腾了整整一个下午。所以这一章，我会把每一步的细节和我的个人经验都掰开揉碎了讲给你听。
1.1 DevEco Studio：你的主战场
DevEco Studio，说白了就是咱们开发鸿蒙应用的“大本营”。它基于IntelliJ IDEA，如果你用过Android Studio，上手会非常快。但别急着高兴，鸿蒙的配置细节和Android还是有区别的。
1.1.1 下载与安装
去官网下载最新版本就行。我个人习惯下载Windows版，但macOS和Linux也完全支持。安装过程很简单，一路Next就好。嗯，这里要注意：安装路径不要带中文，否则后面编译可能会报一些莫名其妙的错。
1.1.2 首次启动与基本配置
启动后，它会自动检测JDK。如果没检测到，手动指定一下JDK路径就行。我建议用JDK 11，兼容性最好。你想想看，如果JDK版本太高，有些老插件可能不兼容，反而给自己找麻烦。
接下来是主题设置。我个人喜欢深色主题，长时间盯着屏幕眼睛没那么累。当然，这个看个人喜好。
1.2 HarmonyOS SDK：你的武器库
SDK就是开发工具包，里面包含了编译、调试、打包所需的一切。没有它，你写的代码就是一堆没用的文本。
1.2.1 SDK下载与版本选择
在DevEco Studio里，通过 Tools → SDK Manager 就能打开SDK管理界面。你会看到多个API版本，比如API 9、API 10、API 11。我建议下载最新的稳定版，但如果你要兼容老设备，可以多下载一个API 9。
| API版本 | 对应HarmonyOS版本 | 适用场景 |
|---|---|---|
| API 9 | HarmonyOS 3.0 | 老设备兼容、稳定性要求高 |
| API 10 | HarmonyOS 3.1 | 主流开发、功能较全 |
| API 11 | HarmonyOS 4.0 | 最新特性、AI框架集成首选 |
1.2.2 SDK目录结构
下载完成后，SDK会存放在你指定的目录里。它的结构大概是这样的：
HarmonyOS_SDK/
├── ets/ # 声明式UI框架
├── js/ # JS/TS开发支持
├── native/ # C/C++原生开发
├── toolchains/ # 编译工具链
├── ohos-sdk/ # 核心SDK包
└── hms/ # 华为移动服务
你不需要记住每个文件夹的用途，但要知道 native 目录下放着C/C++的交叉编译工具链，后面我们做AI推理时，经常要和它打交道。
1.3 模拟器与真机：你的测试阵地
代码写完了，总得跑起来看看效果吧？这就涉及到测试环境的选择了。
1.3.1 模拟器配置
DevEco Studio自带模拟器，支持手机、平板、智慧屏等多种设备类型。启动模拟器的方法很简单：点击工具栏的 Device Manager，选择你需要的设备，然后点启动。
不过我要提醒你一句：模拟器毕竟不是真机，有些硬件特性是模拟不了的。比如NPU（神经网络处理单元）的加速效果，在模拟器上就体现不出来。所以，如果你要做AI推理的性能测试，还是得用真机。
1.3.2 真机准备
真机调试需要开启开发者模式。具体步骤是：
- 打开手机 设置 → 关于手机，连续点击版本号7次，直到提示“已进入开发者模式”。
- 返回设置，进入 系统和更新 → 开发人员选项，打开 USB调试。
- 用USB线连接电脑，手机上会弹出一个授权提示，点击确认。
我记得第一次连真机时，电脑死活识别不到设备。后来发现是USB线的问题——有些线只能充电，不能传数据。所以，建议用原装数据线。
1.4 项目创建与基础工程结构
环境都准备好了，咱们来创建第一个项目吧。
1.4.1 创建新项目
点击 File → New → Create Project，你会看到多种模板：
- Empty Ability：空白模板，适合从零开始
- List：列表模板，适合展示数据
- Login：登录模板，带UI和逻辑
- AI：AI模板，预置了MindSpore Lite集成
我建议初学者选 Empty Ability，这样你能看到最干净的工程结构。后面做AI集成时，再手动添加依赖也不迟。
1.4.2 工程结构解析
项目创建完成后，你会看到这样的目录结构：
MyApplication/
├── entry/ # 应用主模块
│ ├── src/
│ │ ├── main/
│ │ │ ├── ets/ # 声明式UI代码
│ │ │ ├── resources/ # 资源文件（图片、字符串等）
│ │ │ └── module.json5 # 模块配置文件
│ │ └── ohosTest/ # 测试代码
│ ├── build-profile.json5 # 构建配置
│ └── package.json # 依赖管理
├── oh_modules/ # 依赖库
├── build-profile.json5 # 全局构建配置
└── local.properties # 本地环境配置
这里面，entry/src/main/ets 是你写代码的主战场。所有的页面、组件、逻辑都在这里。而 module.json5 是模块的配置文件，里面定义了应用的包名、版本号、权限等。
1.4.3 第一个Hello World
打开 entry/src/main/ets/pages/Index.ets，你会看到默认的Hello World代码：
@Entry
@Component
struct Index {
@State message: string = 'Hello World'
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
}
.width('100%')
}
.height('100%')
}
}
这段代码用声明式UI的方式，在屏幕上显示了一行文字。你可以在模拟器或真机上运行看看效果。如果能看到“Hello World”，恭喜你，环境搭建成功了！
1.5 本章知识体系总览
为了让你更直观地理解本章的内容结构，我画了一张流程图：
这张图把本章的四个核心模块串在了一起。你可以看到，从环境安装到项目创建，每一步都是环环相扣的。任何一个环节出了问题，后面的工作都没法开展。
1.6 写在最后
好了，第一章的内容就到这里。环境搭建虽然繁琐，但它是你后面所有工作的基础。我见过太多人因为这一步没做好，后面反复返工。所以，别嫌麻烦，一步一步来。
如果你在搭建过程中遇到了问题，别慌。先检查SDK版本、JDK路径、USB连接这些常见坑点。实在解决不了，可以翻翻官方文档，或者来我的公众号找我。