HarmonyOS鸿蒙Next中在HAR包中自定义UIAbility供项目使用

HarmonyOS鸿蒙Next中在HAR包中自定义UIAbility供项目使用 我在自己编写的Har包中自定义了一个MyUIAbility，并默认加载Har包中的页面，为什么在主项目中继承MyUIAbility之后页面白屏，似乎无法正常加载页面, 但是我观察MyUIAbility中的加载页面的代码也并没有报错。

MyUIAbility的实现

// lib包中的实现
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';

const DOMAIN = 0x0000;

export default class MyUIAbility extends UIAbility {

  onWindowStageCreate(windowStage: window.WindowStage): void {
    // Main window is created, set main page for this ability
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageCreate');

    // Before loading the target page, decorate the page with @Entry, as in @Entry({routeName: 'xxxPage'}), and import the page.
    windowStage.loadContentByName('components/MainPage', (err) => {
      if (err.code) {
        hilog.error(DOMAIN, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err));
        return;
      }
      hilog.info(DOMAIN, 'testTag', 'Succeeded in loading the content.');
    });
  }
}

// 主项目中入口Ability的代码
import { MyUIAbility } from 'mylib';

export default class EntryAbility extends MyUIAbility {
}

更多关于HarmonyOS鸿蒙Next中在HAR包中自定义UIAbility供项目使用的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

在HarmonyOS Next中，HAR包内可自定义UIAbility。通过创建UIAbility组件并配置exported为true，允许外部调用。在HAR的module.json5中声明UIAbility的actions和entities，确保导出能力。使用时，在调用方项目的module.json5中配置所需依赖，通过featureAbility或startAbility显式启动该UIAbility。注意权限与依赖配置一致。

更多关于HarmonyOS鸿蒙Next中在HAR包中自定义UIAbility供项目使用的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


页面白屏问题通常由资源路径或页面声明不正确导致。检查以下两点：

  1. 确保HAR包中的MainPage组件已使用@Entry装饰器正确定义，且路由名称与loadContentByName中的路径匹配。例如：
@Entry({ routeName: 'components/MainPage' })
@Component
struct MainPage {
  // 页面实现
}
  1. 确认HAR包的资源路径在主项目中可访问。若页面依赖其他资源（如样式或模块），需验证这些资源是否已正确打包并能够被主项目解析。

建议检查hilog日志输出，确认loadContentByName回调中是否有错误信息，这有助于进一步定位问题。

回到顶部