鸿蒙OS开发文档鸿蒙OS Ability AbilityPackage

2024-02-25 开发教程鸿蒙OS开发文档匿名 3℃

用户用来初始化每个 hap 的基类。

领域摘要

从接口 ohos.app 继承的字段。Context
CONTEXT_IGNORE_SECURITY，CONTEXT_INCLUDE_CODE，CONTEXT_RESOUCE_ONLY，CONTEXT_RESTRICTED，MODE_APPEND，MODE_PRIVATE

构造器摘要

建设者	描述
AbilityPackage（）

方法总结

修饰符和类型	方法	描述
void	onConfigurationUpdated（Configurationconfiguration）	当设备的系统configuration更改时调用。
void	onEnd（）	在模块结束时调用。
void	onInitialize（）	在模块启动之前，模块中的任何功能加载之前调用。
void	onMemoryLevel（int级别）	在系统确定修整内存时调用，例如，当该功能在后台运行并且没有足够的内存来运行尽可能多的后台进程时调用。
void	registerCallbacks（（AbilityLifecycleCallbacks skillLifecycleCallbacks，ElementsCallback elementsCallback）	使用此 AbilityPackage 对象注册 AbilityLifecycleCallbacks 和ElementsCallback 对象。
void	unregisterCallbacks（（AbilityLifecycleCallbacks skillLifecycleCallbacks，ElementsCallback elementsCallback）	注销 AbilityLifecycleCallbacks 和 ElementsCallback 对象。

从类ohos.app继承的方法。AbilityContext
attachBaseContext，canRequestPermission，connectAbility，createBundleContext，createParallelTaskDispatcher，createSerialTaskDispatcher，DELETEFILE，disconnectAbility，getAbilityInfo，getAbilityManager，getApplicationContext，getApplicationInfo，getAppType，getBundleCodePath，getBundleManager，getBundleName，getBundleResourcePath，getCacheDir，getCallingAbility，getCallingBundle，getClassloader，getCodeCacheDir，的getContext，getDatabaseDir，getDataDir，GETDIR，getDisplayOrientation，getDistributedDir，getElementName，getExternalCacheDir，getExternalCacheDirs，getExternalFilesDir，getExternalFilesDirs，getExternalMediaDirs，getFilesDir，getGlobalTaskDispatcher，getLocalClassName，getMainTaskDispatcher，getNoBackupFilesDir，getPattern，getPreferencesDir，getProcessInfo，getResourceManager，getTheme，getUITaskDispatcher，getUITaskDispatcher，isDeviceEncryptedStorage，isUpdatingConfigurations，requestPermissionsFromUser，restart，setDisplayOrientation，setPattern，setShowOnLockScreen，setTheme，setTransitionAnimation，setWakeUpScreen，
startAbilities，startAbility，stopAbility，switchToCredentialEncryptedStorageContext，switchToDeviceEncryptedStorageContext，terminateAbility，terminateAbility，terminateAbilityResult，verifyCallingOrSelfPermission，verifyCallingPermission，verifyPermission，verifySelfPermission

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

attachBaseContext，canRequestPermission，connectAbility，createBundleContext，createParallelTaskDispatcher，createSerialTaskDispatcher，DELETEFILE，disconnectAbility，getAbilityInfo，getAbilityManager，getApplicationContext，getApplicationInfo，getAppType，getBundleCodePath，getBundleManager，getBundleName，getBundleResourcePath，getCacheDir，getCallingAbility，getCallingBundle，getClassloader，getCodeCacheDir，的getContext，getDatabaseDir，getDataDir，GETDIR，getDisplayOrientation，getDistributedDir，getElementName，getExternalCacheDir，getExternalCacheDirs，getExternalFilesDir，getExternalFilesDirs，getExternalMediaDirs，getFilesDir，getGlobalTaskDispatcher，getLocalClassName，getMainTaskDispatcher，getNoBackupFilesDir，getPattern，getPreferencesDir，getProcessInfo，getResourceManager，getTheme，getUITaskDispatcher，getUITaskDispatcher，isDeviceEncryptedStorage，isUpdatingConfigurations，requestPermissionsFromUser，restart，setDisplayOrientation，setPattern，setShowOnLockScreen，setTheme，setTransitionAnimation，setWakeUpScreen，

startAbilities，startAbility，stopAbility，switchToCredentialEncryptedStorageContext，switchToDeviceEncryptedStorageContext，terminateAbility，terminateAbility，terminateAbilityResult，verifyCallingOrSelfPermission，verifyCallingPermission，verifyPermission，verifySelfPermission

从类java.lang继承的方法。object
clone，equals，finalize，getClass，hashCode，notify，notifyAll，toString，wait，wait，wait

构造器详细信息

能力包

公共能力包（）

方法细节

在初始化上

onInitialize（）上的公共无效

在模块启动之前，模块中的任何功能加载之前调用。

结束

公共无效onEnd（）

在模块结束时调用。

在内存级别

onMemoryLevel 上的 public void（int 级别）

在系统确定修整内存时调用，例如，当该功能在后台运行并且没有足够的内存来运行尽可能多的后台进程时调用。

指定者：

接口 ElementsCallback中的onMemoryLevel

参数：

参数名称	参数说明
水平	指示内存调整级别，该级别显示当前内存使用状况。

关于配置更新

public void onConfigurationUpdated (Configuration configuration)

当设备的系统配置更改时调用。

仅当已在config.json文件中为当前在前台运行的功能配置了 configurationChange 字段时，才使用此回调方法。否则，系统将重新启动该功能，而不是调用此回调方法。

指定者：

接口ElementsCallback中的onConfigurationUpdated

参数：

参数名称	参数说明
组态	指示新的Configuration对象。

注册回调

公共无效 registerCallbacks（（AbilityLifecycleCallbacks skillLifecycleCallbacks，ElementsCallback elementsCallback）

使用此 AbilityPackage 对象注册 AbilityLifecycleCallbacks 和 ElementsCallback 对象。

当应用程序中的能力生命周期更改时，将触发 AbilityLifecycle 中的回调。

当系统配置或设备的内存状态更改时，将触发 ElementsCallback 中的回调。

参数：

参数名称	参数说明
CapacityLifecycleCallbacks	指示要注册的 AbilityLifecycleCallbacks 对象。此参数可以为 null，表示将不会注册任何此类回调。
elementsCallback	指示要注册的 ElementsCallback 对象。此参数可以为 null，表示将不会注册任何此类回调。

取消注册回调

公共无效 unregisterCallbacks（（AbilityLifecycleCallbacks skillLifecycleCallbacks，ElementsCallback elementsCallback）

注销 AbilityLifecycleCallbacks 和 ElementsCallback 对象。

参数：

参数名称	参数说明
CapacityLifecycleCallbacks	指示要注销的 ElementsCallback 对象。此参数可以为 null，表示不会取消任何回调。
elementsCallback	指示要注销的 ElementsCallback 对象。此参数可以为 null，表示不会取消任何回调。

上一节：鸿蒙OS Ability AbilityForm

下一节：鸿蒙OS Ability AbilitySlice

"鸿蒙OS开发文档"的目录

鸿蒙OS开发文档 鸿蒙OS Ability AbilityPackage