程序包 ohos.aafwk.ability

类 AbilityPackage

java.lang.Object

ohos.app.AbilityContext

ohos.aafwk.ability.AbilityPackage

所有已实现的接口:

Context, ElementsCallback

public class AbilityPackage
extends AbilityContext
implements ElementsCallback

A base class used for user to initialize each hap.

从以下版本开始:

3

SystemCapability

SystemCapability.Aafwk#ABILITY

字段概要

从接口继承的字段 ohos.app.Context

CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESOUCE_ONLY, CONTEXT_RESTRICTED, MODE_APPEND, MODE_PRIVATE

构造器概要

构造器

构造器	说明
AbilityPackage()	A constructor used to create a AbilityPackage instance.

方法概要

限定符和类型	方法	说明
void	dispatchAbilitySavedState(PacMap outState)	Called when Ability#onSaveAbilityState(PacMap) was called on an ability.
void	onConfigurationUpdated(Configuration configuration)	Called when the system configuration of the device changes.
void	onEnd()	Called when the application exits.
void	onInitialize()	Called when your module is starting, before any abilities in the module are loaded.
void	onMemoryLevel(int level)	Called when the system has determined to trim the memory, for example, when the ability is running in the background and there is no enough memory for running as many background processes as possible.
void	registerCallbacks(AbilityLifecycleCallbacks abilityLifecycleCallbacks, ElementsCallback elementsCallback)	Registers AbilityLifecycleCallbacks and ElementsCallback objects with this AbilityPackage object.
void	unregisterCallbacks(AbilityLifecycleCallbacks abilityLifecycleCallbacks, ElementsCallback elementsCallback)	Unregisters AbilityLifecycleCallbacks and ElementsCallback objects.

从类继承的方法 ohos.app.AbilityContext

attachBaseContext, canRequestPermission, compelVerifyCallerPermission, compelVerifyCallerUriPermission, compelVerifyPermission, compelVerifyPermission, compelVerifyUriPermission, compelVerifyUriPermission, compelVerifyUriPermission, connectAbility, createBundleContext, createParallelTaskDispatcher, createSerialTaskDispatcher, deleteFile, disconnectAbility, displayUnlockMissionMessage, getAbilityInfo, getAbilityManager, getAbilityPackageContext, getApplicationContext, getApplicationInfo, getAppType, getBundleCodePath, getBundleManager, getBundleName, getBundleResourcePath, getCacheDir, getCaller, getCallingAbility, getCallingBundle, getClassloader, getCodeCacheDir, getColor, getColorMode, getContext, getDatabaseDir, getDataDir, getDir, getDisplayOrientation, getDistributedDir, getElementName, getExternalCacheDir, getExternalCacheDirs, getExternalFilesDir, getExternalFilesDirs, getExternalMediaDirs, getFilesDir, getGlobalTaskDispatcher, getHapModuleInfo, getIntArray, getLastStoredDataWhenConfigChanged, getLocalClassName, getMainTaskDispatcher, getNoBackupFilesDir, getPattern, getPreferencesDir, getProcessInfo, getProcessName, getResourceManager, getResourceManager, getString, getString, getStringArray, getTheme, getThemeId, getUITaskDispatcher, init, isCredentialEncryptedStorage, isDeviceEncryptedStorage, isUpdatingConfigurations, lockMission, printDrawnCompleted, requestPermissionsFromUser, restart, setColorMode, setDisplayOrientation, setPattern, setShowOnLockScreen, setTheme, setTransitionAnimation, setWakeUpScreen, startAbilities, startAbility, startAbility, startAbility, stopAbility, switchToCredentialEncryptedStorageContext, switchToDeviceEncryptedStorageContext, terminateAbility, terminateAbility, terminateAbilityResult, unlockMission, verifyCallingOrSelfPermission, verifyCallingPermission, verifyPermission, verifySelfPermission

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

AbilityPackage

public AbilityPackage()

A constructor used to create a AbilityPackage instance.

从以下版本开始:

3

方法详细资料

onInitialize

public void onInitialize()

Called when your module is starting, before any abilities in the module are loaded.

从以下版本开始:

3

onEnd

public void onEnd()

Called when the application exits. This callback is invoked only when the application is running on an emulator. It will never be invoked on a real device.

从以下版本开始:

3

onMemoryLevel

public void onMemoryLevel(int level)

Called when the system has determined to trim the memory, for example, when the ability is running in the background and there is no enough memory for running as many background processes as possible.

指定者:

onMemoryLevel 在接口中 ElementsCallback

参数:

level - Indicates the memory trim level, which shows the current memory usage status.

从以下版本开始:

3

onConfigurationUpdated

public void onConfigurationUpdated(Configuration configuration)

Called when the system configuration of the device changes.

This callback method is used only if the configurationChange field has been configured in the config.json file for the ability currently running in the foreground. Otherwise, the system restarts the ability instead of calling this callback method.

指定者:

onConfigurationUpdated 在接口中 ElementsCallback

参数:

configuration - Indicates the new Configuration object.

从以下版本开始:

3

registerCallbacks

public void registerCallbacks(AbilityLifecycleCallbacks abilityLifecycleCallbacks,
                              ElementsCallback elementsCallback)

Registers AbilityLifecycleCallbacks and ElementsCallback objects with this AbilityPackage object.

Callbacks in AbilityLifecycleCallbacks will be triggered when the ability lifecycle in the application changes.

Callbacks in ElementsCallback will be triggered when the system configuration or memory status of the device changes.

参数:

abilityLifecycleCallbacks - Indicates the AbilityLifecycleCallbacks object to register. This parameter can be null，indicating that no such callback will be registered.

elementsCallback - Indicates the ElementsCallback object to register. This parameter can be null，indicating that no such callback will be registered.

从以下版本开始:

3

unregisterCallbacks

public void unregisterCallbacks(AbilityLifecycleCallbacks abilityLifecycleCallbacks,
                                ElementsCallback elementsCallback)

Unregisters AbilityLifecycleCallbacks and ElementsCallback objects.

参数:

abilityLifecycleCallbacks - Indicates the ElementsCallback object to unregister. This parameter can be null，indicating that no such callback will be unregistered.

elementsCallback - Indicates the ElementsCallback object to unregister. This parameter can be null，indicating that no such callback will be unregistered.

从以下版本开始:

3

dispatchAbilitySavedState

public void dispatchAbilitySavedState(PacMap outState)

Called when Ability#onSaveAbilityState(PacMap) was called on an ability.

参数:

outState - Indicates the PacMap object passed to Ability#onSaveAbilityState(PacMap) for storing user data and states. This parameter cannot be null.

从以下版本开始:

4