devbox
weixin_40725706
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

鸿蒙开发接口Ability框架：【@ohos.ability.featureAbility (FeatureAbility模块)】

作者：weixin_40725706 | 2024-05-13 05:27:02

赞

踩

鸿蒙开发接口Ability框架：【@ohos.ability.featureAbility (FeatureAbility模块)】

FeatureAbility模块(JS端SDK接口)

FeatureAbility模块提供带有UI设计与用户交互的能力，包括启动新的ability、获取dataAbilityHelper、设置此Page Ability、获取当前Ability对应的窗口，连接服务等。

说明：

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

使用限制

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

导入模块

import featureAbility from '@ohos.ability.featureAbility'

鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

featureAbility.startAbility

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

启动新的ability（callback形式）。

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

参数：

名称类型必填描述
parameterStartAbilityParameter是表示被启动的Ability。
callbackAsyncCallback<number>是被指定的回调方法。

示例：

  1. import featureAbility from '@ohos.ability.featureAbility'
  2. import wantConstant from '@ohos.ability.wantConstant'
  3. featureAbility.startAbility(
  4.     {
  5.         want:
  6.         {
  7.             action: "",
  8.             entities: [""],
  9.             type: "",
  10.             flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
  11.             deviceId: "",
  12.             bundleName: "com.example.myapplication",
  13.             /* FA模型中abilityName由package + Ability name组成 */
  14.             abilityName: "com.example.entry.secondAbility",
  15.             uri: ""
  16.         },
  17.     },
  18. );

featureAbility.startAbility

startAbility(parameter: StartAbilityParameter): Promise<number>

启动新的ability（Promise形式）。

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

参数：

名称类型必填描述
parameterStartAbilityParameter是表示被启动的Ability。

示例：

  1. import featureAbility from '@ohos.ability.featureAbility'
  2. import wantConstant from '@ohos.ability.wantConstant'
  3. featureAbility.startAbility(
  4.     {
  5.         want:
  6.         {
  7.             action: "action.system.home",
  8.             entities: ["entity.system.home"],
  9.             type: "MIMETYPE",
  10.             flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
  11.             deviceId: "",
  12.             bundleName: "com.example.myapplication",
  13.             /* FA模型中abilityName由package + Ability name组成 */
  14.             abilityName: "com.example.entry.secondAbility",
  15.             uri: ""
  16.         },
  17.     }
  18. ).then((data) => {
  19.     console.info("==========================>startAbility=======================>");
  20. });

featureAbility.acquireDataAbilityHelper7+

acquireDataAbilityHelper(uri: string): DataAbilityHelper

获取dataAbilityHelper。

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

参数：

名称类型必填描述
uristring是指示要打开的文件的路径。

返回值：

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

示例：

  1. import featureAbility from '@ohos.ability.featureAbility'
  2. featureAbility.acquireDataAbilityHelper(
  3.     "dataability:///com.example.DataAbility"
  4. )

featureAbility.startAbilityForResult7+

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

启动一个ability，并在该ability被销毁时返回执行结果（callback形式）。

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

参数：

名称类型必填描述
parameterStartAbilityParameter是表示被启动的Ability。
callbackAsyncCallback<AbilityResult>是被指定的回调方法。

示例：

  1. import featureAbility from '@ohos.ability.featureAbility';
  2. import wantConstant from '@ohos.ability.wantConstant'
  3. featureAbility.startAbilityForResult(
  4.    {
  5.         want:
  6.         {
  7.             action: "action.system.home",
  8.             entities: ["entity.system.home"],
  9.             type: "MIMETYPE",
  10.             flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
  11.             deviceId: "",
  12.             bundleName: "com.example.myapplication",
  13.             /* FA模型中abilityName由package + Ability name组成 */
  14.             abilityName: "com.example.entry.secondAbility",
  15.             uri:""
  16.         },
  17.     },
  18.     (err, data) => {
  19.         console.info("err: " + JSON.stringify(err) + "data: " + JSON.stringify(data))
  20.     }
  21. )

featureAbility.startAbilityForResult7+

startAbilityForResult(parameter: StartAbilityParameter): Promise<AbilityResult>

启动一个ability，并在该ability被销毁时返回执行结果（Promise形式）。

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

参数：

名称类型必填描述
parameterStartAbilityParameter是表示被启动的Ability

返回值：

类型说明
Promise<AbilityResult>返回执行结果。

示例：

  1. import featureAbility from '@ohos.ability.featureAbility';
  2. import wantConstant from '@ohos.ability.wantConstant'
  3. featureAbility.startAbilityForResult(
  4.     {
  5.         want:
  6.         {
  7.             action: "action.system.home",
  8.             entities: ["entity.system.home"],
  9.             type: "MIMETYPE",
  10.             flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
  11.             deviceId: "",
  12.             bundleName: "com.example.myapplication",
  13.             /* FA模型中abilityName由package + Ability name组成 */
  14.             abilityName: "com.example.entry.secondAbility",
  15.             uri:"",
  16.             parameters:
  17.             {
  18.                 mykey0: 1111,
  19.                 mykey1: [1, 2, 3],
  20.                 mykey2: "[1, 2, 3]",
  21.                 mykey3: "xxxxxxxxxxxxxxxxxxxxxx",
  22.                 mykey4: [1, 15],
  23.                 mykey5: [false, true, false],
  24.                 mykey6: ["aaaaaa", "bbbbb", "ccccccccccc"],
  25.                 mykey7: true,
  26.             },
  27.         },
  28.     },
  29. ).then((data) => {
  30.     console.info("==========================>startAbilityForResult=======================>");
  31. });

featureAbility.terminateSelfWithResult7+

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

设置此Page Ability将返回给调用者的结果代码和数据并破坏此Page Ability（callback形式）。

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

参数：

名称类型必填描述
parameterAbilityResult是表示被启动的Ability。
callbackAsyncCallback<void>是被指定的回调方法。

示例：

  1. import featureAbility from '@ohos.ability.featureAbility'
  2. import wantConstant from '@ohos.ability.wantConstant'
  3. featureAbility.terminateSelfWithResult(
  4.     {
  5.         resultCode: 1,
  6.         want:
  7.         {
  8.             action: "action.system.home",
  9.             entities: ["entity.system.home"],
  10.             type: "MIMETYPE",
  11.             flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
  12.             deviceId: "",
  13.             bundleName: "com.example.myapplication",
  14.             /* FA模型中abilityName由package + Ability name组成 */
  15.             abilityName: "com.example.entry.secondAbility",
  16.             uri:"",
  17.             parameters: {
  18.                 mykey0: 2222,
  19.                 mykey1: [1, 2, 3],
  20.                 mykey2: "[1, 2, 3]",
  21.                 mykey3: "ssssssssssssssssssssssssss",
  22.                 mykey4: [1, 15],
  23.                 mykey5: [false, true, false],
  24.                 mykey6: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
  25.                 mykey7: true,
  26.             }
  27.         },
  28.     },
  29. );

featureAbility.terminateSelfWithResult7+

terminateSelfWithResult(parameter: AbilityResult): Promise<void>

设置此Page Ability将返回给调用者的结果代码和数据并破坏此Page Ability（Promise形式）。

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

参数：

名称类型必填描述
parameterAbilityResult是表示被启动的Ability

返回值：

类型说明
Promise<void>以Promise形式返回结果。

示例：

  1. import featureAbility from '@ohos.ability.featureAbility';
  2. import wantConstant from '@ohos.ability.wantConstant'
  3. featureAbility.terminateSelfWithResult(
  4.     {
  5.         resultCode: 1,
  6.         want:
  7.         {
  8.             action: "action.system.home",
  9.             entities: ["entity.system.home"],
  10.             type: "MIMETYPE",
  11.             flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
  12.             deviceId: "",
  13.             bundleName: "com.example.myapplication",
  14.             /* FA模型中abilityName由package + Ability name组成 */
  15.             abilityName: "com.example.entry.secondAbility",
  16.             uri:"",
  17.             parameters: {
  18.                 mykey0: 2222,
  19.                 mykey1: [1, 2, 3],
  20.                 mykey2: "[1, 2, 3]",
  21.                 mykey3: "ssssssssssssssssssssssssss",
  22.                 mykey4: [1, 15],
  23.                 mykey5: [false, true, false],
  24.                 mykey6: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
  25.                 mykey7: true,
  26.             }
  27.         },
  28.     }
  29. ).then((data) => {
  30.     console.info("==========================>terminateSelfWithResult=======================>");
  31. });

featureAbility.hasWindowFocus7+

hasWindowFocus(callback: AsyncCallback<boolean>): void

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

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

参数：

名称类型必填描述
callbackAsyncCallback<boolean>是被指定的回调方法。 如果此Ability当前具有视窗焦点，则返回true；否则返回false。

示例：

  1. import featureAbility from '@ohos.ability.featureAbility';
  2. featureAbility.hasWindowFocus()

featureAbility.hasWindowFocus7+

hasWindowFocus(): Promise<boolean>

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

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

返回值：

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

示例：

  1. import featureAbility from '@ohos.ability.featureability';
  2. featureAbility.hasWindowFocus().then((data) => {
  3.     console.info("==========================>hasWindowFocus=======================>");
  4. });

featureAbility.getWant

getWant(callback: AsyncCallback<Want>): void

获取从Ability发送的Want（callback形式）。

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

参数：

名称类型必填描述
callbackAsyncCallback<Want>是被指定的回调方法。

示例：

  1. import featureAbility from '@ohos.ability.featureAbility';
  2. featureAbility.getWant()

featureAbility.getWant

getWant(): Promise<Want>

获取从Ability发送的Want（Promise形式）。

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

返回值：

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

示例：

  1. import featureAbility from '@ohos.ability.featureAbility';
  2. featureAbility.getWant().then((data) => {
  3.     console.info("==========================>getWantCallBack=======================>");
  4. });

featureAbility.getContext

getContext(): Context

获取应用上下文。

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

返回值：

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

示例：

  1. import featureAbility from '@ohos.ability.featureAbility';
  2. var context = featureAbility.getContext()
  3. context.getBundleName()

featureAbility.terminateSelf7+

terminateSelf(callback: AsyncCallback<void>): void

设置Page Ability返回给被调用方的结果代码和数据，并销毁此Page Ability（callback形式）。

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

参数：

名称类型必填描述
callbackAsyncCallback<void>是被指定的回调方法

示例：

  1. import featureAbility from '@ohos.ability.featureAbility';
  2. featureAbility.terminateSelf()

featureAbility.terminateSelf7+

terminateSelf(): Promise<void>

设置Page Ability返回给被调用方的结果代码和数据，并销毁此Page Ability（Promise形式）。

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

返回值：

类型说明
Promise<void>以Promise的形式返回结果。

示例：

  1. import featureAbility from '@ohos.ability.featureAbility';
  2. featureAbility.terminateSelf().then((data) => {
  3.     console.info("==========================>terminateSelfCallBack=======================>");
  4. });

featureAbility.connectAbility7+

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

将当前ability连接到指定ServiceAbility（callback形式）。

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

参数：

名称类型必填描述
requestWant是表示被连接的ServiceAbility。
optionsConnectOptions是被指定的回调方法。

Want

want类型说明

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

名称读写属性类型必填描述
deviceId只读string否表示被连接的ServiceAbility的设备id，缺省表示连接本地的ServiceAbility。
bundleName只读string是表示被连接的ServiceAbility的包名。
abilityName只读string是表示被连接的ServiceAbility的类名。

ConnectOptions

ConnectOptions类型说明

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

名称读写属性类型必填描述
onConnect7+只读function是连接成功时的回调函数。
onDisconnect7+只读function是连接失败时的回调函数。
onFailed7+只读function是ConnectAbility调用失败时的回调函数。

返回值：

类型说明
number连接的ServiceAbilityID。

示例：

  1. import rpc from '@ohos.rpc'
  2. import featureAbility from '@ohos.ability.featureAbility'
  3. function onConnectCallback(element, remote){
  4.     console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
  5. }
  6. function onDisconnectCallback(element){
  7.     console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
  8. }
  9. function onFailedCallback(code){
  10.     console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
  11. }
  12. var connId = featureAbility.connectAbility(
  13.     {
  14.         deviceId: "",
  15.         bundleName: "com.ix.ServiceAbility",
  16.         abilityName: "ServiceAbilityA",
  17.     },
  18.     {
  19.         onConnect: onConnectCallback,
  20.         onDisconnect: onDisconnectCallback,
  21.         onFailed: onFailedCallback,
  22.     },
  23. );

featureAbility.disconnectAbility7+

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

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

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

参数：

名称类型必填描述
connectionnumber是指定断开连接的ServiceAbilityID
callbackAsyncCallback<void>是被指定的回调方法

示例：

  1. import rpc from '@ohos.rpc'
  2. import featureAbility from '@ohos.ability.featureAbility'
  3. function onConnectCallback(element, remote){
  4.     console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
  5. }
  6. function onDisconnectCallback(element){
  7.     console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
  8. }
  9. function onFailedCallback(code){
  10.     console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
  11. }
  12. var connId = featureAbility.connectAbility(
  13.     {
  14.         bundleName: "com.ix.ServiceAbility",
  15.         abilityName: "ServiceAbilityA",
  16.     },
  17.     {
  18.         onConnect: onConnectCallback,
  19.         onDisconnect: onDisconnectCallback,
  20.         onFailed: onFailedCallback,
  21.     },
  22. );
  23. var result = featureAbility.disconnectAbility(connId,
  24.     (error,data) => {
  25.         console.log('featureAbilityTest DisConnectJsSameBundleName result errCode : ' + error.code + " data: " + data)
  26.     },
  27. );

featureAbility.disconnectAbility7+

disconnectAbility(connection: number): Promise<void>

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

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

参数：

名称类型必填描述
connectionnumber是指定断开连接的ServiceAbilityID

返回值：

类型说明
Promise<void>以Promise形式返回结果。

示例：

  1. import rpc from '@ohos.rpc'
  2. import featureAbility from '@ohos.ability.featureAbility'
  3. function onConnectCallback(element, remote){
  4.     console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
  5. }
  6. function onDisconnectCallback(element){
  7.     console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
  8. }
  9. function onFailedCallback(code){
  10.     console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
  11. }
  12. var connId = featureAbility.connectAbility(
  13.     {
  14.         bundleName: "com.ix.ServiceAbility",
  15.         abilityName: "ServiceAbilityA",
  16.     },
  17.     {
  18.         onConnect: onConnectCallback,
  19.         onDisconnect: onDisconnectCallback,
  20.         onFailed: onFailedCallback,
  21.     },
  22. );
  23.  
  24. featureAbility.disconnectAbility(connId).then((data) => {
  25.     console.log('data : '  + data);
  26. }).catch((error)=>{
  27.     console.log('featureAbilityTest result errCode : ' + error.code);
  28. });

featureAbility.getWindow7+

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

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

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

参数：

名称类型必填描述
callbackAsyncCallback<window.Window>是返回与当前Ability对应的窗口。

示例：

featureAbility.getWindow()

featureAbility.getWindow7+

getWindow(): Promise<window.Window>;

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

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

返回值：

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

示例：

  1. featureAbility.getWindow().then((data) => {
  2.   console.info("=============getWindowPromise========== " +  JSON.stringify(data)); 
  3. });

ConnectOptions.onConnect7+

onConnect(elementName: ElementName, remote: rpc.IRemoteObject): void;

连接成功时的回调函数。

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

参数：

名称类型必填描述
elementNameElementName是元素名。
remoterpc.IRemoteObject是rpc远程对象。

示例：

  1. import rpc from '@ohos.rpc'
  2. import featureAbility from '@ohos.ability.featureAbility'
  3. function onConnectCallback(element, remote){
  4.     console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
  5. }
  6. function onDisconnectCallback(element){
  7.     console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
  8. }
  9. function onFailedCallback(code){
  10.     console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
  11. }
  12. var connId = featureAbility.connectAbility(
  13.     {
  14.         deviceId: "",
  15.         bundleName: "com.ix.ServiceAbility",
  16.         abilityName: "ServiceAbilityA",
  17.     },
  18.     {
  19.         onConnect: onConnectCallback,
  20.         onDisconnect: onDisconnectCallback,
  21.         onFailed: onFailedCallback,
  22.     },
  23. );

ConnectOptions.onDisconnect7+

onDisconnect(elementName: ElementName): void;

连接失败时的回调函数。

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

参数：

名称类型必填描述
elementNameElementName是元素名。

示例：

  1. import rpc from '@ohos.rpc'
  2. import featureAbility from '@ohos.ability.featureAbility'
  3. function onConnectCallback(element, remote){
  4.     console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
  5. }
  6. function onDisconnectCallback(element){
  7.     console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
  8. }
  9. function onFailedCallback(code){
  10.     console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
  11. }
  12. var connId = featureAbility.connectAbility(
  13.     {
  14.         deviceId: "",
  15.         bundleName: "com.ix.ServiceAbility",
  16.         abilityName: "ServiceAbilityA",
  17.     },
  18.     {
  19.         onConnect: onConnectCallback,
  20.         onDisconnect: onDisconnectCallback,
  21.         onFailed: onFailedCallback,
  22.     },
  23. );

ConnectOptions.onFailed7+

onFailed(code: number): void;

ConnectAbility调用失败时的回调函数。

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

参数：

名称类型必填描述
codenumber是number类型。

示例：

  1. import rpc from '@ohos.rpc'
  2. import featureAbility from '@ohos.ability.featureAbility'
  3. function onConnectCallback(element, remote){
  4.     console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy));
  5. }
  6. function onDisconnectCallback(element){
  7.     console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId)
  8. }
  9. function onFailedCallback(code){
  10.     console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code)
  11. }
  12. var connId = featureAbility.connectAbility(
  13.     {
  14.         deviceId: "",
  15.         bundleName: "com.ix.ServiceAbility",
  16.         abilityName: "ServiceAbilityA",
  17.     },
  18.     {
  19.         onConnect: onConnectCallback,
  20.         onDisconnect: onDisconnectCallback,
  21.         onFailed: onFailedCallback,
  22.     },
  23. );

AbilityWindowConfiguration

使用时通过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

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属性的名称。

ErrorCode

获取错误代码。

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

变量值说明
NO_ERROR7+0没有错误。
INVALID_PARAMETER7+-1无效的参数。
ABILITY_NOT_FOUND7+-2找不到能力。
PERMISSION_DENY7+-3拒绝许可。

DataAbilityOperationType

指示数据的操作类型。

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

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

AbilityResult

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

名称读写属性类型必填描述
resultCode7+只读number是指示销毁该能力后返回的结果代码。您可以定义结果代码来识别错误（暂不支持）。
want7+只读Want否指示销毁该能力后返回的数据。您可以定义返回的数据。此参数可以为null。

StartAbilityParameter

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

名称读写属性类型必填描述
want只读Want是表示需要包含有关目标启动能力的信息。
abilityStartSetting只读{[key: string]: any}否表示能力的特殊属性，当开发者启动能力时，该属性可以作为调用中的输入参数传递。

flags说明

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

名称参数描述
FLAG_AUTH_READ_URI_PERMISSION0x00000001指示对URI执行读取操作的授权。
FLAG_AUTH_WRITE_URI_PERMISSION0x00000002指示对URI执行写入操作的授权。
FLAG_ABILITY_FORWARD_RESULT0x00000004将结果返回给元能力。
FLAG_ABILITY_CONTINUATION0x00000008确定是否可以将本地设备上的功能迁移到远程设备。
FLAG_NOT_OHOS_COMPONENT0x00000010指定组件是否属于OHOS。
FLAG_ABILITY_FORM_ENABLED0x00000020指定是否启动某个能力。
FLAG_AUTH_PERSISTABLE_URI_PERMISSION0x00000040指示URI上可能持久化的授权。 系统API: 此接口为系统接口，三方应用不支持调用。
FLAG_AUTH_PREFIX_URI_PERMISSION0x00000080按照前缀匹配的方式验证URI权限。 系统API: 此接口为系统接口，三方应用不支持调用。
FLAG_ABILITYSLICE_MULTI_DEVICE0x00000100支持分布式调度系统中的多设备启动。
FLAG_START_FOREGROUND_ABILITY0x00000200指示无论主机应用程序是否已启动，都将启动使用服务模板的功能。 系统API: 此接口为系统接口，三方应用不支持调用。
FLAG_ABILITY_CONTINUATION_REVERSIBLE0x00000400表示迁移是可拉回的。
FLAG_INSTALL_ON_DEMAND0x00000800如果未安装指定的功能，请安装该功能。
FLAG_INSTALL_WITH_BACKGROUND_MODE0x80000000如果未安装，使用后台模式安装该功能。
FLAG_ABILITY_CLEAR_MISSION0x00008000指示清除其他任务的操作。可以为传递给 ohos.app.Context 中startAbility方法的Want设置此标志，并且必须与flag_ABILITY_NEW_MISSION一起使用。
FLAG_ABILITY_NEW_MISSION0x10000000指示在历史任务堆栈上创建任务的操作。
FLAG_ABILITY_MISSION_TOP0x20000000指示如果启动能力的现有实例已位于任务堆栈的顶部，则将重用该实例。否则，将创建一个新的能力实例。 HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

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

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

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

自己学习时必须要有一份实用的鸿蒙（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 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/weixin_40725706/article/detail/562047
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号