ArkUI-X在Android平台动态化开发指南

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

适用场景

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

场景1:框架动态化,为了降低应用ROM体积占用,及满足动态升级框架目的;

场景2:特性Bundle动态化,特性和宿主应用发布解耦;

开发指南

目录说明

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

plain 复制代码
/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

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

注意:初始化必须在主线程调用。

java 复制代码
appDelegate = new StageApplicationDelegate();
appDelegate.initApplication(this)

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