ACE Tools环境配置指导
简介
ACE Tools是一套为ArkUI-X应用开发者提供的命令行工具,支持在Windows/Ubuntu/macOS平台运行,用于构建OpenHarmony、HarmonyOS、Android和iOS平台的应用程序, 其功能包括开发环境检查,新建项目,编译打包,安装调试等,以下是详细的环境配置指导。
环境准备
前置条件: macOS需要11.6.2及以上版本,Windows需要Windows 10版本,Ubuntu需要18.04及以上版本。
配置ohpm环境
OHPM CLI作为鸿蒙生态三方库的包管理工具,支持OpenHarmony共享包的发布、安装和依赖管理,配置方法请参见:ohpm使用指导。
配置Java环境
Android和OpenHarmony/HarmonyOS应用打包需Java环境支持,建议下载JDK11.0.2版本,下载请点击此处。推荐环境变量配置方法:
[Ubuntu]
// 配置环境变量
export JAVA_HOME=/path-to-java-sdk
export PATH=${JAVA_HOME}/bin:${PATH}
[macOS]
// 配置环境变量
export JAVA_HOME=/path-to-java-sdk
export PATH=$JAVA_HOME/bin:$PATH
[Windows]
// 配置环境变量
set JAVA_HOME=/path-to-java-sdk
set PATH=%PATH%;%JAVA_HOME%/bin
配置ArkUI-X SDK环境
ArkUI-SDK获取和配置目录要求,请参考ArkUI-X SDK介绍。推荐环境变量配置方法:
[Ubuntu]
// 配置环境变量
export ARKUIX_SDK_HOME=/path-to-arkui-x-sdk
export PATH=${ARKUIX_SDK_HOME}/10/arkui-x/toolchains/bin:${PATH}
[macOS]
// 配置环境变量
export ARKUIX_SDK_HOME=/path-to-arkui-x-sdk
export PATH=${ARKUIX_SDK_HOME}/10/arkui-x/toolchains/bin:$PATH
[Windows]
可在桌面工具栏搜索框键入"环境变量",然后选择编辑系统环境变量,进行环境变量配置。另外,也可在控制台通过如下命令进行配置。
// 配置环境变量
set ARKUIX_SDK_HOME=/path-to-arkui-x-sdk
set PATH=%PATH%;%ARKUIX_SDK_HOME%/10/arkui-x/toolchains/bin
说明:配置环境变量时,由于ARKUIX_SDK_HOME是ACE Tools要求的固定变量名,不允许自定义。
环境检查
执行 ace check 命令可以检查ArkUI-X应用开发环境依赖配置情况。对于必选项,需要检查通过,否则无法继续接下来的操作。
ace check
环境配置完成后,即可使用ACE Tools进行跨平台应用开发调试。
说明:开发环境检查只识别IDE和SDK默认的安装路径,以及下文提到的环境变量配置。如果提示结果与实际不符,请您通过ace config命令指定实际的IDE安装和SDK下载路径。
配置目标平台应用开发环境
OpenHarmony平台
SDK下载方法:如果您使用DevEco Studio,可直接通过IDE管理SDK软件包进行下载,否则需通过OpenHarmony SDK命令行工具下载OpenHarmony SDK,命令行工具使用说明详见ohsdkmgr官方指导。
SDK下载完成后,按照如下方法配置环境变量:
[Ubuntu]
// 配置环境变量
export OpenHarmony_HOME=/path-to-openharmony-sdk
export PATH=${OpenHarmony_HOME}/versioncode/toolchains:${PATH}
[macOS]
// 配置环境变量
export OpenHarmony_HOME=/path-to-openharmony-sdk
export PATH=$OpenHarmony_HOME/versioncode/toolchains:$PATH
[Windows]
// 配置环境变量
set OpenHarmony_HOME=/path-to-openharmony-sdk
set PATH=%PATH%;%OpenHarmony_HOME%/versioncode/toolchains
HarmonyOS平台
SDK下载方法:如果您使用DevEco Studio,可直接通过IDE管理SDK软件包进行下载,否则需通过HarmonyOS SDK命令行工具下载HarmonyOS SDK,命令行工具使用说明详见sdkmgr官方指导。
SDK下载完成后,按照如下方法配置环境变量:
[Ubuntu]
// 配置环境变量
export HarmonyOS_HOME=/path-to-harmonyos-sdk
export PATH=${HarmonyOS_HOME}/openharmony/versioncode/toolchains:${PATH}
[macOS]
// 配置环境变量
export HarmonyOS_HOME=/path-to-harmonyos-sdk
export PATH=$HarmonyOS_HOME/openharmony/versioncode/toolchains:$PATH
[Windows]
// 配置环境变量
set HarmonyOS_HOME=/path-to-harmonyos-sdk
set PATH=%PATH%;%HarmonyOS_HOME%/openharmony/versioncode/toolchains
Android平台
SDK下载方法:如果您使用Android Studio,可直接通过IDE管理SDK软件包进行下载,否则需通过Android SDK命令行工具下载Android SDK,命令行工具使用说明详见sdkmanager官方指导。
SDK下载完成后,按照如下方法配置环境变量:
[Ubuntu]
// 配置环境变量
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}
[macOS]
// 配置环境变量
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
[Windows]
// 配置环境变量
set ANDROID_HOME=/path-to-android-sdk
set PATH=%PATH%;%ANDROID_HOME%/tools;%ANDROID_HOME%/tools/bin;%ANDROID_HOME%/build-tools/28.0.3;%ANDROID_HOME%/platform-tools
iOS平台
Xcode和Command Line Tools for Xcode应用可前往Mac App Store应用商店下载安装。Command Line Tools也可使用命令方式安装:
xcode-select --install
libimobiledevice,详细信息参照。
brew install libimobiledevice
ios-deploy安装,详细信息参照。
brew install ios-deploy