Context

NOTE The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Provides the context for running code, including applicationInfo and resourceManager.

Usage

You must extend AbilityContext to implement this module.

Attributes

System capability: SystemCapability.Ability.AbilityRuntime.Core

Name	Type	Readable	Writable	Description
resourceManager	ResourceManager	Yes	No	ResourceManager object.
applicationInfo	ApplicationInfo	Yes	No	Information about the application.
cacheDir	string	Yes	No	Cache directory of the application on the internal storage.
tempDir	string	Yes	No	Temporary file directory of the application.
filesDir	string	Yes	No	File directory of the application on the internal storage.
databaseDir	string	Yes	No	Storage directory of local data.
storageDir	string	Yes	No	Storage directory of lightweight data.
bundleCodeDir	string	Yes	No	Application installation path.
distributedFilesDir	string	Yes	No	Storage directory of distributed application data files.
eventHub	EventHub	Yes	No	Event hub information.

Context.createBundleContext

createBundleContext(bundleName: string): Context;

Creates a context for a given application.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Application bundle name.

Return value

Type	Description
Context	Context created.

Example

let test = "com.example.test";
let context = this.context.createBundleContext(test);

Context.getApplicationContext

getApplicationContext(): Context;

Obtains the context of this application.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Return value

Type	Description
Context	Context obtained.

Example

// This part is mandatory.
let context = this.context.getApplicationContext();

NOTE

Currently, API version 9 is a Canary version.

Context.switchArea

switchArea(mode: AreaMode): void

Switches the file area mode.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
mode	AreaMode	Yes	File area mode.

Example

var areaMode = 0
this.context.switchArea(areaMode);

AreaMode

Describes the file area mode.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Name	Type	Value
EL1	number	0
EL2	number	1