ArkUI-X在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里初始化框架，提前完全引擎库加载，提高跨平台模块加载速度；