鸿蒙ArkUI-X跨平台技术：【SDK结构介绍】

最新推荐文章于 2025-07-15 18:05:47 发布

移不动开发技术

最新推荐文章于 2025-07-15 18:05:47 发布

阅读量1.3k

点赞数 17

CC 4.0 BY-SA版权

分类专栏：鸿蒙开发文章标签： harmonyos 鸿蒙开发移动开发程序员 ArkUI 鸿蒙鸿蒙系统

本文链接：https://blog.csdn.net/m0_62167422/article/details/138976974

ArkUI-X SDK目录结构介绍

简介

本文档配套ArkUI-X，将OpenHarmony ArkUI开发框架扩展到不同的OS平台，比如Android和iOS平台，让开发者基于ArkUI，可复用大部分的应用代码（UI以及主要应用逻辑）并可以部署到相应的OS平台，降低跨平台应用开发成本。

SDK获取

SDK获取可参见[版本说明]
开发前请熟悉鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

开发工具集成

ACE Tools命令行集成 ACE Tools作为ArkUI跨平台应用构建的命令行工具，通过集成ArkUI-X SDK具有创建、编译构建OpenHarmony/HarmonyOS、Android和iOS应用的能力。
DevEco Studio集成 DecEco Studio作为ArkUI跨平台应用构建的IDE工具，通过集成ArkUI-X SDK支持一键构建出OpenHarmony/HarmonyOS应用、Android应用、iOS应用的能力。

ArkUI-X SDK构建规则

SDK压缩包命名规则

ArkUI-X编译构建流水线出包时，需按照SDK命名规则进行打包，命名规则如下：

path_操作系统类型_CPU架构类型_版本号_releaseType.zip

表1 SDK规则字段说明

字段	描述
path	取值为SDK根目录元数据arkui-x.json文件中的path标签内容。
操作系统类型	可选值：windows，darwin，linux。
CPU架构类型	可选值："x64"-x86架构，"arm64"-arm架构。
版本号	构建版本号与OpenHarmony SDK版本号规则保持一致。
releaseType	可选值：Canary，Beta，Release三种可选取值。releaseType后面加数字，标识迭代次数，比如：Beta1。

示例： arkui-x_windows_x64_1.0.0.0_Release.zip

SDK压缩包内部结构

这里，以macOS平台上的ArkUI-X SDK包为例，对SDK目录结构和内容规格进行说明。更详细的ArkUI-X SDK内容规格会在第五节进行介绍。

arkui-x_darwin_x64_1.0.0.0_Release.zip
└── arkui-x
    ├── engine                   // ArkUI-X的引擎库
    │   ├── lib                  // ArkUI-X的引擎库：包括Android平台及架构的动态库
    │   ├── framework            // ArkUI-X的引擎库：包括iOS平台及架构的Framework库
    │   ├── xcframework          // ArkUI-X的引擎库：包括iOS平台及架构的XCFramework库
    │   ├── ets                  // ArkUI-X增量接口，比如：@arkui-x.bridge
    │   ├── apiConfig.json       // engine库配置文件，用于IDE和ACE Tools解析，以支持应用构建按需打包。
    │   └── systemres            // ArkUI-X框架自带的资源
    ├── plugins                  // ArkUI-X官方提供的插件库
    │   ├── component            // ArkUI组件插件库
    │   └── api                  // @ohos接口插件库，apiConfig.json
    ├── toolchains               // ArkUI-X应用开发工具，比如：ACE Tools。
    ├── sdkConfig.json           // 增量d.ts路径和接口前缀配置
    ├── arkui-x.json             // SDK管理配置，流水线自动生成
    └── NOTICE.txt

ArkUI-X SDK引擎目录结构

ArkUI-X应用构建最小依赖集合，位于arkui-x_darwin_x64_1.0.0.0_Release.zip/arkui-x/engine目录：

engine
├── lib
│   ├── include
│   ├── arkui
│   │   ├── arkui_android_adapter.jar
│   │   ├── android-arm
│   │   ├── android-arm-profile
│   │   ├── android-arm-release
│   │   ├── android-arm64
│   │   ├── android-arm64-profile
│   │   ├── android-arm64-release
│   │   └── android-x86_64
│   ├── third_party                        // 内部目录同arkui
│   └── utils                              // 内部目录同arkui
├── framework
│   ├── arkui
│   │   ├── ios-arm64
│   │   ├── ios-arm64-profile
│   │   ├── ios-arm64-release
│   │   ├── ios-arm64-simulator
│   │   └── ios-x86_64-simulator
│   ├── third_party
│   └── utils
├── xcframework
│   ├── arkui
│   │   ├── ios
│   │   │   └── libarkui_ios.xcframework
│   │   │       ├── Info.plist
│   │   │       ├── ios-arm64
│   │   │       └── ios-arm64_x86_64-simulator
│   │   ├── ios-profile
│   │   │   └── libarkui_ios.xcframework
│   │   │       ├── Info.plist
│   │   │       ├── ios-arm64
│   │   │       └── ios-arm64_x86_64-simulator
│   │   └── ios-release
│   │       └── libarkui_ios.xcframework
│   │           ├── Info.plist
│   │           ├── ios-arm64
│   │           └── ios-arm64_x86_64-simulator
│   ├── third_party                          // 内部目录同arkui
│   └── utils                                // 内部目录同arkui
├── ets
│   └── @arkui-x.bridge.d.ts
├── apiConfig.json
└── systemres

ArkUI-X SDK插件目录结构

ArkUI-X应用按需打包插件库集合，位于arkui-x_darwin_x64_1.0.0.0_Release.zip/arkui-x/plugins目录：

plugins
├── component
│   ├── lib
│   │   ├── include
│   │   └── ${ui-name}                                        // 一个UI组件一个目录
│   │       ├── ${ui-name}.jar
│   │       ├── android-arm
│   │       ├── android-arm-profile
│   │       ├