环境要求
开发环境
DevEco Studio
- 版本要求:DevEco Studio 5.0 或更高版本
- 下载地址:华为开发者联盟
HarmonyOS SDK
- 推荐版本:使用最新稳定版 SDK
Node.js(可选)
如果需要使用文档系统或其他 Node.js 工具:
- 版本要求:Node.js 18.0 或更高版本
- 下载地址:Node.js 官网
系统要求
Windows
- 操作系统:Windows 10 64 位或更高版本
- 内存:8GB 或更高(推荐 16GB)
macOS
- 操作系统:macOS 10.14 或更高版本
- 内存:8GB 或更高(推荐 16GB)
运行环境
- 真机或模拟器:用于运行与调试示例页面。
- 调试权限:确保设备已开启开发者模式与 USB 调试(若使用真机)。
依赖库
项目使用以下主要依赖库:
IBest-UI-V2
- 版本:1.1.1 或更高版本
- 用途:UI 组件库
- 文档:IBest-UI-V2 官方文档
IBest-ORM
- 版本:2.0.3 或更高版本
- 用途:数据库 ORM
- 文档:IBest-ORM 官方文档
配置说明
1. 安装 DevEco Studio
- 从华为开发者联盟下载 DevEco Studio
- 按照安装向导完成安装
- 首次启动时配置 SDK 路径
2. 配置 HarmonyOS SDK
- 打开 DevEco Studio
- 进入
File>Settings>HarmonyOS SDK
3. 配置签名
开发调试时需要配置签名:
- 登录华为开发者账号
- 在 DevEco Studio 中配置自动签名
- 或手动配置签名文件
详细步骤请参考 华为官方文档。
验证环境
检查 DevEco Studio
- 打开 DevEco Studio
- 创建一个新的 HarmonyOS 项目
- 运行项目,确保可以正常编译和运行
检查 SDK
在 DevEco Studio 中查看 SDK 版本:
File > Settings > HarmonyOS SDK常见问题
1. SDK 下载失败
解决方案:
- 检查网络连接
- 使用华为开发者账号登录
- 尝试使用镜像源
2. 编译失败
解决方案:
- 检查 SDK 版本是否符合要求
- 清理项目缓存:
Build>Clean Project - 重新同步依赖
3. 签名配置问题
解决方案:
- 确保已登录华为开发者账号
- 检查签名配置是否正确
- 参考华为官方文档重新配置