【HarmonyOS】ArkUI-X 跨平台框架入门详解(一) 原创

GeorgeGcs
发布于 2025-7-15 18:32
浏览
0收藏

【HarmonyOS】ArkUI-X 跨平台框架入门详解(一)

一、前言

1、ArkUI-X框架是什么?

ArkUI-X是在ArkUI开发框架的基础上,进行扩展。支持多个OS平台,目前支持OpenHarmony、HarmonyOS、Android、 iOS。
【HarmonyOS】ArkUI-X 跨平台框架入门详解(一)-鸿蒙开发者社区
2、ArkUI-X目前的能力现状:
在gitCode可以查询到跨平台框架的源码和使用说明等。不过目前维护推进速度比较慢,很多ArkUI上的API在框架上还不支持。并且安卓上操作效果也一般。

二、配置开发环境

1、以Android端开发为例,Android开发环境这里就不赘述了,可以当官方去看下。目前Android更新还是非常快,但是编译环境还是依旧和当年不相上下。

2、DevEco IDE下载ArkUI-X的SDK:
File - Setting 选择 ArkUI-X,选择下载地址路径,选择自己需要的SDK版本。
【HarmonyOS】ArkUI-X 跨平台框架入门详解(一)-鸿蒙开发者社区

3、配置ACE Tool (ArkUI Cross-Platform Environment)的环境变量


在Path系统环境变量,新增arkui-x的tolchains-bin地址即可,示例:
D:\CodeAPP\DevEcoStudio\ArkUI-X-SDK\17\arkui-x\toolchains\bin

【HarmonyOS】ArkUI-X 跨平台框架入门详解(一)-鸿蒙开发者社区
4、检查ACE Tool的环境


ace check -v


5、检查多平台环境变量
【HarmonyOS】ArkUI-X 跨平台框架入门详解(一)-鸿蒙开发者社区

三、创建DEMO工程

1、在File-Project-Create Project,选择Application中的ArkUI-X Emptry Ability 示例项目:
【HarmonyOS】ArkUI-X 跨平台框架入门详解(一)-鸿蒙开发者社区
2、编译ArkUI-X框架项目:
在项目结构上看,与普通鸿蒙项目区别不大,只是多了arkui-x的文件夹。
DevEco Studio可打包生成不同平台的应用包。在主菜单栏,单击Build > Build Hap(s)/APP(s) > Build APP(s)。
当插入设备编译时,会检查环境,如有提示弹框,根据提示进行配置:
【HarmonyOS】ArkUI-X 跨平台框架入门详解(一)-鸿蒙开发者社区
3、编译项目后,使用Ace或者AndroidStudio安装apk到安卓手机。
【HarmonyOS】ArkUI-X 跨平台框架入门详解(一)-鸿蒙开发者社区

@Entry
@Component
struct Index {
  @State message: string = 'Hello World';

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize($r('app.float.page_text_font_size'))
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            this.message = 'Welcome ArkUI-X';
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}

我们可以看到示例项目中,page页面内的写法,与普通鸿蒙ArkTS写法是一致。跨平台处理都在arkui-x文件中:
【HarmonyOS】ArkUI-X 跨平台框架入门详解(一)-鸿蒙开发者社区

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
收藏
回复
举报
回复
    相关推荐