1# 元能力子系统JS API变更 2 3OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，元能力子系统的API变更如下: 4 5## 接口变更 6 7| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | 8|---|---|---|---| 9| featureability | FeatureAbility | static getDeviceList(flag: number): Promise\<Result>; | 新增 | 10| customizeData | CustomizeData | extra: string; | 新增 | 11| applicationInfo | ApplicationInfo | readonly entityType: string; | 新增 | 12| applicationInfo | ApplicationInfo | readonly uid: number; | 新增 | 13| applicationInfo | ApplicationInfo | readonly accessTokenId: number; | 新增 | 14| applicationInfo | ApplicationInfo | readonly removable: boolean; | 新增 | 15| applicationInfo | ApplicationInfo | readonly metaData: Map\<string, Array\<CustomizeData>>; | 新增 | 16| applicationInfo | ApplicationInfo | readonly codePath: string; | 新增 | 17| applicationInfo | ApplicationInfo | readonly moduleInfos: Array\<ModuleInfo>; | 新增 | 18| shellCmdResult | ShellCmdResult | exitCode: number; | 新增 | 19| shellCmdResult | ShellCmdResult | stdResult: String; | 新增 | 20| ProcessRunningInfo | ProcessRunningInfo | bundleNames: Array\<string>; | 新增 | 21| ProcessRunningInfo | ProcessRunningInfo | processName: string; | 新增 | 22| ProcessRunningInfo | ProcessRunningInfo | uid: number; | 新增 | 23| ProcessRunningInfo | ProcessRunningInfo | pid: number; | 新增 | 24| BaseContext | BaseContext | stageMode: boolean; | 新增 | 25| abilityDelegatorArgs | AbilityDelegatorArgs | testRunnerClassName: string; | 新增 | 26| abilityDelegatorArgs | AbilityDelegatorArgs | testCaseNames: string; | 新增 | 27| abilityDelegatorArgs | AbilityDelegatorArgs | parameters: {[key: string]: string}; | 新增 | 28| abilityDelegatorArgs | AbilityDelegatorArgs | bundleName: string; | 新增 | 29| abilityDelegator | AbilityDelegator | executeShellCommand(cmd: string, callback: AsyncCallback\<ShellCmdResult>): void;<br>executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\<ShellCmdResult>): void;<br>executeShellCommand(cmd: string, timeoutSecs?: number): Promise\<ShellCmdResult>; | 新增 | 30| abilityDelegator | AbilityDelegator | print(msg: string, callback: AsyncCallback\<void>): void;<br>print(msg: string): Promise\<void>; | 新增 | 31| context | Context | printDrawnCompleted(callback: AsyncCallback\<void>): void;<br>printDrawnCompleted(): Promise\<void>; | 新增 | 32| context | Context | isUpdatingConfigurations(callback: AsyncCallback\<boolean>): void;<br>isUpdatingConfigurations(): Promise\<boolean>; | 新增 | 33| context | Context | getAbilityInfo(callback: AsyncCallback\<AbilityInfo>): void<br>getAbilityInfo(): Promise\<AbilityInfo>; | 新增 | 34| context | Context | getApplicationContext(): Context; | 新增 | 35| context | Context | getAppVersionInfo(callback: AsyncCallback\<AppVersionInfo>): void<br>getAppVersionInfo(): Promise\<AppVersionInfo>; | 新增 | 36| context | Context | getHapModuleInfo(callback: AsyncCallback\<HapModuleInfo>): void<br>getHapModuleInfo(): Promise\<HapModuleInfo>; | 新增 | 37| context | Context | getAppType(callback: AsyncCallback\<string>): void<br>getAppType(): Promise\<string>; | 新增 | 38| context | Context | getOrCreateDistributedDir(): Promise\<string>;<br>getOrCreateDistributedDir(callback: AsyncCallback\<string>): void; | 新增 | 39| context | Context | getCacheDir(callback: AsyncCallback\<string>): void;<br>getCacheDir(): Promise\<string>; | 新增 | 40| context | Context | getFilesDir(callback: AsyncCallback\<string>): void;<br>getFilesDir(): Promise\<string>; | 新增 | 41| context | Context | setWakeUpScreen(wakeUp: boolean, callback: AsyncCallback\<void>): void<br>setWakeUpScreen(wakeUp: boolean): Promise\<void>; | 新增 | 42| context | Context | setShowOnLockScreen(show: boolean, callback: AsyncCallback\<void>): void<br>setShowOnLockScreen(show: boolean): Promise\<void>; | 新增 | 43| context | Context | setDisplayOrientation(orientation: DisplayOrientation, callback: AsyncCallback\<void>): void<br>setDisplayOrientation(orientation: DisplayOrientation): Promise\<void>; | 新增 | 44| context | Context | getDisplayOrientation(callback: AsyncCallback\<DisplayOrientation>): void<br>getDisplayOrientation(): Promise\<DisplayOrientation>; | 新增 | 45| appVersionInfo | AppVersionInfo | readonly versionName: string; | 新增 | 46| appVersionInfo | AppVersionInfo | readonly versionCode: number; | 新增 | 47| appVersionInfo | AppVersionInfo | readonly appName: string; | 新增 | 48| dataAbilityHelper | PacMap | [key: string]: number \| string \| boolean \| Array\<string \| number \| boolean> \| null; | 新增 | 49| dataAbilityHelper | DataAbilityHelper | executeBatch(uri: string, operations: Array\<DataAbilityOperation>, callback: AsyncCallback\<Array\<DataAbilityResult>>): void;<br>executeBatch(uri: string, operations: Array\<DataAbilityOperation>): Promise\<Array\<DataAbilityResult>>; | 新增 | 50| dataAbilityHelper | DataAbilityHelper | call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCallback\<PacMap>): void;<br>call(uri: string, method: string, arg: string, extras: PacMap): Promise\<PacMap>; | 新增 | 51| ohos.application.Want | Want | entities?: Array\<string>; | 新增 | 52| ohos.application.Want | Want | parameters?: {[key: string]: any}; | 新增 | 53| ohos.application.Want | Want | action?: string; | 新增 | 54| ohos.application.Want | Want | flags?: number; | 新增 | 55| ohos.application.Want | Want | type?: string; | 新增 | 56| ohos.application.Want | Want | uri?: string; | 新增 | 57| ohos.application.Want | Want | abilityName?: string; | 新增 | 58| ohos.application.Want | Want | bundleName?: string; | 新增 | 59| ohos.application.Want | Want | deviceId?: string; | 新增 | 60| ohos.application.testRunner | TestRunner | onRun(): void; | 新增 | 61| ohos.application.testRunner | TestRunner | onPrepare(): void; | 新增 | 62| ohos.application.formProvider | formProvider | updateForm(formId: string, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback\<void>): void;<br>updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Promise\<void>; | 新增 | 63| ohos.application.formProvider | formProvider | setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback\<void>): void;<br>setFormNextRefreshTime(formId: string, minute: number): Promise\<void>; | 新增 | 64| ohos.application.formInfo | FormParam | TEMPORARY_KEY = "ohos.extra.param.key.form_temporary" | 新增 | 65| ohos.application.formInfo | FormParam | HEIGHT_KEY = "ohos.extra.param.key.form_height" | 新增 | 66| ohos.application.formInfo | FormParam | WIDTH_KEY = "ohos.extra.param.key.form_width" | 新增 | 67| ohos.application.formInfo | FormParam | MODULE_NAME_KEY = "ohos.extra.param.key.module_name" | 新增 | 68| ohos.application.formInfo | FormParam | NAME_KEY = "ohos.extra.param.key.form_name" | 新增 | 69| ohos.application.formInfo | FormParam | DIMENSION_KEY = "ohos.extra.param.key.form_dimension" | 新增 | 70| ohos.application.formInfo | FormState | READY = 1 | 新增 | 71| ohos.application.formInfo | FormState | DEFAULT = 0 | 新增 | 72| ohos.application.formInfo | FormState | UNKNOWN = -1 | 新增 | 73| ohos.application.formInfo | FormStateInfo | want: Want; | 新增 | 74| ohos.application.formInfo | FormStateInfo | formState: FormState; | 新增 | 75| ohos.application.formInfo | ColorMode | MODE_LIGHT = 1 | 新增 | 76| ohos.application.formInfo | ColorMode | MODE_DARK = 0 | 新增 | 77| ohos.application.formInfo | ColorMode | MODE_AUTO = -1 | 新增 | 78| ohos.application.formInfo | FormType | JS = 1 | 新增 | 79| ohos.application.formInfo | FormInfo | customizeData: {[key: string]: [value: string]}; | 新增 | 80| ohos.application.formInfo | FormInfo | supportDimensions: Array\<number>; | 新增 | 81| ohos.application.formInfo | FormInfo | defaultDimension: number; | 新增 | 82| ohos.application.formInfo | FormInfo | updateDuration: number; | 新增 | 83| ohos.application.formInfo | FormInfo | formConfigAbility: string; | 新增 | 84| ohos.application.formInfo | FormInfo | scheduledUpdateTime: string; | 新增 | 85| ohos.application.formInfo | FormInfo | relatedBundleName: string; | 新增 | 86| ohos.application.formInfo | FormInfo | formVisibleNotify: boolean; | 新增 | 87| ohos.application.formInfo | FormInfo | updateEnabled: boolean; | 新增 | 88| ohos.application.formInfo | FormInfo | isDefault: boolean; | 新增 | 89| ohos.application.formInfo | FormInfo | colorMode: ColorMode; | 新增 | 90| ohos.application.formInfo | FormInfo | jsComponentName: string; | 新增 | 91| ohos.application.formInfo | FormInfo | type: FormType; | 新增 | 92| ohos.application.formInfo | FormInfo | description: string; | 新增 | 93| ohos.application.formInfo | FormInfo | name: string; | 新增 | 94| ohos.application.formInfo | FormInfo | abilityName: string; | 新增 | 95| ohos.application.formInfo | FormInfo | moduleName: string; | 新增 | 96| ohos.application.formInfo | FormInfo | bundleName: string; | 新增 | 97| ohos.application.formError | FormError | ERR_IN_RECOVERY = 36 | 新增 | 98| ohos.application.formError | FormError | ERR_FORM_DUPLICATE_ADDED = 31 | 新增 | 99| ohos.application.formError | FormError | ERR_SYSTEM_RESPONSES_FAILED = 30 | 新增 | 100| ohos.application.formError | FormError | ERR_FORM_FA_NOT_INSTALLED = 20 | 新增 | 101| ohos.application.formError | FormError | ERR_FORM_NO_SUCH_DIMENSION = 19 | 新增 | 102| ohos.application.formError | FormError | ERR_FORM_NO_SUCH_ABILITY = 18 | 新增 | 103| ohos.application.formError | FormError | ERR_FORM_NO_SUCH_MODULE = 17 | 新增 | 104| ohos.application.formError | FormError | ERR_MAX_SYSTEM_TEMP_FORMS = 16 | 新增 | 105| ohos.application.formError | FormError | ERR_MAX_FORMS_PER_CLIENT = 15 | 新增 | 106| ohos.application.formError | FormError | ERR_PROVIDER_DEL_FAIL = 14 | 新增 | 107| ohos.application.formError | FormError | ERR_OPERATION_FORM_NOT_SELF = 13 | 新增 | 108| ohos.application.formError | FormError | ERR_MAX_INSTANCES_PER_FORM = 12 | 新增 | 109| ohos.application.formError | FormError | ERR_MAX_SYSTEM_FORMS = 11 | 新增 | 110| ohos.application.formError | FormError | ERR_BIND_PROVIDER_FAILED = 10 | 新增 | 111| ohos.application.formError | FormError | ERR_NOT_EXIST_ID = 9 | 新增 | 112| ohos.application.formError | FormError | ERR_CFG_NOT_MATCH_ID = 8 | 新增 | 113| ohos.application.formError | FormError | ERR_ADD_INVALID_PARAM = 7 | 新增 | 114| ohos.application.formError | FormError | ERR_GET_LAYOUT_FAILED = 6 | 新增 | 115| ohos.application.formError | FormError | ERR_GET_BUNDLE_FAILED = 5 | 新增 | 116| ohos.application.formError | FormError | ERR_GET_INFO_FAILED = 4 | 新增 | 117| ohos.application.formError | FormError | ERR_PERMISSION_DENY = 2 | 新增 | 118| ohos.application.formError | FormError | ERR_COMMON = 1 | 新增 | 119| ohos.application.formBindingData | FormBindingData | data: Object | 新增 | 120| ohos.application.formBindingData | formBindingData | createFormBindingData(obj?: Object \| string): FormBindingData; | 新增 | 121| ohos.application.ConfigurationConstant | ColorMode | COLOR_MODE_LIGHT = 1 | 新增 | 122| ohos.application.ConfigurationConstant | ColorMode | COLOR_MODE_DARK = 0 | 新增 | 123| ohos.application.ConfigurationConstant | ColorMode | COLOR_MODE_NOT_SET = -1 | 新增 | 124| ohos.application.Configuration | Configuration | colorMode: ConfigurationConstant.ColorMode; | 新增 | 125| ohos.application.Configuration | Configuration | language: string; | 新增 | 126| ohos.application.appManager | appManager | getAppMemorySize(): Promise\<number>;<br>getAppMemorySize(callback: AsyncCallback\<number>): void; | 新增 | 127| ohos.application.appManager | appManager | isRamConstrainedDevice(): Promise\<boolean>;<br>isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void; | 新增 | 128| ohos.application.appManager | appManager | getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;<br>getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): void; | 新增 | 129| ohos.application.appManager | appManager | isRunningInStabilityTest(callback: AsyncCallback\<boolean>): void;<br>isRunningInStabilityTest(): Promise\<boolean>; | 新增 | 130| ohos.application.abilityDelegatorRegistry | AbilityLifecycleState | DESTROY | 新增 | 131| ohos.application.abilityDelegatorRegistry | AbilityLifecycleState | BACKGROUND | 新增 | 132| ohos.application.abilityDelegatorRegistry | AbilityLifecycleState | FOREGROUND | 新增 | 133| ohos.application.abilityDelegatorRegistry | AbilityLifecycleState | CREATE | 新增 | 134| ohos.application.abilityDelegatorRegistry | AbilityLifecycleState | UNINITIALIZED | 新增 | 135| ohos.application.abilityDelegatorRegistry | abilityDelegatorRegistry | getArguments(): AbilityDelegatorArgs; | 新增 | 136| ohos.application.abilityDelegatorRegistry | abilityDelegatorRegistry | getAbilityDelegator(): AbilityDelegator; | 新增 | 137| ohos.abilityAccessCtrl | GrantStatus | PERMISSION_GRANTED = 0 | 新增 | 138| ohos.abilityAccessCtrl | GrantStatus | PERMISSION_DENIED = -1 | 新增 | 139| ohos.abilityAccessCtrl | AtManager | verifyAccessToken(tokenID: number, permissionName: string): Promise\<GrantStatus>; | 新增 | 140| ohos.abilityAccessCtrl | abilityAccessCtrl | createAtManager(): AtManager; | 新增 | 141| ohos.ability.wantConstant | Action | ACTION_APP_ACCOUNT_OAUTH = "ohos.account.appAccount.action.oauth" | 新增 | 142| ohos.ability.wantConstant | Action | ACTION_VIDEO_CAPTURE = "ohos.want.action.videoCapture" | 新增 | 143| ohos.ability.wantConstant | Action | ACTION_IMAGE_CAPTURE = "ohos.want.action.imageCapture" | 新增 | 144| ohos.ability.particleAbility | ErrorCode | INVALID_PARAMETER = -1 | 新增 | 145| ohos.ability.particleAbility | particleAbility | disconnectAbility(connection: number, callback:AsyncCallback\<void>): void;<br>disconnectAbility(connection: number): Promise\<void>; | 新增 | 146| ohos.ability.particleAbility | particleAbility | connectAbility(request: Want, options:ConnectOptions): number; | 新增 | 147| ohos.ability.particleAbility | particleAbility | cancelBackgroundRunning(callback: AsyncCallback\<void>): void;<br>cancelBackgroundRunning(): Promise\<void>; | 新增 | 148| ohos.ability.particleAbility | particleAbility | startBackgroundRunning(id: number, request: NotificationRequest, callback: AsyncCallback\<void>): void;<br>startBackgroundRunning(id: number, request: NotificationRequest): Promise\<void>; | 新增 | 149| ohos.ability.featureAbility | featureAbility | getWindow(callback: AsyncCallback\<window.Window>): void;<br>getWindow(): Promise\<window.Window>; | 新增 | 150| ohos.ability.errorCode | ErrorCode | NO_ERROR = 0 | 新增 | 151| ohos.ability.errorCode | ErrorCode | INVALID_PARAMETER = -1 | 新增 | 152| ohos.ability.errorCode | ErrorCode | ABILITY_NOT_FOUND = -2 | 新增 | 153| ohos.ability.errorCode | ErrorCode | PERMISSION_DENY = -3 | 新增 | 154| lifecycle | LifecycleData | call?(method: string, arg: string, extras: PacMap, callback: AsyncCallback\<PacMap>): void; | 新增 | 155| lifecycle | LifecycleData | executeBatch?(ops: Array\<DataAbilityOperation>, callback: AsyncCallback\<Array\<DataAbilityResult>>): void; | 新增 | 156| lifecycle | LifecycleService | onReconnect?(want: Want): void; | 新增 | 157| lifecycle | LifecycleApp | onMemoryLevel?(level: number): void; | 新增 | 158| lifecycle | LifecycleApp | onNewWant?(want: Want): void; | 新增 | 159| lifecycle | LifecycleApp | onActive?(): void; | 新增 | 160| lifecycle | LifecycleApp | onInactive?(): void; | 新增 | 161| lifecycle | LifecycleApp | onRestoreAbilityState?(inState: PacMap): void; | 新增 | 162| lifecycle | LifecycleApp | onSaveAbilityState?(outState: PacMap): void; | 新增 | 163| lifecycle | LifecycleForm | onAcquireFormState?(want: Want): formInfo.FormState; | 新增 | 164| lifecycle | LifecycleForm | onDestroy?(formId: string): void; | 新增 | 165| lifecycle | LifecycleForm | onEvent?(formId: string, message: string): void; | 新增 | 166| lifecycle | LifecycleForm | onVisibilityChange?(newStatus: { [key: string]: number }): void; | 新增 | 167| lifecycle | LifecycleForm | onUpdate?(formId: string): void; | 新增 | 168| lifecycle | LifecycleForm | onCastToNormal?(formId: string): void; | 新增 | 169| lifecycle | LifecycleForm | onCreate?(want: Want): formBindingData.FormBindingData; | 新增 | 170