跨Android、iOS、鸿蒙多平台框架ArkUI-X_鸿蒙 arkui-x 安卓 苹果

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

一、配套关系

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

二、SDK获取

表2 获取SDK路径列表

三、Samples

表3 Samples列表

四、开发工具

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

2. 配置Java环境

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

[macOS]

// 配置环境变量
export JAVA_HOME=/path-to-java-sdk
export PATH=$JAVA_HOME/bin:$PATH
1
2
3

[Windows]

// 配置环境变量  
set JAVA\_HOME\=/path-to-java-sdk  
set PATH\=%PATH%;%JAVA\_HOME%/bin
1
2
3

3. 配置ohpm环境

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

4. 配置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
1
2

[Windows]

// 配置环境变量  
set ARKUIX\_SDK\_HOME\=/path-to-arkui-x-sdk
1
2

六、命令安装

安装ace命令

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

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

• 全局安装ACE命令

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

七、开发环境检查

ace check
1

执行 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。
1
2
3
4
5
6
7
8

九、应用运行

• 安装运行到Android设备

cd demo  
ace run apk
1
2

• 安装运行到iOS设备

cd demo  
ace run app
1
2

• 安装运行到OpenHarmony设备

cd demo  
ace run hap
1
2

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