背景知识
- Form Kit（卡片开发服务）提供了一种在桌面、锁屏等系统应用上嵌入显示应用信息的开发框架和API，可以将应用内用户关注的重要信息或常用操作抽取到服务卡片（简称“卡片”）上，通过将卡片添加到桌面、锁屏等系统应用上，以达到信息展示、服务直达的便捷体验效果。
- HAR（Harmony Archive）是静态共享包，可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相关代码。
解决方案
在项目中引用HAR，本文介绍采用从本地文件夹安装以及从本地压缩包安装两种方式。
- 场景一：从本地文件夹安装。
- 参考创建ArkTS卡片，在工程中创建动态卡片。
- 参考构建HAR，在工程中创建名称为localFolderPack的HAR包。
- 在localFolderPack的HAR包中自定义MainPage组件，并导出。
@Component export struct MainPage { @State message: string = 'Hello World'; build() { Row() { Column() { Text(this.message) .fontSize($r('app.float.page_text_font_size')) .fontWeight(FontWeight.Bold) .onClick(() => { this.message = 'Welcome'; }); } .width('100%'); } .height('100%'); } } - 在主项目中配置对HAR的依赖，参考引用及管理共享包-引用本地模块源码。导入后oh-package.json5中会添加"localfolderpack": "file:../localFolderPack"。
- 在项目卡片页面WidgetCard.ets，引入HAR包并使用组件。
import { MainPage } from 'localfolderpack'; @Entry @Component struct WidgetCard { build() { Row() { MainPage(); } .width('100%') .height('100%') .backgroundColor($r('sys.color.comp_background_primary')); } }
- 参考创建ArkTS卡片，在工程中创建动态卡片。
- 场景二：从本地压缩包安装。
- 参考创建ArkTS卡片，在工程中创建动态卡片。
- 参考构建HAR，在工程中创建名称为localZipPack的HAR包。
- 在localZipPack的HAR包中自定义MainPage组件，并导出。
@Component export struct MainPage { isShow: boolean = true; build() { Column() { if (this.isShow) { Row() { Text('localZipPack hello') .fontSize(20); }; } else { Row() { Text('localZipPack hi') .fontSize(20); }; } } .padding(16) .width('100%') .height('100%'); } } - 参考编译HAR模块，进行编译，获取build/default/outputs/default/localZipPack.har。
- 在主项目中配置对HAR的依赖，参考引用及管理共享包-引用本地HAR/HSP包。导入后oh-package.json5中会添加"localzippack": "file:../localZipPack.har"。
- 在项目卡片页面WidgetCard.ets，引入HAR包并使用组件。注意：从本地压缩包安装HAR包，编译器未能将HAR包自定义组件所使用的系统组件自动导入，需要手动将所使用的组件重新配置。本案例在MainPage组件中使用了Column、Row、Text、if组件，所以完整写法如下：
import { MainPage } from 'localzippack'; @Entry @Component struct WidgetCard { build() { Row() { MainPage({ isShow: false }); }; } @Builder MainPageImport() { Column(); Text(); Row(); if (true) { } } }
- 参考创建ArkTS卡片，在工程中创建动态卡片。