鸿蒙开发接口Ability框架：【ServiceExtensionContext】

最新推荐文章于 2024-06-05 20:38:58 发布
最新推荐文章于 2024-06-05 20:38:58 发布
阅读量774 收藏 29
点赞数 35
分类专栏： 鸿蒙 文章标签： harmonyos OpenHarmony 程序员 鸿蒙 鸿蒙开发 鸿蒙系统 移动开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_76813281/article/details/139065991
版权

 ServiceExtensionContext

ServiceExtensionContext模块是ServiceExtension的上下文环境，继承自ExtensionContext。

ServiceExtensionContext模块提供ServiceExtension具有的能力和接口，包括启动、停止、绑定、解绑Ability。

说明：
开发前请熟悉鸿蒙开发指导文档： gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
本模块接口仅可在Stage模型下使用。

使用说明

ServiceExtensionContext模块是ServiceExtension的上下文环境，继承自ExtensionContext。

属性

系统能力：SystemCapability.Ability.AbilityRuntime.Core

名称参数类型可读可写说明
extensionAbilityInfoExtensionAbilityInfo是否服务扩展信息。

startAbility

startAbility(want: Want, callback: AsyncCallback<void>): void;

启动Ability。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
wantWant是Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。
callbackAsyncCallback<void>否回调函数，返回接口调用是否成功的结果。

示例：

import ExtensionContext from '@ohos.application.ServiceExtensionAbility';
class MainAbility extends ExtensionContext {
    onWindowStageCreate(windowStage) {
        let want = {
            "bundleName": "com.example.myapp",
            "abilityName": "MyAbility"};
        this.context.startAbility(want, (err) => {
        console.log('startAbility result:' + JSON.stringify(err));
        });
    }
}

startAbility

startAbility(want: Want, options?: StartOptions): Promise<void>;

启动Ability。通过Promise返回结果。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
wantWant是Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。
optionsStartOptions是启动Ability所携带的参数。

返回值：

类型说明
Promise<void>返回一个Promise，包含接口的结果。

示例：

  import ExtensionContext from '@ohos.application.ServiceExtensionAbility';
  class MainAbility extends ExtensionContext {
      onWindowStageCreate(windowStage) {
          let want = {
          "bundleName": "com.example.myapp",
          "abilityName": "MyAbility"
          };
      this.context.startAbility(want).then((data) => {
          console.log('success:' + JSON.stringify(data));
      }).catch((error) => {
          console.log('failed:' + JSON.stringify(error));
      });
      }
  }

startAbility

startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void

启动Ability。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
wantWant是启动Ability的want信息。
optionsStartOptions是启动Ability所携带的参数。
callbackAsyncCallback<void>是callback形式返回启动结果。

示例：

var want = {
    "deviceId": "",
    "bundleName": "com.extreme.test",
    "abilityName": "MainAbility"
};
var options = {
    windowMode: 0,
};
this.context.startAbility(want, options, (error) => {
    console.log("error.code = " + error.code)
})

ServiceExtensionContext.startAbilityWithAccount

startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void;

根据account启动Ability（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
wantWant是启动Ability的want信息。
accountIdnumber是需要启动的accountId。
callbackAsyncCallback<void>是启动Ability的回调函数。

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
this.context.startAbilityWithAccount(want, accountId, (err) => {
  console.log('---------- startAbilityWithAccount fail, err:  -----------', err);
});

ServiceExtensionContext.startAbilityWithAccount

startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>): void;

根据account启动Ability（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
wantWant是启动Ability的want信息。
accountIdnumber是需要启动的accountId。
optionsStartOptions否启动Ability所携带的参数。
callbackAsyncCallback<void>是启动Ability的回调函数。

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
var options = {
  windowMode: 0,
};
this.context.startAbilityWithAccount(want, accountId, options, (err) => {
  console.log('---------- startAbilityWithAccount fail, err:  -----------', err);
});

ServiceExtensionContext.startAbilityWithAccount

startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise<void>;

根据account启动Ability（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
wantWant是启动Ability的want信息。
accountIdnumber是需要启动的accountId。
optionsStartOptions否启动Ability所携带的参数。

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
var options = {
  windowMode: 0,
};
this.context.startAbilityWithAccount(want, accountId, options)
  .then((data) => {
      console.log('---------- startAbilityWithAccount success, data:  -----------', data);
  })
  .catch((err) => {
      console.log('---------- startAbilityWithAccount fail, err:  -----------', err);
  })

ServiceExtensionContext.terminateSelf

terminateSelf(callback: AsyncCallback<void>): void;

停止Ability自身。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
callbackAsyncCallback<void>否回调函数，返回接口调用是否成功的结果。

示例：

  import ExtensionContext from '@ohos.application.ServiceExtensionAbility';
      class MainAbility extends ExtensionContext {
          onWindowStageCreate(windowStage) {
          this.context.terminateSelf((err) => {
            console.log('terminateSelf result:' + JSON.stringify(err));
          });
          }
      }

ServiceExtensionContext.terminateSelf

terminateSelf(): Promise<void>;

停止自身。通过Promise返回结果。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

返回值：

类型说明
Promise<void>返回一个Promise，包含接口的结果。

示例：

  import ExtensionContext from '@ohos.application.ServiceExtensionAbility';
  class MainAbility extends ExtensionContext {
  onWindowStageCreate(windowStage) {
    this.context.terminateSelf().then((data) => {
      console.log('success:' + JSON.stringify(data));
    }).catch((error) => {
      console.log('failed:' + JSON.stringify(error));
    });
  }
}

ServiceExtensionContext.connectAbility

connectAbility(want: Want, options: ConnectOptions): number;

将一个Ability与服务类型的Ability绑定。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
wantWant是Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。
optionsConnectOptions是ConnectOptions类型的回调函数，返回服务连接成功、断开或连接失败后的信息。

返回值：

类型说明
number返回一个number，后续根据这个number去断开连接。

示例：

let want = {
    "bundleName": "com.example.myapp",
    "abilityName": "MyAbility"
};
let options = {
    onConnect: function(elementName, proxy) {},
    onDisConnect: function(elementName) {},
    onFailed: function(code) {}
}
let connection = this.context.connectAbility(want,options);

ServiceExtensionContext.connectAbilityWithAccount

connectAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number;

使用AbilityInfo.AbilityType.SERVICE模板和account将当前能力连接到一个能力。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
wantWant是启动Ability的want信息。
accountIdnumber是需要启动的accountId。
optionsConnectOptions否远端对象实例。

返回值：

类型说明
number返回Ability连接的结果code。

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
var options = {
  onConnect(elementName, remote) { console.log('----------- onConnect -----------') },
  onDisconnect(elementName) { console.log('----------- onDisconnect -----------') },
  onFailed(code) { console.log('----------- onFailed -----------') }
}
const result = this.context.connectAbilityWithAccount(want, accountId, options);
console.log('----------- connectAbilityResult: ------------', result);

ServiceExtensionContext.disconnectAbility

disconnectAbility(connection: number, callback:AsyncCallback<void>): void;

将一个Ability与绑定的服务类型的Ability解绑。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
connectionnumber是在connectAbility中返回的number。
callbackAsyncCallback<void>否回调函数，返回接口调用是否成功的结果。

示例：

import ExtensionContext from '@ohos.application.ServiceExtensionAbility';
  class MainAbility extends ExtensionContext {
  onWindowStageCreate(windowStage) {
    let connection=1
    this.context.disconnectAbility(connection, (err) => { 
      // connection为connectAbility中的返回值
      console.log('terminateSelf result:' + JSON.stringify(err));
    });
  }
}

ServiceExtensionContext.disconnectAbility

disconnectAbility(connection: number): Promise<void>;

将一个Ability与绑定的服务类型的Ability解绑。通过Promise返回结果。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
connectionnumber是在connectAbility中返回的number。

返回值：

类型说明 HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿
Promise<void>返回一个Promise，包含接口的结果。

搜狗高速浏览器截图20240326151344.png


示例：

import ExtensionContext from '@ohos.application.ServiceExtensionAbility';
class MainAbility extends ExtensionContext {
  onWindowStageCreate(windowStage) {
    let connection=1
    this.context.disconnectAbility(connection).then((data) => { // connection为connectAbility中的返回值
    console.log('success:' + JSON.stringify(data));
    }).catch((error) => {
    console.log('failed:' + JSON.stringify(error));
    });
  }
}

鸿蒙开发岗位需要掌握那些核心要领？

目前还有很多小伙伴不知道要学习哪些鸿蒙技术？不知道重点掌握哪些？为了避免学习时频繁踩坑，最终浪费大量时间的。

自己学习时必须要有一份实用的鸿蒙（Harmony NEXT）资料非常有必要。 这里我推荐，根据鸿蒙开发官网梳理与华为内部人员的分享总结出的开发文档。内容包含了：【ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战】等技术知识点。

废话就不多说了，接下来好好看下这份资料。

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

针对鸿蒙成长路线打造的鸿蒙学习文档。鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，帮助大家在技术的道路上更进一步。

其中内容包含：

《鸿蒙开发基础》鸿蒙OpenHarmony知识←前往

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

《鸿蒙开发进阶》鸿蒙OpenHarmony知识←前往

  1. Stage模型入门
  2. 网络管理
  3. 数据管理
  4. 电话服务
  5. 分布式应用开发
  6. 通知与窗口管理
  7. 多媒体技术
  8. 安全技能
  9. 任务管理
  10. WebGL
  11. 国际化开发
  12. 应用测试
  13. DFX面向未来设计
  14. 鸿蒙系统移植和裁剪定制
  15. ……

《鸿蒙开发实战》鸿蒙OpenHarmony知识←前往

  1. ArkTS实践
  2. UIAbility应用
  3. 网络案例
  4. ……

最后

鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！

爱桥代码的程序媛
关注
  • 35
    点赞
  • 踩
  • 29
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
博客的《鸿蒙Ability（二）：Particle Ability的Service Ability模板》的配套代码
06-21
博客的《鸿蒙Ability（二）：Particle Ability的Service Ability模板》的配套代码
HarmonyOS开发必备基础知识.pdf
10-14
HarmonyOS开发基础知识 HarmonyOS是一个基于微内核的操作系统，由华为公司开发。 HarmonyOS应用软件包以APP Pack（Application Package）形式发布，由一个或多个HAP（HarmonyOS Ability Package）以及描述每个HAP...
鸿蒙Ability Kit（程序框架服务）【ServiceExtensionAbility】
m0_70748845的博客
06-04 604
ServiceExtensionAbility作为后台服务，需要向外部提供可调用的接口，开发者可将接口定义在idl文件中，并使用[IDL工具]生成对应的proxy、stub文件。├── ets│ │ ├── i_idl_service_ext.ts # 生成文件│ │ ├── idl_service_ext_proxy.ts # 生成文件│ │ ├── idl_service_ext_stub.ts # 生成文件。
鸿蒙Ability Kit（程序框架服务）【应用上下文Context】
最新发布
m0_70748845的博客
06-05 1231
Context]是应用中对象的上下文，其提供了应用的一些基础信息，例如resourceManager（资源管理）、applicationInfo（当前应用信息）、dir（应用文件路径）、area（文件分区）等，以及应用的一些基本方法，例如createBundleContext()、getApplicationContext()等。UIAbility组件和各种ExtensionAbility派生类组件都有各自不同的Context类。
鸿蒙Ability Kit（程序框架服务）【UIAbility组件间交互（设备内）】
m0_70748845的博客
06-02 779
一个UIAbility可以对应多个页面，在不同的场景下启动该UIAbility时需要展示不同的页面，例如从一个UIAbility的页面中跳转到另外一个UIAbility时，希望启动目标UIAbility的指定页面。UIAbility的启动分为两种情况：UIAbility冷启动和UIAbility热启动。UIAbility冷启动：指的是UIAbility实例处于完全关闭状态下被启动，这需要完整地加载和初始化UIAbility实例的代码、资源等。
HarmonyOS实战开发-如何实现一个仿桌面应用。
2401_82546228的博客
04-08 635
本示例实现了一个简单桌面应用，实现了以下几点功能：
鸿蒙版「玩Android」已经来了，你还不来学习一下？_玩安卓 鸿蒙开发
2401_84132496的博客
05-03 835
├── build-profile.json5 // app 构建配置，包括 app 签名、编译 SDK 版本、兼容 SDK 版本，以及包含的 entry 列表。├── oh_modules // 项目依赖的三方库，相当于前端项目中的 node_modules。├── oh-package.json5 // 项目配置，包括名称、版本、许可证、依赖项等。params: {id: 123} // 添加params属性，传递自定义参数。url: ‘pages/Detail’, // 目标url。
HarmonyOS应用开发-Stage模型开发（ArkTS）
shudaoshanQAQ的博客
03-27 1016
Stage模型（ArkTS）（Full SDK）(API10)
HarmonyOS实战开发-Stage模型、Stage和FA模型的区别
m0_70749039的博客
04-13 863
Stage模型 的设计，主要是为了解决FA模型无法解决的开发场景问题，方便开发者更加方便地开发出分布式环境下的复杂应用。
HarmonyOS应用开发-Stage模型开发（ArkTS）_鸿蒙app stage 比 fa模型好
2401_84182636的博客
04-17 1069
有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了。
HCIA-HarmonyOS应用开发工程师 V2.0 模拟考试
10-13
初级认证 HarmonyOS应用开发能力工程师模拟测试
博客的《鸿蒙Ability（一）：Feature Ability的Page Ability模板》文章的配套代码
05-17
HarmonyPageAbilityDemo.rar
HCIA鸿蒙设备开发认证习题整理1
08-08
本资源摘要信息对应的知识点主要涉及到HarmonyOS设备开发认证的相关知识领域，涵盖了操作系统、编程语言、开发工具、设备驱动、软件开发等方面。 一、操作系统 * HarmonyOS设备开发需要使用到Linux操作系统（题目1...
HarmonyOS移动应用开发
04-07
通过该课程的学习，您将掌握HarmonyOS基本概念及原理、HarmonyOS技术架构、HarmonyOS应用开发流程、Ability与UI开发知识，具备HarmonyOS功能开发、调试与发布的能力，能够胜任HarmonyOS应用开发工程师岗位。
鸿蒙HarmonyOS应用开发者认证 题库+答案案
01-18
本资源提供了鸿蒙HarmonyOS应用开发者认证的题库和答案，涵盖了HarmonyOS应用开发的多个方面，包括容器组件、 Ability、Web组件、网络请求、首选项、自定义组件、弹窗组件、图片加载、网络权限等。通过学习和理解...
HarmonyOS Ability简介1
08-08
Ability是应用所具备的能力的抽象，一个应用可以包含一个或多个AbilityAbility是用户程序的基本组成部分，HarmonyOS 支持应用以 Abil
HarmonyOS Feature Ability简介1
08-08
HarmonyOS Feature Ability 简介 HarmonyOS Feature Ability 是 HarmonyOS 操作系统中的一个重要组件，提供了丰富的功能和交互能力。本文将对 HarmonyOS Feature Ability 进行介绍，并详细解释其组成部分、生命周期...
华为harmonyos公测-HarmonyOS-examples:鸿蒙示例
07-01
HarmonyOS应用开发的各种示例，项目及开发教程汇总，帮助初学者快速掌握HarmonyOS应用开发。 没有人能熄灭满天的星光，每一位开发者，让我们在此汇集，一起点亮整个星空。 记得给仓库点个 Star 哟:winking_face: 一...
学习安卓开发的应用 能在鸿蒙系统上运行吗
07-15
然而，华为提供了一种名为"鸿蒙能力开放平台"（HarmonyOS Ability Open Platform）的技术，可以使安卓应用在鸿蒙系统上运行。通过这个平台，开发者可以将他们的安卓应用转换为鸿蒙系统上的应用。但是需要注意的是，...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值