ArkUI-X创建跨平台应用工程的命令
如何用ArkUI-X创建跨平台应用工程。
ace create project
创建跨平台应用工程。
如果项目已存在,提示并询问开发者是否删除当前项目。
创建过程中,需要开发者依次填写工程名称和包名称,如果开发者不输入包名称,默认为com.example.工程名。
语法:
ace create project
删除已有项目提示:
The project already exists. Do you want to delete the directory (Y / N):
删除已有项目成功:
Delete directory successfully, creating new project...:
删除已有项目失败:
Failed to create project, project directory already exists!
提示输入工程名称:
Please input project name: nust
提示输入包名:
Please input package name: com.example.${projectName}: com.jianguo.nust
提示输入RuntimeOS系统:
Please enter the system (1: OpenHarmony, 2: HarmonyOS): 1
提示输入项目模板:
Please enter the template (1: Empty Ability, 2: Native C++): 1
创建完成:
Project created successfully! Target directory:${projectName}
ace build
构建跨平台应用安装包。
语法:
ace build [options] [fileType]
在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上无法签名。
options
子命令说明--target [moduleName]指定目标模块名进行构建。-r --release构建应用程序的类型为release(默认为release)。--debug构建应用程序的类型为debug。--nosign构建出未签名的应用程序(仅App)。-h --help显示帮助信息。
fileType
参数说明hap生成OpenHarmony/HarmonyOS应用 hap 包,fileType未输入时,默认参数为hap。apk生成Android应用 apk 包。app生成iOS应用 app 包。aar生成Android应用 aar 包。framework生成iOS应用 framework 包。xcframework生成iOS应用 xcframework 包。
构建完成,提示包生成路径:
Build hap successfully.
filepath: /Users/ohos/WorkSpace/demo/ohos/entry/build/default/outputs/default
比如在安卓平台
Android 工程编译
对Android工程编译时,ACE Tools或DevEco Studio会完成两个步骤:
集成ArkUI-X SDK Android工程集成ArkUI-X SDK遵循Android应用工程集成Jar和动态库规则,即SDK组成清单中的arkui_android_adapter.jar包拷贝到libs目录,动态库(libarkui_android.so\libhilog_android.so\libhilog.so\libresourcemanager.so)会自动拷贝到libs/arm64-v8a目录。
集成ArkUI-X应用编译产物 ArkUI-X编译产物生成后,拷贝到Android应用工程assets/arkui-x目录下。这里“arkui-x”目录名称是固定的,不能更改;详情参见
ace build --debug apk
如何用ArkUI-X运行跨平台应用包
ace run
运行跨平台应用包。
ace run 先检查设备是否连接,确定设备类型,然后执行跨平台应用构建、安装、启动、输出应用进程log等操作。
在Windows平台上可以构建安装并运行Hap和Apk,在Linux平台上可以构建安装并运行Apk,仅能构建Hap,在Mac平台上可以构建安装并运行Hap、Apk和App。
语法:
ace run [options] [fileType]
options
子命令说明-d [deviceId]指定运行应用的设备Id。--device [deviceId]指定运行应用的设备Id。
fileType
参数说明hap构建并运行OpenHarmony/HarmonyOS应用 hap 包,fileType未输入时,默认参数为hap。apk构建并运行Android应用 apk 包。app构建并运行iOS应用 app 包。
比如我现在要运行到android平台上。
ace run --device 4HDVB22721000372 apk