HarmonyOS实战开发：@ohos.app.form.FormExtensionAbility (FormExtensionAbility)

最新推荐文章于 2025-08-11 21:32:04 发布
最新推荐文章于 2025-08-11 21:32:04 发布
阅读量909 收藏 24
点赞数 24
CC 4.0 BY-SA版权
分类专栏： 鸿蒙 文章标签： harmonyos 华为 鸿蒙 鸿蒙系统 android
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_84194030/article/details/138871990

FormExtensionAbility为卡片扩展模块，提供卡片创建、销毁、刷新等生命周期回调。

说明：

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 本模块接口仅可在Stage模型下使用。

导入模块

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';

属性

系统能力：SystemCapability.Ability.Form

名称类型可读可写说明
contextFormExtensionContext是否FormExtensionAbility的上下文环境，继承自ExtensionContext。

onAddForm

onAddForm(want: Want): formBindingData.FormBindingData

卡片提供方接收创建卡片的通知接口。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
wantWant是当前卡片相关的Want类型信息，包括卡片ID、卡片名称、卡片样式等。这些卡片信息必须作为持久数据进行管理，以便后续更新和删除卡片。

返回值：

类型说明
formBindingData.FormBindingDataformBindingData.FormBindingData对象，卡片要显示的数据。

示例：

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import formBindingData from '@ohos.app.form.formBindingData';
import Want from '@ohos.app.ability.Want';

export default class MyFormExtensionAbility extends FormExtensionAbility {
  onAddForm(want: Want) {
    console.log(`FormExtensionAbility onAddForm, want: ${want.abilityName}`);
    let dataObj1 = new Map<string, string>();
    dataObj1.set('temperature', '11c');
    dataObj1.set('time', '11:00');

    let obj1: formBindingData.FormBindingData = formBindingData.createFormBindingData(dataObj1);
    return obj1;
  }
}

onCastToNormalForm

onCastToNormalForm(formId: string): void

卡片提供方接收临时卡片转常态卡片的通知接口。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是请求转换为常态的卡片标识。

示例：

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';

export default class MyFormExtensionAbility extends FormExtensionAbility {
  onCastToNormalForm(formId: string) {
    console.log(`FormExtensionAbility onCastToNormalForm, formId: ${formId}`);
  }
};

onUpdateForm

onUpdateForm(formId: string): void

卡片提供方接收更新卡片的通知接口。获取最新数据后调用formProvider的updateForm接口刷新卡片数据。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是请求更新的卡片ID。

示例：

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import formBindingData from '@ohos.app.form.formBindingData';
import formProvider from '@ohos.app.form.formProvider';
import Base from '@ohos.base';

export default class MyFormExtensionAbility extends FormExtensionAbility {
  onUpdateForm(formId: string) {
    console.log(`FormExtensionAbility onUpdateForm, formId: ${formId}`);
    let param: Record<string, string> = {
      'temperature': '22c',
      'time': '22:00'
    }
    let obj2: formBindingData.FormBindingData = formBindingData.createFormBindingData(param);
    formProvider.updateForm(formId, obj2).then(() => {
      console.log(`FormExtensionAbility context updateForm`);
    }).catch((error: Base.BusinessError) => {
      console.error(`FormExtensionAbility context updateForm failed, data: ${error}`);
    });
  }
};

onChangeFormVisibility

onChangeFormVisibility(newStatus: { [key: string]: number }): void

卡片提供方接收修改可见性的通知接口。
该接口仅对系统应用生效，且需要将formVisibleNotify配置为true。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
newStatus{ [key: string]: number }是请求修改的卡片标识和可见状态。

示例：

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import formBindingData from '@ohos.app.form.formBindingData';
import formProvider from '@ohos.app.form.formProvider';
import Base from '@ohos.base';

// 由于arkTs中无Object.keys，且无法使用for..in...
// 若报arkTs问题，请将此方法单独抽离至一个ts文件中并暴露，在需要用到的ets文件中引入使用
function getObjKeys(obj: Object): string[] {
  let keys = Object.keys(obj);
  return keys;
}

export default class MyFormExtensionAbility extends FormExtensionAbility {
  onChangeFormVisibility(newStatus: Record<string, number>) {
    console.log(`FormExtensionAbility onChangeFormVisibility, newStatus: ${newStatus}`);
    let param: Record<string, string> = {
      'temperature': '22c',
      'time': '22:00'
    }
    let obj2: formBindingData.FormBindingData = formBindingData.createFormBindingData(param);

    let keys: string[] = getObjKeys(newStatus);

    for (let i: number = 0; i < keys.length; i++) {
      console.log(`FormExtensionAbility onChangeFormVisibility, key: ${keys[i]}, value= ${newStatus[keys[i]]}`);
      formProvider.updateForm(keys[i], obj2).then(() => {
        console.log(`FormExtensionAbility context updateForm`);
      }).catch((error: Base.BusinessError) => {
        console.error(`Operation updateForm failed. Cause: ${JSON.stringify(error)}`);
      });
    }
  }
};

onFormEvent

onFormEvent(formId: string, message: string): void

卡片提供方接收处理卡片事件的通知接口（此方法仅可在JS卡片中使用）。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是请求触发事件的卡片标识。
messagestring是事件消息。

示例：

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';

export default class MyFormExtensionAbility extends FormExtensionAbility {
  onFormEvent(formId: string, message: string) {
    console.log(`FormExtensionAbility onFormEvent, formId: ${formId}, message: ${message}`);
  }
};

onRemoveForm

onRemoveForm(formId: string): void

卡片提供方接收销毁卡片的通知接口。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是请求销毁的卡片标识。

示例：

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';

export default class MyFormExtensionAbility extends FormExtensionAbility {
  onRemoveForm(formId: string) {
    console.log(`FormExtensionAbility onRemoveForm, formId: ${formId}`);
  }
};

onConfigurationUpdate

onConfigurationUpdate(newConfig: Configuration): void

当系统配置更新时调用。
仅当前formExtensionAbility存活时更新配置才会触发此生命周期。需要注意，formExtensionAbility创建后5秒内无操作将会被清理。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
newConfigConfiguration是表示需要更新的配置信息。

示例：

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import { Configuration } from '@ohos.app.ability.Configuration';

export default class MyFormExtensionAbility extends FormExtensionAbility {
  onConfigurationUpdate(newConfig: Configuration) {
    // 仅当前formExtensionAbility存活时更新配置才会触发此生命周期。
    // 需要注意，formExtensionAbility创建后5秒内无操作将会被清理。
    console.log(`onConfigurationUpdate, config: ${JSON.stringify(config)}`);
  }
};

onAcquireFormState

onAcquireFormState?(want: Want): formInfo.FormState

卡片提供方接收查询卡片状态通知接口，默认返回卡片初始状态(该方法可以选择性重写)。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
wantWant是want表示获取卡片状态的描述。描述包括Bundle名称、能力名称、模块名称、卡片名和卡片维度。

示例：

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import formInfo from '@ohos.app.form.formInfo';
import Want from '@ohos.app.ability.Want';

export default class MyFormExtensionAbility extends FormExtensionAbility {
  onAcquireFormState(want: Want) {
    console.log(`FormExtensionAbility onAcquireFormState, want: ${want}`);
    return formInfo.FormState.UNKNOWN;
  }
};

onShareForm

onShareForm?(formId: string): { [key: string]: Object }

卡片提供方接收卡片分享的通知接口。

系统接口: 此接口为系统接口。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。

返回值：

类型说明
{[key: string]: Object}卡片要分享的数据，由开发者自行决定传入的键值对。

示例：

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';

export default class MyFormExtensionAbility extends FormExtensionAbility {
  onShareForm(formId: string) {
    console.log(`FormExtensionAbility onShareForm, formId: ${formId}`);
    let wantParams: Record<string, Object> = {
      'temperature': '20',
      'time': '2022-8-8 09:59',
    };
    return wantParams;
  }
};

onAcquireFormData10+

onAcquireFormData?(formId: string): { [key: string]: Object }

卡片提供方接收卡片请求自定义数据的通知接口。

系统接口: 此接口为系统接口。

系统能力：SystemCapability.Ability.Form

参数：

参数名类型必填说明
formIdstring是卡片标识。

返回值：

类型说明
{[key: string]: Object}卡片的自定义数据，由开发者自行决定传入的键值对。

示例：

import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';

export default class MyFormExtensionAbility extends FormExtensionAbility {
  onAcquireFormData(formId: string) {
    console.log(`FormExtensionAbility onAcquireFormData, formId: ${formId}`);
    let wantParams: Record<string, Object> = {
      'temperature': '20',
      'time': '2022-8-8 09:59',
    };
    return wantParams;
  }
};

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。

OpenHarmony/HarmonyOS服务卡片详解
坚果的博客
03-23 1万+
FormExtensionAbility作为服务卡片扩展组件是一种界面展示形式，可以将应用的重要信息或操作前置到卡片，以达到服务直达，减少体验层级的目的。
从零开始的HarmonyOS Next开发指南：打造HarmonyOS NEXT元服务
一键难忘的博客
05-26 9040
DevEco Studio 4.0是一个集成开发环境（IDE），专门为开发者提供一站式的HarmonyOS应用和服务开发支持。以下是DevEco Studio 4.0的一些主要特点：高效智能代码编辑：支持多种语言，如ArkTS、JavaScript、C/C++等，提供代码高亮、智能补齐、错误检查、自动跳转、格式化、查找等功能，以提升代码编写的效率。低代码可视化开发：拥有丰富的UI界面编辑能力，支持自由拖拽组件和可视化数据绑定，能够快速预览效果，所见即所得。
HarmonyOS/OpenHarmony应用开发-Stage模型ArkTS语言FormExtensionAbility
weixin_69135651的博客
04-25 900
HarmonyOS/OpenHarmony应用开发-Stage模型ArkTS语言FormExtensionAbility
【鸿蒙初级知识点】ExtensionAbility组件
2501_90127602的博客
01-04 822
ExtensionAbility 组件是基于特定场景（例如服务卡片、输入法等）提供的应用组件，以便满足更多的使用场景。每一个具体场景对应一个 ExtensionAbilityType ，开发者只能使用（包括实现和访问）系统已定义的类型。各类型的ExtensionAbility组件均由相应的系统服务统一管理，例如 InputMethodExtensionAbility 组件由输入法管理服务统一管理。当前系统已定义的ExtensionAbility类型如下表所示。
【鸿蒙实战开发】FormExtensionAbility卡片生命周期
HarmonyOS007的博客
07-24 587
●如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我两个小忙：●关注小编，同时可以期待后续文章ing ，不定期分享原创知识。
鸿蒙5.0开发：Stage模型（ExtensionAbility组件）
AyomQAQ的博客
10-17 779
HarmonyOS中的ExtensionAbility组件是一种能够扩展系统功能的能力组件。
鸿蒙5.0开发进阶：@ohos.bundle.bundleManager (bundleManager模块)
Androidbye的博客
11-24 821
本模块提供应用信息查询能力.........
HarmonyOS从基础到实战-高性能华为在线答题元服务
热门推荐
一键难忘的博客
11-21 15万+
HarmonyOS从基础到实战-高性能华为在线答题元服务 在本文中，我们介绍了一个关于在线答题应用的项目，其中包括项目结构和开发计划。项目主要分为主应用的Ability（entryability）、卡片的Ability（Entnyformability）、从云数据库导出的数据类型（Models）以及页面代码文件夹（Pages）等模块。使用了两个重要的配置文件，分别是agconnect-services.json和schema.json，用于连接serverless服务和云端配置信息。
【HarmonyOS实战开发】服务卡片
HarmonyOS_666的博客
07-10 1941
这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。
鸿蒙HarmonyOS实战-Stage模型（开发卡片事件）
sdgfafg_25的博客
05-21 1112
HarmonyOS元服务卡片页面（Metaservice Card Page）是指在HarmonyOS系统中，用于展示元服务的页面界面。元服务是指一组提供特定功能或服务的组件，例如天气服务、音乐播放服务等。元服务卡片页面可以显示元服务的相关信息和操作选项，用户可以通过点击卡片页面上的按钮或交互元素来使用相关的元服务功能。这个接口提供了卡片和提供方应用之间进行交互的方式，可以实现卡片的功能扩展和与提供方应用的数据交互。可以通过指定目标应用、要调用的函数或方法名以及传递的参数，调用提供方应用中的函数或方法。
HarmonyOS 应用开发之ExtensionAbility组件，面试被逆袭
2301_78398209的博客
04-09 728
一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**
【中工开发者】深入理解鸿蒙应用级组件扩展能力（ExtensionAbility）
2301_76522218的博客
12-19 1181
各种扩展能力应用场景各不相同，差异比较大，不具有可比性，因此并不完全存在一个统一的扩展ExtensionAbility的开发模式 一些扩展能力不对普通开发者开放 进程间通信开销较大，使用扩展能力时要注意进程模型。以下是对各类扩展能力的概述。二. 在大多数系统中，扩展能力的调用不能由调用方直接进行，而是由相应的系统管理服务间接拉起的。：扩展能力的调用由系统管理服务间接进行，调用方通过系统提供的接口请求相应的扩展能力。渲染进程与应用的主进程和其他扩展能力进程分离，确保网页内容的独立性和安全性。
Stage 模型下实现 FormExtension 卡片的创建与使用流程分析
坚果的博客
03-25 1万+
作者：坚果团队：坚果组织公众号：“大前端之旅”润开鸿技术专家，华为HDE，InfoQ签约作者，OpenHarmony布道师，擅长HarmonyOS应用开发、熟悉服务卡片开发，在“战码先锋”活动中作为大队长，累计培养三个小队长，带领100+队员完成Pr的提交合入。欢迎通过主页或者私信联系我，加入坚果组织，一起学习鸿蒙应用开发。
OpenHarmony开源鸿蒙学习入门--Ability,FA和Stage基本概念理解
路漫漫亦无涯
05-15 1万+
OpenHarmony开源鸿蒙学习入门--Ability,FA和Stage基本概念理解
HarmonyOS 开发入门 第一章
最新发布
abcdefgh_gh的博客
08-11 95
本文介绍了HarmonyOS开发中ArkTS语言的基础知识。ArkTS是华为基于TypeScript扩展的编程语言，专为HarmonyOS优化。文章详细讲解了基本数据类型（string、number、boolean）、变量声明、数组、函数定义（包括普通函数和箭头函数）、对象（使用接口约定结构）、对象方法、联合类型和枚举类型的使用方法。同时提供了开发环境准备建议，指出DevEco Studio是推荐的开发工具。这些基础知识为HarmonyOS应用开发奠定了语法基础。
鸿蒙HarmonyOS中Axios网络库封装与文件上传功能实现
猫哥 的沉淀、积累、总结。天天学习，好好向上...c/c++,嵌入式 linux,Android,HarmonyOS，AIOT)
08-08 403
本文介绍了如何在鸿蒙HarmonyOS中封装axios库以支持文件上传功能。封装后的AxiosHttpRequest类提供了GET、POST等HTTP请求方法，并实现了统一错误处理机制。重点讲解了文件上传接口的设计，支持单个/多个文件上传，可自定义文件字段名和表单数据，并包含上传进度回调功能。通过继承InternalAxiosRequestConfig实现了可选的拦截器配置，同时保留了axios原有的特性。该封装简化了网络请求操作，使开发者能更便捷地处理文件上传等业务需求。
HarmonyOS AI辅助编程工具（CodeGenie）概述
weixin_69135651的博客
08-11 313
在DevEco Studio菜单栏，点击File > Settings（macOS为DevEco Studio > Preferences）> Plugins，点击 > Install Plugin from Disk…DevEco AI辅助编程工具（CodeGenie）基于BitFun Platform AI能力平台，为开发者提供高效的应用与服务AI编程支持，支持智能知识问答，同时支持ArkTS代码生成和万能卡片生成能力，帮助开发者提高编码效率。安装压缩包无需解压，下载完成可直接依照下方步骤进行安装。
鸿蒙ArkUI中的Button组件全面解析：从基础到高级应用
我叫柱子哥
08-11 918
本文详细介绍了鸿蒙ArkUI框架中Button组件的开发与应用。主要内容包括：1）Button的三种创建方式及核心属性配置；2）样式定制方法，包括预定义样式和自定义样式；3）交互功能实现，如点击事件处理和状态管理；4）高级用法，如自定义内容、按钮组和动态效果；5）常见问题解决方案和性能优化建议；6）设计规范与组件组合技巧。通过系统讲解Button的各类特性和使用场景，为开发者提供了全面的开发指导，帮助构建美观、高效的交互界面。
【鸿蒙/OpenHarmony/NDK】C/C++开发教程之环境搭建
青春不言败
08-10 198
本文介绍了如何在鸿蒙系统上使用C/C++开发应用的实操指南。核心内容为：1）确认鸿蒙应用支持C/C++核心逻辑开发，但界面需用ArkTS；2）详细指导DevEco Studio安装及NDK工程创建，强调选择Native C++模板；3）提供真机运行和签名配置的关键操作截图；4）说明成功运行的验证标准（显示"Hello World"及日志输出）。文章采用"问题-解决"结构，配合图文指引开发者快速上手NDK开发，并鼓励读者在评论区交流优化建议。全文突出实操性，将官方文档要
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值