動(dòng)態(tài)化介紹

簡(jiǎn)介

ArkUI-X支持動(dòng)態(tài)化，使用者可以根據(jù)自己需要?jiǎng)討B(tài)發(fā)布跨平臺(tái)內(nèi)容，從而使跨平臺(tái)部分和宿主應(yīng)用進(jìn)行解耦。動(dòng)態(tài)化能力支持如下兩個(gè)典型場(chǎng)景：

1. 框架動(dòng)態(tài)化：指ArkUI跨平臺(tái)開(kāi)發(fā)框架本身可以做到動(dòng)態(tài)下發(fā)，即應(yīng)用發(fā)布時(shí)可以不帶框架基礎(chǔ)庫(kù)，降低應(yīng)用原始發(fā)布包體積，在需要時(shí)才從云端動(dòng)態(tài)下發(fā)和執(zhí)行加載；
2. 特性動(dòng)態(tài)化：指用ArkTS語(yǔ)言開(kāi)發(fā)的特性可以做到動(dòng)態(tài)化，和宿主應(yīng)用解耦，獨(dú)立發(fā)布、升級(jí)版本；

說(shuō)明 ：應(yīng)用在使用動(dòng)態(tài)化能力時(shí)需要遵循目標(biāo)終端操作系統(tǒng)應(yīng)用上架規(guī)則，如果違規(guī)可能有下架風(fēng)險(xiǎn)，風(fēng)險(xiǎn)由各自應(yīng)用承擔(dān)。 開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

實(shí)踐參考

• [Android平臺(tái)動(dòng)態(tài)化開(kāi)發(fā)指南]

Android平臺(tái)動(dòng)態(tài)化開(kāi)發(fā)指南

簡(jiǎn)介

本文介紹如何在Android平臺(tái)進(jìn)行ArkUI-X動(dòng)態(tài)化開(kāi)發(fā)，包括動(dòng)態(tài)化目錄規(guī)則及約束。

適用場(chǎng)景

動(dòng)態(tài)化主要包括兩個(gè)典型場(chǎng)景：

• 場(chǎng)景1：框架動(dòng)態(tài)化，為了降低應(yīng)用ROM體積占用，及滿足動(dòng)態(tài)升級(jí)框架目的；
• 場(chǎng)景2：特性Bundle動(dòng)態(tài)化，特性和宿主應(yīng)用發(fā)布解耦；

開(kāi)發(fā)指南

目錄說(shuō)明

動(dòng)態(tài)加載時(shí)要求應(yīng)用沙箱內(nèi)目錄架構(gòu)如下所示：

/data/data/應(yīng)用/files/arkui-x    
├── feature1                    # 跨平臺(tái)特性1
│   ├── ets                     # ets目錄
│   │   ├──sourceMaps.map
│   │   └──modules.abc
│   ├── resources.index         
│   ├── resources              
│   ├── module.json
│   └── libs                    # 特性bundle帶的so庫(kù)
│       ├── arm64-v8a
│       ├── armeabi-v7a
│       └── x86_64  
├── systemres                   # ArkUI公共資源
└── libs                        # 根目錄下libs庫(kù)
    ├── arm64-v8a               
    │    └──libarkui_android.so    # ArkUI-X引擎
    ├── armeabi-v7a           
    └── x86_64

1. /data/data/應(yīng)用/files/arkui-x 可以視為ArkUI-X動(dòng)態(tài)加載的沙箱根目錄，框架和特性Bundle均需要放在這個(gè)目錄下；
2. 根目錄下的libs文件夾放置引擎（libarkui_android.so），及其他公共庫(kù)；
3. 根目錄下要求按照module級(jí)別組織， 不可以重名 ；

   加載優(yōu)先級(jí)

• 引擎so庫(kù)：優(yōu)先加載應(yīng)用lib目錄下，如果未找到則去應(yīng)用沙箱根目錄加載；

• 插件so庫(kù)：優(yōu)先加載應(yīng)用lib目錄下，如果未找到則去應(yīng)用沙箱根目錄嘗試加載，最后去插件自身的libs目錄加載；

• module加載：優(yōu)先從應(yīng)用assets目錄下尋找，如果找不到則去沙箱內(nèi)嘗試加載；

• systemres加載：同上，優(yōu)先加載應(yīng)用assets目錄，找不到則去沙箱內(nèi)加載；
  注意 ：不建議應(yīng)用同一個(gè)module，即預(yù)制到應(yīng)用assets內(nèi)又在沙箱同時(shí)部署。

  框架初始化

  如果應(yīng)用使用了框架引擎動(dòng)態(tài)化，首次下載引擎庫(kù)后將其放置/data/data/應(yīng)用/files/arkui-x/libs/arm64-v8a

目錄，之后再打開(kāi)對(duì)應(yīng)跨平臺(tái)界面時(shí)初始化框架：

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

后續(xù)再打開(kāi)應(yīng)用，建議按照正常流程在Application里初始化框架，提前完全引擎庫(kù)加載，提高跨平臺(tái)模塊加載速度；

• [iOS平臺(tái)動(dòng)態(tài)化開(kāi)發(fā)指南]

iOS平臺(tái)動(dòng)態(tài)化開(kāi)發(fā)指南

簡(jiǎn)介

本文介紹如何在iOS平臺(tái)進(jìn)行ArkUI-X動(dòng)態(tài)化開(kāi)發(fā)，包括動(dòng)態(tài)化目錄規(guī)則及約束。

適用場(chǎng)景

由于iOS平臺(tái)AppStore不允許應(yīng)用動(dòng)態(tài)更新so庫(kù)，因此ArkUI-X在iOS上動(dòng)態(tài)化只能更新界面及業(yè)務(wù)邏輯構(gòu)成的abc，不支持so庫(kù)動(dòng)態(tài)加載。應(yīng)用需要將ArkUI-X基礎(chǔ)庫(kù)、插件及業(yè)務(wù)so庫(kù)提前打包到應(yīng)用內(nèi)上架。

開(kāi)發(fā)指南

目錄結(jié)構(gòu)

iOS平臺(tái)ArkUI-X沙箱內(nèi)目錄結(jié)構(gòu)如下所示：

/Data/Application/應(yīng)用/Documents/files/arkui-x    
├── feature1                    # 跨平臺(tái)特性1
│   ├── ets                     # ets目錄
│   │   ├──sourceMaps.map
│   │   └──modules.abc
│   ├── resources.index         
│   ├── resources              
│   └── module.json
└── systemres                   # ArkUI公共資源

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

1. /Data/Application/應(yīng)用/Documents/files/arkui-x可以視為ArkUI-X動(dòng)態(tài)加載的沙箱根目錄，特性Bundle需要放在這個(gè)目錄下；
2. 根目錄下要求按照module級(jí)別組織， 不可以重名 ；

加載優(yōu)先級(jí)

• module加載：優(yōu)先從應(yīng)用根目錄下尋找，如果找不到則去沙箱內(nèi)嘗試加載；
• systemres加載：同上，優(yōu)先加載應(yīng)用根目錄下的資源，找不到則去沙箱內(nèi)加載；
  注意 ：不建議應(yīng)用同一個(gè)module，即預(yù)制到應(yīng)用內(nèi)又在沙箱同時(shí)部署。

審核編輯 黃宇