当前位置:首页 > 系统教程 > 正文

开源鸿蒙PC开发训练营

开源鸿蒙PC开发训练营

HarmonyOS PC命令行适配环境搭建及验证(Mac版)

欢迎参加开源鸿蒙PC开发训练营!本文将带你一步步在Mac上搭建HarmonyOS PC的命令行适配环境,并进行验证。无论你是新手还是资深开发者,都能轻松上手。

开源鸿蒙PC开发训练营 HarmonyOS PC 开源鸿蒙 命令行适配 Mac环境搭建 第1张

1. 环境准备

确保你的Mac运行macOS Catalina 10.15或更高版本。安装Xcode命令行工具:xcode-select --install。同时需要Homebrew包管理器:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装依赖工具

HarmonyOS PC开发需要gn、ninja、python等工具。使用Homebrew安装:

brew install gn ninja python3 node

安装hb命令行工具(鸿蒙构建工具):pip3 install ohos-build

3. 获取HarmonyOS PC源码

通过repo工具下载开源鸿蒙源码。首先安装repo:

mkdir ~/bincurl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repochmod a+x ~/bin/repoexport PATH=~/bin:$PATH

然后创建工作目录并初始化repo:

mkdir harmonyos-pccd harmonyos-pcrepo init -u https://gitee.com/openharmony/manifest.git -b masterrepo sync -c

4. 配置命令行适配环境

设置环境变量,指定设备类型为pc:

export DEVICE_NAME=pcexport PRODUCT_NAME=ohos-sdk

运行hb set命令选择产品:hb set,然后在列表中选择pc相关配置。

5. 编译验证

执行编译:hb build -f。首次编译可能需要较长时间。编译成功后,输出镜像位于out目录。可以运行模拟器验证:./out/pc/packages/phone/images/run.sh

开源鸿蒙PC开发训练营 HarmonyOS PC 开源鸿蒙 命令行适配 Mac环境搭建 第2张

6. 常见问题与解决

若遇到python版本问题,请使用python3。如果gn缺失,请确认brew安装成功。更多问题可查阅开源鸿蒙官方文档。

通过以上步骤,你已成功在Mac上搭建了HarmonyOS PC的命令行适配环境。现在你可以开始探索开源鸿蒙在PC上的开发了!