当前位置：首页 > news >正文

初识鸿蒙跨平台开发框架ArkUI-X

news 2025/9/27 13:43:14

HarmonyOS是一款面向万物互联时代的、全新的分布式操作系统。在传统的单设备系统能力基础上，HarmonyOS提出了基于同一套系统能力、适配多种终端形态的分布式理念，能够支持手机、平板、智能穿戴、智慧屏、车机等多种终端设备，提供全场景（移动办公、运动健康、社交通信、媒体娱乐等）业务能力。

ArkTS 是华为自研的开发语言。它在TypeScript（简称TS）的基础上，匹配 ArkUI 框架，扩展了声明式 UI 、状态管理等相应的能力，让开发者以更简洁、更自然的方式开发跨端应用。关于ArkTS，可以参考：ArkTS基础知识

ArkUI-X 进一步将 ArkUI 扩展到了多个 OS 平台：目前支持 OpenHarmony、HarmonyOS、Android、iOS，后续会逐步增加更多平台支持。到时，开发者就可以基于一套主代码，就能够构建支持多平台应用。以下是ArkUI跨平台框架整体架构的示意图。

一、环境搭建

1.1 下载IDE

DevEco Studio

首先，需要下载支持 ArkUI-X 套件的华为开发工具 DevEco ，版本为 4.0 以上，目前只能下载预览版进行体验。下载地址：

软件	版本	备注
OpenHarmony	4.0 Beta2	NA
Public SDK	Ohos_sdk_public 4.0.9.6 (API Version 10 Beta2)	面向应用开发者提供，不包含需要使用系统权限的系统接口。通过DevEco Studio默认获取的SDK为Public SDK。
HUAWEI DevEco Studio（可选）	4.0 Beta2	OpenHarmony应用开发推荐使用。获取方式：Windows(64-bit)SHA256校验码：ae9b228fb1f79e99441e10bdcf347ebfc42266be8b170bbce3c9764ba32d82a4Mac(X86)SHA256校验码：5c9afc5b1262868b58376155f1e8576d33c1ade8b01091edc4d7d397cd34026cMac(ARM)SHA256校验码：ea6c98cafd5036e4a6fd46b0b1cde3a306953b1eef423d5940f1af7c632205d6
HUAWEI DevEco Device Tool（可选）	4.0 Beta1	OpenHarmony智能设备集成开发环境推荐使用。获取方式：点击跳转至下载页面

下载完成之后，安装就可以了，这东西是基于 IDEA 做的，和 Android Studio 体验差不多。

Android Studio

由于ArkUI-X 可以将 ArkTS 项目编译为一个 Android 项目，需要需要使用 Android Studio 来进行打包。Android Studio 安装方法就不赘述了。下载地址：

Download Android Studio & App Tools - Android Developers (google.cn)

同样，我们可以需要搭建iOS的原生环境，下载Xcode等，不再过多的说明。

1.2 安装OpenHarmony SDK

安装完后，当我们启动DevEco Studio工具的时候，系统提示我们需要安装Node，这是因为HarmonyOS应用程序也支持使用JS进行开发，我们只需要按照提示进行安装即可，如下图。

相关依赖下载完成，进入 IDE 首页后，先不急着创建项目，需要先安装 OpenHarmony SDK，类似于Android的SDK。

然后，打开Preferences面板，选择OpenHarmony，如下图。

选择后需要指定一下路径，然后它会进行一些依赖下载，等它下载完成。下载完成后，勾选 API Version 10 相关的选项，点击确定等它下载完成。

1.3 安装 ArkUI-X SDK

OpenHarmony SDK 安装完成后，接下来还需要安装 ArkUI-X SDK，了。同样的在设置里面选择 ArkUI-X ，指定路径，等待下载完成。

1.4 环境变量

ArkUI-X 需要设置好相应的环境变量才能正确使用。若缺少相关环境变量，会有弹窗提示。所以在装好 Android Studio 后，需要将 Android SDK 添加至环境变量中（如果之前添加过，就不用管了）：

Windows

在此【电脑】 >【属性】 > 【高级系统设置】 > 【高级】 > 【环境变量】中，新建系统变量。变量名为ANDROID_HOME，变量值为Android SDK安装目录。

macOS

打开终端工具，执行以下命令，打开.bash_profile文件，然后配置Android SDK安装目录，命令如下：

vi ~/.bash_profile
export ANDROID_HOME=/Users/xxx/Library/Android/sdk
source ~/.bash_profile

环境变量配置完成后，关闭并重启DevEco Studio。

二、快速上手

2.1 创建工程

首先，我们创建一个普通的Harmony OS工程，如下图。

然后，按照提示填写工程名、包名、编译环境等内容。

在创建了一个 Harmon OS 工程后，我们就进入到了 IDE 的实际界面，在此就可以找到创建 OpenHarmony 工程的选项。为什么要 OpenHarmony 呢？首先要认识到 HarmonOS 和 OpenHarmony 的区别。

这个具体区别大家可以自己去对比下工程结构，可能会被当做引战引起某些人不满意，当然我们可以理解为是借鉴，此处只说明一点 ArkUI-X 是基于 OpenHarmony 的技术。

我们在上面菜单栏选择【File】->【New】-> 【Import - Import Sample】，如下图。

然后，系统会让我们选择导入的Sample，此处选择 OpenHarmony 以及ArkUI-X 下的 HelloWorld。

接着，系统会去下载对应的依赖。不过，我执行导入的时候，遇到了一个网络超时的问题，所以我直接下载了源码，然后再本地导入。

源码的下载链接如下：https://gitee.com/arkui-x/samples

依赖安装完成，在右上角选择 Previewer ，点击【运行】按钮，就可以通过 OpenHarmony 预览界面进行预览。

2.2 移入代码

回到之前创建的 Harmony OS 工程，将里面的 UI 代码移入到OpenHarmony工程中。首先，进入 Harmony OS 工程的 entry - src - main 目录，复制里面的 ets、resources 和module.json5文件。然后替换OpenHarmony工程中对应的三个文件，也可以直接覆盖。

然后，再次预览并运行OpenHarmony工程，就可以看到之前通过 Harmony OS 工程模板创建的界面显示在了这个 OpenHarmony 预览界面上，如下图。

2.3 编译 OpenHarmony 工程

打开OpenHarmony工程，在 DevEco 菜单栏，选择 Build App，在编译为 OpenHarmony App 的同时，也会生成 Android 与 IOS 项目。

编译完成后，可以看到生成的 Android 工程了，如下图。

2.4 在 Android 环境运行

由于 ArkUI-X 编译出来的为 native 文件只能运行在ARM环境上，所以Android Studio 提供的模拟器如果为 x64 架构是无法预览程序的。

接着，将上述生成的 Android 工程使用 Android Studio打开，等待 Gradle 初始化完成，并编译完成，如下图。

然后，我们就可以使用Android Studio来运行项目，也可以使用Android Studio打包apk。

同样的，我们也可以使用Xcode来打开iOS的源码，运行以及打包。

三、应用工程结构

3.1 工程目录结构

跨平台应用工程目录结构，包含一套为ArkUI开发者提供的应用工程模板，提供构建OpenHarmony应用，HarmonyOS应用，Android应用，iOS应用的能力。工程结构目录如下：

ArkUI-X应用工程目录结构├── .arkui-x│   ├── android                 // Android平台相关代码│   └── ios                     // iOS平台相关代码├── .hvigor├── .idea├── AppScope├── entry├── hvigor├── oh_modules├── build-profile.json5├── hvigorfile.ts├── local.properties└── oh-package.json5

此应用目录结构设计思想是从OpenHarmony应用工程原生支持跨平台角度出发，在OpenHarmony应用工程之上叠加Android和iOS应用工程，ArkTS代码和resources资源在OpenHarmony侧完成编译，Native代码仍在各自平台应用工程中完成编译。

3.2 编译构建

理解OpenHarmony应用工程的编译构建需要理解几个概念：

ArkTS源码：ArkTS源码通过OpenHarmony SDK工具链生成abc（Ark Byte Code），并分别拷贝到Android和iOS应用工程，作为平台应用资源进行管理。
ArkUI应用资源：ArkUI Resources资源也通过OpenHarmony SDK工具链进行编译，编译后的ArkUI资源分别拷贝到Android和iOS应用工程，作为平台应用资源进行管理。
ArkUI框架资源：ArkUI框架资源随ArkUI-X SDK进行发布，应用构建时会自动打包到ArkUI-X应用中，可保证ArkUI-X应用在各平台上UX渲染一致性。

综上所述，Android平台上通过assets管理ArkTS编译产物、ArkUI应用资源和ArkUI框架资源，iOS平台上通过Bundle Resources管理ArkTS编译产物、ArkUI应用资源和ArkUI框架资源。

下面说一下原生应用工程结构：

Android应用工程结构

ArkUI-X Android应用工程
├── app
│   ├── libs
│   │   ├── arkui_android_adapter.jar                   // ArkUI-X跨平台适配层，在SDK中发布
│   │   └── arm64-v8a
│   │       └── libarkui_android.so                     // ArkUI-X跨平台引擎库，在SDK中发布
│   ├── src
│   │   ├── androidTest
│   │   ├── main
│   │   │   ├── assets
│   │   │   │   └── arkui-x                             // ArkUI应用编译后的字节码文件和Resources，作为资源文件存放在assets/arkui-x中
│   │   │   │       ├── entry                           // ArkUI单个模块的编译结果
│   │   │   │       │   ├── ets                         // ArkUI单个模块代码的编译结果：包括字节码文件以及sourceMap文件
│   │   │   │       │   │   ├── sourceMaps.map
│   │   │   │       │   │   └── modules.abc
│   │   │   │       │   ├── resources.index             // ArkUI单个模块资源的编译结果：resources资源的编译结果
│   │   │   │       │   ├── resources                   // resources资源中的rawfile资源，不会进行编译。
│   │   │   │       │   └── module.json
│   │   │   │       ├── entry_test                      // ohosTest，仅仅Debug模式构建包含。
│   │   │   │       └── systemres                       // ArkUI框架自带的系统资源
│   │   │   ├── java/com/example/mayapp
│   │   │   │   ├── MyApplication.java                  // 基于StageApplication扩展MyApplication
│   │   │   │   └── EntryEntryAbilityActivity.java      // 基于StageActivity扩展EntryEntryAbilityActivity
│   │   │   ├── res
│   │   │   └── AndroidManifest.xml
│   │   └── test
│   ├── build.gradle
│   └── proguard-rules.pro
├── gradle/wrapper
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
└── settings.gradle

iOS应用工程结构

ArkUI-X iOS应用工程
├── app.xcodeproj
│   ├── project.xcworkspace
│   └── project.pbxproj
├── app
│   ├── Assets.xcassets
│   ├── Base.Iproj
│   ├── AppDelegate.h
│   ├── AppDelegate.m                               // 应用入口, 驱动StageApplication的生命周期
│   ├── EntryEntryAbilityViewController.m           // 基于StageViewController扩展EntryEntryViewController
│   ├── Info.plist
│   └── main.m
├── arkui-x                                         // ArkUI应用编译后的字节码文件和Resources，作为资源文件存放在assets/arkui-x中
│   ├── entry                                       // ArkUI单个模块的编译结果
│   │   ├── ets                                     // ArkUI单个模块代码的编译结果：包括字节码文件以及sourceMap文件
│   │   │   ├── sourceMaps.map
│   │   │   └── modules.abc
│   │   ├── resources.index                         // ArkUI单个模块资源的编译结果：resources资源的编译结果
│   │   ├── resources                               // resources资源中的rawfile资源，不会进行编译。
│   │   └── module.json
│   ├── entry_test                                  // ohosTest，仅仅Debug模式构建包含。
│   └── systemres                                   // ArkUI框架自带的系统资源
└── frameworks                                      // ArkUI跨平台Framework动态库：包含ArkUI-X的框架以及插件

关于华为 ArkTS + ArkUI-X 跨平台开发框架的基础知识就介绍到这里，从中我看到了React Native、flutter的影子，事实上，从官方给出的架构图也能看到它们的影子，毕竟站在巨人的肩膀上，才能看的更远。相信，随着鸿蒙的崛起，ArkTS + ArkUI-X技术的到来，国产自研技术将不再是 PPT ，不再是“套壳”。

文中涉及的代码链接如下：https://gitee.com/arkui-x/samples

参考链接：

https://gitee.com/arkui-x
https://juejin.cn/post/7253240772840701989