1# 元能力子系统Changelog 2 3## cl.ability.1 AbilityDelegator.startAbility()接口错误码变更 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11AbilityDelegator.startAbility()返回的所有错误码与API描述不一致。 12 13**变更影响** 14 15此变更不涉及应用适配。 16 17变更影响AbilityDelegator.startAbility()返回的所有错误码，错误码对照表如下： 18 19| 变更前 | 变更后 | 20| -------- | -------- | 21| 29360128 | 401 | 22| 2097199 | 16000001 | 23| 2097187 | 16000002 | 24| 2097179 | 16000004 | 25| 2097208 | 16000005 | 26| 2097207 |16000006 | 27| 2097203 | 16000008 | 28| 11 | 16000009 | 29| 2097206 | 16000010 | 30| 2097323 | 16000011 | 31| 2097204 | 16000012 | 32| 2097215 | 16000013 | 33| 2097167 | 16000050 | 34| 5242881 | 16000053 | 35| 29360300 | 16000055 | 36| 2097205 | 16200001 | 37 38**起始API Level** 39 40API 9 41 42**变更发生版本** 43 44从OpenHarmony SDK 6.0.0.32开始。 45 46**变更的接口/组件** 47 48AbilityDelegator提供的startAbility()接口。 49 50**适配指导** 51 52无需适配。 53 54AbilityDelegator提供的startAbility()接口参见[startAbility API参考](../../../application-dev/reference/apis-test-kit/js-apis-inner-application-abilityDelegator.md#startability9)。 55 56## cl.ability.2 借助Want进行文件分享时擦除不合法的URI 57 58**访问级别** 59 60公开接口 61 62**变更原因** 63 64在文件分享场景下（[Want](../../../application-dev/reference/apis-ability-kit/js-apis-app-ability-want.md#want)的flags字段中配置了[wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION](../../../application-dev/reference/apis-ability-kit/js-apis-app-ability-wantConstant.md#flags)或[wantConstant.Flags.FLAG_AUTH_WRITE_URI_PERMISSION](../../../application-dev/reference/apis-ability-kit/js-apis-app-ability-wantConstant.md#flags)），应用可以通过Want的uri字段传递单个URI、或者通过[wantConstant.Params.PARAMS_STREAM](../../../application-dev/reference/apis-ability-kit/js-apis-app-ability-wantConstant.md#params)的Key值传递多个URI。为了确保传递给目标应用的参数合法，系统将主动擦除不满足条件的URI。 65 66**变更影响** 67 68变更前：文件分享场景下，如果Want的uri字段中scheme为空，或wantConstant.Params.PARAMS_STREAM字段中的URI的scheme不为file，系统不做任何处理。 69 70变更后：文件分享场景下，如果Want的uri字段中scheme为空，或wantConstant.Params.PARAMS_STREAM字段中的URI的scheme不为file，系统将擦除对应的URI取值。 71 72**起始API Level** 73 74API 9 75 76**变更发生版本** 77 78从OpenHarmony SDK 6.0.0.32开始。 79 80**变更的接口/组件** 81 82启动和退出应用的相关接口在文件分享场景下可触发该变更，涉及的接口如下： 83 84[UIAbilityContext](../../../application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#uiabilitycontext): 85- startAbility(want: Want, callback: AsyncCallback<void>): void 86- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void 87- startAbility(want: Want, options?: StartOptions): Promise<void> 88- startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): void 89- startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>): void 90- startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityResult> 91- terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<void>): void 92- terminateSelfWithResult(parameter: AbilityResult): Promise<void> 93- connectServiceExtensionAbility(want: Want, options: ConnectOptions): number 94- startAbilityByCall(want: Want): Promise<Caller> 95- startUIServiceExtensionAbility(want: Want): Promise<void> 96- connectUIServiceExtensionAbility(want: Want, callback: UIServiceExtensionConnectCallback) : Promise<UIServiceProxy> 97 98[UIExtensionContext](../../../application-dev/reference/apis-ability-kit/js-apis-inner-application-uiExtensionContext.md#uiextensioncontext): 99 100- startAbility(want: Want, callback: AsyncCallback<void>): void 101- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void 102- startAbility(want: Want, options?: StartOptions): Promise<void> 103- startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): void 104- startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>): void 105- startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityResult> 106- connectServiceExtensionAbility(want: Want, options: ConnectOptions): number 107- terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<void>): void 108- terminateSelfWithResult(parameter: AbilityResult): Promise<void> 109- startUIServiceExtensionAbility(want: Want): Promise<void> 110- connectUIServiceExtensionAbility(want: Want, callback: UIServiceExtensionConnectCallback) : Promise<UIServiceProxy> 111 112**适配指导** 113 114排查Want的flags字段中是否设置了文件URI读写Flag(wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION或wantConstant.Flags.FLAG_AUTH_WRITE_URI_PERMISSION)，并且uri字段或wantConstant.Params.PARAMS_STREAM字段中写入了非[文件URI](../../../application-dev/reference/apis-core-file-kit/js-apis-file-fileuri.md#fileuri10)。 115 116以下两种处理方式任选其一： 117- 删除Want中flags字段的文件URI读写Flag。 118- 修改uri字段和wantConstant.Params.PARAMS_STREAM字段中的非文件URI为文件URI。如果原来写入的URI是沙箱路径，可以通过[fileUri.getUriFromPath](../../../application-dev/reference/apis-core-file-kit/js-apis-file-fileuri.md#fileurigeturifrompath)接口将其转为文件URI。 119