HarmonyOS 鸿蒙Next中如何使用本地static library中的第三方框架

【背景知识】

当HAR引用三方库时，需要确保三方库被初始化。因此，首先在HAR包中封装一个初始化三方库的方法并暴露出去，其次需要宿主应用在适当的时候（如应用启动时）调用该初始化方法，并传递正确的参数。

步骤包括：

• 在HAR包中暴露一个初始化方法，接收Context参数。
• 宿主应用在UIAbility的onCreate方法中调用这个初始化方法。

注意事项：

• HAR的独立性限制：HAR作为静态共享包，无法直接访问应用级上下文（如UIAbility），需通过接口暴露与主工程交互。
• 初始化时序控制：若三方库依赖UI渲染前完成初始化，建议在EntryAbility的onWindowStageCreate()前调用。

【解决方案】

在HAR包中初始化三方库，以初始化三方库harmony-utils的AppUtil.init()方法为例，需要以下两个步骤：

步骤一：在HAR中封装并暴露初始化方法initAppUtil()，在其内部调用AppUtil.init()；initAppUtil()需由主工程在UIAbility的生命周期中主动触发。

• 通过export导出initAppUtil()，示例如下所示：

// library/src/main/ts/HarInitializer.ets
import { AppUtil } from "@pura/harmony-utils";
import { common } from "@kit.AbilityKit";
export function initAppUtil(context: common.UIAbilityContext): void {
  AppUtil.init(context); // 触发harmony-utils初始化
}

• HAR对外暴露的接口，在Index.ets导出文件中声明如下所示：

// library/Index.ets
export { initAppUtil } from './src/main/ets/HarInitializer';

步骤二：在宿主模块的EntryAbility.ets中，通过onCreate()或onWindowStageCreate()调用HAR暴露的初始化接口。

• ‌配置HAR包依赖‌：在宿主模块的oh-package.json5中声明对自定义HAR包的依赖，如下所示：

"dependencies": {
  "library": "file:../library"
}

• 在UIAbility的onCreate生命周期中调用HAR包的初始化方法，传递当前上下文，如下所示：

// EntryAbility.ets（主工程）
import { AbilityConstant, common, ConfigurationConstant, UIAbility, Want } from '@kit.AbilityKit';
import { initAppUtil } from 'library';

export default class EntryAbility extends UIAbility {
  onCreate(): void {
    let context = getContext(this) as common.UIAbilityContext; 
    initAppUtil(context); // 手动初始化
  }
  // ...
}