Bootstrap

鸿蒙ArkUI-X跨平台开发：【命令行工具（ACE Tools）】

ACE Tools

简介

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

注释：  ACE - ArkUI跨平台运行环境 (ArkUI Cross-platform Environment)。

图1 ACE Tools命令行工具模块结构

命令行各平台使用不同脚本文件做为入口，再通过Node.js执行到ace_tools.js文件，使用npm模块commander解析命令行执行各子模块导出的方法。

目录结构

ACE Tools工具链的代码在//developtools/ace_tools下，目录结构如下图所示：

开发前请熟悉鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

/developtools/ace_tools
├── lib/src/cli                 # 命令相关
│   ├── ace-build               # 构建跨平台应用安装包
│   ├── ace-check               # 查验跨平台应用开发环境
│   ├── ace-clean               # 清理跨平台应用编译结果
│   ├── ace-config              # 设置ACE工具链相关配置
│   ├── ace-create              # 创建跨平台应用工程及应用模块
│   ├── ace-devices             # 查询当前所有连接的设备
│   ├── ace-help                # 帮助命令
│   ├── ace-install             # 将跨平台应用安装到连接的设备上
│   ├── ace-launch              # 在设备上运行ArkUI跨平台应用
│   ├── ace-log                 # 展示正在运行的跨平台应用的日志
│   ├── ace-run                 # 编译并在设备上运行ArkUI跨平台应用
|   ├── ace-test                # 执行跨平台应用包单元测试
│   ├── ace-uninstall           # 将跨平台应用从连接的设备上卸载
│   └── util                    # 工具模块
├── lib
│   └── ace_tools.js            # 入口脚本
└── templates                   # 模板相关
    ├── android                 # Android工程模板
    ├── cpp                     # Native C++配置模板
    ├── cpp_ets_stage           # Stage Native C++开发模板
    ├── ets_stage               # Stage开发模板
    ├── framework               # framework工程模板
    ├── ios                     # iOS工程模板
    └── ohos_stage              # ohos Stage工程模板

使用方法

ace config

设置ACE工具链相关配置，包括OpenHarmony SDK路径，HarmonyOS SDK路径、ArkUI-X SDK路径、Android SDK路径、Node.js路径、编译输出路径等。

语法：

ace config [arguments]
  • arguments
参数说明
--android-sdkAndroid SDK路径。
--android-studio-pathAndroid Studio安装路径（可选参数）。
--arkui-x-sdkArkUI-X SDK路径。
--build-dir编译输出的路径。
--deveco-studio-pathDevEco Studio安装路径（可选参数）。
--harmonyos-sdkHarmonyOS SDK路径。
--java-sdkJDK路径。
--nodejs-dirNode.js 路径。
--ohpm-dirOhpm路径。
--openharmony-sdkOpenHarmony SDK路径。

ace check

查验跨平台应用开发环境。

需要检查的项：

检查内容说明WindowsLinuxMac
adbAndroid设备调试工具是是是
Android SDKAndroid SDK路径是是是
Android StudioAndroid Studio安装路径是是是
ArkUI-X SDKArkUI-X SDK路径是是是
DevEco StudioDevEco Studio安装路径是否是
HarmonyOS hdcHarmonyOS设备调试工具是是是
HarmonyOS SDKHarmonyOS SDK路径是是是
ios-deploy当前ios-deploy的版本号否否是
libimobiledevice当前libimobiledevice的版本号否否是
Node.jsNode.js 路径是是是
OhpmOhpm路径是是是
OpenHarmony hdcOpenHarmony调试工具是是是
OpenHarmony SDKOpenHarmony SDK路径是是是
Xcode当前Xcode的版本号否否是
连接设备当前连接的所有设备是是是

语法：

ace check [arguments]
  • arguments
参数说明
-v --v显示详细结果。
-h --help显示帮助信息。

执行结果参考：

ohos@user ~ % ace check
Check summary (to see all details, run ace check -v)
[√] ArkUI-X (ArkUI-X SDK version 1.0.0.0)
[√] OpenHarmony toolchains - develop for OpenHarmony devices (OpenHarmony SDK version 4.0.10.13)
[√] HarmonyOS toolchains - develop for HarmonyOS devices (HarmonyOS SDK version 3.1.0)
[√] Android toolchains - develop for Android devices (Android SDK version 34.0.0)
[√] DevEco Studio (version 4.0.0.600)
[√] Android Studio (version 2022.3)
[√] Xcode - develop for iOS (Xcode 14.3.1)
Tools info :[√] OpenHarmony hdc installed
            [√] HarmonyOS hdc installed
            [√] adb installed
            [√] ios-deploy installed
[√] Connected device (1 available)
  •  iPhone 14 Pro Max (1058643C-A725-4E19-AA62-781588C94A7F) [iOS Simulator]

  √ ACE Tools found no issues.

ohos@user ~ % ace check -v
[√] ArkUI-X (ArkUI-X SDK version 1.0.0.0)
  • ArkUI-X SDK at /Users/ohos/Library/ArkUI-X/Sdk
  • Node.js (v18.17.1) Runtime Environment at /usr/local/n/versions/node/18.17.1/
  • libimobiledevice 1.3.0
  • ios-deploy 1.12.2
[√] OpenHarmony toolchains - develop for OpenHarmony devices (OpenHarmony SDK version 4.0.10.13)
  • OpenHarmony SDK at /Users/ohos/Library/OpenHarmony/Sdk
  • Ohpm at /Users/ohos/Library/Huawei/ohpm
  • Java SDK at /Applications/deveco-studio.app/Contents/jbr/Contents/Home
  • OpenJDK Runtime Environment JBR-17.0.6+10-829.5-jcef (build 17.0.6+10-b829.5)
[√] HarmonyOS toolchains - develop for HarmonyOS devices (HarmonyOS SDK version 3.1.0)
  • HarmonyOS SDK at /Users/ohos/Library/Huawei/Sdk
  • Ohpm at /Users/ohos/Library/Huawei/ohpm
  • Java SDK at /Applications/deveco-studio.app/Contents/jbr/Contents/Home
  • OpenJDK Runtime Environment JBR-17.0.6+10-829.5-jcef (build 17.0.6+10-b829.5)
[√] Android toolchains - develop for Android devices (Android SDK version 34.0.0)
  • Android SDK at /Users/ohos/Library/Android/sdk
  • Java SDK at /Applications/Android Studio.app/Contents/jbr/Contents/Home
  • OpenJDK Runtime Environment (build 17.0.6+0-17.0.6b829.9-10027231)
[√] DevEco Studio (version 4.0.3)
  • DevEco Studio at /Applications/deveco-studio.app
  • Java SDK at /Applications/deveco-studio.app/Contents/jbr/Contents/Home
  • OpenJDK Runtime Environment JBR-17.0.6+10-829.5-jcef (build 17.0.6+10-b829.5)
[√] Android Studio (version 2022.3)
  • Android Studio at /Applications/Android Studio.app
  • Java SDK at /Applications/Android Studio.app/Contents/jbr/Contents/Home
  • OpenJDK Runtime Environment (build 17.0.6+0-17.0.6b829.9-10027231)
[√] Xcode - develop for iOS (Xcode 14.3.1)
  • Xcode at /Applications/Xcode.app
  • Build version 14E300c
Tools info :[√] OpenHarmony hdc installed
            [√] HarmonyOS hdc installed
            [√] adb installed
            [√] ios-deploy installed
[√] Connected device (1 available)
  •  iPhone 14 Pro Max (1058643C-A725-4E19-AA62-781588C94A7F) [iOS Simulator]

  √ ACE Tools found no issues.

ace devices

列出当前所有连接的设备，Windows平台上可以查询到当前连接的Android(包括Android Studio的模拟器)和OpenHarmony/HarmonyOS设备；Linux平台上可以查询到当前连接的Android设备；

Mac平台上可以查询到当前连接的Android(包括Android Studio的模拟器)，OpenHarmony/HarmonyOS，iOS设备和Mac自带的iOS模拟器(可通过命令行open -a Simulator启动，需要安装Xcode)。

语法：

ace devices [arguments]
  • arguments
参数说明
-h --help显示帮助信息。

执行结果参考：

ohos@user ~ % ace devices
Tools info :[√] OpenHarmony hdc installed
            [√] HarmonyOS hdc installed
            [√] adb installed
            [√] ios-deploy installed
[√] Connected device (2 available)
  •  sdk_gphone64_x86_64 (emulator-5554) [Android]
  •  iPhone 14 Pro Max (1058643C-A725-4E19-AA62-781588C94A7F) [iOS Simulator]

ace create project

创建跨平台应用工程。

创建过程中，需要开发者依次填写工程名称和包名称，如果开发者不输入包名称，默认为com.example.工程名。

语法：

ace create <output directory>
  • options
选项说明
-t --template <type>指定创建工程。
-h --help显示帮助信息。
  • type
type说明
app创建普通arkui-x应用工程。
library创建aar/framework工程。
plugin_napi创建native工程。

在当前目录创建test工程：

ohos@user:~/cli-project$ ace create test
? Enter the project name(test):  # 输入工程名称，不输入默认为文件夹名称
? Enter the bundleName (com.example.test):  # 输入包名，不输入默认为com.example.工程名
? Enter the runtimeOS (1: OpenHarmony, 2: HarmonyOS): 1 # 输入RuntimeOS系统

Project created. Target directory:  /home/ohos/cli-project/test.

In order to run your app, type:

    $ cd test
    $ ace run

Your app code is in test/entry.

ace new module

新建跨平台应用模块(Module)

需要在新建的跨平台应用工程的根目录下执行，提示输入module名称：

Enter the module name:

如果此module name已存在，会提示开发者${module name} already exists.，开发者修改名称后，回车确认，可以成功新建出跨平台应用模块(Module)。

ace new ability

新建跨平台应用Ability

需要在新建的跨平台应用工程的根目录/具体module目录下执行，提示输入Ability名称：

Enter the ability name:

如果此ability name已存在，会提示开发者abilityName name already exists!.，开发者修改名称后，回车确认，可以成功新建出跨平台应用Ability。

ace build

构建跨平台应用安装包。

语法：

ace build <subCommand> [arguments]

在Windows和Linux平台上可构建Hap和Apk，在Mac平台上可构建Hap、Apk和App。

注：在DevEco Studio中打开要编译的工程配置自动签名，单击File > Project Structure > Project > Signing Configs界面勾选“Automatically generate signature”，等待自动签名完成即可，再执行ace build即可构建出签名hap安装包；在Mac上编译App之前需要使用Xcode打开对应ios工程，在Build settings的Singing进行签名配置，再执行编译命令；在Linux上无法签名。

  • subCommand
子命令说明
aab构建Android App Bundle文件。
aar构建Android应用 aar 包。
apk构建Android应用 apk 包。
bundle构建ArkUI cross-platform资源目录。
hap构建OpenHarmony/HarmonyOS应用 hap 包。
ios构建iOS应用 app 包。
ios-framework构建iOS应用 framework 包。
ios-xcframework构建iOS应用 xcframework 包。
  • arguments
参数子命令说明
--debugaab、aar、apk、bundle、hap、ios、ios-framework、ios-xcframework构建应用程序的类型为debug。
-r --releaseaab、aar、apk、bundle、hap、ios、ios-framework、ios-xcframework构建应用程序的类型为release(默认为release)。
--profileaab、aar、apk、bundle、hap、ios、ios-framework、ios-xcframework构建应用程序的类型为profile。
--nosignios、ios-framework、ios-xcframework构建出未签名的应用程序。
--target [moduleName]hap指定目标模块名进行构建。
--target-platform <platform>apk、aab、aar、bundle编译apk的目标平台[arm, arm64, x86_64]
-s --simulatorios、ios-framework、ios-xcframework构建ios模拟器对应包。
-h --helpaab、aar、apk、bundle、hap、ios、ios-framework、ios-xcframework显示帮助信息。

构建完成，提示包生成路径:

HAP file built successfully..
File path: /Users/ohos/WorkSpace/demo/ohos/entry/build/default/outputs/default

ace install

将跨平台应用安装到连接的设备上。

语法：

ace install [arguments]

在Windows和Linux平台上可以安装Hap和Apk应用包，在Mac平台上可以安装Hap、Apk和App应用包。 命令会根据options提示开发者选择对应平台的设备，如果只有一个设备连接，会直接安装到该设备上。 注：编译Release版本的Apk需要签名才能安装，请通过Android Studio完成签名或者编译Debug版本Apk安装。

  • arguments
参数说明
apk安装Android应用 apk 包，可选。
hap安装OpenHarmony/HarmonyOS应用 hap 包，可选。
ios安装iOS应用 app 包，可选。
参数说明
--target [moduleName]指定目标模块名进行安装。
-d --device <deviceId>指定运行应用的设备Id。
-h --help显示帮助信息。

安装完成：

ohos@user % ace install
[1]:  iPhone 14 Pro (67B40DC8-111C-4B30-9987-08E3BE30016A) [iOS Simulator]
[2]:  iPhone 14 Pro Max (1058643C-A725-4E19-AA62-781588C94A7F) [iOS Simulator]
? Please choose one (or "q" to quit): 2
iOS APP installed.

ace uninstall

将跨平台应用从连接的设备上卸载。命令会根据options提示开发者选择对应平台的设备，如果只有一个设备连接，会直接卸载该设备上的应用。

语法：

ace uninstall [arguments]
  • arguments
参数说明
apk卸载Android应用 apk 包，可选。
hap卸载OpenHarmony/HarmonyOS应用 hap 包，可选。
ios卸载iOS应用 app 包，可选。
参数说明
--bundle <bundleName>指定卸载应用的包名，iOS需为实际签名。
-d --device <deviceId>指定运行应用的设备Id。
-h --help显示帮助信息。

卸载完成：

ohos@user % ace uninstall --bundle com.example.${projectName}
[1]:  iPhone 14 Pro (67B40DC8-111C-4B30-9987-08E3BE30016A) [iOS Simulator]
[2]:  iPhone 14 Pro Max (1058643C-A725-4E19-AA62-781588C94A7F) [iOS Simulator]
? Please choose one (or "q" to quit): 2
iOS APP uninstalled.

ace launch

在设备上运行跨平台应用。命令会根据options提示开发者选择对应平台的设备，如果只有一个设备连接，会直接运行该设备上的应用。需要在设备上安装跨平台应用后才能运行。

语法：

ace launch [arguments]
  • arguments
参数说明
apk运行Android应用 apk 包，可选。
hap运行OpenHarmony/HarmonyOS应用 hap 包，可选。
ios运行iOS应用 app 包，可选。
参数说明
--target [moduleName]指定目标模块名进行运行。
-d --device <deviceId>指定运行应用的设备Id。
-h --help显示帮助信息。

运行完成：

ohos@user % ace launch
[1]:  iPhone 14 Pro (67B40DC8-111C-4B30-9987-08E3BE30016A) [iOS Simulator]
[2]:  iPhone 14 Pro Max (1058643C-A725-4E19-AA62-781588C94A7F) [iOS Simulator]
? Please choose one (or "q" to quit): 2
iOS APP launched.

ace log

滚动展示正在运行的跨平台应用的日志。命令会根据options提示开发者选择对应平台的设备，如果只有一个设备连接，会直接展示该设备上的应用日志。

默认只输出跨平台应用进程相关日志。

语法：

ace log [arguments]
  • arguments
参数说明
apk查看Android应用日志，可选。
hap查看OpenHarmony/HarmonyOS应用日志，可选。
ios查看iOS应用日志，可选。
参数说明
-d --device <deviceId>指定运行应用的设备Id。
-h --help显示帮助信息。
ohos@user % ace log
[1]:  iPhone 14 Pro (67B40DC8-111C-4B30-9987-08E3BE30016A) [iOS Simulator]
[2]:  iPhone 14 Pro Max (1058643C-A725-4E19-AA62-781588C94A7F) [iOS Simulator]
? Please choose one (or "q" to quit): 2

ace run

运行跨平台应用包。

ace run 先检查设备是否连接，确定设备类型，然后执行跨平台应用构建、安装、启动、输出应用进程log等操作。命令会根据options提示开发者选择对应平台的设备，如果只有一个设备连接，应用会安装到该设备并运行。

在Windows平台上可以构建安装并运行Hap和Apk，在Linux平台上可以构建安装并运行Apk，仅能构建Hap，在Mac平台上可以构建安装并运行Hap、Apk和App。

语法：

ace run [arguments]
  • arguments
参数说明
apk构建并运行Android应用 apk 包，可选。
hap构建并运行OpenHarmony/HarmonyOS应用 hap 包，可选。
ios构建并运行iOS应用 app 包，可选。
参数说明
--debug构建并运行debug版本应用。
-r --release构建并运行release版本应用。
--profile构建并运行profile版本应用。
--target [moduleName]指定目标模块名进行运行。
-d --device <deviceId>指定运行应用的设备Id。
-h --help显示帮助信息。
ohos@user % ace run
[1]:  iPhone 14 Pro (67B40DC8-111C-4B30-9987-08E3BE30016A) [iOS Simulator]
[2]:  iPhone 14 Pro Max (1058643C-A725-4E19-AA62-781588C94A7F) [iOS Simulator]
? Please choose one (or "q" to quit): 2

ace test

执行跨平台应用包单元测试。

ace test 先检查设备是否连接，确定设备类型，然后执行跨平台应用构建、安装、启动、执行单元测试、输出单元测试结果等操作。

在Windows平台上可以构建安装并测试Apk，在Linux平台上可以构建安装并测试Apk，在Mac平台上可以构建安装并测试Apk和App，暂时不支持iOS模拟器上的单元测试。

语法：

ace test [arguments]
  • arguments
参数说明
apk构建并运行Android应用 apk 包。
ios构建并运行iOS应用 app 包。
参数说明
--b [bundleName]指定测试应用的BundleName，iOS需要指定为自行设置的URL Types中的URL Schemes。
--class [class]指定测试应用的class。
--m [testModuleName]指定测试应用的ModuleName。
--skipInstall已安装情况跳过安装直接测试。（仍需依赖app/apk包，若指定了'path'则使用'path'下的app/apk包，否则使用默认路径下的app/apk包）
--target [moduleName]指定测试module用于安装测试。
--timeout [timeout]指定测试应用的单条用例的超时时间。
--unittest [testRunner]指定测试应用的testRunner。
--path [path]指定app/apk包路径用于直接安装测试。
-d --device <deviceId>指定运行应用的设备Id。
-h --help显示帮助信息。

ace clean

清理跨平台应用编译结果。

语法：

ace clean [arguments]
  • arguments
参数说明
-h --help显示帮助信息。

清理完成：

Project cleaned up.

ace help

跨平台应用命令行工具帮助。

语法：

ace help <command>
  • command
命令说明
build构建跨平台应用安装包。
check查验跨平台应用开发环境。
clean清理跨平台应用编译结果。
config设置ACE工具链相关配置，包括OpenHarmony SDK路径、HarmonyOS SDK路径、Android SDK路径、Node.js路径、编译输出路径等。
create创建一个新的跨平台应用或者模块(Module)。
devices列出所有连接的设备。
install将跨平台应用安装到连接的设备上。
launch在设备上运行跨平台应用。
log滚动展示正在运行的跨平台应用的日志。
run运行跨平台应用包。
test执行跨平台应用包单元测试。
uninstall将跨平台应用从设备上卸载。 HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

搜狗高速浏览器截图20240326151450.png

提示内容：

ohos@user % ace help
Manage your ArkUI cross-platform app development.

Common commands:

  ace create
  Create a new ArkUI cross-platform project in the specified directory.

  ace run
  Run your ArkUI cross-platform application on an attached device or in an emulator.

Usage: ace <command> [options]

Options:
  -V, --version          output the version number
  -d, --device <device>  Input device id to specify the device to do something.
  -h, --help             display help for command

Available commands:

Application:
  install                Install an ArkUI cross-platform app on an attached device.
  launch                 Launch your ArkUI cross-platform app on an attached device.
  log                    Show log output for running ArkUI cross-platform apps.
  run                    Run your ArkUI cross-platform app on an attached device.
  test                   Run ArkUI cross-platform unit tests for the current project.
  uninstall              Uninstall an ArkUI cross-platform app on an attached device.

Device:
  devices                List the connected devices.

Environment:
  check                  Show information about the installed tools.
  config                 Configure ArkUI cross-platform settings.

Project:
  build                  Build an executable app or install a bundle.
  clean                  Delete the build/ directories.
  create                 Create a new ArkUI cross-platform project.
  new                    Create a new ability or module for your project.

Run "ace help <command>" for more information about a command.

鸿蒙语言有TS、ArkTS等语法，那么除了这些基础知识之外，其核心技术点有那些呢？下面就用一张整理出的鸿蒙学习路线图表示：

从上面的OpenHarmony技术梳理来看，鸿蒙的学习内容也是很多的。现在全网的鸿蒙学习文档也是非常的少，下面推荐一些：完整内容可在头像页保存，或这qr23.cn/AKFP8k甲助力

内容包含：《鸿蒙NEXT星河版开发学习文档》

  • ArkTS
  • 声明式ArkUI
  • 多媒体
  • 通信问题
  • 系统移植
  • 系统裁剪
  • FW层的原理
  • 各种开发调试工具
  • 智能设备开发
  • 分布式开发等等。

这些就是对往后开发者的分享，希望大家多多点赞关注喔！

悦读

道可道，非常道；名可名，非常名。 无名，天地之始，有名，万物之母。 故常无欲，以观其妙，常有欲，以观其徼。 此两者，同出而异名，同谓之玄，玄之又玄，众妙之门。

最新收录
c语言程序不用编译即可被计算机识别运行,C语言程序设计-中国大学mooc-题库零氪...
遍历列表易错点
vue获取当前位置信息
Android7以上抓取https数据包-无需root
攻防演练学习之浅析ATT&CK和Cyber Kill Chain
跨语言的智能：在多种编程环境中部署Mojo模型
【运维知识大神篇】运维界的超神器Kubernetes教程15（数据持久化详解：Persistent Volume+Persistent Volume Claim+Storage Class）
扩展DropDownList控件和ListBox控件(1) - 支持分组功能(optgroup标签)
基本概念------Hadamard product / Element-wise multiplication / Element-wise product /Point-wise product
linux命令之crontab详解
;