2、开发环境搭建:工欲善其事,必先利其器
说实话,做鸿蒙开发的第一步,就是把你的电脑武装起来。我见过太多新手卡在环境搭建这一步,折腾半天连个Hello World都跑不起来。别急,今天我就带你一步步搞定。
2.1 DevEco Studio安装:你的主战场
DevEco Studio是华为官方推出的IDE,说白了就是咱们写代码的根据地。它基于IntelliJ IDEA,如果你用过Android Studio,上手会非常快。
系统要求:
- Windows 10/11(64位),内存建议16GB以上
- macOS 10.15+,M1/M2芯片也支持
- 硬盘至少留出10GB空间
安装步骤其实很简单:
- 去华为开发者官网下载安装包,注意选对操作系统版本
- 双击安装,一路Next就行。但我建议你改一下安装路径,别放C盘
- 安装完成后,第一次启动会提示下载SDK,先别急,咱们后面再配
我的小习惯:我会把DevEco Studio的缓存目录也改到其他盘。你想想看,项目多了之后,缓存文件能占好几个G,放C盘迟早要炸。
2.2 HarmonyOS SDK配置:别踩这个坑
SDK配置这块,我曾经吃过亏。第一次装的时候,我直接点了默认安装,结果发现API版本不全,有些新特性用不了。
正确的做法是这样的:
- 打开DevEco Studio,进入 Settings → SDK Manager
- 选择你要用的HarmonyOS版本。我个人建议至少装两个版本:一个稳定版(比如3.1),一个最新版(比如4.0)
- 勾选 SDK Platform 和 System Image,后者是跑模拟器用的
注意:SDK下载需要联网,而且文件不小。如果你在公司网络环境下,记得关掉代理,否则可能下载失败。我遇到过好几次,折腾半天才发现是代理的问题。
配置完成后,记得检查一下环境变量。打开命令行,输入:
hdc -V
如果能输出版本号,说明环境配好了。如果提示找不到命令,嗯,那就手动加一下环境变量吧。
2.3 模拟器与真机调试:两种方式,各有千秋
调试是开发中绕不开的环节。我个人的习惯是:UI调试用模拟器,性能测试用真机。
模拟器调试
DevEco Studio自带模拟器,支持手机、平板、智慧屏等多种设备类型。启动方式很简单:
- 点击工具栏的 Device Manager 图标
- 选择你需要的设备类型,点击 Launch
- 等模拟器启动,大概需要1-2分钟
提速小技巧:模拟器启动后别关,保持运行状态。下次调试时直接连接就行,省去等待时间。
真机调试
真机调试其实更简单,但有几个前置条件:
- 手机开启 开发者模式:设置 → 关于手机 → 连续点击版本号7次
- 开启 USB调试:设置 → 系统和更新 → 开发人员选项 → USB调试
- 用数据线连接电脑,手机上会弹出授权提示,点确定
我曾经踩过的坑:有些数据线只能充电,不能传数据。我一开始用的就是这种线,折腾了半小时连不上,后来换了根原装线,秒连。所以,线材很重要!
2.4 项目结构解析:别被文件夹吓到
第一次创建鸿蒙项目时,看到那一堆文件夹,你是不是有点懵?别担心,我来给你拆解一下。
一个标准的HarmonyOS项目结构是这样的:
| 目录/文件 | 作用 |
|---|---|
entry/ |
应用主模块,你的代码主要写在这里 |
entry/src/main/ets/ |
ArkTS源码目录,UI和逻辑都在这里 |
entry/src/main/resources/ |
资源文件,比如图片、字符串、颜色定义 |
entry/src/main/config.json |
模块配置文件,声明权限、页面路由等 |
build-profile.json5 |
项目级构建配置,签名、版本号等 |
oh_modules/ |
依赖的第三方库,类似node_modules |
你真正需要关注的是 entry/src/main/ets/ 这个目录。里面默认会有 pages/ 和 app.ets:
pages/:存放你的页面组件,每个页面一个文件夹app.ets:应用的入口文件,全局配置写在这里
我的建议:刚开始别急着改目录结构,先按默认的来。等你熟悉了,再考虑按功能模块拆分。我见过有人一上来就搞复杂架构,结果把自己绕晕了。
好了,环境搭建就到这里。下一章咱们开始写第一个组件,到时候你就知道这些配置到底有什么用。
最后提醒一句:如果你在搭建过程中遇到任何问题,先检查SDK版本和网络连接。80%的问题都出在这两个地方。别问我怎么知道的,都是血泪教训。
公众号:蓝海资料掘金营,微信deep3321