HarmonyOS实战开发：@ohos.ability.featureAbility (FeatureAbility模块)

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

FeatureAbility模块提供与用户进行交互的Ability的能力，包括启动新的Ability、停止Ability、获取dataAbilityHelper对象、获取当前Ability对应的窗口，连接断连Service等。

说明：

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

使用限制

FeatureAbility模块的接口只能在Page类型的Ability中调用

导入模块

import featureAbility from '@ohos.ability.featureAbility';

featureAbility.startAbility

startAbility(parameter: StartAbilityParameter, callback: AsyncCallback<number>): void

启动新的Ability（callback形式）。

使用规则：

  • 调用方应用位于后台时，使用该接口启动Ability需申请权限ohos.permission.START_ABILITIES_FROM_BACKGROUND
  • 跨应用场景下，目标Ability的visible属性若配置为false，调用方应用需申请权限ohos.permission.START_INVISIBLE_ABILITY
  • 组件启动规则详见：组件启动规则（FA模型）

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.startAbility。

参数：

参数名类型必填说明
parameterStartAbilityParameter是表示被启动的Ability。
callbackAsyncCallback<number>是回调函数。当启动Ability成功，err为undefined，data为0表示启动成功，data为其他表示启动失败；否则为错误对象。

错误码：

错误码ID错误信息
1Get ability error.
202Parameter is invalid.
16000001The specified ability does not exist.
16000002Incorrect ability type.
16000004Can not start invisible component.
16000005The specified process does not have the permission.
16000006Cross-user operations are not allowed.
16000008The crowdtesting application expires.
16000009An ability cannot be started or stopped in Wukong mode.
16000010The call with the continuation flag is forbidden.
16000011The context does not exist.
16000012The application is controlled.
16000013The application is controlled by EDM.
16000050Internal error.
16000053The ability is not on the top of the UI.
16000055Installation-free timed out.
16200001The caller has been released.

错误码详细介绍请参考errcode-ability

示例：

import featureAbility from '@ohos.ability.featureAbility';
import wantConstant from '@ohos.app.ability.wantConstant';
featureAbility.startAbility(
    {
        want:
        {
            action: '',
            entities: [''],
            type: '',
            flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
            deviceId: '',
            bundleName: 'com.example.myapplication',
            /* FA模型中abilityName由package + Ability name组成 */
            abilityName: 'com.example.myapplication.secondAbility',
            uri: ''
        },
    },
    (error, data) => {
        if (error && error.code !== 0) {
            console.error(`startAbility fail, error: ${JSON.stringify(error)}`);
        } else {
            console.log(`startAbility success, data: ${JSON.stringify(data)}`);
        }
    }
);

featureAbility.startAbility

startAbility(parameter: StartAbilityParameter): Promise<number>

启动新的Ability（Promise形式）。

使用规则：

  • 调用方应用位于后台时，使用该接口启动Ability需申请权限ohos.permission.START_ABILITIES_FROM_BACKGROUND
  • 跨应用场景下，目标Ability的visible属性若配置为false，调用方应用需申请权限ohos.permission.START_INVISIBLE_ABILITY
  • 组件启动规则详见：组件启动规则（FA模型）

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.startAbility。

参数：

参数名类型必填说明
parameterStartAbilityParameter是表示被启动的Ability。

返回值：

类型说明
Promise<number>Promise对象。返回0表示启动成功，返回其他表示启动失败。

错误码：

错误码ID错误信息
1Get ability error.
202Parameter is invalid.
16000001The specified ability does not exist.
16000002Incorrect ability type.
16000004Can not start invisible component.
16000005The specified process does not have the permission.
16000006Cross-user operations are not allowed.
16000008The crowdtesting application expires.
16000009An ability cannot be started or stopped in Wukong mode.
16000010The call with the continuation flag is forbidden.
16000011The context does not exist.
16000012The application is controlled.
16000013The application is controlled by EDM.
16000050Internal error.
16000053The ability is not on the top of the UI.
16000055Installation-free timed out.
16200001The caller has been released.

错误码详细介绍请参考errcode-ability

示例：

import featureAbility from '@ohos.ability.featureAbility';
import wantConstant from '@ohos.app.ability.wantConstant';
featureAbility.startAbility(
    {
        want:
        {
            action: 'ohos.want.action.home',
            entities: ['entity.system.home'],
            type: 'MIMETYPE',
            flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
            deviceId: '',
            bundleName: 'com.example.myapplication',
            /* FA模型中abilityName由package + Ability name组成 */
            abilityName: 'com.example.myapplication.secondAbility',
            uri: ''
        },
    }
).then((data) => {
    console.info(`startAbility data: ${JSON.stringify(data)}`);
});

featureAbility.acquireDataAbilityHelper7+

acquireDataAbilityHelper(uri: string): DataAbilityHelper

获取dataAbilityHelper对象。

使用规则：

  • 跨应用访问dataAbility，对端应用需配置关联启动
  • 调用方应用位于后台时，使用该接口访问dataAbility需申请权限（基于API 8或更早版本SDK开发的应用在启动DataAbility组件时不受此限制的约束）ohos.permission.START_ABILITIES_FROM_BACKGROUND
  • 跨应用场景下，目标dataAbility的visible属性若配置为false，调用方应用需申请权限ohos.permission.START_INVISIBLE_ABILITY
  • 组件启动规则详见：组件启动规则（FA模型）

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用dataShare.createDataShareHelper。

参数：

参数名类型必填说明
uristring是表示要打开的文件的路径。

返回值：

类型说明
DataAbilityHelper用来协助其他Ability访问DataAbility的工具类。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);

featureAbility.startAbilityForResult7+

startAbilityForResult(parameter: StartAbilityParameter, callback: AsyncCallback<AbilityResult>): void

启动一个Ability。Ability被启动后，有如下情况(callback形式):

  • 正常情况下可通过调用terminateSelfWithResult接口使之终止并且返回结果给调用方。
  • 异常情况下比如杀死Ability会返回异常信息给调用方, 异常信息中resultCode为-1。
  • 如果被启动的Ability模式是单实例模式, 不同应用多次调用该接口启动这个Ability，当这个Ability调用terminateSelfWithResult接口使之终止时，只将正常结果返回给最后一个调用方, 其它调用方返回异常信息, 异常信息中resultCode为-1。

使用规则：

  • 调用方应用位于后台时，使用该接口启动Ability需申请权限ohos.permission.START_ABILITIES_FROM_BACKGROUND
  • 跨应用场景下，目标Ability的visible属性若配置为false，调用方应用需申请权限ohos.permission.START_INVISIBLE_ABILITY
  • 组件启动规则详见：组件启动规则（FA模型）

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.startAbilityForResult。

参数：

参数名类型必填说明
parameterStartAbilityParameter是表示被启动的Ability。
callbackAsyncCallback<AbilityResult>是回调函数。当启动Ability成功，err为undefined，data为ability的启动结果；否则为错误对象。

错误码：

错误码ID错误信息
1Get ability error.
202Parameter is invalid.
16000001The specified ability does not exist.
16000002Incorrect ability type.
16000004Can not start invisible component.
16000005The specified process does not have the permission.
16000006Cross-user operations are not allowed.
16000008The crowdtesting application expires.
16000009An ability cannot be started or stopped in Wukong mode.
16000010The call with the continuation flag is forbidden.
16000011The context does not exist.
16000012The application is controlled.
16000013The application is controlled by EDM.
16000050Internal error.
16000053The ability is not on the top of the UI.
16000055Installation-free timed out.
16200001The caller has been released.

错误码详细介绍请参考errcode-ability

示例：

import featureAbility from '@ohos.ability.featureAbility';
import wantConstant from '@ohos.app.ability.wantConstant';
featureAbility.startAbilityForResult(
   {
        want:
        {
            action: 'ohos.want.action.home',
            entities: ['entity.system.home'],
            type: 'MIMETYPE',
            flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
            deviceId: '',
            bundleName: 'com.example.myapplication',
            /* FA模型中abilityName由package + Ability name组成 */
            abilityName: 'com.example.myapplication.secondAbility',
            uri:''
        },
    },
    (error, data) => {
        if (error && error.code !== 0) {
            console.error(`startAbilityForResult fail, error: ${JSON.stringify(error)}`);
        } else {
            console.log(`startAbilityForResult success, data: ${JSON.stringify(data)}`);
        }
    }
);

featureAbility.startAbilityForResult7+

startAbilityForResult(parameter: StartAbilityParameter): Promise<AbilityResult>

启动一个Ability。Ability被启动后，有如下情况(Promise形式):

  • 正常情况下可通过调用terminateSelfWithResult接口使之终止并且返回结果给调用方。
  • 异常情况下比如杀死Ability会返回异常信息给调用方, 异常信息中resultCode为-1。
  • 如果被启动的Ability模式是单实例模式, 不同应用多次调用该接口启动这个Ability，当这个Ability调用terminateSelfWithResult接口使之终止时，只将正常结果返回给最后一个调用方, 其它调用方返回异常信息, 异常信息中resultCode为-1。

使用规则：

  • 调用方应用位于后台时，使用该接口启动Ability需申请权限ohos.permission.START_ABILITIES_FROM_BACKGROUND
  • 跨应用场景下，目标Ability的visible属性若配置为false，调用方应用需申请权限ohos.permission.START_INVISIBLE_ABILITY
  • 组件启动规则详见：组件启动规则（FA模型）

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.startAbilityForResult。

参数：

参数名类型必填说明
parameterStartAbilityParameter是表示被启动的Ability

返回值：

类型说明
Promise<AbilityResult>Promise对象，返回启动Ability的结果。

错误码：

错误码ID错误信息
1Get ability error.
202Parameter is invalid.
16000001The specified ability does not exist.
16000002Incorrect ability type.
16000004Can not start invisible component.
16000005The specified process does not have the permission.
16000006Cross-user operations are not allowed.
16000008The crowdtesting application expires.
16000009An ability cannot be started or stopped in Wukong mode.
16000010The call with the continuation flag is forbidden.
16000011The context does not exist.
16000012The application is controlled.
16000013The application is controlled by EDM.
16000050Internal error.
16000053The ability is not on the top of the UI.
16000055Installation-free timed out.
16200001The caller has been released.

错误码详细介绍请参考errcode-ability

示例：

import featureAbility from '@ohos.ability.featureAbility';
import wantConstant from '@ohos.app.ability.wantConstant';
featureAbility.startAbilityForResult(
    {
        want:
        {
            action: 'ohos.want.action.home',
            entities: ['entity.system.home'],
            type: 'MIMETYPE',
            flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
            deviceId: '',
            bundleName: 'com.example.myapplication',
            /* FA模型中abilityName由package + Ability name组成 */
            abilityName: 'com.example.myapplication.secondAbility',
            uri:'',
            parameters:
            {
                mykey0: 1111,
                mykey1: [1, 2, 3],
                mykey2: '[1, 2, 3]',
                mykey3: 'xxxxxxxxxxxxxxxxxxxxxx',
                mykey4: [1, 15],
                mykey5: [false, true, false],
                mykey6: ['aaaaaa', 'bbbbb', 'ccccccccccc'],
                mykey7: true,
            },
        },
    },
).then((data) => {
    console.info(`startAbilityForResult data: ${JSON.stringify(data)}`);
});

featureAbility.terminateSelfWithResult7+

terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<void>): void

停止当前的Ability。如果该Ability是通过调用startAbilityForResult接口被拉起的，调用terminateSelfWithResult接口时会将结果返回给调用者，如果该Ability不是通过调用startAbilityForResult接口被拉起的，调用terminateSelfWithResult接口时不会有结果返回给调用者（callback形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.terminateSelfWithResult。

参数：

参数名类型必填说明
parameterAbilityResult是表示停止Ability之后返回的结果。
callbackAsyncCallback<void>是回调函数。当停止当前Ability成功，err为undefined，否则为错误对象。

错误码：

错误码ID错误信息
16000001The specified ability does not exist.
16000004Can not start invisible component.
16000005The specified process does not have the permission.
16000009An ability cannot be started or stopped in Wukong mode.
16000011The context does not exist.
16000050Internal error.

错误码详细介绍请参考errcode-ability

示例：

import featureAbility from '@ohos.ability.featureAbility';
import wantConstant from '@ohos.app.ability.wantConstant';
featureAbility.terminateSelfWithResult(
    {
        resultCode: 1,
        want:
        {
            action: 'ohos.want.action.home',
            entities: ['entity.system.home'],
            type: 'MIMETYPE',
            flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
            deviceId: '',
            bundleName: 'com.example.myapplication',
            /* FA模型中abilityName由package + Ability name组成 */
            abilityName: 'com.example.myapplication.secondAbility',
            uri:'',
            parameters: {
                mykey0: 2222,
                mykey1: [1, 2, 3],
                mykey2: '[1, 2, 3]',
                mykey3: 'ssssssssssssssssssssssssss',
                mykey4: [1, 15],
                mykey5: [false, true, false],
                mykey6: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
                mykey7: true,
            }
        },
    },
    (error) => {
        console.error(`error: ${JSON.stringify(error)}`);
    }
);

featureAbility.terminateSelfWithResult7+

terminateSelfWithResult(parameter: AbilityResult): Promise<void>

停止当前的Ability。如果该Ability是通过调用startAbilityForResult接口被拉起的，调用terminateSelfWithResult接口时会将结果返回给调用者，如果该Ability不是通过调用startAbilityForResult接口被拉起的，调用terminateSelfWithResult接口时不会有结果返回给调用者（Promise形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.terminateSelfWithResult。

参数：

参数名类型必填说明
parameterAbilityResult是表示停止Ability之后返回的结果

返回值：

类型说明
Promise<void>Promise对象。无返回结果的Promise对象。

错误码：

错误码ID错误信息
16000001The specified ability does not exist.
16000004Can not start invisible component.
16000005The specified process does not have the permission.
16000009An ability cannot be started or stopped in Wukong mode.
16000011The context does not exist.
16000050Internal error.

错误码详细介绍请参考errcode-ability

示例：

import featureAbility from '@ohos.ability.featureAbility';
import wantConstant from '@ohos.app.ability.wantConstant';
featureAbility.terminateSelfWithResult(
    {
        resultCode: 1,
        want:
        {
            action: 'ohos.want.action.home',
            entities: ['entity.system.home'],
            type: 'MIMETYPE',
            flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
            deviceId: '',
            bundleName: 'com.example.myapplication',
            /* FA模型中abilityName由package + Ability name组成 */
            abilityName: 'com.example.myapplication.secondAbility',
            uri:'',
            parameters: {
                mykey0: 2222,
                mykey1: [1, 2, 3],
                mykey2: '[1, 2, 3]',
                mykey3: 'ssssssssssssssssssssssssss',
                mykey4: [1, 15],
                mykey5: [false, true, false],
                mykey6: ['qqqqq', 'wwwwww', 'aaaaaaaaaaaaaaaaa'],
                mykey7: true,
            }
        },
    }
).then(() => {
    console.info('==========================>terminateSelfWithResult=======================>');
});

featureAbility.hasWindowFocus7+

hasWindowFocus(callback: AsyncCallback<boolean>): void

检查Ability的主窗口是否具有窗口焦点（callback形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用on('windowEvent')。

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是以callback的形式返回结果。
如果此Ability当前具有视窗焦点，则返回true；否则返回false。

错误码：

错误码ID错误信息
-102Failed to acquire ability object.

示例：

import featureAbility from '@ohos.ability.featureAbility';
featureAbility.hasWindowFocus((error, data) => {
    if (error && error.code !== 0) {
        console.error(`hasWindowFocus fail, error: ${JSON.stringify(error)}`);
    } else {
        console.log(`hasWindowFocus success, data: ${JSON.stringify(data)}`);
    }
});

featureAbility.hasWindowFocus7+

hasWindowFocus(): Promise<boolean>

检查Ability的主窗口是否具有窗口焦点（Promise形式）。

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

返回值：

类型说明
Promise<boolean>Promise形式返回结果，如果此Ability当前具有视窗焦点，则返回true；否则返回false。

错误码：

错误码ID错误信息
-102Failed to acquire ability object.

示例：

import featureAbility from '@ohos.ability.featureAbility';
featureAbility.hasWindowFocus().then((data) => {
    console.info(`hasWindowFocus data: ${JSON.stringify(data)}`);
});

featureAbility.getWant

getWant(callback: AsyncCallback<Want>): void

获取要拉起的Ability对应的Want（callback形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbility.launchWant。

参数：

参数名类型必填说明
callbackAsyncCallback<Want>是以callback的形式返回want。

错误码：

错误码ID错误信息
-102Failed to acquire ability object.
-106Call the ability interface, the return value is wrong.

示例：

import featureAbility from '@ohos.ability.featureAbility';
featureAbility.getWant((error, data) => {
    if (error && error.code !== 0) {
        console.error(`getWant fail, error: ${JSON.stringify(error)}`);
    } else {
        console.log(`getWant success, data: ${JSON.stringify(data)}`);
    }
});

featureAbility.getWant

getWant(): Promise<Want>

获取要拉起的Ability对应的Want（Promise形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbility.launchWant。

返回值：

类型说明
Promise<Want>以Promise的形式返回want。

错误码：

错误码ID错误信息
-102Failed to acquire ability object.
-106Call the ability interface, the return value is wrong.

示例：

import featureAbility from '@ohos.ability.featureAbility';
featureAbility.getWant().then((data) => {
    console.info(`getWant data: ${JSON.stringify(data)}`);
});

featureAbility.getContext

getContext(): Context

获取应用上下文。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbility.context。

返回值：

类型说明
Context返回应用程序上下文。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let context = featureAbility.getContext();
context.getBundleName((error, data) => {
    if (error && error.code !== 0) {
        console.error(`getBundleName fail, error: ${JSON.stringify(error)}`);
    } else {
        console.log(`getBundleName success, data: ${JSON.stringify(data)}`);
    }
});

featureAbility.terminateSelf7+

terminateSelf(callback: AsyncCallback<void>): void

停止当前的Ability（callback形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.terminateSelf。

参数：

参数名类型必填说明
callbackAsyncCallback<void>是以callback的形式返回停止当前Ability结果

错误码：

错误码ID错误信息
16000001The specified ability does not exist.
16000004Can not start invisible component.
16000005The specified process does not have the permission.
16000009An ability cannot be started or stopped in Wukong mode.
16000011The context does not exist.
16000050Internal error.

错误码详细介绍请参考errcode-ability

示例：

import featureAbility from '@ohos.ability.featureAbility';
featureAbility.terminateSelf(
    (error) => {
        console.error(`error: ${JSON.stringify(error)}`);
    }
)

featureAbility.terminateSelf7+

terminateSelf(): Promise<void>

停止当前的Ability（Promise形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.terminateSelf。

返回值：

类型说明
Promise<void>Promise对象。无返回结果的Promise对象。

错误码：

错误码ID错误信息
16000001The specified ability does not exist.
16000004Can not start invisible component.
16000005The specified process does not have the permission.
16000009An ability cannot be started or stopped in Wukong mode.
16000011The context does not exist.
16000050Internal error.

错误码详细介绍请参考errcode-ability

示例：

import featureAbility from '@ohos.ability.featureAbility';
featureAbility.terminateSelf().then(() => {
    console.info('==========================>terminateSelf=======================>');
});

featureAbility.connectAbility7+

connectAbility(request: Want, options:ConnectOptions): number

将当前Ability与指定的ServiceAbility进行连接。

使用规则：

  • 跨应用连接serviceAbility，对端应用需配置关联启动
  • 调用方应用位于后台时，使用该接口连接serviceAbility需申请权限（基于API 8或更早版本SDK开发的应用在启动ServiceAbility组件时不受此限制的约束）ohos.permission.START_ABILITIES_FROM_BACKGROUND
  • 跨应用场景下，目标serviceAbility的visible属性若配置为false，调用方应用需申请权限ohos.permission.START_INVISIBLE_ABILITY
  • 组件启动规则详见：组件启动规则（FA模型）

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.connectAbility。

参数：

参数名类型必填说明
requestWant是表示被连接的ServiceAbility。
optionsConnectOptions是表示连接回调函数。

返回值：

类型说明
number连接的ServiceAbility的ID(ID从0开始自增，每连接成功一次ID加1)。

错误码：

错误码ID错误信息
-1Invalid parameter.
-2Ability not found.
-3Permission denied.
16000001The specified ability does not exist.
16000002Incorrect ability type.
16000004Can not start invisible component.
16000005The specified process does not have the permission.
16000006Cross-user operations are not allowed.
16000008The crowdtesting application expires.
16000053The ability is not on the top of the UI.
16000055Installation-free timed out.
16000011The context does not exist.
16000050Internal error.

错误码详细介绍请参考errcode-ability

示例：

import rpc from '@ohos.rpc';
import featureAbility from '@ohos.ability.featureAbility';

let connectId = featureAbility.connectAbility(
    {
        deviceId: '',
        bundleName: 'com.ix.ServiceAbility',
        abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
    },
    {
        onConnect: (element, remote) => {
            console.log(`ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}`);
        },
        onDisconnect: (element) => {
            console.log(`ConnectAbility onDisconnect element.deviceId : ${element.deviceId}`)
        },
        onFailed: (code) => {
            console.error(`featureAbilityTest ConnectAbility onFailed errCode : ${code}`)
        },
    },
);

featureAbility.disconnectAbility7+

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

断开与指定ServiceAbility的连接（callback形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.disconnectAbility。

参数：

参数名类型必填说明
connectionnumber是表示断开连接的ServiceAbility的ID。
callbackAsyncCallback<void>是以callback的形式返回断开连接结果

错误码：

错误码ID错误信息
-102Failed to acquire ability object.
-105Type of ability is invalid.
16000011The context does not exist.
16000050Internal error.

错误码详细介绍请参考errcode-ability

示例：

import rpc from '@ohos.rpc';
import featureAbility from '@ohos.ability.featureAbility';

let connectId = featureAbility.connectAbility(
    {
        bundleName: 'com.ix.ServiceAbility',
        abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
    },
    {
        onConnect: (element, remote) => {
            console.log(`ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}`);
        },
        onDisconnect: (element) => {
            console.log(`ConnectAbility onDisconnect element.deviceId : ${element.deviceId}`);
        },
        onFailed: (code) => {
            console.error(`featureAbilityTest ConnectAbility onFailed errCode : ${code}`);
        },
    },
);

featureAbility.disconnectAbility(connectId, (error) => {
    if (error && error.code !== 0) {
        console.error(`disconnectAbility fail, connectId: ${connectId}, error: ${JSON.stringify(error)}`);
    } else {
        console.log(`disconnectAbility success， connectId: ${connectId}`);
    }
});

featureAbility.disconnectAbility7+

disconnectAbility(connection: number): Promise<void>

断开与指定ServiceAbility的连接（Promise形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用UIAbilityContext.disconnectAbility。

参数：

参数名类型必填说明
connectionnumber是表示断开连接的ServiceAbility的ID。

返回值：

类型说明
Promise<void>Promise对象。无返回结果的Promise对象。

错误码：

错误码ID错误信息
-102Failed to acquire ability object.
-105Type of ability is invalid.
16000011The context does not exist.
16000050Internal error.

错误码详细介绍请参考errcode-ability

示例：

import rpc from '@ohos.rpc';
import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';

let connectId = featureAbility.connectAbility(
    {
        bundleName: 'com.ix.ServiceAbility',
        abilityName: 'com.ix.ServiceAbility.ServiceAbilityA',
    },
    {
        onConnect: (element, remote) => {
            console.log(`ConnectAbility onConnect remote is proxy: ${(remote instanceof rpc.RemoteProxy)}`);
        },
        onDisconnect: (element) => {
            console.log(`ConnectAbility onDisconnect element.deviceId : ${element.deviceId}`);
        },
        onFailed: (code) => {
            console.error(`featureAbilityTest ConnectAbility onFailed errCode : ${code}`);
        },
    },
);

featureAbility.disconnectAbility(connectId).then(() => {
    console.log('disconnectAbility success')
}).catch((error: BusinessError)=>{
    console.error(`featureAbilityTest result errCode : ${error.code}`);
});

featureAbility.getWindow7+

getWindow(callback: AsyncCallback<window.Window>): void

获取当前Ability对应的窗口（callback形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用window.getLastWindow。

参数：

参数名类型必填说明
callbackAsyncCallback<window.Window>是callback形式返回当前Ability对应的窗口。

错误码：

错误码ID错误信息
-102Failed to acquire ability object.

示例：

import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';
import window from '@ohos.window';

export default {

  onActive() {
    console.info("onActive");
    featureAbility.getWindow((error: BusinessError, data: window.Window) => {
      if (error && error.code !== 0) {
        console.error(`getWindow fail, error: ${JSON.stringify(error)}`);
      } else {
        console.log(`getWindow success, data: ${typeof(data)}`);
      }
    });
  }
}

featureAbility.getWindow7+

getWindow(): Promise<window.Window>

获取当前Ability对应的窗口（Promise形式）。

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

说明：本接口仅可在FA模型下使用，Stage模型下需使用window.getLastWindow。

返回值：

类型说明
Promise<window.Window>Promise形式返回当前Ability对应的窗口。

错误码：

错误码ID错误信息
-102Failed to acquire ability object.

示例：

import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';
import window from '@ohos.window';

export default {

  onActive() {
    console.info("onActive");
    featureAbility.getWindow().then((data: window.Window) => {
        console.log(`getWindow success, data: ${typeof(data)}`);
    }).catch((error: BusinessError)=>{
        console.error(`getWindow fail, error: ${JSON.stringify(error)}`);
    });
  }
}

AbilityWindowConfiguration

表示当前Ability对应的窗口配置项，使用时通过featureAbility.AbilityWindowConfiguration获取。

示例：

featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel

名称值说明
WINDOW_MODE_UNDEFINED7+0未定义。
WINDOW_MODE_FULLSCREEN7+1全屏。
WINDOW_MODE_SPLIT_PRIMARY7+100屏幕如果是水平方向表示左分屏，屏幕如果是竖直方向表示上分屏。
WINDOW_MODE_SPLIT_SECONDARY7+101屏幕如果是水平方向表示右分屏，屏幕如果是竖直方向表示下分屏。
WINDOW_MODE_FLOATING7+102悬浮窗。

AbilityStartSetting

表示当前Ability对应的窗口属性，abilityStartSetting属性是一个定义为[key: string]: any的对象，key对应设定类型为：AbilityStartSetting枚举类型，value对应设定类型为：AbilityWindowConfiguration枚举类型。

使用时通过featureAbility.AbilityStartSetting获取。

示例：

featureAbility.AbilityStartSetting.BOUNDS_KEY

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel

名称值说明
BOUNDS_KEY7+'abilityBounds'窗口显示大小属性的参数名。
WINDOW_MODE_KEY7+'windowMode'窗口显示模式属性的参数名。
DISPLAY_ID_KEY7+'displayId'窗口显示设备ID属性的参数名。

DataAbilityOperationType

表示数据的操作类型。DataAbility批量操作数据时可以通过该枚举值指定操作类型

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel

名称值说明
TYPE_INSERT7+1插入类型。
TYPE_UPDATE7+2修改类型。
TYPE_DELETE7+3删除类型。
TYPE_ASSERT7+4声明类型。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（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学习资料

总结

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

蜀道衫QAQ
关注
  • 7
    点赞
  • 踩
  • 20
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Stage模型
坚果的博客
12-23 8864
版本：Api9，Stage模型。
梅克尔工作室-赵一帆-鸿蒙笔记4
m0_62393927的博客
02-12 1173
ArkTS整理笔记
HarmonyOS实战开发：@ohos.data.dataShare (数据共享)
2401_84194030的博客
05-31 1071
DataShare用于应用管理其自身数据，同时支持同个设备上不同应用间的数据共享。
鸿蒙开发接口Ability框架：【@ohos.application.Ability (Ability)】
2301_76813281的博客
04-30 1043
Ability模块提供对Ability生命周期、上下文环境等调用管理的能力，包括Ability创建、销毁、转储客户端信息等。本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。本模块接口仅可在Stage模型下使用。
Stage模型下指定Ability的启动页面
坚果的博客
02-02 2362
对象的loadContent()方法设置启动页面。需要注意的是在DevEco Studio中创建的Ability中，该Ability实例默认会加载Index页面，根据需要将Index页面路径替换为需要的页面路径即可。应用中的Ability在启动过程中，需要指定启动页面，否则应用启动后会因为没有默认加载页面而导致白屏。可以在Ability的onWindowStageCreate()生命周期回调中，通过。
HarmonyOS 应用开发之组件启动规则（Stage模型）
maniuT的博客
03-29 771
以打开浏览器为例，假设设备上安装了一个或多个浏览器应用。当存在多个匹配的应用时，系统将弹出应用选择框供用户选择。示意效果如下图所示。在调用方UIAbility中，使用隐式Want方式启动浏览器应用。4.鸿蒙开发系统底层方向。1.项目开发必备面试题。5.鸿蒙音视频开发方向。6.鸿蒙车载开发方向。7.鸿蒙南向开发方向。
精通HarmonyOS应用开发：从入门到高级实战"
最新发布
07-06
- 理解HarmonyOS的应用开发框架，包括Ability、Window、Scene等。 - 学习如何使用HarmonyOS的UI框架和组件。 ### 4. 熟悉API和开发工具 - 掌握HarmonyOS提供的API，包括系统服务、多媒体、网络等。 - 学习如何使用...
HarmonyOS应用开发基础知识.pdf
12-28
在 HarmonyOS 中，应用程序由一个或多个 HAP（HarmonyOS Ability Package）组成，HAP 是 Ability 的部署包，每个 HAP 都是由代码、资源、第三方库及应用配置文件组成的模块包。HAP 可以分为两种类型：entry 和 ...
HarmonyOS开发必备基础知识.pdf
10-14
HAP是Ability的部署包，是HarmonyOS应用代码围绕Ability组件展开的模块包。一个HAP包含代码、资源、第三方库及应用清单文件。HAP可以分为entry和feature两种模块类型。 * entry：应用的主模块。一个APP中，对于同一...
3-6.HarmonyOS概述：应用开发基础知识.pdf
10-21
2. **HAP（HarmonyOS Ability Package）**: HAP 是 Ability 的部署包，是构建 HarmonyOS 应用的基本模块。一个 HAP 包含代码、资源、第三方库和应用配置文件。HAP 可以分为两种类型： - **Entry HAP**: 应用的主...
harmonyos-tutorial:HarmonyOS Tutorial. 《跟老卫学HarmonyOS》
05-04
《跟老卫学HarmonyOS开发》是一本 HarmonyOS 应用开发的开源学习教程，主要介绍如何从0开始开发 HarmonyOS 应用。本书包括最新版本 HarmonyOS 2.0 中的新特性。图文并茂，并通过大量实例带你走近 HarmonyOS 的世界！...
鸿蒙开发接口Ability框架：【(AbilityContext)】
2301_76813281的博客
05-12 1163
AbilityContext是Ability的上下文环境，继承自Context。AbilityContext模块提供允许访问特定于ability的资源的能力，包括对Ability的启动、停止的设置、获取caller通信接口、拉起弹窗请求用户授权等。本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。本模块接口仅可在Stage模型下使用。
鸿蒙原生应用元服务-访问控制（权限）开发应用权限列表二
weixin_69135651的博客
04-24 971
允许应用使用系统身份凭据管理能力进行口令、人脸、指纹等录入、修改、删除等操作。允许应用使用口令输入接口，用于系统应用完成口令输入框绘制场景。允许应用查询其他应用的快捷方式信息、启动其他应用的快捷方式。允许应用使用系统身份认证能力进行用户身份认证或身份识别。允许应用监听输入事件，仅系统签名应用可申请此权限。允许应用获取对端WLAN或者蓝牙设备的MAC地址。允许应用获取本机WLAN或者蓝牙设备的MAC地址。允许系统应用查询其他应用在前台或后台的运行时间。本文根据HarmonyOS官方文档API9整理。
HarmonyOS鸿蒙开发之06 通过代码创建页面 Feature Ability（教程含源码）
iCloudEnd的博客
09-12 7158
实战需求 本期，我们来从零开始通过代码创建一个页面 前期文章 原创 HarmonyOS 鸿蒙入门教程之01 基础环境和开发工具 （教程含源码） 原创 HarmonyOS 鸿蒙开发之02开发工具安装 原创 HarmonyOS 鸿蒙入门教程之03 运行开发工具完成基础配置DevEco Studio（教程含源码） 原创 HarmonyOS鸿蒙开发之04 运行第一个hello world （教程含源码） 原创 HarmonyOS鸿蒙开发之05 运行第一个页面 （教程含源码） 通过代码编写您的第一个鸿蒙App页
华为鸿蒙JSAPI跳转第三方应用
Drumsticks的博客
12-30 1938
以跳转支付宝基金页面为例，需要API版本6以上 官方文档 import featureAbility from '@ohos.ability.featureAbility'; 方法体： var str = { "StartAbilityParameter": { "want": { "uri": "alipays://platformapi/startapp?appId=20000793", "action": "andr
HarmonyOS之深入解析应用的权限
╰つ栺尖篴夢ゞ
07-26 4510
一、权限概述 ① 基本概念 应用沙盒： 系统利用内核保护机制来识别和隔离应用资源，可将不同的应用隔离开，保护应用自身和系统免受恶意应用的攻击。默认情况下，应用间不能彼此交互，而且对系统的访问会受到限制。 例如，如果应用 A（一个单独的应用）尝试在没有权限的情况下读取应用B的数据或者调用系统的能力拨打电话，操作系统会阻止此类行为，因为应用 A 没有被授予相应的权限。 应用权限： 由于系统通过沙盒机制管理各个应用，在默认规则下，应用只能访问有限的系统资源。但应用为了扩展功能的需要，需要访问
鸿蒙系统学习六-Ability之间跳转和传参
luwei233的博客
08-17 5288
AbilitySlice 间跳转 present 当发起的 AbilitySlice 和目标的 AbilitySlice 处于同一个 Page 时，您可以通过 present()方法实现跳转 界面一如图：点击跳转界面二并传递参数，AbilitySlice之前传参也通过Intent，如下代码所示： public class MainAbilitySlice extends AbilitySlice { @Override public void onStart(Intent intent)
鸿蒙组件包之 ohos.accessibility.ability （HarmonyOS鸿蒙开发基础知识）
iCloudEnd的博客
11-01 4046
ohos.accessibility.ability 提供可访问性服务开发框架，供您开发自己的可访问性应用程序。 要开发可访问性应用程序，必须创建一个继承AccessibleAbility类的可访问性服务。此类提供以下基本的辅助功能服务功能： 使用AccessibleAbility.onAbilityConnected（）设置服务连接 使用AccessibleAbility.onInterrupt（）处理服务中断 使用AccessibleAbility.onAccessibilityEvent（ohos.a
HarmonyOS应用开发详解：HAP与Ability解析
" HarmonyOS开发涉及的基础概念包括应用程序结构、 Ability组件、库文件、资源文件、清单文件以及应用配置文件。HarmonyOS应用基于APPPack（Application Package）发布，由一个或多个HAP（HarmonyOS Ability Package...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值