02-开发环境搭建与工具链

第2课：开发环境搭建与工具链

📚 课程目标

• 掌握DevEco Studio的下载、安装和配置
• 熟悉HMS Core（华为移动服务）的使用
• 了解鸿蒙模拟器与真机调试环境
• 掌握必备开发工具的使用

🛠️ DevEco Studio环境搭建

2.1 下载与安装

系统要求

• Windows: Windows 10 64位及以上版本
• macOS: macOS 10.15及以上版本
• Linux: Ubuntu 18.04及以上版本
• 内存: 8GB以上（推荐16GB）
• 存储: 10GB以上可用空间

下载步骤

1. 访问HarmonyOS开发者官网
2. 点击"开发工具" → “DevEco Studio”
3. 选择对应操作系统版本下载
4. 下载完成后运行安装程序

安装配置

# 安装完成后，首次启动配置
1. 选择UI主题（推荐深色主题）
2. 配置SDK路径
3. 安装必要的SDK组件
4. 配置模拟器路径

2.2 基础配置

SDK配置

• API版本: 选择最新的API 9或API 10
• 构建工具: 配置Gradle和构建工具
• 模拟器: 下载并配置模拟器镜像

项目配置

// project.json 基础配置
{"name": "MyHarmonyApp","type": "application","srcEntry": "./ets/entryability/EntryAbility.ets","srcEntry": "./ets/pages/Index.ets"
}

🔧 HMS Core（华为移动服务）

2.3 HMS Core简介

HMS Core是华为移动服务生态的核心，为鸿蒙应用提供丰富的系统能力。

核心服务

• 账号服务：用户身份认证
• 推送服务：消息推送
• 地图服务：位置服务
• 支付服务：移动支付
• 云存储：数据存储

2.4 集成配置

添加依赖

// module.json5
{"dependencies": ["@ohos/hms-core": "^6.0.0"]
}

权限申请

// module.json5
{"requestPermissions": [{"name": "ohos.permission.INTERNET","reason": "用于网络请求","usedScene": {"abilities": ["EntryAbility"],"when": "always"}}]
}

📱 鸿蒙模拟器与真机调试

2.5 模拟器配置

创建模拟器

1. 打开DevEco Studio
2. 点击"Tools" → “Device Manager”
3. 选择"Create Device"
4. 选择设备类型和系统版本
5. 配置模拟器参数

模拟器类型

• 手机模拟器：测试手机应用
• 平板模拟器：测试平板应用
• 智慧屏模拟器：测试大屏应用
• 穿戴设备模拟器：测试穿戴应用

2.6 真机调试

设备准备

1. 开启开发者选项
2. 启用USB调试
3. 连接电脑并授权调试

调试配置

# 查看连接设备
hdc list targets# 安装应用
hdc install -r app-debug.hap# 查看日志
hdc shell hilog

🛠️ 必备开发工具

2.7 命令行工具

HDC（HarmonyOS Device Connector）

# 基础命令
hdc list targets          # 列出设备
hdc shell                 # 进入设备shell
hdc file send             # 传输文件
hdc file recv             # 接收文件
hdc install               # 安装应用
hdc uninstall             # 卸载应用

常用调试命令

# 查看应用日志
hdc shell hilog | grep "MyApp"# 查看系统信息
hdc shell cat /proc/version# 查看应用进程
hdc shell ps | grep "MyApp"

2.8 Git版本控制

初始化项目

# 创建Git仓库
git init# 添加远程仓库
git remote add origin <repository-url># 首次提交
git add .
git commit -m "Initial commit"
git push -u origin main

分支管理

# 创建功能分支
git checkout -b feature/new-feature# 合并分支
git checkout main
git merge feature/new-feature# 删除分支
git branch -d feature/new-feature

2.9 包管理工具

npm/yarn配置

// package.json
{"name": "my-harmony-app","version": "1.0.0","dependencies": {"@ohos/hypium": "^1.0.0"},"devDependencies": {"@ohos/hvigor": "^1.0.0"}
}

安装依赖

# 使用npm
npm install# 使用yarn
yarn install# 安装特定版本
npm install @ohos/hypium@1.0.0

🎯 实践练习

2.10 环境搭建练习

任务1：安装DevEco Studio

1. 下载并安装DevEco Studio
2. 配置开发环境
3. 创建第一个Hello World项目

任务2：配置模拟器

1. 创建手机模拟器
2. 运行Hello World应用
3. 熟悉模拟器操作

任务3：命令行工具使用

1. 安装HDC工具
2. 连接模拟器
3. 执行基础命令

🚨 常见问题与解决方案

2.11 安装问题

• 问题：安装过程中卡住

• 解决：检查网络连接，使用VPN或镜像源

• 问题：SDK下载失败

• 解决：更换下载源，检查防火墙设置

2.12 运行问题

• 问题：模拟器启动失败

• 解决：检查虚拟化设置，更新显卡驱动

• 问题：应用安装失败

• 解决：检查签名配置，清理缓存

📚 扩展资源

2.13 官方文档

• DevEco Studio使用指南
• HMS Core集成指南
• 真机调试指南

2.14 社区资源

• 华为开发者社区
• 鸿蒙开发者论坛
• GitHub开源项目

---

下一课预告：第3课 - 鸿蒙架构与编程模型