harmony(鸿蒙)元能力子系统JS API变更

2022-08-09
浏览 (705)

元能力子系统JS API变更

OpenHarmony 3.2 Canary1版本相较于OpenHarmony 3.1 Release版本，元能力子系统的API变更如下:

接口变更

模块名	类名	方法/属性/枚举/常量	变更类型
AbilityContext	AbilityContext	restoreWindowStage(contentStorage: ContentStorage) : void;	新增
AbilityContext	AbilityContext	requestPermissionsFromUser(permissions: Array<string>, requestCallback: AsyncCallback<PermissionRequestResult>) : void; requestPermissionsFromUser(permissions: Array<string>) : Promise<PermissionRequestResult>;	新增
AbilityContext	AbilityContext	setMissionLabel(label: string, callback:AsyncCallback<void>): void; setMissionLabel(label: string): Promise<void>;	新增
AbilityContext	AbilityContext	disconnectAbility(connection: number, callback:AsyncCallback<void>): void; disconnectAbility(connection: number): Promise<void>;	新增
AbilityContext	AbilityContext	connectAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number;	新增
AbilityContext	AbilityContext	connectAbility(want: Want, options: ConnectOptions): number;	新增
AbilityContext	AbilityContext	terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<void>): void; terminateSelfWithResult(parameter: AbilityResult): Promise<void>;	新增
AbilityContext	AbilityContext	terminateSelf(callback: AsyncCallback<void>): void; terminateSelf(): Promise<void>;	新增
AbilityContext	AbilityContext	startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback<AbilityResult>): void; startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>): void; startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions): Promise<AbilityResult>;	新增
AbilityContext	AbilityContext	startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): void; startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>): void; startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityResult>;	新增
AbilityContext	AbilityContext	startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void; startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>): void; startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise<void>;	新增
AbilityContext	AbilityContext	startAbilityByCall(want: Want): Promise<Caller>;	新增
AbilityContext	AbilityContext	startAbility(want: Want, callback: AsyncCallback<void>): void; startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void; startAbility(want: Want, options?: StartOptions): Promise<void>;	新增
AbilityContext	AbilityContext	config: Configuration;	新增
AbilityContext	AbilityContext	currentHapModuleInfo: HapModuleInfo;	新增
AbilityContext	AbilityContext	abilityInfo: AbilityInfo;	新增
abilityDelegator	AbilityDelegator	doAbilityBackground(ability: Ability, callback: AsyncCallback<boolean>): void; doAbilityBackground(ability: Ability): Promise<boolean>;	新增
abilityDelegator	AbilityDelegator	doAbilityForeground(ability: Ability, callback: AsyncCallback<boolean>): void; doAbilityForeground(ability: Ability): Promise<boolean>;	新增
abilityDelegator	AbilityDelegator	getCurrentTopAbility(callback: AsyncCallback<Ability>): void; getCurrentTopAbility(): Promise<Ability>	新增
abilityDelegator	AbilityDelegator	getAbilityState(ability: Ability): number;	新增
abilityDelegator	AbilityDelegator	getAppContext(): Context;	新增
abilityDelegator	AbilityDelegator	waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback<Ability>): void; waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCallback<Ability>): void; waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise<Ability>;	新增
abilityDelegator	AbilityDelegator	removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback<void>): void; removeAbilityMonitor(monitor: AbilityMonitor): Promise<void>;	新增
abilityDelegator	AbilityDelegator	addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback<void>): void; addAbilityMonitor(monitor: AbilityMonitor): Promise<void>;	新增
abilityMonitor	AbilityMonitor	onWindowStageDestroy?:() => void;	新增
abilityMonitor	AbilityMonitor	onWindowStageRestore?:() => void;	新增
abilityMonitor	AbilityMonitor	onWindowStageCreate?:() => void;	新增
abilityMonitor	AbilityMonitor	onAbilityDestroy?:() => void;	新增
abilityMonitor	AbilityMonitor	onAbilityBackground?:() => void;	新增
abilityMonitor	AbilityMonitor	onAbilityForeground?:() => void;	新增
abilityMonitor	AbilityMonitor	onAbilityCreate?:() => void;	新增
abilityMonitor	AbilityMonitor	abilityName: string;	新增
AbilityStageContext	AbilityStageContext	config: Configuration;	新增
AbilityStageContext	AbilityStageContext	currentHapModuleInfo: HapModuleInfo;	新增
context	AreaMode	EL2 = 1	新增
context	AreaMode	EL1 = 0	新增
context	Context	switchArea(mode: AreaMode): void;	新增
context	Context	createBundleContext(bundleName: string): Context;	新增
context	Context	eventHub: EventHub;	新增
context	Context	distributedFilesDir: string;	新增
context	Context	bundleCodeDir : string;	新增
context	Context	storageDir : string;	新增
context	Context	databaseDir : string;	新增
context	Context	filesDir : string;	新增
context	Context	tempDir: string;	新增
context	Context	cacheDir: string;	新增
context	Context	applicationInfo: ApplicationInfo;	新增
context	Context	resourceManager: resmgr.ResourceManager;	新增
EventHub	EventHub	emit(event: string, …args: Object[]): void	新增
EventHub	EventHub	off(event: string, callback?: Function): void	新增
EventHub	EventHub	on(event: string, callback: Function): void	新增
ExtAbilityContext	ExtAbilityContext	currentHapModuleInfo: HapModuleInfo;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly writePermission: string;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly readPermission: string;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly enabled: boolean;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly metadata: Array<Metadata>;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly applicationInfo: ApplicationInfo;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly permissions: Array<string>;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly extensionAbilityType: bundle.ExtensionAbilityType;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly isVisible: boolean;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly iconId: number;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly descriptionId: number;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly labelId: number;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly name: string;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly moduleName: string;	新增
extensionAbilityInfo	ExtensionAbilityInfo	readonly bundleName: string;	新增
ExtensionContext	ExtensionContext	config: Configuration;	新增
ExtensionContext	ExtensionContext	currentHapModuleInfo: HapModuleInfo;	新增
ExtensionRunningInfo	ExtensionRunningInfo	type: bundle.ExtensionAbilityType;	新增
ExtensionRunningInfo	ExtensionRunningInfo	clientPackage: Array<String>;	新增
ExtensionRunningInfo	ExtensionRunningInfo	startTime: number;	新增
ExtensionRunningInfo	ExtensionRunningInfo	processName: string;	新增
ExtensionRunningInfo	ExtensionRunningInfo	uid: number;	新增
ExtensionRunningInfo	ExtensionRunningInfo	pid: number;	新增
ExtensionRunningInfo	ExtensionRunningInfo	extension: ElementName;	新增
FormExtensionContext	FormExtensionContext	updateForm(formId: string, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback<void>): void; updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Promise<void>;	新增
ohos.application.Ability	Ability	onConfigurationUpdated(config: Configuration): void;	新增
ohos.application.Ability	Ability	onNewWant(want: Want): void;	新增
ohos.application.Ability	Ability	onContinue(wantParam : {[key: string]: any}): AbilityConstant.OnContinueResult;	新增
ohos.application.Ability	Ability	onBackground(): void;	新增
ohos.application.Ability	Ability	onForeground(): void;	新增
ohos.application.Ability	Ability	onDestroy(): void;	新增
ohos.application.Ability	Ability	onWindowStageRestore(windowStage: window.WindowStage): void;	新增
ohos.application.Ability	Ability	onWindowStageDestroy(): void;	新增
ohos.application.Ability	Ability	onWindowStageCreate(windowStage: window.WindowStage): void;	新增
ohos.application.Ability	Ability	onCreate(want: Want, param: AbilityConstant.LaunchParam): void;	新增
ohos.application.Ability	Ability	callee: Callee;	新增
ohos.application.Ability	Ability	lastRequestWant: Want;	新增
ohos.application.Ability	Ability	launchWant: Want;	新增
ohos.application.Ability	Ability	context: AbilityContext;	新增
ohos.application.Ability	Callee	off(method: string): void;	新增
ohos.application.Ability	Callee	on(method: string, callback: function): void;	新增
ohos.application.Ability	Caller	onRelease(callback: function): void;	新增
ohos.application.Ability	Caller	release(): void;	新增
ohos.application.Ability	Caller	callWithResult(method: string, data: rpc.Sequenceable): Promise<rpc.MessageParcel>;	新增
ohos.application.Ability	Caller	call(method: string, data: rpc.Sequenceable): Promise<void>;	新增
ohos.application.AbilityConstant	OnContinueResult	MISMATCH = 2	新增
ohos.application.AbilityConstant	OnContinueResult	REJECT = 1	新增
ohos.application.AbilityConstant	OnContinueResult	AGREE = 0	新增
ohos.application.AbilityConstant	LastExitReason	NORMAL = 2	新增
ohos.application.AbilityConstant	LastExitReason	ABILITY_NOT_RESPONDING = 1	新增
ohos.application.AbilityConstant	LastExitReason	UNKNOWN = 0	新增
ohos.application.AbilityConstant	LaunchReason	CONTINUATION = 3	新增
ohos.application.AbilityConstant	LaunchReason	CALL = 2	新增
ohos.application.AbilityConstant	LaunchReason	START_ABILITY = 1	新增
ohos.application.AbilityConstant	LaunchReason	UNKNOWN = 0	新增
ohos.application.AbilityConstant	LaunchParam	lastExitReason: LastExitReason;	新增
ohos.application.AbilityConstant	LaunchParam	launchReason: LaunchReason;	新增
ohos.application.abilityManager	abilityManager	getExtensionRunningInfos(upperLimit: number): Promise<Array<ExtensionRunningInfo>>; getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback<Array<ExtensionRunningInfo>>): void;	新增
ohos.application.AbilityStage	AbilityStage	onConfigurationUpdated(config: Configuration): void;	新增
ohos.application.AbilityStage	AbilityStage	onAcceptWant(want: Want): string;	新增
ohos.application.AbilityStage	AbilityStage	onCreate(): void;	新增
ohos.application.AbilityStage	AbilityStage	context: AbilityStageContext;	新增
ohos.application.Configuration	Configuration	displayId?: number;	新增
ohos.application.Configuration	Configuration	screenDensity?: ConfigurationConstant.ScreenDensity;	新增
ohos.application.Configuration	Configuration	direction?: ConfigurationConstant.Direction;	新增
ohos.application.ConfigurationConstant	ScreenDensity	SCREEN_DENSITY_XXXLDPI = 640	新增
ohos.application.ConfigurationConstant	ScreenDensity	SCREEN_DENSITY_XXLDPI = 480	新增
ohos.application.ConfigurationConstant	ScreenDensity	SCREEN_DENSITY_XLDPI = 320	新增
ohos.application.ConfigurationConstant	ScreenDensity	SCREEN_DENSITY_LDPI = 240	新增
ohos.application.ConfigurationConstant	ScreenDensity	SCREEN_DENSITY_MDPI = 160	新增
ohos.application.ConfigurationConstant	ScreenDensity	SCREEN_DENSITY_SDPI = 120	新增
ohos.application.ConfigurationConstant	ScreenDensity	SCREEN_DENSITY_NOT_SET = 0	新增
ohos.application.ConfigurationConstant	Direction	DIRECTION_HORIZONTAL = 1	新增
ohos.application.ConfigurationConstant	Direction	DIRECTION_VERTICAL = 0	新增
ohos.application.ConfigurationConstant	Direction	DIRECTION_NOT_SET = -1	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	denormalizeUri?(uri: string, callback: AsyncCallback<string>): void;	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	normalizeUri?(uri: string, callback: AsyncCallback<string>): void;	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	batchInsert?(uri: string, valueBuckets: Array<rdb.ValuesBucket>, callback: AsyncCallback<number>): void;	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	getType?(uri: string, callback: AsyncCallback<string>): void;	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	“query?(uri: string, columns: Array<string>, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<ResultSet>): void;”	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	delete?(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<number>): void;	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	“update?(uri: string, valueBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<number>): void;”	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	insert?(uri: string, valueBucket: rdb.ValuesBucket, callback: AsyncCallback<number>): void;	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	getFileTypes?(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array<string>>): void;	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	onCreate?(want: Want): void;	新增
ohos.application.DataShareExtensionAbility	DataShareExtensionAbility	context?: ExtensionContext;	新增
ohos.application.FormExtension	FormExtension	onConfigurationUpdated(config: Configuration): void;	新增
ohos.application.FormExtension	FormExtension	onDestroy(formId: string): void;	新增
ohos.application.FormExtension	FormExtension	onEvent(formId: string, message: string): void;	新增
ohos.application.FormExtension	FormExtension	onVisibilityChange(newStatus: { [key: string]: number }): void;	新增
ohos.application.FormExtension	FormExtension	onUpdate(formId: string): void;	新增
ohos.application.FormExtension	FormExtension	onCastToNormal(formId: string): void;	新增
ohos.application.FormExtension	FormExtension	onCreate(want: Want): formBindingData.FormBindingData;	新增
ohos.application.FormExtension	FormExtension	context: FormExtensionContext;	新增
ohos.application.ServiceExtAbility	ServiceExtAbility	onReconnect(want: Want): void;	新增
ohos.application.ServiceExtAbility	ServiceExtAbility	onDisconnect(want: Want): void;	新增
ohos.application.ServiceExtAbility	ServiceExtAbility	onConnect(want: Want): rpc.RemoteObject;	新增
ohos.application.ServiceExtAbility	ServiceExtAbility	onRequest(want: Want, startId: number): void;	新增
ohos.application.ServiceExtAbility	ServiceExtAbility	onDestroy(): void;	新增
ohos.application.ServiceExtAbility	ServiceExtAbility	onCreate(want: Want): void;	新增
ohos.application.ServiceExtAbility	ServiceExtAbility	context: ServiceExtAbilityContext;	新增
ohos.application.ServiceExtension	ServiceExtension	onConfigurationUpdated(config: Configuration): void;	新增
ohos.application.ServiceExtension	ServiceExtension	onReconnect(want: Want): void;	新增
ohos.application.ServiceExtension	ServiceExtension	onDisconnect(want: Want): void;	新增
ohos.application.ServiceExtension	ServiceExtension	onConnect(want: Want): rpc.RemoteObject;	新增
ohos.application.ServiceExtension	ServiceExtension	onRequest(want: Want, startId: number): void;	新增
ohos.application.ServiceExtension	ServiceExtension	onDestroy(): void;	新增
ohos.application.ServiceExtension	ServiceExtension	onCreate(want: Want): void;	新增
ohos.application.ServiceExtension	ServiceExtension	context: ServiceExtensionContext;	新增
ohos.application.ServiceExtensionAbility	ServiceExtensionAbility	onConfigurationUpdated(config: Configuration): void;	新增
ohos.application.ServiceExtensionAbility	ServiceExtensionAbility	onReconnect(want: Want): void;	新增
ohos.application.ServiceExtensionAbility	ServiceExtensionAbility	onDisconnect(want: Want): void;	新增
ohos.application.ServiceExtensionAbility	ServiceExtensionAbility	onConnect(want: Want): rpc.RemoteObject;	新增
ohos.application.ServiceExtensionAbility	ServiceExtensionAbility	onRequest(want: Want, startId: number): void;	新增
ohos.application.ServiceExtensionAbility	ServiceExtensionAbility	onDestroy(): void;	新增
ohos.application.ServiceExtensionAbility	ServiceExtensionAbility	onCreate(want: Want): void;	新增
ohos.application.ServiceExtensionAbility	ServiceExtensionAbility	context: ServiceExtensionContext;	新增
ohos.application.StartOptions	StartOptions	displayId?: number;	新增
ohos.application.StartOptions	StartOptions	windowMode?: number;	新增
ohos.application.uriPermissionManager	uriPermissionManager	verifyUriPermission(uri: string, flag: wantConstant.Flags, accessTokenId: number, callback: AsyncCallback<number>): void; verifyUriPermission(uri: string, flag: wantConstant.Flags, accessTokenId: number): Promise<number>;	新增
ohos.wantAgent	wantAgent	getOperationType(agent: WantAgent, callback: AsyncCallback<number>): void; getOperationType(agent: WantAgent): Promise<number>;	新增
PermissionRequestResult	PermissionRequestResult	authResults: Array<number>;	新增
PermissionRequestResult	PermissionRequestResult	permissions: Array<string>;	新增
ServiceExtAbilityContext	ServiceExtAbilityContext	disconnectAbility(connection: number, callback:AsyncCallback<void>): void; disconnectAbility(connection: number): Promise<void>;	新增
ServiceExtAbilityContext	ServiceExtAbilityContext	connectAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number;	新增
ServiceExtAbilityContext	ServiceExtAbilityContext	connectAbility(want: Want, options: ConnectOptions): number;	新增
ServiceExtAbilityContext	ServiceExtAbilityContext	terminateSelf(callback: AsyncCallback<void>): void; terminateSelf(): Promise<void>;	新增
ServiceExtAbilityContext	ServiceExtAbilityContext	startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void; startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>): void; startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise<void>;	新增
ServiceExtAbilityContext	ServiceExtAbilityContext	startAbility(want: Want, callback: AsyncCallback<void>): void; startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void; startAbility(want: Want, options?: StartOptions): Promise<void>;	新增
ServiceExtensionContext	ServiceExtensionContext	disconnectAbility(connection: number, callback:AsyncCallback<void>): void; disconnectAbility(connection: number): Promise<void>;	新增
ServiceExtensionContext	ServiceExtensionContext	connectAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number;	新增
ServiceExtensionContext	ServiceExtensionContext	connectAbility(want: Want, options: ConnectOptions): number;	新增
ServiceExtensionContext	ServiceExtensionContext	terminateSelf(callback: AsyncCallback<void>): void; terminateSelf(): Promise<void>;	新增
ServiceExtensionContext	ServiceExtensionContext	startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void; startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>): void; startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise<void>;	新增
ServiceExtensionContext	ServiceExtensionContext	startAbility(want: Want, callback: AsyncCallback<void>): void; startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void; startAbility(want: Want, options?: StartOptions): Promise<void>;	新增
ServiceExtensionContext	ServiceExtensionContext	extensionAbilityInfo: ExtensionAbilityInfo;	新增
want	Want	extensionAbilityType?: number;	新增
want	Want	extensionAbilityName?: string;	新增