ACE Tools是一套为ArkUI-X应用开发者提供的命令行工具,支持在Windows/Ubuntu/macOS平台运行,用于构建OpenHarmony、HarmonyOS、Android和iOS平台的应用程序, 其功能包括开发环境检查,新建项目,编译打包,安装调试等。
环境准备:
** Ubuntu需要18.04以上版本,macOS需要11.6.2及以上版本,Windows需要Windows 10版本。
以下只介绍windows的配置方法:
**1. 配置Node.js环境**
运行ACE Tools需Node.js环境支持,建议下载18.x版本。可命令行运行 `node -v` 查看本地Node.js版本,如不存在或版本不符合要求,请自行下载安装稳定版本:[Node.js下载地址](https://nodejs.org/en/download/)。推荐环境变量配置如下:
```shell
// 配置环境变量
set NODE_HOME=/path-to-nodejs-sdk
set PATH=%PATH%;%NODE_HOME%/bin
添加NODE_HOME
Path里添加
配置之后使用
node -v 出现版本号证明配置完成
**2. 配置ohpm环境**
OHPM CLI(OpenHarmony Package Manager Command-line Interface)OpenHarmony生态三方库的包管理工具,位于OpenHarmony [SDK命令行工具](https://developer.harmonyos.com/cn/develop/deveco-studio#download_cli_openharmony)中。
推荐环境变量配置如下:
```shell
// 配置环境变量
set OHPM_HOME=/path-to-ohpm-sdk
set PATH=%PATH%;%OHPM_HOME%/bin
也可以只在Path中添加:
可通过DevEco Studio > File > Settings > Build, Execution, Deployment > Ohpm 查看ohpm home的安装路径,并配置到环境变量中。
环境变量配置完成后,执行ohpm初始化。
```shell
cd command-line-tools/ohpm //按实进入package.json所在目录
./bin/init //执行init命令
**3. 配置Java环境**
Android和OpenHarmony/HarmonyOS应用打包需Java环境支持,建议下载JDK11.0.2以上版本,下载请点击[此处](https://repo.huaweicloud.com/openjdk/)。推荐环境变量配置如下:
// 配置环境变量
set JAVA_HOME=/path-to-java-sdk
set PATH=%PATH%;%JAVA_HOME%/bin
Path里添加
命令行输入java -version显示版本号就配好了
**4. 配置OpenHarmony SDK环境**
**SDK下载:** 通过[OpenHarmony SDK命令行工具](https://developer.harmonyos.com/cn/develop/deveco-studio#download_cli_openharmony)下载OpenHarmony SDK,命令行工具使用说明详见[ohsdkmgr](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-sdk-command-line-tool-0000001263280431)官方指导。推荐环境变量配置如下:
// 配置环境变量
set OpenHarmony_HOME=/path-to-openharmony-sdk
set PATH=%PATH%;%OpenHarmony_HOME%/versioncode/toolchains
**说明:** 如果您使用DevEco Studio,则无需使用此命令行工具,可直接通过[IDE管理SDK软件包](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/environment_config-0000001052902427)。
**注意文件的路径,如果不按这个名称顺序命名,很有可能会报异常**
**5. 配置HarmonyOS SDK环境**
**SDK下载:** 通过[HarmonyOS SDK命令行工具](https://developer.harmonyos.com/cn/develop/deveco-studio#download_cli)下载HarmonyOS SDK,命令行工具使用说明详见[sdkmgr](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide-command-line-sdkmgr-0000001110390078)官方指导。推荐环境变量配置如下:
// 配置环境变量
set HarmonyOS_HOME=/path-to-harmonyos-sdk
set PATH=%PATH%;%HarmonyOS_HOME%/hmscore/versioncode/toolchains
**说明:** 如果您使用DevEco Studio,则无需使用此命令行工具,可直接通过[IDE管理SDK软件包](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/environment_config-0000001052902427)。
**6. 配置Android SDK环境**
**SDK下载:** 通过[Android SDK命令行工具](https://developer.android.google.cn/studio#command-line-tools-only)下载Android SDK,命令行工具使用说明详见[sdkmanager](https://developer.android.google.cn/studio/command-line/sdkmanager)官方指导。推荐环境变量配置如下:
// 配置环境变量
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软件包](https://developer.android.google.cn/studio/intro/update#sdk-manager)。
**7. 配置ArkUI-X SDK环境**
ArkUI-SDK获取和配置目录要求,请参考[ArkUI-X SDK介绍](../tools/how-to-use-arkui-x-sdk.md)。
zh-cn/release-notes/ArkUI-X-v1.0.0-canary1.md · ArkUI-X/docs - Gitee.com
下载。sha256也要下载,放在如下图所示的licenses里
推荐环境变量配置如下:
// 配置环境变量
set ARKUIX_SDK_HOME=/path-to-arkui-x-sdk
Path里
ArkUI-X SDK下载路径,可通过DevEco Studio > File > Settings > ArkUI-X查看ArkUI-X的安装路径,并配置到环境变量中(macOS为DevEco Studio > Preferences > ArkUI-X)
## 命令安装
### 安装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` 命令可以检查上述的本地开发环境配置情况。对于必选项,需要检查通过,否则无法继续接下来的操作。
如此打对钩就表明装好了。