跨Android、iOS、鸿蒙多平台框架ArkUI-X

ArkUI是一套构建分布式应用界面的声明式UI开发框架。它使用极简的UI信息语法、丰富的UI组件、以及实时界面预览工具，帮助您提升移动应用界面开发效率30%。您只需使用一套ArkTS API，就能在Android、iOS、鸿蒙多个平台上提供生动而流畅的用户界面体验。

一、配套关系

表1 版本软件和平台配套关系

目标平台	项目编译使用OS SDK版本	备注
OpenHarmony	4.0 (API Version 10)	Beta2
Android	Android 8+ (API level 26+)	NA
iOS	iOS 10+	NA

二、SDK获取

表2 获取SDK路径列表

SDK版本	版本信息	下载站点	SHA256校验码
ArkUI-X SDK包（macOS）	1.0.0 Canary1	站点	SHA256校验码
ArkUI-X SDK包（macOS-M1）	1.0.0 Canary1	站点	SHA256校验码
ArkUI-X SDK包（Windows）	1.0.0 Canary1	站点	SHA256校验码
ArkUI-X SDK包（Linux）	1.0.0 Canary1	站点	SHA256校验码

三、Samples

表3 Samples列表

项目名称	简介
HelloWorld	HellWorld应用工程示例，支持Android、iOS和OpenHarmony应用构建。
Shopping	仿购物应用工程示例，支持Android、iOS和OpenHarmony应用构建。
HealthyDiet	健康饮食应用工程示例，支持Android、iOS和OpenHarmony应用构建。
Native	NAPI应用工程示例，支持Android、iOS和OpenHarmony应用构建。
Library	平台库应用工程示例，支持Android、iOS和OpenHarmony应用构建。

四、开发工具

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

五、环境准备

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

配置Node.js环境

运行ACE Tools和OpenHarmony SDK需Node.js环境支持，建议下载14.19.1 - 16.19.1版本。可命令行运行 node -v 查看本地Node.js版本，如不存在或版本不符合要求，请自行下载安装稳定版本：Node.js下载地址，并配置到环境变量。

配置Java环境

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

[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

配置ohpm环境

OHPM CLI（OpenHarmony Package Manager Command-line Interface）是OpenHarmony应用工程的三方库的包管理工具，可通过DevEco Studio > File > Settings > Build, Execution, Deployment > Ohpm 查看ohpm home的安装路径，并配置到环境变量中。

配置ArkUI-X SDK环境

ArkUI-X SDK下载路径，可通过DevEco Studio > File > Settings > ArkUI-X（macOS为DevEco Studio > Preferences > ArkUI-X）查看ArkUI-X的下载路径，并配置到环境变量中。推荐环境变量配置如下：

[macOS]

// 配置环境变量  
export ARKUIX_SDK_HOME=/path-to-arkui-x-sdk

[Windows]

// 配置环境变量  
set ARKUIX_SDK_HOME=/path-to-arkui-x-sdk

六、命令安装

安装ace命令

修改npm源，前往用户目录，在.npmrc文件中添加如下内容：

@ohos:registry=https://repo.harmonyos.com/npm/  
registry=https://repo.huaweicloud.com/repository/npm/

全局安装ACE命令

cd arkui-x/toolchains/ace_tools    // 根据ArkUI-X SDK下载路径，进入ACE Tools实际所在目录。  
npm install  
npm install . -g

七、开发环境检查

ace check

执行 ace check 命令可以检查ArkUI-X应用本地开发环境是否完备。

注：开发环境检查主要针对Android/iOS/OpenHarmony/HarmonyOS IDE以及对应SDK的默认安装和下载路径进行检查。如果提示结果与实际不符，请您通过ace config命令指定实际的IDE安装和SDK下载路径。

八、创建应用

以创建一个 Stage模型‘demo’项目为例：

ace create project  
? Please enter the project name: demo  
? Please enter the bundle name (com.example.demo):com.example.demo  
? Please enter the system (1: OpenHarmony, 2: HarmonyOS): 1  
? Please enter the project type (1: Application, 2: Library): 1  
? Please enter the template (1: Empty Ability, 2: Native C++): 1   //选择创建Empty Ability或者Native C++项目

执行 `ace create project` 命令，接着输入工程名 demo。

九、应用运行

安装运行到Android设备

cd demo  
ace run apk

安装运行到iOS设备

cd demo  
ace run app

安装运行到OpenHarmony设备

cd demo  
ace run hap

上述命令会完成应用构建打包，并安装到目标平台设备运行。

审核编辑 黄宇