UIExtensionComponent用于支持在本页面内嵌入其他应用提供的UI。展示的内容在另外一个进程中运行,本应用并不参与其中的布局和渲染。
通常用于有进程隔离诉求的模块化开发场景。
说明:
该组件从API Version 10开始支持。
本组件为系统接口。
使用约束
本组件不支持预览。
被拉起的Ability必须是带UI的Ability扩展,如何实现带UI的Ability扩展请参考实现带UI的Ability扩展。
必须显示设置组件宽高为非0有效值。
子组件
无
接口
UIExtensionComponent(want: Want)
参数:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
want | Want | 是 | 要加载的Ability。 |
UIExtensionProxy
用于在双方建立连接成功后,组件使用方向被拉起的Ability发送数据的场景,提供send方法。
send
send(data: { [key: string]: Object }): void
参数:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
data | { [key: string]: Object } | 是 | 发送给被拉起的扩展Ability的数据。 |
属性
支持通用属性。
事件
不支持通用事件。
将事件经过坐标转换后传递给对端Ability处理。
支持以下事件:
onRemoteReady
onRemoteReady(callback: Callback<UIExtensionProxy>)
UIExtensionAbility连接完成时的回调,之后可使用proxy向被拉起的Ability发送数据。
参数:
参数名 | 类型 | 说明 |
---|---|---|
proxy | UIExtensionProxy | 用于向对端Ability发送数据。 |
onReceive
onReceive(callback: Callback<{ [key: string]: Object }>)
收到被拉起的Ability发送的数据时触发的回调。
参数:
参数名 | 类型 | 说明 |
---|---|---|
data | { [key: string]: Object } | 收到来自对端Ability的数据。 |
onResult
onResult(callback: Callback<{code: number; want?: Want}>)
被拉起的Ability扩展调用terminateSelfWithResult时会先触发本回调函数,再触发OnRelease。
本回调内可处理对端Ability的结果数据,可参考AbilityResult。
参数:
参数名 | 类型 | 说明 |
---|---|---|
code | number | 收到来自对端Ability的处理結果code。 |
want | Want | 收到来自对端Ability的处理結果Want。 |
onRelease
onRelease(callback: Callback<number>)
用于处理被拉起的Ability销毁时的回调。
被拉起的Ability扩展调用terminateSelfWithResult或者terminateSelf时会触发本回调,此时releaseCode为0,即正常销毁。
被拉起的Ability扩展意外Crash或被kill时,触发本回调,此时releaseCode为1。
参数:
参数名 | 类型 | 说明 |
---|---|---|
releaseCode | number | 对端Ability销毁时的code,0为正常销毁,1为异常销毁。 |
onError
onError(callback:ErrorCallback)
被拉起的Ability扩展在运行过程中发生异常时触发本回调。可通过回调参数中的code、name和message获取错误信息并做处理。
参数:
参数名 | 类型 | 说明 |
---|---|---|
err | BusinessError | 报错信息。 |
示例
本示例仅展示组件使用的方法和扩展的Ability,实际运行需在设备中安装bundleName为"com.example.uiextensionprovider",abilityName为"UIExtensionProvider"的Ability扩展。
// 组件使用示例:
import Want from '@ohos.app.ability.Want';
@Entry
@Component
struct Index {
@State message: string = 'Hello World'
private myProxy: UIExtensionProxy | null = null;
want: Want = {
bundleName: "com.example.uiextensionprovider",
abilityName: "UIExtensionProvider",
parameters: { "x": 12345, "y": "data" }
}
build() {
Row() {
Column() {
Text(this.message).fontColor(Color.Red)
UIExtensionComponent(this.want)
.size({ width: "100%", height: "100%" })
.onRemoteReady((proxy: UIExtensionProxy) => {
this.message = "remote ready"
this.myProxy = proxy
})
.onReceive((data: Object) => {
this.message = JSON.stringify(data)
})
.onRelease((releaseCode: number) => {
this.message = "Release: " + releaseCode
})
.onResult((data: Object) => {
this.message = JSON.stringify(data)
})
.onError((error: ErrorObject) => {
this.message = "onError: " + error.code + ", name: " + error.name + ", message: " + error.message
})
Button("sendData").onClick(() => {
if (this.myProxy != null) {
let a: Record<string, number> = { "x": 5678910 };
this.myProxy.send(a)
}
})
}
.width("100%")
}
.height('100%')
}
}
interface ErrorObject {
code: number;
name: string;
message: string;
}
// 扩展入口文件UIExtensionProvider.ts
import UIExtensionAbility from '@ohos.app.ability.UIExtensionAbility'
import UIExtensionContentSession from '@ohos.app.ability.UIExtensionContentSession'
import Want from '@ohos.app.ability.Want';
const TAG: string = '[UIExtAbility]'
export default class UIExtAbility extends UIExtensionAbility {
onCreate() {
console.log(TAG, `UIExtAbility onCreate`)
}
onForeground() {
console.log(TAG, `UIExtAbility onForeground`)
}
onBackground() {
console.log(TAG, `UIExtAbility onBackground`)
}
onDestroy() {
console.log(TAG, `UIExtAbility onDestroy`)
}
onSessionCreate(want: Want, session: UIExtensionContentSession) {
console.log(TAG, `UIExtAbility onSessionCreate, want: ${JSON.stringify(want)}`)
let param: Record<string, UIExtensionContentSession> = {
'session': session
}
let storage: LocalStorage = new LocalStorage(param);
session.loadContent('pages/extension', storage);
}
onSessionDestroy(session: UIExtensionContentSession) {
console.log(TAG, `UIExtAbility onSessionDestroy`)
}
}
// 扩展Ability入口页面文件extension.ets
import UIExtensionContentSession from '@ohos.app.ability.UIExtensionContentSession'
let storage = LocalStorage.GetShared()
@Entry(storage)
@Component
struct Index {
@State message: string = 'UIExtension'
@State message2: string = 'message from comp'
private session: UIExtensionContentSession | undefined = storage.get<UIExtensionContentSession>('session');
controller: TextInputController = new TextInputController()
onPageShow() {
if (this.session != undefined) {
this.session.setReceiveDataCallback((data: Object) => {
this.message2 = "data come from comp"
this.message = JSON.stringify(data)
})
}
}
build() {
Row() {
Column() {
Text(this.message2)
Text(this.message)
Button("sendData")
.onClick(() => {
if (this.session != undefined) {
let a: Record<string, string> = {"xxx": "data from extension"};
this.session.sendData(a)
}
})
Button("terminateSelf")
.onClick(() => {
if (this.session != undefined) {
this.session.terminateSelf();
storage.clear();
}
}).margin(5)
Button("TerminateSelfWithResult")
.onClick(() => {
if (this.session != undefined) {
this.session.terminateSelfWithResult({
"resultCode": 0,
"want": {
"bundleName": "myName"
}
});
storage.clear();
}
}).margin(5)
}
.width('100%')
}
.height('100%')
}
}
最后
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(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学习资料
总结
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。