开发环境配置
本章节详细介绍如何配置 HarmonyOS 开发环境，包括 DevEco Studio 的高级设置和常用配置。
DevEco Studio 配置
编辑器设置
主题设置
- 打开 File → Settings → Appearance & Behavior → Appearance
- 选择你喜欢的主题（Darcula、Light 等）
- 点击 Apply 保存
字体设置
File → Settings → Editor → Font
- 推荐字体：JetBrains Mono、Fira Code
- 字体大小：14-16
- 行高：1.2-1.5
SDK 管理
查看已安装 SDK
File → Settings → SDK → HarmonyOS
这里可以查看和管理已安装的 SDK 版本。
下载新版本 SDK
- 在 SDK 列表中勾选需要的版本
- 点击 Apply 开始下载
- 等待下载完成
SDK 版本选择
- 生产环境：使用稳定版本
- 学习环境：可以尝试最新版本获取新特性
模拟器配置
创建虚拟设备
- 打开 Tools → Device Manager
- 点击 + 创建新设备
- 选择设备类型（手机、平板等）
- 配置设备参数：
- 设备名称
- 系统版本
- 屏幕分辨率
- 内存大小
模拟器优化
性能优化
- 分配足够的内存（建议 4GB 以上）
- 启用硬件加速
- 关闭不必要的传感器模拟
快捷键
| 快捷键 | 功能 |
|---|---|
| Ctrl + P | 截图 |
| Ctrl + O | 旋转屏幕 |
| Ctrl + K | 返回键 |
| Ctrl + H | Home 键 |
真机调试
USB 调试配置
1. 开启开发者模式
在设备上：
- 打开 设置 → 关于手机
- 连续点击 版本号 7 次
- 返回设置，进入 开发者选项
- 开启 USB 调试
2. 连接设备
- 使用 USB 线连接设备和电脑
- 在设备上允许 USB 调试授权
- 在 DevEco Studio 中选择设备
注意
首次连接需要安装驱动，请耐心等待。
无线调试
前提条件
- 设备和电脑在同一局域网
- 设备已开启开发者模式
连接步骤
- 在设备上开启 无线调试
- 记录设备 IP 地址和端口
- 在 DevEco Studio 中输入 IP 和端口连接
bash
# 命令行方式连接
hdc tconn 192.168.1.100:5555项目配置
签名配置
自动签名（推荐）
DevEco Studio 会自动生成调试签名，无需手动配置。
手动签名
- 生成密钥对
- 申请证书
- 在
build-profile.json5中配置签名信息
json5
{
"app": {
"signingConfigs": [
{
"name": "default",
"type": "HarmonyOS",
"material": {
"certpath": "path/to/cert.cer",
"storePassword": "password",
"keyAlias": "alias",
"keyPassword": "password",
"profile": "path/to/profile.p7b",
"signAlg": "SHA256withECDSA",
"storeFile": "path/to/keystore.p12"
}
}
]
}
}构建配置
开发环境
json5
{
"apiType": "stageMode",
"buildOption": {
"strictMode": {
"caseSensitiveCheck": true
}
}
}生产环境
json5
{
"buildOption": {
"arkOptions": {
"obfuscation": {
"ruleOptions": {
"enable": true,
"files": ["obfuscation-rules.txt"]
}
}
}
}
}代码风格
EditorConfig
创建 .editorconfig 文件：
ini
root = true
[*]
charset = utf-8
indent_style = space
indent_size = 2
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true
[*.md]
trim_trailing_whitespace = falseESLint 配置
安装 ESLint：
bash
npm install --save-dev eslint创建 .eslintrc.json：
json
{
"env": {
"es2021": true
},
"extends": [
"eslint:recommended"
],
"parserOptions": {
"ecmaVersion": 12,
"sourceType": "module"
},
"rules": {
"indent": ["error", 2],
"quotes": ["error", "single"],
"semi": ["error", "never"]
}
}调试工具
日志输出
使用 hilog 输出日志：
typescript
import hilog from '@ohos.hilog'
// 输出日志
hilog.info(0x0000, 'TestTag', 'Hello %{public}s', 'World')调试面板
View → Tool Windows → Debugger
功能包括：
- 断点调试
- 变量查看
- 调用栈查看
- 表达式计算
性能分析
View → Tool Windows → Profiler
可以分析：
- CPU 使用率
- 内存占用
- 网络请求
- 帧率
常用快捷键
编辑
| 快捷键 | 功能 |
|---|---|
| Ctrl + Space | 代码补全 |
| Ctrl + / | 注释/取消注释 |
| Ctrl + D | 复制当前行 |
| Ctrl + Y | 删除当前行 |
| Alt + Enter | 快速修复 |
导航
| 快捷键 | 功能 |
|---|---|
| Ctrl + N | 查找类 |
| Ctrl + Shift + N | 查找文件 |
| Ctrl + B | 跳转到定义 |
| Alt + ← / → | 前进/后退 |
运行
| 快捷键 | 功能 |
|---|---|
| Shift + F10 | 运行 |
| Shift + F9 | 调试 |
| Ctrl + F2 | 停止 |
常见问题
编译失败
问题：编译时报错
解决方案：
- 清理项目：Build → Clean Project
- 重新构建：Build → Rebuild Project
- 检查 SDK 版本是否匹配
模拟器黑屏
问题：模拟器启动后黑屏
解决方案：
- 检查虚拟化是否开启
- 增加模拟器内存
- 更新显卡驱动
真机连接失败
问题：设备无法被识别
解决方案：
- 检查 USB 调试是否开启
- 更换 USB 线或端口
- 重新安装驱动