零基础上手鸿蒙开发:从安装 DevEco 到跑通第一个页面(实操教程)
鸿蒙开发到底难不难?本篇文章手把手带你从零开始,安装开发环境、创建项目、编写页面,10分钟搞定你的第一个鸿蒙应用!
🧩 一、为什么选择鸿蒙开发?
- 🔧 国产自研系统,生态不断壮大
- 📱 一次开发,多端部署(手机、平板、穿戴、车机)
- 🚀 学习门槛低,支持 TypeScript 派生语言 ArkTS
- 💼 就业机会增长快,大厂逐步拥抱鸿蒙生态
🛠️ 二、开发环境准备(安装 DevEco Studio)
✅ 1. 下载地址
建议下载最新稳定版本(当前推荐 DevEco Studio 4.0+)
✅ 2. 安装步骤
- 安装完成后打开 DevEco Studio
- 配置 SDK 路径,选择 HarmonyOS SDK(如未安装,点击下载)
- 创建账户并登录华为开发者账号(必须)
🧪 三、创建第一个鸿蒙应用项目
步骤一:创建新项目
打开 DevEco → File > New Project → 选择 Stage 模型 > Empty Feature Ability
- 项目名称:MyFirstApp
- 包名:
com.example.myfirstapp - 语言:ArkTS(推荐)
- 模板:Empty Feature Ability
点击 Finish 完成项目初始化。
📄 四、编写第一个页面
进入 /entry/src/main/ets/pages/Index.ets,将默认页面替换为以下代码:
import { View, Text, Button } from '@ohos/ui';
@Entry
@Component
struct Index {
@State message: string = 'Hello HarmonyOS!'
build() {
Column() {
Text(this.message)
.fontSize(26)
.fontWeight(FontWeight.Bold)
.margin({ bottom: 20 })
Button('点我一下')
.onClick(() => {
this.message = '你点击了按钮 🚀'
})
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
.alignItems(HorizontalAlign.Center)
}
}
🚀 效果说明:
- 初始显示文本:Hello HarmonyOS!
- 点击按钮后:变更为“你点击了按钮 🚀”
▶️ 五、运行项目:真机 or 模拟器
✅ 方式一:使用模拟器
- 点击 DevEco 右上角「Run」按钮,选择“使用模拟器”
- 第一次启动略慢,耐心等待加载
✅ 方式二:真机调试
- 手机打开「开发者选项」+「调试模式」
- 用 USB 连接电脑,确认信任设备
- 选择设备后运行即可真机预览
💡 六、常见问题排查
| 问题 | 解决方法 |
|---|---|
| 模拟器启动卡住 | 关闭后台重启,或升级 HVD Manager |
| 运行时报错缺少权限 | 检查 config.json 中 reqPermissions 配置 |
| DevEco 无法联网 | 检查代理/防火墙,或手动下载 SDK 包 |
📦 七、总结与预告
恭喜你!已经完成了鸿蒙开发的第一步:
✅ 成功安装 DevEco Studio
✅ 创建了鸿蒙项目
✅ 编写并运行了第一个组件页面
下篇预告:
📘《ArkTS 是什么?鸿蒙最强开发语言语法全讲解》——深入理解鸿蒙语法的本质与技巧,打造更强页面组件!