Skip to content

环境要求

开发环境

DevEco Studio

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

IBest-ORM

配置说明

1. 安装 DevEco Studio

  1. 从华为开发者联盟下载 DevEco Studio
  2. 按照安装向导完成安装
  3. 首次启动时配置 SDK 路径

2. 配置 HarmonyOS SDK

  1. 打开 DevEco Studio
  2. 进入 File > Settings > HarmonyOS SDK

3. 配置签名

开发调试时需要配置签名:

  1. 登录华为开发者账号
  2. 在 DevEco Studio 中配置自动签名
  3. 或手动配置签名文件

详细步骤请参考 华为官方文档

验证环境

检查 DevEco Studio

  1. 打开 DevEco Studio
  2. 创建一个新的 HarmonyOS 项目
  3. 运行项目,确保可以正常编译和运行

检查 SDK

在 DevEco Studio 中查看 SDK 版本:

File > Settings > HarmonyOS SDK

常见问题

1. SDK 下载失败

解决方案

  • 检查网络连接
  • 使用华为开发者账号登录
  • 尝试使用镜像源

2. 编译失败

解决方案

  • 检查 SDK 版本是否符合要求
  • 清理项目缓存:Build > Clean Project
  • 重新同步依赖

3. 签名配置问题

解决方案

  • 确保已登录华为开发者账号
  • 检查签名配置是否正确
  • 参考华为官方文档重新配置

下一步