ACE Tools环境配置指导

简介

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

环境准备

前置条件: Ubuntu需要18.04以上版本,macOS需要11.6.2及以上版本,Windows需要Windows 10版本。

1. 配置Node.js环境

运行ACE Tools需Node.js环境支持,建议下载18.x版本。可命令行运行 node -v 查看本地Node.js版本,如不存在或版本不符合要求,请自行下载安装稳定版本:Node.js下载地址。推荐环境变量配置如下:

[Linux]

shell 复制代码
// 配置环境变量
export NODE_HOME=/path-to-nodejs-sdk
export PATH=${NODE_HOME}/bin:${PATH}

[macOS]

shell 复制代码
// 配置环境变量
export NODE_HOME=/path-to-nodejs-sdk
export PATH=$NODE_HOME/bin:$PATH

[Windows]

shell 复制代码
// 配置环境变量
set NODE_HOME=/path-to-nodejs-sdk
set PATH=%PATH%;%NODE_HOME%/bin

2. 配置ohpm环境

OHPM CLI(OpenHarmony Package Manager Command-line Interface)OpenHarmony生态三方库的包管理工具,位于OpenHarmony SDK命令行工具中。推荐环境变量配置如下:

[Linux]

shell 复制代码
// 配置环境变量
export OHPM_HOME=/path-to-ohpm-sdk
export PATH=${OHPM_HOME}/bin:${PATH}

[macOS]

shell 复制代码
// 配置环境变量
export OHPM_HOME=/path-to-ohpm-sdk
export PATH=$OHPM_HOME/bin:$PATH

[Windows]

shell 复制代码
// 配置环境变量
set OHPM_HOME=/path-to-ohpm-sdk
set PATH=%PATH%;%OHPM_HOME%/bin

环境变量配置完成后,执行ohpm初始化。

shell 复制代码
cd command-line-tools/ohpm    //按实进入package.json所在目录
./bin/init                    //执行init命令

3. 配置Java环境

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

[Linux]

shell 复制代码
// 配置环境变量
export JAVA_HOME=/path-to-java-sdk
export PATH=${JAVA_HOME}/bin:${PATH}

[macOS]

shell 复制代码
// 配置环境变量
export JAVA_HOME=/path-to-java-sdk
export PATH=$JAVA_HOME/bin:$PATH

[Windows]

shell 复制代码
// 配置环境变量
set JAVA_HOME=/path-to-java-sdk
set PATH=%PATH%;%JAVA_HOME%/bin

4. 配置OpenHarmony SDK环境

SDK下载: 通过OpenHarmony SDK命令行工具下载OpenHarmony SDK,命令行工具使用说明详见ohsdkmgr官方指导。推荐环境变量配置如下:

[Linux]

shell 复制代码
// 配置环境变量
export OpenHarmony_HOME=/path-to-openharmony-sdk
export PATH=${OpenHarmony_HOME}/versioncode/toolchains:${PATH}

[macOS]

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

[Windows]

shell 复制代码
// 配置环境变量
set OpenHarmony_HOME=/path-to-openharmony-sdk
set PATH=%PATH%;%OpenHarmony_HOME%/versioncode/toolchains

说明: 如果您使用DevEco Studio,则无需使用此命令行工具,可直接通过IDE管理SDK软件包

5. 配置HarmonyOS SDK环境

SDK下载: 通过HarmonyOS SDK命令行工具下载HarmonyOS SDK,命令行工具使用说明详见sdkmgr官方指导。推荐环境变量配置如下:

[Linux]

shell 复制代码
// 配置环境变量
export HarmonyOS_HOME=/path-to-harmonyos-sdk
export PATH=${HarmonyOS_HOME}/hmscore/versioncode/toolchains:${PATH}

[macOS]

shell 复制代码
// 配置环境变量
export HarmonyOS_HOME=/path-to-harmonyos-sdk
export PATH=$HarmonyOS_HOME/hmscore/versioncode/toolchains:$PATH

[Windows]

shell 复制代码
// 配置环境变量
set HarmonyOS_HOME=/path-to-harmonyos-sdk
set PATH=%PATH%;%HarmonyOS_HOME%/hmscore/versioncode/toolchains

说明: 如果您使用DevEco Studio,则无需使用此命令行工具,可直接通过IDE管理SDK软件包

6. 配置Android SDK环境

SDK下载: 通过Android SDK命令行工具下载Android SDK,命令行工具使用说明详见sdkmanager官方指导。推荐环境变量配置如下:

[Linux]

shell 复制代码
// 配置环境变量
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]

shell 复制代码
// 配置环境变量
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]

shell 复制代码
// 配置环境变量
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

说明: 如果您使用Android Studio,则无需使用此命令行工具,可直接通过IDE管理SDK软件包

7. iOS应用开发环境

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

shell 复制代码
xcode-select --install

7.2 libimobiledevice,详细信息参照

shell 复制代码
brew install libimobiledevice

7.3 ios-deploy安装,详细信息参照

shell 复制代码
brew install ios-deploy

8. 配置ArkUI-X SDK环境

ArkUI-SDK获取和配置目录要求,请参考ArkUI-X SDK介绍。推荐环境变量配置如下:

[Linux]

shell 复制代码
// 配置环境变量
export ARKUIX_SDK_HOME=/path-to-arkui-x-sdk

[macOS]

shell 复制代码
// 配置环境变量
export ARKUIX_SDK_HOME=/path-to-arkui-x-sdk

[Windows]

shell 复制代码
// 配置环境变量
set ARKUIX_SDK_HOME=/path-to-arkui-x-sdk

命令安装

安装ace命令

  • 修改npm源,前往用户目录,在.npmrc文件中添加如下内容:
shell 复制代码
@ohos:registry=https://repo.harmonyos.com/npm/
registry=https://repo.huaweicloud.com/repository/npm/
  • 全局安装ACE命令
shell 复制代码
cd arkui-x/toolchains/ace_tools    // 根据ArkUI-X SDK下载路径,进入ACE Tools实际所在目录。
npm install
npm install . -g

环境检查

shell 复制代码
ace check

执行 ace check 命令可以检查上述的本地开发环境配置情况。对于必选项,需要检查通过,否则无法继续接下来的操作。

相关推荐
m0_644222615 个月前
鸿蒙嵌入式设备开发之hello world
华为·harmonyos·鸿蒙·鸿蒙系统·鸿蒙应用开发·鸿蒙开发
m0_644222615 个月前
纯血鸿蒙开发教程:如何实现运动饮食卡片效果
华为·harmonyos·鸿蒙·鸿蒙系统·鸿蒙应用开发·鸿蒙开发·鸿蒙工程师
不入流Android开发6 个月前
OpenHarmony实战开发-请求自绘制内容绘制帧率
华为·harmonyos·鸿蒙系统·openharmony·鸿蒙应用开发·鸿蒙开发
不入流Android开发6 个月前
OpenHarmony实战开发-使用通用事件、焦点事件
harmonyos·鸿蒙·鸿蒙系统·openharmony·鸿蒙应用开发·鸿蒙开发
不入流Android开发6 个月前
OpenHarmony实战开发-基础知识
华为·harmonyos·鸿蒙·openharmony·鸿蒙应用开发·鸿蒙开发
不入流Android开发6 个月前
OpenHarmony实战开发-使用SmartPerf-Host分析应用性能
harmonyos·鸿蒙·鸿蒙系统·openharmony·鸿蒙应用开发·鸿蒙开发
不入流Android开发6 个月前
OpenHarmony实战开发-性能测试工具SmartPerf Editor使用指导
华为·harmonyos·鸿蒙系统·openharmony·鸿蒙应用开发·鸿蒙开发·鸿蒙工程师
不入流Android开发6 个月前
OpenHarmony实战开发-提升应用响应速度。
华为·harmonyos·鸿蒙·openharmony·鸿蒙应用开发·鸿蒙开发
不入流Android开发6 个月前
HarmonyOS实战开发-如何在鸿蒙开发中使用数据库
华为·harmonyos·鸿蒙系统·openharmony·鸿蒙应用开发·鸿蒙开发·鸿蒙工程师
不入流Android开发6 个月前
OpenHarmony实战开发-动画曲线、如何实现动画衔接
华为·harmonyos·鸿蒙·鸿蒙系统·openharmony·鸿蒙应用开发·鸿蒙开发