鸿蒙5.0&next开发【@ohos.app.ability.DriverExtensionAbility (驱动程序扩展能力)】硬件

本文链接：https://blog.csdn.net/m0_70748845/article/details/146527629

DriverExtensionAbility模块提供驱动相关扩展能力，提供驱动创建、销毁、连接、断开等生命周期回调。

说明

本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { DriverExtensionAbility } from '@kit.DriverDevelopmentKit';

属性

模型约束：此接口仅在Stage模型下使用。

系统能力：SystemCapability.Driver.ExternalDevice

名称	类型	可读	可写	说明
context	[DriverExtensionContext]	是	否	DriverExtension的上下文环境，继承自ExtensionContext。

DriverExtensionAbility.onInit

onInit(want: Want): void;

Extension生命周期回调，在创建时回调，执行初始化业务逻辑操作。

模型约束：此接口仅在Stage模型下使用。

系统能力：SystemCapability.Driver.ExternalDevice

参数：

参数名	类型	必填	说明
want	[Want]	是	当前Extension相关的Want类型信息，包括ability名称、bundle名称等。

示例：

import { DriverExtensionAbility } from '@kit.DriverDevelopmentKit';
import { Want } from '@kit.AbilityKit';
class DriverExt extends DriverExtensionAbility {
  onInit(want : Want) {
    console.log('onInit, want: ${want.abilityName}');
  }
}

DriverExtensionAbility.onRelease

onRelease(): void;

Extension生命周期回调，在销毁时回调，执行资源清理等操作。

模型约束：此接口仅在Stage模型下使用。

系统能力：SystemCapability.Driver.ExternalDevice

示例：

class DriverExt extends DriverExtensionAbility {
  onRelease() {
    console.log('onRelease');
  }
}

DriverExtensionAbility.onConnect

onConnect(want: Want): rpc.RemoteObject | Promise<rpc.RemoteObject>;

Extension生命周期回调，如果是connectAbility拉起的服务，会在onCreate之后回调。返回一个RemoteObject对象，用于客户端和服务端进行通信。

模型约束：此接口仅在Stage模型下使用。

系统能力：SystemCapability.Driver.ExternalDevice

参数：

参数名	类型	必填	说明
want	[Want]	是	当前Extension相关的Want类型信息，包括ability名称、bundle名称等。

返回值：

类型	说明
rpc.RemoteObject	一个RemoteObject对象，用于客户端和服务端进行通信。

示例：

import { DriverExtensionAbility } from '@kit.DriverDevelopmentKit';
import { rpc } from '@kit.IPCKit';
import { Want } from '@kit.AbilityKit';
class StubTest extends rpc.RemoteObject{
    constructor(des : string) {
        super(des);
    }
    onRemoteMessageRequest(code : number, data : rpc.MessageSequence, reply : rpc.MessageSequence, option : rpc.MessageOption) {
      //必须重写此接口
      return true;
    }
}
class DriverExt extends DriverExtensionAbility {
  onConnect(want : Want) {
    console.log('onConnect , want: ${want.abilityName}');
    return new StubTest('test');
  }
}

如果生成返回值RemoteObject依赖一个异步接口，可以使用异步生命周期：

import { DriverExtensionAbility } from '@kit.DriverDevelopmentKit';
import { rpc } from '@kit.IPCKit';
import { Want } from '@kit.AbilityKit';
class StubTest extends rpc.RemoteObject{
    constructor(des : string) {
        super(des);
    }
    onRemoteMessageRequest(code : number, data : rpc.MessageSequence, reply : rpc.MessageSequence, option : rpc.MessageOption) {
      //必须重写此接口
      return true;
    }
}
async function getDescriptor() {
    // 调用异步函数...
    return "asyncTest"
}
class DriverExt extends DriverExtensionAbility {
  async onConnect(want : Want) {
    console.log(`onConnect , want: ${want.abilityName}`);
    let descriptor = await getDescriptor();
    return new StubTest(descriptor);
  }
}

DriverExtensionAbility.onDisconnect

onDisconnect(want: Want): void | Promise;

Extension的生命周期回调，客户端执行断开连接服务时回调。

模型约束：此接口仅在Stage模型下使用。

系统能力：SystemCapability.Driver.ExternalDevice

参数：

参数名	类型	必填	说明
want	[Want]	是	当前Extension相关的Want类型信息，包括ability名称、bundle名称等。

示例：

import { DriverExtensionAbility } from '@kit.DriverDevelopmentKit';
import { Want } from '@kit.AbilityKit';
class DriverExt extends DriverExtensionAbility {
  onDisconnect(want : Want) {
    console.log('onDisconnect, want: ${want.abilityName}');
  }
}

在执行完onDisconnect生命周期回调后，应用可能会退出，从而可能导致onDisconnect中的异步函数未能正确执行，比如异步写入数据库。可以使用异步生命周期，以确保异步onDisconnect完成后再继续后续的生命周期。

import { DriverExtensionAbility } from '@kit.DriverDevelopmentKit';
import { Want } from '@kit.AbilityKit';
class DriverExt extends DriverExtensionAbility {
  async onDisconnect(want : Want) {
    console.log('onDisconnect, want: ${want.abilityName}');
    // 调用异步函数...
  }
}

DriverExtensionAbility.onDump

onDump(params: Array): Array;

转储客户端信息时调用。

模型约束：此接口仅在Stage模型下使用。

系统能力：SystemCapability.Driver.ExternalDevice

参数：

参数名	类型	必填	说明
params	Array	是	表示命令形式的参数。

示例：

class DriverExt extends DriverExtensionAbility {
    onDump(params : Array<string>) {
        console.log(`dump, params: ${JSON.stringify(params)}`);
        return ['params'];
    }
}

DriverExtensionContext

type DriverExtensionContext = _DriverExtensionContext;

DriverExtensionAbility的上下文环境。

系统能力：SystemCapability.Driver.ExternalDevice

类型	说明
_DriverExtensionContext	DriverExtensionAbility的上下文环境，继承自ExtensionContext

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述