ACE Tools环境配置指导【macOS】

❝作者：坚果 团队：坚果派 团队介绍：坚果派由坚果创建，团队拥有8个华为HDE，3个HSD，以及若干其他领域的三十余位万粉博主运营。 本人为华为HDE、中国计算机学会CCF专业会员、OpenHarmony布道师、开发者联盟优秀讲师、2023年开源之夏导师、2023年OpenHarmony应用创新赛导师、RISC-V+OpenHarmony应用创意赛导师、OpenHarmony三方库贡献者、开放原子开源基金会技术+生态贡献者第一批开放原子开源讲师、OpenHarmony校源行开源大使、InfoQ签约作者、CSDN博客专家、电子发烧友MVP、51CTO博客专家博主、阿里云博客专家、曾受邀参加2022，2023HDC大会。专注于分享的技术包括HarmonyOS/OpenHarmony，ArkUI-X，元服务，服务卡片，华为自研语言，在2022年战码活动中，带领100余人完成pr的提交，配合孵化三个小队长。也在此活动中累计完成1.5W行代码提交，以及在2023年OpenHarmony创新赛中。累计辅导60+队伍，完成作品的提交,在相关社区累计发布OpenHarmony相关技术文章/视频50+，获得20w+浏览量。

简介

ACE Tools是一套为ArkUI-X应用开发者提供的命令行工具，支持在Windows/Ubuntu/macOS平台运行，用于构建OpenHarmony、HarmonyOS、Android和iOS平台的应用程序， 其功能包括开发环境检查，新建项目，编译打包，安装调试等，以下是详细的环境配置指导。

环境准备

前置条件： macOS需要11.6.2及以上版本，Windows需要Windows 10版本，Ubuntu需要18.04及以上版本。这里只以macos为例。

配置ohpm环境

OHPM CLI作为鸿蒙生态三方库的包管理工具，支持OpenHarmony共享包的发布、安装和依赖管理。

配置Java环境

Android和OpenHarmony/HarmonyOS应用打包需Java环境支持，建议下载JDK11.0.2版本，下载请点击此处。推荐环境变量配置方法：

// 配置环境变量
export JAVA_HOME=/path-to-java-sdk
export PATH=$JAVA_HOME/bin:$PATH
比如我的
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH

配置ArkUI-X SDK环境

ArkUI-SDK获取和配置目录要求，请参考ArkUI-X SDK介绍。推荐环境变量配置方法：

// 配置环境变量
export ARKUIX_SDK_HOME=/path-to-arkui-x-sdk
export PATH=${ARKUIX_SDK_HOME}/10/arkui-x/toolchains/bin:$PATH

比如我的
export ARKUIX_SDK_HOME=/Users/jianguo/Library/ArkUI-X/Sdk
export PATH=${ARKUIX_SDK_HOME}/10/arkui-x/toolchains/bin:$PATH

环境检查

执行 ace check 命令可以检查ArkUI-X应用开发环境依赖配置情况。对于必选项，需要检查通过，否则无法继续接下来的操作。

ace check

环境配置完成后，即可使用ACE Tools进行跨平台应用开发调试。

配置目标平台应用开发环境

OpenHarmony平台

SDK下载完成后，按照如下方法配置环境变量：

// 配置环境变量
export OpenHarmony_HOME=/path-to-openharmony-sdk
export PATH=$OpenHarmony_HOME/versioncode/toolchains:$PATH

HarmonyOS平台

SDK下载完成后，按照如下方法配置环境变量：

// 配置环境变量
export HarmonyOS_HOME=/path-to-harmonyos-sdk
export PATH=$HarmonyOS_HOME/openharmony/versioncode/toolchains:$PATH

Android平台

SDK下载完成后，按照如下方法配置环境变量：

// 配置环境变量
export ANDROID_HOME=/path-to-android-sdk
export PATH=$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/build-tools/28.0.3:$ANDROID_HOME/platform-tools:$PATH

iOS平台

Xcode和Command Line Tools for Xcode应用可前往Mac App Store应用商店下载安装。Command Line Tools也可使用命令方式安装:

xcode-select --install

brew install libimobiledevice

brew install ios-deploy