鸿蒙ArkUI-X跨语言调用说明：平台差异化【Android、ios动态化】

动态化介绍

简介

ArkUI-X支持动态化，使用者可以根据自己需要动态发布跨平台内容，从而使跨平台部分和宿主应用进行解耦。动态化能力支持如下两个典型场景：

1. 框架动态化：指ArkUI跨平台开发框架本身可以做到动态下发，即应用发布时可以不带框架基础库，降低应用原始发布包体积，在需要时才从云端动态下发和执行加载；
2. 特性动态化：指用ArkTS语言开发的特性可以做到动态化，和宿主应用解耦，独立发布、升级版本；

说明 ：应用在使用动态化能力时需要遵循目标终端操作系统应用上架规则，如果违规可能有下架风险，风险由各自应用承担。 开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

实践参考

• [Android平台动态化开发指南]

Android平台动态化开发指南

简介

本文介绍如何在Android平台进行ArkUI-X动态化开发，包括动态化目录规则及约束。

适用场景

动态化主要包括两个典型场景：

• 场景1：框架动态化，为了降低应用ROM体积占用，及满足动态升级框架目的；
• 场景2：特性Bundle动态化，特性和宿主应用发布解耦；

开发指南

目录说明

动态加载时要求应用沙箱内目录架构如下所示：

/data/data/应用/files/arkui-x    
├── feature1                    # 跨平台特性1
│   ├── ets                     # ets目录
│   │   ├──sourceMaps.map
│   │   └──modules.abc
│   ├── resources.index         
│   ├── resources              
│   ├── module.json
│   └── libs                    # 特性bundle带的so库
│       ├── arm64-v8a
│       ├── armeabi-v7a
│       └── x86_64  
├── systemres                   # ArkUI公共资源
└── libs                        # 根目录下libs库
    ├── arm64-v8a               
    │    └──libarkui_android.so    # ArkUI-X引擎
    ├── armeabi-v7a           
    └── x86_64

1. /data/data/应用/files/arkui-x 可以视为ArkUI-X动态加载的沙箱根目录，框架和特性Bundle均需要放在这个目录下；
2. 根目录下的libs文件夹放置引擎（libarkui_android.so），及其他公共库；
3. 根目录下要求按照module级别组织， 不可以重名 ；

   加载优先级

• 引擎so库：优先加载应用lib目录下，如果未找到则去应用沙箱根目录加载；

• 插件so库：优先加载应用lib目录下，如果未找到则去应用沙箱根目录尝试加载，最后去插件自身的libs目录加载；

• module加载：优先从应用assets目录下寻找，如果找不到则去沙箱内尝试加载；

• systemres加载：同上，优先加载应用assets目录，找不到则去沙箱内加载；
  注意 ：不建议应用同一个module，即预制到应用assets内又在沙箱同时部署。

  框架初始化

  如果应用使用了框架引擎动态化，首次下载引擎库后将其放置/data/data/应用/files/arkui-x/libs/arm64-v8a

目录，之后再打开对应跨平台界面时初始化框架：

appDelegate = new StageApplicationDelegate();
appDelegate.initApplication(this)

后续再打开应用，建议按照正常流程在Application里初始化框架，提前完全引擎库加载，提高跨平台模块加载速度；

• [iOS平台动态化开发指南]

iOS平台动态化开发指南

简介

本文介绍如何在iOS平台进行ArkUI-X动态化开发，包括动态化目录规则及约束。

适用场景

由于iOS平台AppStore不允许应用动态更新so库，因此ArkUI-X在iOS上动态化只能更新界面及业务逻辑构成的abc，不支持so库动态加载。应用需要将ArkUI-X基础库、插件及业务so库提前打包到应用内上架。

开发指南

目录结构

iOS平台ArkUI-X沙箱内目录结构如下所示：

/Data/Application/应用/Documents/files/arkui-x    
├── feature1                    # 跨平台特性1
│   ├── ets                     # ets目录
│   │   ├──sourceMaps.map
│   │   └──modules.abc
│   ├── resources.index         
│   ├── resources              
│   └── module.json
└── systemres                   # ArkUI公共资源

`HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`

1. /Data/Application/应用/Documents/files/arkui-x可以视为ArkUI-X动态加载的沙箱根目录，特性Bundle需要放在这个目录下；
2. 根目录下要求按照module级别组织， 不可以重名 ；

加载优先级

• module加载：优先从应用根目录下寻找，如果找不到则去沙箱内尝试加载；
• systemres加载：同上，优先加载应用根目录下的资源，找不到则去沙箱内加载；
  注意 ：不建议应用同一个module，即预制到应用内又在沙箱同时部署。

审核编辑 黄宇