2. 开发环境搭建:DevEco Studio的下载与安装、配置鸿蒙SDK、创建第一个Hello World项目
说实话,很多初学者在学鸿蒙开发时,第一步就被环境搭建给卡住了。我见过不少朋友下载了错误的版本,或者SDK配置了半天就是跑不起来。其实没那么复杂,今天我就带你一步步搞定它。
2.1 DevEco Studio 的下载与安装
DevEco Studio 是华为官方推出的IDE,说白了就是咱们写鸿蒙代码的“战场”。它基于IntelliJ IDEA,如果你用过Android Studio,上手会非常快。
2.1.1 下载前的准备工作
我个人习惯在动手前先确认三件事:
- 操作系统:Windows 10/11(64位)、macOS(10.15+)或Ubuntu 18.04+。我建议用Windows,因为遇到问题好找资料。
- 内存:至少8GB,16GB会更舒服。我之前用8GB的笔记本跑模拟器,卡得想砸电脑。
- 硬盘空间:预留30GB以上。SDK和模拟器都很占地方。
2.1.2 下载步骤
- 打开浏览器,访问华为开发者联盟官网。
- 找到“开发工具” -> “DevEco Studio”。
- 选择对应操作系统的版本下载。注意区分“标准版”和“预览版”,我建议用标准版,稳定。
2.1.3 安装过程
双击安装包,一路Next就行。不过有几个地方要注意:
- 安装路径不要有中文和空格。我习惯放在
D:\DevEcoStudio这种纯英文路径下。 - 勾选“创建桌面快捷方式”,方便以后启动。
- 安装完成后先别急着打开,咱们还要配SDK。
2.2 配置鸿蒙SDK
SDK就是开发工具包,没有它,你写的代码就是一堆废纸。嗯,这里要注意:鸿蒙的SDK和Android的SDK是两码事,别搞混了。
2.2.1 首次启动配置
第一次打开DevEco Studio,它会自动弹出SDK配置向导。你想想看,如果网络不好,这一步可能会卡很久。我曾经在公司内网配了半小时没反应,最后发现是防火墙拦了。
- 选择“HarmonyOS SDK”路径。我建议单独建一个文件夹,比如
D:\HarmonyOS\SDK。 - 勾选你需要的API版本。目前主流是API 9和API 10。新手建议全选,省得后面缺东西。
- 点击“Next”,等待下载完成。这个过程大概10-20分钟,取决于你的网速。
2.2.2 手动配置SDK
如果向导没成功,或者你后面想加新的SDK版本,可以手动配置:
- 打开DevEco Studio,点击
File -> Settings -> Appearance & Behavior -> System Settings -> HarmonyOS SDK。 - 在这里你可以看到已安装的SDK版本,也可以点“Edit”修改路径。
- 需要添加新版本时,点“Show Package Details”,勾选对应版本后点“Apply”。
2.3 创建第一个Hello World项目
环境搭好了,咱们来写个Hello World庆祝一下。说实话,看到“Hello World”在模拟器上跑起来的那一刻,还是挺有成就感的。
2.3.1 新建项目
- 点击“Create New Project”。
- 选择模板。我建议新手选“Empty Ability”,它最干净,没有多余代码。
- 配置项目信息:
- Project Name:比如
HelloWorld - Package Name:比如
com.example.helloworld - Save Location:选个好记的路径
- Language:选Java或ArkTS。我建议ArkTS,这是鸿蒙的亲儿子语言。
- API Version:选你刚才下载的版本,比如API 9。
- Project Name:比如
- 点击“Finish”,等待项目构建完成。
2.3.2 项目结构一览
项目建好后,你会看到一堆文件夹。别怕,咱们只看几个关键的:
| 文件夹/文件 | 作用 |
|---|---|
entry/src/main/ets |
存放ArkTS代码的地方,咱们主要在这里写逻辑 |
entry/src/main/resources |
存放图片、字符串等资源文件 |
entry/src/main/config.json |
应用的配置文件,比如应用名称、权限等 |
2.3.3 编写Hello World
打开 entry/src/main/ets/MainAbility/pages/index.ets,你会看到类似这样的代码:
@Entry
@Component
struct Index {
@State message: string = 'Hello World'
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
}
.width('100%')
}
.height('100%')
}
}
这段代码很简单:@State 定义了一个响应式变量 message,Text 组件把它显示出来。你改成 '你好,鸿蒙' 试试?
2.3.4 运行项目
点击工具栏上的三角形运行按钮,选择“Run 'entry'”。它会弹出设备选择窗口:
- 模拟器:如果你没真机,选这个。第一次启动模拟器需要下载镜像,大概几百MB。
- 真机:用USB连上手机,打开开发者模式,就能直接跑。
config.json 里把 debuggable 设为 true,不然装不上。
2.4 本章知识体系
为了让你更直观地理解整个流程,我画了一张图:
你看,整个流程就是一条直线:下载 -> 配置 -> 运行。没有想象中那么复杂吧?
fontSize 或者换个颜色,感受一下实时预览的效果。这样能帮你快速建立信心。
好了,环境搭好了,Hello World也跑起来了。接下来你就可以开始探索鸿蒙的世界了。记住,遇到问题别硬扛,多看看官方文档,或者去社区搜一搜。我当年就是这么过来的。
公众号:蓝海资料掘金营,微信deep3321