1.1 安装 DevEco Studio 并跑通第一个工程
1.1 安装 DevEco Studio 并跑通第一个工程
本节摘要：从下载安装 DevEco Studio、配置 SDK，到新建 Empty Ability 工程并在模拟器中运行，完整走通 HarmonyOS 应用开发的第一次闭环。本节解决"装什么、怎么装、怎么验证装好了"三个问题，全程约半小时。
先把环境装起来
学开发最忌讳的第一件事，是概念读了一堆、环境一直没装。本节反其道而行：十分钟内进入安装流程，装的过程里遇到什么讲什么。HarmonyOS 应用的官方集成开发环境叫 DevEco Studio，它把编辑器、SDK 管理、模拟器、profiler 打包在一起——相当于把这个生态的 Android Studio、SDK Manager、模拟器三件套合成了一个安装包。
安装步骤：
- 到华为开发者官网的开发工具页面，下载对应操作系统的 DevEco Studio 安装包（Windows 是 exe，macOS 是 dmg）。
- 运行安装程序，路径不要带中文和空格，其余选项默认即可。首次启动时会弹出设置向导。
- 向导里选择安装 SDK 与工具链。这一步在线下载几个 GB 的内容，网络不稳时容易中断，中断了重跑向导即可，已下载的部分会续用。
- 安装完成后，在欢迎页左侧找到 Device Manager（设备管理器），下载一个手机形态的模拟器镜像并创建实例。
⚠️ 常见坑：公司网络走代理时，SDK 下载经常卡在百分之几十不动。在 DevEco Studio 的设置里找到代理配置项，填入公司代理地址后再重试。另一个高频坑是模拟器启动失败并提示虚拟化异常，需要在主板的 BIOS 里开启虚拟化支持，或确认系统 hypervisor 没有被其他模拟器占用。
创建第一个工程
环境装好，马上验证。依次操作：
1.欢迎页点 New Project，模板选 Application 里的 Empty Ability，这是最小的可运行应用模板。
2. Project name 填 MyFirstApp，Compile SDK 选你安装的版本（本教程以 API 12 一线版本为准），Model 保持 Stage（这是当前唯一的推荐模型，旧文档里的 FA 模型第 2 章会作为历史背景提一句）。
3. 点 Finish，等索引构建完成。第一次打开工程会跑一段时间的依赖解析，属正常现象。
工程打开后，先别急着看代码。定位到编辑器右侧的 Previewer（预览器）标签页，点开——你会看到"Hello World"字样的页面已经渲染出来了。这就是你的第一个产出：还没写一行代码，但整条"代码到界面"的链路已经通了。
接着上模拟器。在顶部工具栏的设备列表里选中刚创建的模拟器实例，点绿色运行按钮。控制台会依次输出编译、打包、安装的日志，最后模拟器亮起，显示与预览器相同的应用首页。
到这里环境验证就完成了。区分三个看效果的地方，此后会一直混用：
| 入口 | 速度 | 适合场景 |
|---|---|---|
| Previewer 预览器 | 秒级 | 改 UI 布局、看样式，不跑完整逻辑 |
| 模拟器 | 分钟级首次、之后较快 | 跑真逻辑、试交互、看日志 |
| 真机（开发者模式） | 与模拟器相当 | 验证传感器、多设备等模拟器没有的能力 |
跑不通怎么办：一次真实排错
"点运行没反应"是新手最高频的问题。我在一台 Windows 机器上复现过一次完整排错，过程值得参考：
背景是模拟器刚创建完，第一次点运行，进度条走到 Install 一半就停，最终弹窗提示安装失败。打开底部 Log 窗口过滤错误关键字，发现一行"bundle install failed: signature verify failed"——签名校验失败。
操作排查：DevEco Studio 的调试签名是自动的，一般不需要人工干预，签名失败通常意味着工程的调试证书没生成或过期。打开构建配置，确认签名页签里 "Automatically generate signature" 已勾选；勾选状态下重新同步工程，日志里出现重新申请证书的记录。证书更新后再点运行，安装成功，模拟器正常亮起。
解读：这次排错的关键不是记住结论，而是记住路径——出问题先看 Log 窗口的错误行，错误信息里通常带着可检索的关键字；签名、证书这类词在第 1.2 节和第 8 章上架时还会反复出现，现在混个眼熟，以后就不会慌。
变式：如果日志里出现的是"hvigor install failed"或依赖解析错误，多半是网络问题导致依赖没拉全，重试同步或检查代理即可；如果是模拟器本身起不来，优先查虚拟化设置。
认识你每天要按的几个按钮
工程能跑之后，把日后天天用的入口认一遍：
- 运行与调试：绿色三角是直接运行，旁边的虫子图标是调试模式，打断点后用它启动。
- Previewer：右侧标签页，UI 改动的快速反馈回路。
- Log 窗口：底部 Log 标签，配合过滤器只看自己应用的日志（第 2 章会用 hilog 打自己的日志，届时再细讲过滤技巧）。
- Profiler：分析性能用，第 8 章的常客。
- Device Manager：管理模拟器实例，也可以在这里给多设备场景（第 7 章）再建一个平板模拟器。
💡 关键直觉：把"预览器看样式、模拟器跑逻辑、真机验硬件"当成条件反射。新手最常见的浪费，是在预览器里调试一个只有模拟器才能复现的问题，或者在真机上反复编译只为改一个字号。
最后做一个小练习收尾：把工程里 Index 页面显示的 "Hello World" 文字改成任意一句中文，保存后分别看预览器和模拟器的变化。预览器应该几乎即时更新，模拟器则会重新走一次编译安装。改这一个词的意义在于确认：你已经知道代码的哪一处控制了屏幕上的哪一块。下一节我们不止改文字，而是把整个工程的骨架和"代码怎么变成包"的机制拆开看。
附：环境装好后的第一轮顺手配置
趁环境刚装好、印象还热，有几项配置现在做、以后少踩坑。第一项是日志颜色与过滤器的默认设置：在 Log 窗口的过滤栏里把默认级别调到 Info，并把常用标签保存为过滤器方案——第 2 章起我们会频繁按自定义 TAG 过滤，现在存好方案以后一键切换。第二项是编辑器的保存自动格式化：ArkTS 的链式属性调用很长，格式化规则统一后，团队协作与自我回读都会轻松很多。第三项是模拟器快照：给装好基础应用的模拟器实例打一个快照，后面章节做破坏性实验（改签名、删权限）前可以先存档，失败了一键回滚，比重装模拟器省半小时。
另外记一下本机 SDK 的安装位置与版本号。后面遇到"同事机器上能跑我这里报接口不存在"的问题，九成是 SDK 版本差异——第一时间对比两台机器的版本号，比盯着代码看效率高得多。这些小事现在只花十分钟，但它们决定了你后面八章的实验环境是否稳定。