DevEco Studio 配置开发环境
DevEco Studio 使用 SDK Manager 管理 SDK 和工具组件,包括以下组件:
组件 | 描述 | API 版本 | 参考文档 |
Native | C/C++ 语言 SDK 包 | API Version 4 至 9 | Native API 参考 |
ArkTS | ArkTS 语言 SDK 包 | API Version 4 至 9 | ArkTS API 参考 |
JS 和 Java 语言 SDK 包 | JS 和 Java 语言 SDK 包 | API Version 4 至 8 | Java API 参考 |
System-image-phone | 本地模拟器 Phone 设备镜像文件 | API Version 4 至 9 | 使用 Local Emulator 运行应用/服务 |
System-image-tv | 本地模拟器 TV 设备镜像文件 | API Version 6 | |
System-image-wearable | 本地模拟器 Wearable 设备镜像文件 | API Version 6 | |
Emulator | 本地模拟器工具包 | API Version 4 至 9 | |
工具链 | 应用/服务开发必备工具集,包括编译、打包、签名、数据库管理等工具的集合 | API Version 4 至 9 | |
Previewer | 应用/服务预览器,在开发过程中可以动态预览 Phone、TV、Wearable、LiteWearable 等设备的应用/服务效果,支持 JS、ArkTS 和 Java 应用/服务预览 | API Version 4 至 9 | 使用预览器查看应用/服务效果 |
支持 API 版本 4 至 9 的应用/服务开发。首次启动 DevEco Studio,配置向导会引导您下载 SDK 和工具链。配置向导默认下载 API Version 9 的 SDK 和工具链。在工程配置完成后,您可以在 HarmonyOS SDK 界面手动下载 API Version 4 至 8 的 SDK 和工具链。
手动下载 SDK
- 在 DevEco Studio 欢迎页,点击 “Configure” (或图标) > “Settings” > “SDK” > “HarmonyOS” 选项卡 (macOS 系统为 “Configure” > “Preferences” > “SDK” > “HarmonyOS”)。
- 在 DevEco Studio 打开工程的情况下,点击 “Files” > “Settings” > “SDK” > “HarmonyOS” 选项卡进入 (macOS 系统为 “DevEco Studio” > “Preferences” > “SDK” > “HarmonyOS”)。
首次启动配置向导
- 运行已安装的 DevEco Studio,首次使用,选择 “Do not import settings”,点击 “OK”。
- 安装 Node.js 和 ohpm:
- 可以指定本地已安装的 Node.js 或 ohpm (Node.js 版本要求为 v14.19.1 及以上,且低于 v17.0.0;对应的 npm 版本要求为 6.14.16 及以上) 路径位置。
- 如果本地没有合适的版本,可以选择 “Install” 按钮,选择下载源和存储路径后,进行在线下载,点击 “Next” 进入下一步。
- 说明: 如果配置向导界面出现设置 HTTP Proxy Setup,说明网络受限,请根据参考信息配置 DevEco Studio 代理后,再下载 Node.js、ohpm 和 SDK。
- 设置 HarmonyOS SDK 存储路径:
- 点击按钮设置 HarmonyOS SDK 存储路径,点击 “Next” 进入下一步。
- 说明: HarmonyOS SDK 路径中不能包含中文字符。
- 下载 SDK:
- 在弹出的 SDK 下载信息页面,点击 “Next”,并在弹出的 License Agreement 窗口,阅读 License 协议,需同意 License 协议后,点击 “Next”。
- 说明: 下载 SDK 过程中,如果出现下载 JS SDK 失败,提示 “Install Js dependencies failed.”,请根据 JS SDK 安装失败处理指导进行处理。
- 开始安装:
- 确认设置信息,点击 “Next” 开始安装。
- 完成安装:
- 等待 Node.js、ohpm 和 SDK 下载完成后,点击 “Finish”,界面会进入到 DevEco Studio 欢迎页。
配置 HDC 工具环境变量
HDC 是 HarmonyOS 应用/服务的调试工具,为了方便使用 HDC 工具,请设置 HDC 端口环境变量。
Windows 环境变量设置方法
- 在 “此电脑” > “属性” > “高级系统设置” > “高级” > “环境变量” 中,添加名为 “HDC_SERVER_PORT” 的环境变量,值为任意未被占用的端口,例如 7035。
- 环境变量配置完成后,关闭并重启 DevEco Studio。
macOS 环境变量设置方法
- 打开终端,执行以下命令,根据输出结果选择相应的命令:
- echo $SHELL
- 根据终端类型选择操作:
- 如果输出结果为 “/bin/bash”,则执行以下命令打开 “.bash_profile” 文件:
- vi ~/.bash_profile
- 如果输出结果为 “/bin/zsh”,则执行以下命令打开 “.zshrc” 文件:
- vi ~/.zshrc
- 如果输出结果为 “/bin/bash”,则执行以下命令打开 “.bash_profile” 文件:
- 编辑文件:
- 按 “i” 键进入 Insert 模式。
- 输入以下内容,添加 HDC_SERVER_PORT 端口信息:
- export HDC_SERVER_PORT=7035
- 按 “Esc” 键退出编辑模式,然后输入 “:wq”,按 “Enter” 键保存。
- 使配置的环境变量生效:
- 如果步骤 2 中打开的是 “.bash_profile” 文件,请执行以下命令:
- source ~/.bash_profile
- 如果步骤 2 中打开的是 “.zshrc” 文件,请执行以下命令:
- source ~/.zshrc
- 如果步骤 2 中打开的是 “.bash_profile” 文件,请执行以下命令:
- 环境变量配置完成后,关闭并重启 DevEco Studio。