鴻蒙OS Context

Context

public interface Context

提供應(yīng)用中對(duì)象的上下文，獲取應(yīng)用環(huán)境信息。

您可以使用 Context 來(lái)獲取資源、啟動(dòng)能力、創(chuàng)建或獲取任務(wù)調(diào)度程序，以及獲取有關(guān)應(yīng)用程序的捆綁和運(yùn)行信息。

字段摘要

修飾符和類(lèi)型	字段	描述
static int	CONTEXT_IGNORE_SECURITY	指示與 createBundleContext(java.lang.String,nt) 一起使用的標(biāo)志，用于創(chuàng)建始終可以在忽略所有安全限制的情況下加載的 Context 對(duì)象。
static int	CONTEXT_INCLUDE_CODE	指示與 createBundleContext(java.lang.String,int) 一起使用的標(biāo)志，用于創(chuàng)建包含應(yīng)用程序代碼的 Context 對(duì)象。
static int	CONTEXT_RESOUCE_ONLY
static int	CONTEXT_RESTRICTED	指示與 createBundleContext(java.lang.String,int) 一起使用的標(biāo)志，用于創(chuàng)建可以禁用特定功能的 Context 對(duì)象。
static int	MODE_APPEND	表示追加文件創(chuàng)建模式，如果要?jiǎng)?chuàng)建的文件已經(jīng)存在，數(shù)據(jù)將被寫(xiě)入文件末尾，而不是被擦除。
static int	MODE_PRIVATE	指示默認(rèn)文件創(chuàng)建模式，其中創(chuàng)建的文件只能由調(diào)用應(yīng)用程序（或共享相同用戶(hù) ID 的所有應(yīng)用程序）訪問(wèn)。

方法總結(jié)

修飾符和類(lèi)型	方法	描述
boolean	canRequestPermission(String permission)	與權(quán)限管理模塊確認(rèn)是否需要請(qǐng)求提示才能授予某個(gè)權(quán)限。
void	compelVerifyCallerPermission(String permission, String message)	檢查是否已為調(diào)用進(jìn)程授予進(jìn)程間通信 (IPC) 的指定權(quán)限，如果未授予該權(quán)限，則拋出 SecurityException。
void	compelVerifyCallerUriPermission(Uri uri, int modeFlags, String message)	檢查IPC的調(diào)用進(jìn)程是否有訪問(wèn)指定URI的權(quán)限，如果沒(méi)有權(quán)限則拋出SecurityException。
void	compelVerifyPermission(String permission, int pid, int uid, String message)	檢查pid和uid標(biāo)識(shí)的進(jìn)程是否已授予指定權(quán)限，如果未授予權(quán)限，則拋出SecurityException。
void	compelVerifyPermission(String permission, String message)	檢查是否已將指定權(quán)限授予調(diào)用進(jìn)程，如果未授予權(quán)限，則拋出 SecurityException。
void	compelVerifyUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)	檢查pid和uid標(biāo)識(shí)的進(jìn)程是否有權(quán)限訪問(wèn)指定的URI，如果沒(méi)有權(quán)限則拋出SecurityException。
void	compelVerifyUriPermission(Uri uri, int modeFlags, String message)	檢查調(diào)用進(jìn)程是否有訪問(wèn)指定URI的權(quán)限，如果沒(méi)有權(quán)限則拋出SecurityException。
void	compelVerifyUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)	檢查pid和uid標(biāo)識(shí)的進(jìn)程是否指定了讀寫(xiě)權(quán)限以及訪問(wèn)指定URI的權(quán)限，如果沒(méi)有權(quán)限則拋出SecurityException。
boolean	connectAbility(Intent intent, IAbilityConnection conn)	使用 AbilityInfo.AbilityType.SERVICE 模板將當(dāng)前ability連接到ability。
Context	createBundleContext(String bundleName, int flag)	為具有給定包名稱(chēng)的應(yīng)用程序創(chuàng)建 Context 對(duì)象。
TaskDispatcher	createParallelTaskDispatcher(String name, TaskPriority priority)	創(chuàng)建具有指定優(yōu)先級(jí)的并行任務(wù)調(diào)度程序。
TaskDispatcher	createSerialTaskDispatcher(String name, TaskPriority priority)	創(chuàng)建具有指定優(yōu)先級(jí)的串行任務(wù)調(diào)度程序。
boolean	deleteFile(String fileName)	刪除與應(yīng)用程序關(guān)聯(lián)的指定私有文件。
void	disconnectAbility(IAbilityConnection conn)	使用 AbilityInfo.AbilityType.SERVICE 模板斷開(kāi)當(dāng)前ability與ability的連接。
void	displayUnlockMissionMessage()	向用戶(hù)顯示系統(tǒng)定義的消息，提示用戶(hù)如何退出鎖定任務(wù)模式。
AbilityInfo	getAbilityInfo()	獲取有關(guān)當(dāng)前ability的信息。
IAbilityManager	getAbilityManager()	獲得ability管理器。
Context	getAbilityPackageContext()	獲取此ability的 Context 對(duì)象。
Context	getApplicationContext()	獲取應(yīng)用程序的 Context 對(duì)象。
ApplicationInfo	getApplicationInfo()	獲取有關(guān)當(dāng)前應(yīng)用程序的信息。
String	getAppType()	獲取此應(yīng)用程序的類(lèi)型。
String	getBundleCodePath()	獲取包含當(dāng)前ability的包的路徑。
IBundleManager	getBundleManager()	獲得一個(gè) IBundleManager 實(shí)例。
String	getBundleName()	獲取當(dāng)前ability的捆綁包名稱(chēng)。
String	getBundleResourcePath()	獲取包含此ability的 Ohos ability包 (HAP} 的路徑。
File	getCacheDir()	獲取設(shè)備內(nèi)部存儲(chǔ)上特定于應(yīng)用程序的緩存目錄。
Uri	getCaller()	獲取有關(guān)此ability調(diào)用者的信息。
ElementName	getCallingAbility()	獲取調(diào)用當(dāng)前ability的ElementName。
String	getCallingBundle()	獲取調(diào)用當(dāng)前技能的技能的捆綁包名稱(chēng)。
ClassLoader	getClassloader()	獲取一個(gè) ClassLoader 實(shí)例。
File	getCodeCacheDir()	獲取設(shè)備內(nèi)部存儲(chǔ)上特定于應(yīng)用程序的代碼緩存目錄。
int	getColor(int resId)	根據(jù)指定的資源 ID 獲取此 Context 的顏色。
int	getColorMode()	獲取顏色模式。
File	getDatabaseDir()	獲取本地?cái)?shù)據(jù)庫(kù)路徑。
File	getDataDir()	獲取存儲(chǔ)本應(yīng)用所有私有數(shù)據(jù)文件的絕對(duì)路徑。
File	getDir(String name, int mode)	獲取應(yīng)用程序自定義數(shù)據(jù)文件存放目錄。
int	getDisplayOrientation()	獲取ability的當(dāng)前顯示方向。
File	getDistributedDir()	獲取分布式文件路徑。
ElementName	getElementName()	獲取當(dāng)前ability的 ohos.bundle.ElementName 對(duì)象。
File	getExternalCacheDir()	獲取主外部或共享存儲(chǔ)設(shè)備上特定于應(yīng)用程序的緩存目錄的絕對(duì)路徑。
File[]	getExternalCacheDirs()	獲取所有外部或共享存儲(chǔ)設(shè)備上特定于應(yīng)用程序的緩存目錄的絕對(duì)路徑。
File	getExternalFilesDir(String type)	獲取用于在主外部或共享存儲(chǔ)設(shè)備上存儲(chǔ)應(yīng)用程序文件的目錄的絕對(duì)路徑。
File[]	getExternalFilesDirs(String type)	獲取用于在所有外部或共享存儲(chǔ)設(shè)備上存儲(chǔ)應(yīng)用程序文件的目錄的絕對(duì)路徑。
File[]	getExternalMediaDirs()	獲取它可以放置的所有文件上的特定于應(yīng)用程序的媒體目錄。
File	getFilesDir()	獲取設(shè)備內(nèi)部存儲(chǔ)中應(yīng)用程序文件的存儲(chǔ)目錄。
TaskDispatcher	getGlobalTaskDispatcher(TaskPriority priority)	獲取具有指定優(yōu)先級(jí)的全局任務(wù)調(diào)度程序。
HapModuleInfo	getHapModuleInfo()	獲取應(yīng)用程序的 HapModuleInfo 對(duì)象。
int[]	getIntArray(int resId)	根據(jù)指定的資源 ID 獲取此 Context 的整數(shù)數(shù)組。
Object	getLastStoredDataWhenConfigChanged()	當(dāng)系統(tǒng)配置發(fā)生變化時(shí)，獲取通過(guò) Ability.onStoreDataWhenConfigChange() 保存的最新數(shù)據(jù)。
String	getLocalClassName()	獲取ability的本地類(lèi)名。
TaskDispatcher	getMainTaskDispatcher()	獲取綁定到應(yīng)用程序主線程的任務(wù)調(diào)度程序。
File	getNoBackupFilesDir()	獲取應(yīng)用程序創(chuàng)建并將自動(dòng)備份到遠(yuǎn)程存儲(chǔ)的絕對(duì)路徑。
Pattern	getPattern()	獲取此 Context 的模式。
File	getPreferencesDir()	獲取應(yīng)用程序偏好文件的存放路徑。
ProcessInfo	getProcessInfo()	獲取當(dāng)前進(jìn)程的信息，包括進(jìn)程ID和名稱(chēng)。
String	getProcessName()	獲取當(dāng)前進(jìn)程的名稱(chēng)
ResourceManager	getResourceManager()	獲得資源管理器。
ResourceManager	getResourceManager(Configuration configuration)	根據(jù)指定的 Configuration 對(duì)象獲取資源管理器。
String	getString(int resId)	根據(jù)指定的資源 ID 獲取此 Context 的字符串。
String	getString(int resId, Object... formatArgs)	根據(jù)指定的資源 ID 和 formatArgs 獲取此 Context 的字符串。
String[]	getStringArray(int resId)	根據(jù)指定的資源 ID 獲取此 Context 的字符串?dāng)?shù)組。
Theme	getTheme()	獲取此 Context 的主題。
int	getThemeId()	獲取此 Context 的主題 ID。
TaskDispatcher	getUITaskDispatcher()	獲取綁定到 UI 線程的任務(wù)調(diào)度程序。
boolean	isCredentialEncryptedStorage()	檢查上下文是否使用憑據(jù)加密存儲(chǔ)。
boolean	isDeviceEncryptedStorage()	檢查上下文是否使用受設(shè)備保護(hù)的存儲(chǔ)。
boolean	isUpdatingConfigurations()	檢查此ability的配置是否正在更改
void	lockMission()	設(shè)置應(yīng)用程序以在鎖定任務(wù)模式下啟動(dòng)其功能。
void	printDrawnCompleted()	打印出系統(tǒng)完成繪制此頁(yè)面ability所需的時(shí)間。
void	requestPermissionsFromUser(String[] permissions, int requestCode)	從系統(tǒng)請(qǐng)求某些權(quán)限。
void	restart()	使用新實(shí)例重新啟動(dòng)此ability。
void	setColorMode(int mode)	設(shè)置顏色模式。
void	setDisplayOrientation(AbilityInfo.DisplayOrientation newOrientation)	設(shè)置當(dāng)前ability的顯示方向。
void	setPattern(int patternId)	根據(jù)指定的模式 ID 設(shè)置此上下文的模式。
void	setShowOnLockScreen(boolean showOnLockScreen)	設(shè)置是否在鎖定屏幕顯示時(shí)在鎖定屏幕頂部顯示該ability，保持該ability處于 ACTIVE 狀態(tài)。
void	setTheme(int themeId)	根據(jù)指定的主題 ID 設(shè)置此 Context 的主題。
void	setTransitionAnimation(int enterAnim, int exitAnim)	設(shè)置兩個(gè)ability之間的過(guò)渡動(dòng)畫(huà)。
void	setWakeUpScreen(boolean wakeUpScreen)	設(shè)置此ability恢復(fù)時(shí)是否喚醒屏幕。
void	startAbilities(Intent[] intents)	啟動(dòng)多個(gè)ability。
void	startAbility(Intent intent, int requestCode)	開(kāi)始一個(gè)新的ability。
void	startAbility(Intent intent, int requestCode, AbilityStartSetting abilityStartSetting)	使用特殊ability開(kāi)始設(shè)置一個(gè)新ability。
void	startAbility(Intent intent, AbilityStartSetting abilityStartSetting, IAbilityStartCallback iAbilityStartCallback)	開(kāi)始一個(gè)新的ability。
boolean	stopAbility(Intent intent)	銷(xiāo)毀另一個(gè)使用 AbilityInfo.AbilityType.SERVICE 模板的ability。
void	switchToCredentialEncryptedStorageContext()	將上下文存儲(chǔ)更改為受憑證保護(hù)的存儲(chǔ)。
void	switchToDeviceEncryptedStorageContext()	將上下文存儲(chǔ)更改為設(shè)備保護(hù)存儲(chǔ)。
void	terminateAbility()	破壞當(dāng)前ability
void	terminateAbility(int requestCode)	通過(guò)調(diào)用 Ability.startAbilityForResult(ohos.aafwk.content.Intent, int, ohos.aafwk.ability.startsetting.AbilityStartSetting) 并傳遞相同的 requestCode 來(lái)破壞您之前啟動(dòng)的另一個(gè)能力。
boolean	terminateAbilityResult(int startId)	如果啟動(dòng)的次數(shù)等于給定 startId 表示的次數(shù)，則銷(xiāo)毀此 Service ability。
void	unlockMission()	通過(guò)退出鎖定任務(wù)模式來(lái)解鎖此ability。
int	verifyCallingOrSelfPermission(String permission)	檢查調(diào)用或當(dāng)前進(jìn)程是否具有給定的權(quán)限。
int	verifyCallingPermission(String permission)	檢查進(jìn)程間通信的調(diào)用進(jìn)程是否具有給定的權(quán)限。
int	verifyPermission(String permission, int pid, int uid)	檢查進(jìn)程 ID (PID) 和用戶(hù) ID (UID) 是否具有給定的權(quán)限。
int	verifySelfPermission(String permission)	檢查當(dāng)前進(jìn)程是否具有給定的權(quán)限。

字段詳細(xì)信息

CONTEXT_IGNORE_SECURITY

static final int CONTEXT_IGNORE_SECURITY

指示與 createBundleContext(java.lang.String,int) 一起使用的標(biāo)志，用于創(chuàng)建始終可以在忽略所有安全限制的情況下加載的 Context 對(duì)象。

值為 0x00000002。

CONTEXT_INCLUDE_CODE

static final int CONTEXT_INCLUDE_CODE

指示與 createBundleContext(java.lang.String,int) 一起使用的標(biāo)志，用于創(chuàng)建包含應(yīng)用程序代碼的 Context 對(duì)象。

值為 0x00000001。

CONTEXT_RESOUCE_ONLY

static final int CONTEXT_RESOUCE_ONLY

CONTEXT_RESTRICTED

static final int CONTEXT_RESTRICTED

指示與 createBundleContext(java.lang.String,int) 一起使用的標(biāo)志，用于創(chuàng)建可以禁用特定功能的 Context 對(duì)象。

值為 0x00000004。

MODE_APPEND

static final int MODE_APPEND

表示追加文件創(chuàng)建模式，如果要?jiǎng)?chuàng)建的文件已經(jīng)存在，數(shù)據(jù)將被寫(xiě)入文件末尾，而不是被擦除。

MODE_PRIVATE

static final int MODE_PRIVATE

指示默認(rèn)文件創(chuàng)建模式，其中創(chuàng)建的文件只能由調(diào)用應(yīng)用程序（或共享相同用戶(hù) ID 的所有應(yīng)用程序）訪問(wèn)。

方法詳情

createParallelTaskDispatcher

TaskDispatcher createParallelTaskDispatcher(String name, TaskPriority priority)

創(chuàng)建具有指定優(yōu)先級(jí)的并行任務(wù)調(diào)度程序。

與使用 getGlobalTaskDispatcher(ohos.app.dispatcher.task.TaskPriority) 創(chuàng)建的全局任務(wù)調(diào)度器不同，并行任務(wù)調(diào)度器可以使用單獨(dú)的任務(wù)組并行運(yùn)行一個(gè)組中的任務(wù)，并依次運(yùn)行不同的任務(wù)組。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
name	指示任務(wù)調(diào)度程序名稱(chēng)，該參數(shù)用于定位問(wèn)題。
priority	指示并行任務(wù)分派器分派的所有任務(wù)的優(yōu)先級(jí)。

返回:

返回一個(gè)并行任務(wù)調(diào)度程序。

createSerialTaskDispatcher

TaskDispatcher createSerialTaskDispatcher(String name, TaskPriority priority)

創(chuàng)建具有指定優(yōu)先級(jí)的串行任務(wù)調(diào)度程序。

如果要按特定順序執(zhí)行任務(wù)，請(qǐng)使用串行任務(wù)調(diào)度程序。 否則，請(qǐng)使用并行任務(wù)調(diào)度程序。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
name	指示任務(wù)調(diào)度程序名稱(chēng)。 該參數(shù)用于定位問(wèn)題。
priority	表示創(chuàng)建的任務(wù)調(diào)度器所調(diào)度的所有任務(wù)的優(yōu)先級(jí)。

返回:

返回一個(gè)串行任務(wù)調(diào)度程序。

getGlobalTaskDispatcher

TaskDispatcher getGlobalTaskDispatcher(TaskPriority priority)

獲取具有指定優(yōu)先級(jí)的全局任務(wù)調(diào)度程序。

您可以使用全局任務(wù)分派器來(lái)分派彼此獨(dú)立的任務(wù)。 不要在此調(diào)度程序上創(chuàng)建任務(wù)組或執(zhí)行障礙。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
priority	表示全局任務(wù)調(diào)度器調(diào)度的所有任務(wù)的優(yōu)先級(jí)。

返回:

返回一個(gè)全局任務(wù)調(diào)度器。

getMainTaskDispatcher

TaskDispatcher getMainTaskDispatcher()

獲取綁定到應(yīng)用程序主線程的任務(wù)調(diào)度程序。

在此調(diào)度程序上調(diào)度的任務(wù)按順序執(zhí)行。 不要在主線程上使用這個(gè)dispatcher來(lái)運(yùn)行同步任務(wù)，否則會(huì)發(fā)生死鎖。

返回:

返回綁定到應(yīng)用程序主線程的任務(wù)調(diào)度程序。

getUITaskDispatcher

TaskDispatcher getUITaskDispatcher()

獲取綁定到 UI 線程的任務(wù)調(diào)度程序。

在此調(diào)度程序上調(diào)度的任務(wù)按順序執(zhí)行。 請(qǐng)勿在 UI 線程上使用此調(diào)度程序來(lái)運(yùn)行同步任務(wù)，否則會(huì)發(fā)生死鎖。

返回:

返回綁定到 UI 線程的任務(wù)調(diào)度程序。

getApplicationInfo

ApplicationInfo getApplicationInfo()

獲取有關(guān)當(dāng)前應(yīng)用程序的信息。

返回的應(yīng)用信息包括應(yīng)用名稱(chēng)、應(yīng)用權(quán)限等基本信息。

返回:

返回當(dāng)前應(yīng)用程序的 ApplicationInfo 對(duì)象。

getProcessInfo

ProcessInfo getProcessInfo()

獲取當(dāng)前進(jìn)程的信息，包括進(jìn)程ID和名稱(chēng)。

返回:

返回當(dāng)前進(jìn)程的 ProcessInfo 對(duì)象。

getAbilityInfo

AbilityInfo getAbilityInfo()

獲取有關(guān)當(dāng)前ability的信息。

返回的信息包括類(lèi)名、包名和其他有關(guān)當(dāng)前ability的信息。

返回:

返回當(dāng)前ability的 AbilityInfo 對(duì)象。

getResourceManager

ResourceManager getResourceManager()

獲得資源管理器。

返回:

返回一個(gè) ResourceManager 對(duì)象。

getPreferencesDir

File getPreferencesDir()

獲取應(yīng)用程序偏好文件的存放路徑。

如果首選項(xiàng)文件路徑不存在，則系統(tǒng)創(chuàng)建一個(gè)并返回創(chuàng)建的路徑。

返回:

返回首選項(xiàng)文件。

getDatabaseDir

File getDatabaseDir()

獲取本地?cái)?shù)據(jù)庫(kù)路徑。

如果本地?cái)?shù)據(jù)庫(kù)路徑不存在，則系統(tǒng)創(chuàng)建一個(gè)并返回創(chuàng)建的路徑。

返回:

返回本地?cái)?shù)據(jù)庫(kù)文件。

getDistributedDir

File getDistributedDir()

獲取分布式文件路徑。

如果分布式文件路徑不存在，則系統(tǒng)創(chuàng)建一個(gè)并返回創(chuàng)建的路徑。 此方法僅適用于能力的上下文，而不適用于應(yīng)用程序的上下文。

返回:

返回分發(fā)的文件。

switchToDeviceEncryptedStorageContext

void switchToDeviceEncryptedStorageContext()

將上下文存儲(chǔ)更改為設(shè)備保護(hù)存儲(chǔ)。

switchToCredentialEncryptedStorageContext

void switchToCredentialEncryptedStorageContext()

將上下文存儲(chǔ)更改為受憑證保護(hù)的存儲(chǔ)。

isDeviceEncryptedStorage

boolean isDeviceEncryptedStorage()

檢查上下文是否使用受設(shè)備保護(hù)的存儲(chǔ)。

返回:

如果上下文使用受設(shè)備保護(hù)的存儲(chǔ)，則返回 true； 否則返回 false。

isCredentialEncryptedStorage

boolean isCredentialEncryptedStorage()

檢查上下文是否使用憑據(jù)加密存儲(chǔ)。

返回:

如果上下文使用憑證加密存儲(chǔ)，則返回 true； 否則返回 false。

verifyCallingPermission

int verifyCallingPermission(String permission)

檢查進(jìn)程間通信的調(diào)用進(jìn)程是否具有給定的權(quán)限。

調(diào)用進(jìn)程不是當(dāng)前進(jìn)程。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
permission	表示檢查的權(quán)限，此參數(shù)不能為空。

返回:

如果調(diào)用進(jìn)程有權(quán)限，則返回 0 (IBundleManager.PERMISSION_GRANTED)； 否則返回 -1 (IBundleManager.PERMISSION_DENIED)。

verifySelfPermission

int verifySelfPermission(String permission)

檢查當(dāng)前進(jìn)程是否具有給定的權(quán)限。

僅當(dāng)當(dāng)前進(jìn)程沒(méi)有特定權(quán)限時(shí)，才需要調(diào)用 [requestPermissionsFromUser(java.lang.String],int) 來(lái)請(qǐng)求權(quán)限。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
permission	表示檢查的權(quán)限，此參數(shù)不能為空。

返回:

如果當(dāng)前進(jìn)程有權(quán)限，則返回 0 (IBundleManager.PERMISSION_GRANTED)； 否則返回 -1 (IBundleManager.PERMISSION_DENIED)。

verifyCallingOrSelfPermission

int verifyCallingOrSelfPermission(String permission)

檢查調(diào)用或當(dāng)前進(jìn)程是否具有給定的權(quán)限。

僅當(dāng)調(diào)用來(lái)自遠(yuǎn)程設(shè)備時(shí)，此方法才檢查調(diào)用進(jìn)程的權(quán)限。 否則，它會(huì)檢查當(dāng)前進(jìn)程的權(quán)限。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
permission	表示檢查的權(quán)限，此參數(shù)不能為空。

返回:

如果調(diào)用或當(dāng)前進(jìn)程具有權(quán)限，則返回 0 (IBundleManager.PERMISSION_GRANTED)； 否則返回 -1 (IBundleManager.PERMISSION_DENIED)。

verifyPermission

int verifyPermission(String permission, int pid, int uid)

檢查進(jìn)程 ID (PID) 和用戶(hù) ID (UID) 是否具有給定的權(quán)限。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
permission	表示檢查的權(quán)限，此參數(shù)不能為空。
pid	表示進(jìn)程ID，該值必須大于 0。
uid	表示用戶(hù)標(biāo)識(shí)。

返回:

如果 PID 和 UID 有權(quán)限，則返回 0 (IBundleManager.PERMISSION_GRANTED)； 否則返回 -1 (IBundleManager.PERMISSION_DENIED)。

getClassloader

ClassLoader getClassloader()

獲取一個(gè) ClassLoader 實(shí)例。

ClassLoader實(shí)例用于加載一個(gè)類(lèi)，例如使用類(lèi)名加載當(dāng)前ability的類(lèi)。

返回:

返回一個(gè) ClassLoader 實(shí)例。

getApplicationContext

Context getApplicationContext()

獲取應(yīng)用程序的 Context 對(duì)象。

返回:

返回應(yīng)用程序的 Context 對(duì)象。

terminateAbility

void terminateAbility()

破壞當(dāng)前ability。

當(dāng)前使用AbilityInfo.AbilityType.SERVICE 或AbilityInfo.AbilityType.PAGE 模板的ability執(zhí)行所有操作后，它可以使用此方法銷(xiāo)毀自身以釋放內(nèi)存。

terminateAbility

void terminateAbility(int requestCode)

通過(guò)調(diào)用 Ability.startAbilityForResult(ohos.aafwk.content.Intent, int, ohos.aafwk.ability.startsetting.AbilityStartSetting) 并傳遞相同的 requestCode 來(lái)破壞您之前啟動(dòng)的另一個(gè)能力。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
requestCode	指示為啟動(dòng)ability而傳遞的請(qǐng)求代碼。

displayUnlockMissionMessage

void displayUnlockMissionMessage()

向用戶(hù)顯示系統(tǒng)定義的消息，提示用戶(hù)如何退出鎖定任務(wù)模式。

此方法僅在包含此能力的任務(wù)處于 ohos.app.AbilityManager#LOCK_MISSION_MODE_LOCKED 或 ohos.app.AbilityManager#LOCK_MISSION_MODE_PINNED 狀態(tài)時(shí)生效。

lockMission

void lockMission()

設(shè)置應(yīng)用程序以在鎖定任務(wù)模式下啟動(dòng)ability。

此方法僅在ability在前臺(tái)運(yùn)行時(shí)生效。

unlockMission

void unlockMission()

通過(guò)退出鎖定任務(wù)模式來(lái)解鎖此ability。

此方法僅對(duì)已通過(guò) lockMission() 方法進(jìn)入鎖定任務(wù)模式的ability生效。

getLocalClassName

String getLocalClassName()

獲取ability的本地類(lèi)名。 本地類(lèi)名不以包名作為前綴。 此方法僅適用于頁(yè)面功能。

返回:

返回本地類(lèi)名。

getElementName

ElementName getElementName()

獲取當(dāng)前ability的 ohos.bundle.ElementName 對(duì)象。 此方法僅適用于頁(yè)面ability。

返回:

返回當(dāng)前ability的 ohos.bundle.ElementName 對(duì)象。

getCallingAbility

ElementName getCallingAbility()

獲取調(diào)用當(dāng)前技能的技能的ElementName。

您可以使用獲取的 ElementName 來(lái)檢查是否允許調(diào)用能力接收您將發(fā)送的數(shù)據(jù)。

如果您沒(méi)有使用 Ability.startAbilityForResult(ohos.aafwk.content.Intent, int, ohos.aafwk.ability.startsetting.AbilityStartSetting) 啟動(dòng)調(diào)用能力，則返回 null。

返回:

返回調(diào)用ability的 ElementName； 如果沒(méi)有可用的調(diào)用能力，則返回 null。

getCallingBundle

String getCallingBundle()

獲取調(diào)用當(dāng)前ability的捆綁包名稱(chēng)。

您可以使用獲取的捆綁包名稱(chēng)來(lái)檢查是否允許調(diào)用ability接收您將發(fā)送的數(shù)據(jù)。

如果您沒(méi)有使用 Ability.startAbilityForResult(ohos.aafwk.content.Intent, int, ohos.aafwk.ability.startsetting.AbilityStartSetting) 啟動(dòng)調(diào)用ability，則返回 null。

返回:

返回調(diào)用ability的捆綁包名稱(chēng)； 如果沒(méi)有可用的調(diào)用ability，則返回 null。

stopAbility

boolean stopAbility(Intent intent)

銷(xiāo)毀另一個(gè)使用 AbilityInfo.AbilityType.SERVICE 模板的能力。

當(dāng)前使用 AbilityInfo.AbilityType.SERVICE 或 AbilityInfo.AbilityType.PAGE 模板的能力可以調(diào)用此方法來(lái)銷(xiāo)毀另一個(gè)使用 AbilityInfo.AbilityType.SERVICE 模板的能力。 當(dāng)前的能力本身可以通過(guò)調(diào)用 terminateAbility() 方法來(lái)銷(xiāo)毀。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
intent	表示 Intent 包含有關(guān)破壞能力的信息。

返回:

如果ability被成功摧毀，則返回 true； 否則返回 false。

startAbility

void startAbility(Intent intent, int requestCode)

開(kāi)始一個(gè)新的ability。

使用 AbilityInfo.AbilityType.SERVICE 或 AbilityInfo.AbilityType.PAGE 模板的ability使用此方法啟動(dòng)特定ability。 系統(tǒng)根據(jù)意圖參數(shù)的值從已安裝的技能中定位目標(biāo)ability，然后啟動(dòng)。 您可以使用intent參數(shù)指定開(kāi)始的ability。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
intent	指示包含有關(guān)目標(biāo)啟動(dòng)ability信息的 Intent。
requestCode	表示使用AbilityInfo.AbilityType.PAGE模板的ability啟動(dòng)后返回的請(qǐng)求碼。 您可以定義請(qǐng)求代碼來(lái)識(shí)別ability返回的結(jié)果。 取值范圍為0～65535。該參數(shù)只對(duì)使用AbilityInfo.AbilityType.PAGE模板的ability有效。

startAbility

void startAbility(Intent intent, AbilityStartSetting abilityStartSetting, IAbilityStartCallback iAbilityStartCallback)

開(kāi)始一個(gè)新的ability。

使用 AbilityInfo.AbilityType.SERVICE 或 AbilityInfo.AbilityType.PAGE 模板的ability啟動(dòng)特定ability。 系統(tǒng)根據(jù)意圖參數(shù)的值從已安裝的ability中定位目標(biāo)ability，然后啟動(dòng)。 您可以使用intent參數(shù)指定開(kāi)始的ability。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
intent	指示包含有關(guān)目標(biāo)啟動(dòng)ability信息的 Intent。
abilityStartSetting	表示啟動(dòng)ability中使用的特殊啟動(dòng)設(shè)置。
iAbilityStartCallback	表示ability啟動(dòng)回調(diào)接口。

startAbility

void startAbility(Intent intent, int requestCode, AbilityStartSetting abilityStartSetting)

使用特殊ability開(kāi)始設(shè)置一個(gè)新的ability。

使用 AbilityInfo.AbilityType.SERVICE 或 AbilityInfo.AbilityType.PAGE 模板的ability啟動(dòng)特定ability。 系統(tǒng)根據(jù)意圖參數(shù)的值從已安裝的ability中定位目標(biāo)abilit，然后啟動(dòng)。 您可以使用intent參數(shù)指定開(kāi)始的ability。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
intent	指示包含有關(guān)目標(biāo)啟動(dòng)ability信息的 Intent。
requestCode	表示ability啟動(dòng)后返回的請(qǐng)求碼。 您可以定義請(qǐng)求代碼來(lái)識(shí)別ability返回的結(jié)果。取值范圍為 0 到 65535。
abilityStartSetting	表示啟動(dòng)ability中使用的特殊啟動(dòng)設(shè)置。

startAbilities

void startAbilities(Intent[] intents)

啟動(dòng)多種ability。

使用 AbilityInfo.AbilityType.SERVICE 或 AbilityInfo.AbilityType.PAGE 模板的ability啟動(dòng)特定ability。 系統(tǒng)根據(jù)intents參數(shù)的值區(qū)分目標(biāo)ability和已安裝ability，然后啟動(dòng)目標(biāo)ability。 您可以使用intents參數(shù)來(lái)指定目標(biāo)ability。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
intents	表示包含目標(biāo)ability信息的 Intent 對(duì)象數(shù)組。

createBundleContext

Context createBundleContext(String bundleName, int flag)

為具有給定包名稱(chēng)的應(yīng)用程序創(chuàng)建 Context 對(duì)象。

創(chuàng)建的Context對(duì)象與指定應(yīng)用程序加載后獲取的Context對(duì)象相同。 它們具有相同的資源和類(lèi)加載器。 每次調(diào)用此方法時(shí)都會(huì)返回一個(gè)新的 Context 對(duì)象。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
bundleName	指示應(yīng)用程序的捆綁包名稱(chēng)。
flag	表示創(chuàng)建 Context 對(duì)象的標(biāo)志。 它可以是 0、以下任意值或以下值的任意組合：CONTEXT_IGNORE_SECURITY、CONTEXT_INCLUDE_CODE 和 CONTEXT_RESTRICTED。 值 0 表示為應(yīng)用程序創(chuàng)建上下文沒(méi)有限制。

返回:

返回為指定應(yīng)用程序創(chuàng)建的 Context 對(duì)象。

Throws:

Throw名稱(chēng)	Throw描述
SecurityException	如果出于安全原因無(wú)法將請(qǐng)求的 Context 加載到調(diào)用者的進(jìn)程中，則拋出此異常。 要解決此異常，您可以將 CONTEXT_IGNORE_SECURITY 添加到 flag 的值。

canRequestPermission

boolean canRequestPermission(String permission)

與權(quán)限管理模塊確認(rèn)是否需要請(qǐng)求提示才能授予某個(gè)權(quán)限。

在調(diào)用 [requestPermissionsFromUser(java.lang.String],int) 請(qǐng)求權(quán)限之前，需要調(diào)用當(dāng)前方法檢查是否需要提示。 如果不需要提示，則不會(huì)發(fā)起權(quán)限請(qǐng)求。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
permission	表示要查詢(xún)的權(quán)限，此參數(shù)不能為空。

返回:

如果當(dāng)前應(yīng)用程序沒(méi)有權(quán)限并且用戶(hù)沒(méi)有關(guān)閉進(jìn)一步的請(qǐng)求，則返回 true； 如果當(dāng)前應(yīng)用程序已經(jīng)擁有該權(quán)限，該權(quán)限被系統(tǒng)拒絕，或者該權(quán)限被用戶(hù)拒絕并且用戶(hù)關(guān)閉了進(jìn)一步的請(qǐng)求，則返回 false。

requestPermissionsFromUser

void requestPermissionsFromUser(String[] permissions, int requestCode)

從系統(tǒng)請(qǐng)求某些權(quán)限。

權(quán)限請(qǐng)求調(diào)用此方法。 這是一種異步方法。 執(zhí)行時(shí)，Ability.onRequestPermissionsFromUserResult(int, String[], int[]) 方法會(huì)被回調(diào)。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
permissions	指示要請(qǐng)求的權(quán)限列表，此參數(shù)不能為空。
requestCode	指示要傳遞給 Ability.onRequestPermissionsFromUserResult(int, String[], int[]) 回調(diào)方法的請(qǐng)求代碼，此代碼不能為負(fù)數(shù)。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	如果 requestCode 為負(fù)。

connectAbility

boolean connectAbility(Intent intent, IAbilityConnection conn)

使用 AbilityInfo.AbilityType.SERVICE 模板將當(dāng)前ability連接到ability。

此方法可由使用 AbilityInfo.AbilityType.SERVICE 或 AbilityInfo.AbilityType.PAGE 模板的ability調(diào)用，但連接的目標(biāo)必須是使用 AbilityInfo.AbilityType.SERVICE 模板的ability。 連接后，必須實(shí)現(xiàn) IAbilityConnection 接口才能獲取目標(biāo)ability的代理。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
intent	指示包含有關(guān)連接ability的信息的 Intent。
conn	指示目標(biāo)ability連接時(shí)的回調(diào)對(duì)象。

返回:

如果連接成功，則返回 true；否則返回 false。

disconnectAbility

void disconnectAbility(IAbilityConnection conn)

使用 AbilityInfo.AbilityType.SERVICE 模板斷開(kāi)當(dāng)前ability與ability的連接。

此方法可由使用 AbilityInfo.AbilityType.SERVICE 或 AbilityInfo.AbilityType.PAGE 模板的ability調(diào)用，但斷開(kāi)連接的目標(biāo)必須是使用 AbilityInfo.AbilityType.SERVICE 模板的ability。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
conn	表示連接建立后connectAbility(ohos.aafwk.content.Intent,ohos.aafwk.ability.IAbilityConnection)傳遞的IAbilityConnection回調(diào)對(duì)象。 IAbilityConnection 對(duì)象唯一地標(biāo)識(shí)兩個(gè)ability之間的連接。

setDisplayOrientation

void setDisplayOrientation(AbilityInfo.DisplayOrientation newOrientation)

設(shè)置當(dāng)前ability的顯示方向。

該設(shè)置僅對(duì)使用 AbilityInfo.AbilityType.PAGE 模板的ability生效。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
newOrientation	指示當(dāng)前ability的新方向。

getBundleManager

IBundleManager getBundleManager()

獲得一個(gè) IBundleManager 實(shí)例。

您可以使用此實(shí)例來(lái)獲取有關(guān)應(yīng)用程序包的信息。

返回:

返回一個(gè) IBundleManager 實(shí)例。

getBundleName

String getBundleName()

獲取當(dāng)前ability的捆綁包名稱(chēng)。

返回:

返回當(dāng)前ability的捆綁包名稱(chēng)。

getBundleCodePath

String getBundleCodePath()

獲取包含當(dāng)前ability的包的路徑。

返回的路徑包含模塊的資源、源代碼和配置文件。

返回:

返回包文件的路徑。

getBundleResourcePath

String getBundleResourcePath()

獲取包含此ability的 Ohos ability package (HAP} 的路徑。

返回:

返回包含此ability的 HAP 的路徑。

getDataDir

File getDataDir()

獲取存儲(chǔ)本應(yīng)用所有私有數(shù)據(jù)文件的絕對(duì)路徑。

返回:

返回存儲(chǔ)此應(yīng)用程序所有私有數(shù)據(jù)文件的絕對(duì)路徑。

getCacheDir

File getCacheDir()

獲取設(shè)備內(nèi)部存儲(chǔ)上特定于應(yīng)用程序的緩存目錄。

如果設(shè)備上的其他地方需要磁盤(pán)空間，系統(tǒng)會(huì)自動(dòng)從緩存目錄中刪除文件。 舊文件總是首先被刪除。

返回:

返回特定于應(yīng)用程序的緩存目錄。

getCodeCacheDir

File getCodeCacheDir()

獲取設(shè)備內(nèi)部存儲(chǔ)上特定于應(yīng)用程序的代碼緩存目錄。

當(dāng)您的特定應(yīng)用程序升級(jí)和整個(gè)平臺(tái)升級(jí)時(shí)，系統(tǒng)將刪除存儲(chǔ)在此位置的所有文件。

返回:

返回特定于應(yīng)用程序的代碼緩存目錄。

getExternalMediaDirs

File[] getExternalMediaDirs()

獲取它可以放置的所有文件上的特定于應(yīng)用程序的媒體目錄。

卸載您的特定應(yīng)用程序時(shí)，系統(tǒng)將刪除所有這些文件。

返回:

返回特定于應(yīng)用程序的媒體。

getNoBackupFilesDir

File getNoBackupFilesDir()

獲取應(yīng)用程序創(chuàng)建并將自動(dòng)備份到遠(yuǎn)程存儲(chǔ)的絕對(duì)路徑。

如果將應(yīng)用程序移動(dòng)到采用的存儲(chǔ)設(shè)備，則返回的路徑可能會(huì)更改。

返回:

保存不會(huì)自動(dòng)備份到遠(yuǎn)程存儲(chǔ)的應(yīng)用程序文件的目錄的路徑。

getFilesDir

File getFilesDir()

獲取設(shè)備內(nèi)部存儲(chǔ)中應(yīng)用程序文件的存儲(chǔ)目錄。

返回:

返回應(yīng)用程序文件目錄。

getDir

File getDir(String name, int mode)

獲取應(yīng)用程序自定義數(shù)據(jù)文件存放目錄。

您可以使用返回的 File 對(duì)象在此目錄中創(chuàng)建和訪問(wèn)文件。 這些文件只能由當(dāng)前應(yīng)用程序訪問(wèn)。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
name	指示要檢索的目錄的名稱(chēng)。 該目錄是作為應(yīng)用程序數(shù)據(jù)的一部分創(chuàng)建的。
mode	指示文件操作模式。 該值可以是 0 或 MODE_PRIVATE 的組合。

返回:

返回請(qǐng)求目錄的 File 對(duì)象。

getExternalCacheDir

File getExternalCacheDir()

獲取主外部或共享存儲(chǔ)設(shè)備上特定于應(yīng)用程序的緩存目錄的絕對(duì)路徑。

應(yīng)用程序可以將其緩存文件放在此目錄中。

返回:

返回外部或共享存儲(chǔ)設(shè)備上應(yīng)用程序特定緩存目錄的絕對(duì)路徑； 如果外部或共享存儲(chǔ)設(shè)備暫時(shí)不可用，則返回 null。

getExternalCacheDirs

File[] getExternalCacheDirs()

獲取所有外部或共享存儲(chǔ)設(shè)備上特定于應(yīng)用程序的緩存目錄的絕對(duì)路徑。

應(yīng)用程序可以將其緩存文件放在這些目錄中。

返回:

返回所有外部或共享存儲(chǔ)設(shè)備上應(yīng)用程序特定緩存目錄的絕對(duì)路徑； 如果外部或共享存儲(chǔ)設(shè)備暫時(shí)不可用，則返回 null。 返回的第一個(gè)路徑與 getExternalCacheDir() 返回的路徑相同。

getExternalFilesDir

File getExternalFilesDir(String type)

獲取用于在主外部或共享存儲(chǔ)設(shè)備上存儲(chǔ)應(yīng)用程序文件的目錄的絕對(duì)路徑。

應(yīng)用程序可以將其持久文件放置在此目錄中。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
type	指示要返回的文件目錄的類(lèi)型。 對(duì)于以下目錄或子目錄，此參數(shù)可以為空：文件的根目錄 Environment.DIRECTORY_PICTURES、Environment.DIRECTORY_DOCUMENTS、Environment.DIRECTORY_DOWNLOADS、Environment.DIRECTORY_MOVIES 或 Environment.DIRECTORY_MUSIC 類(lèi)型的子目錄。

返回:

返回外部或共享存儲(chǔ)設(shè)備上應(yīng)用程序文件目錄的絕對(duì)路徑； 如果外部或共享存儲(chǔ)設(shè)備暫時(shí)不可用，則返回 null。

getExternalFilesDirs

File[] getExternalFilesDirs(String type)

獲取用于在所有外部或共享存儲(chǔ)設(shè)備上存儲(chǔ)應(yīng)用程序文件的目錄的絕對(duì)路徑。

應(yīng)用程序可以將其持久文件放在這些目錄中。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
type	指示要返回的文件目錄的類(lèi)型。 對(duì)于以下目錄或子目錄，此參數(shù)可以為空：文件的根目錄 Environment.DIRECTORY_PICTURES、Environment.DIRECTORY_DOCUMENTS、Environment.DIRECTORY_DOWNLOADS、Environment.DIRECTORY_MOVIES 或 Environment.DIRECTORY_MUSIC 類(lèi)型的子目錄。

返回:

返回所有外部或共享存儲(chǔ)設(shè)備上應(yīng)用程序文件目錄的絕對(duì)路徑； 如果外部或共享存儲(chǔ)設(shè)備暫時(shí)不可用，則返回 null。 返回的第一個(gè)路徑與 getExternalFilesDir(java.lang.String) 返回的路徑相同。

deleteFile

boolean deleteFile(String fileName)

刪除與應(yīng)用程序關(guān)聯(lián)的指定私有文件。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
fileName	指示要?jiǎng)h除的文件的名稱(chēng)，文件名不能包含路徑分隔符。

返回:

如果文件被成功刪除，則返回 true；否則返回 false。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	如果 fileName 包含路徑分隔符，則引發(fā)此異常。

getAbilityManager

IAbilityManager getAbilityManager()

獲得ability管理器。

ability管理器提供有關(guān)正在運(yùn)行的進(jìn)程和應(yīng)用程序的內(nèi)存使用情況的信息。

返回:

返回一個(gè) IAbilityManager 實(shí)例。

terminateAbilityResult

boolean terminateAbilityResult(int startId)

如果啟動(dòng)的次數(shù)等于給定 startId 表示的次數(shù)，則銷(xiāo)毀此 Service ability。 此方法與調(diào)用 terminateAbility() 銷(xiāo)毀此 Service ability相同，只是此方法可幫助您避免在客戶(hù)端在 Ability.onCommand(ohos.aafwk.content.Intent, boolean) 中請(qǐng)求服務(wù)ability啟動(dòng)時(shí)銷(xiāo)毀它

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
startId	表示傳遞給 Ability.onCommand(ohos.aafwk.content.Intent, boolean) 的該 Service ability的啟動(dòng)次數(shù)。 每次啟動(dòng)此功能時(shí)，startId 都會(huì)增加 1。 例如，如果該ability已啟動(dòng)六次，則 startId 的值為 6。

返回:

如果 startId 與啟動(dòng)次數(shù)匹配，則返回 true 并且該 Service ability將被銷(xiāo)毀； 否則返回 false。

getDisplayOrientation

int getDisplayOrientation()

獲取此ability的當(dāng)前顯示方向。

返回:

返回當(dāng)前顯示方向。

setShowOnLockScreen

void setShowOnLockScreen(boolean showOnLockScreen)

設(shè)置是否在鎖定屏幕顯示時(shí)在鎖定屏幕頂部顯示該ability，保持該ability處于 ACTIVE 狀態(tài)。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
showOnLockScreen	指定是否在鎖定屏幕頂部顯示此功能。 true 表示在鎖屏上顯示，false 表示不顯示。

setWakeUpScreen

void setWakeUpScreen(boolean wakeUpScreen)

設(shè)置此ability恢復(fù)時(shí)是否喚醒屏幕。

此方法僅對(duì)用戶(hù)在屏幕喚醒后可見(jiàn)的ability生效。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
wakeUpScreen	指定是否喚醒屏幕。 true 表示喚醒它，false 表示不喚醒。

restart

void restart()

使用新實(shí)例重新啟動(dòng)此ability。 這類(lèi)似于當(dāng)該ability由于系統(tǒng)配置更改而被破壞時(shí)，重新啟動(dòng)該ability的實(shí)例的過(guò)程。

此方法僅對(duì)使用 AbilityInfo.AbilityType.PAGE 模板的ability生效。

setTransitionAnimation

void setTransitionAnimation(int enterAnim, int exitAnim)

設(shè)置兩個(gè)ability之間的過(guò)渡動(dòng)畫(huà)。

該方法必須在 startAbility(ohos.aafwk.content.Intent,int) 被調(diào)用后調(diào)用。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
enterAnim	指示傳入ability的動(dòng)畫(huà)資源 ID。
exitAnim	表示傳出ability的動(dòng)畫(huà)資源 ID。

isUpdatingConfigurations

boolean isUpdatingConfigurations()

檢查此ability的配置是否正在更改

通常，此類(lèi)更改信息在 Ability.onStop() 中用于確定如何處理此ability引用的資源。

返回:

如果配置正在更改，例如，如果設(shè)備的顯示方向正在更改，則返回 true； 否則返回 false。

setTheme

void setTheme(int themeId)

根據(jù)指定的主題 ID 設(shè)置此 Context 的主題。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
themeId	表示要設(shè)置的主題的資源ID。

getTheme

Theme getTheme()

獲取此 Context 的主題。

此方法僅在通過(guò)調(diào)用 setTheme(int) 設(shè)置主題時(shí)有效。

返回:

theme 返回此 Context 的主題。

getThemeId

int getThemeId()

獲取此 Context 的主題 ID。

返回:

int 返回此 Context 的主題 ID。

setPattern

void setPattern(int patternId)

根據(jù)指定的模式 ID 設(shè)置此上下文的模式。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
patternId	指示要設(shè)置的模式的資源 ID。

getPattern

Pattern getPattern()

獲取此 Context 的模式。

此方法僅在通過(guò)調(diào)用 setPattern(int) 設(shè)置模式時(shí)有效。

返回:

pattern 返回此上下文的模式。

getAppType

String getAppType()

獲取此應(yīng)用程序的類(lèi)型。

返回:

如果此應(yīng)用程序是系統(tǒng)應(yīng)用程序，則返回系統(tǒng)； 如果在 Ohos AppGallery 中發(fā)布，則返回正常； 如果由第三方供應(yīng)商發(fā)布，則返回其他； 如果查詢(xún)失敗，則返回一個(gè)空字符串。

getResourceManager

ResourceManager getResourceManager(Configuration configuration)

根據(jù)指定的 Configuration 對(duì)象獲取資源管理器。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
configuration	表示包含資源配置信息的Configuration對(duì)象。

返回：

返回獲取到的 ResourceManager 對(duì)象。

getLastStoredDataWhenConfigChanged

Object getLastStoredDataWhenConfigChanged()

當(dāng)系統(tǒng)配置發(fā)生變化時(shí)，獲取通過(guò) Ability.onStoreDataWhenConfigChange() 保存的最新數(shù)據(jù)。

返回:

返回保存的數(shù)據(jù)對(duì)象。

printDrawnCompleted

void printDrawnCompleted()

打印出系統(tǒng)完成繪制此頁(yè)面ability所需的時(shí)間。

compelVerifyPermission

void compelVerifyPermission(String permission, String message)

檢查是否已將指定權(quán)限授予調(diào)用進(jìn)程，如果未授予權(quán)限，則拋出 SecurityException。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
permission	表示檢查的權(quán)限。
message	指示拋出 SecurityException 時(shí)要顯示的信息。

Throws:

Throw名稱(chēng)	Throw描述
SecurityException	如果調(diào)用進(jìn)程沒(méi)有指定的權(quán)限，則拋出此異常。

compelVerifyUriPermission

void compelVerifyUriPermission(Uri uri, int modeFlags, String message)

檢查調(diào)用進(jìn)程是否有訪問(wèn)指定URI的權(quán)限，如果沒(méi)有權(quán)限則拋出SecurityException。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
uri	指示要檢查的 URI，此參數(shù)不能為空。
modeFlags	指示要檢查的訪問(wèn)模式。 該值可以是 ohos.aafwk.content.Intent#FLAG_AUTH_READ_URI_PERMISSION、ohos.aafwk.content.Intent#FLAG_AUTH_WRITE_URI_PERMISSION 或它們的組合。
message	指示拋出 SecurityException 時(shí)要顯示的信息。

Throws:

Throw名稱(chēng)	Throw描述
SecurityException	如果調(diào)用進(jìn)程沒(méi)有權(quán)限，則拋出此異常。

compelVerifyCallerPermission

void compelVerifyCallerPermission(String permission, String message)

檢查是否已為調(diào)用進(jìn)程授予進(jìn)程間通信 (IPC) 的指定權(quán)限，如果未授予該權(quán)限，則拋出 SecurityException。 如果您當(dāng)前未參與 IPC，此方法也會(huì)引發(fā) SecurityException。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
permission	表示檢查的權(quán)限。
message	指示拋出 SecurityException 時(shí)要顯示的信息。

Throws:

Throw名稱(chēng)	Throw描述
SecurityException	如果調(diào)用進(jìn)程沒(méi)有指定的權(quán)限或者您當(dāng)前未參與 IPC，則引發(fā)此異常。

compelVerifyCallerUriPermission

void compelVerifyCallerUriPermission(Uri uri, int modeFlags, String message)

檢查IPC的調(diào)用進(jìn)程是否有權(quán)限訪問(wèn)指定的URI，如果沒(méi)有權(quán)限則拋出SecurityException。 如果您當(dāng)前未參與 IPC，此方法也會(huì)引發(fā) SecurityException。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
uri	指示要檢查的 URI。 此參數(shù)不能為空。
modeFlags	指示要檢查的訪問(wèn)模式。 該值可以是 ohos.aafwk.content.Intent#FLAG_AUTH_READ_URI_PERMISSION、ohos.aafwk.content.Intent#FLAG_AUTH_WRITE_URI_PERMISSION 或它們的組合。
message	指示拋出 SecurityException 時(shí)要顯示的信息。

Throws:

Throw名稱(chēng)	Throw描述
SecurityException	如果調(diào)用進(jìn)程沒(méi)有權(quán)限或者您當(dāng)前未參與 IPC，則拋出此異常。

compelVerifyPermission

void compelVerifyPermission(String permission, int pid, int uid, String message)

檢查pid和uid標(biāo)識(shí)的進(jìn)程是否已授予指定權(quán)限，如果未授予權(quán)限，則拋出SecurityException。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
permission	表示檢查的權(quán)限。
pid	指示要檢查的進(jìn)程的 ID。
uid	指示要檢查的進(jìn)程的 UID。
message	指示拋出 SecurityException 時(shí)要顯示的信息。

Throws:

Throw名稱(chēng)	Throw描述
SecurityException	如果具有指定 PID 和 UID 的進(jìn)程沒(méi)有指定的權(quán)限，則拋出此異常。

compelVerifyUriPermission

void compelVerifyUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)

檢查pid和uid標(biāo)識(shí)的進(jìn)程是否有權(quán)限訪問(wèn)指定的URI，如果沒(méi)有權(quán)限則拋出SecurityException。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
uri	指示要檢查的 URI。 此參數(shù)不能為空。
pid	指示要檢查的進(jìn)程的 ID。
uid	指示要檢查的進(jìn)程的 UID。
modeFlags	指示要檢查的訪問(wèn)模式。 該值可以是 ohos.aafwk.content.Intent#FLAG_AUTH_READ_URI_PERMISSION、ohos.aafwk.content.Intent#FLAG_AUTH_WRITE_URI_PERMISSION 或它們的組合。
message	指示拋出 SecurityException 時(shí)要顯示的信息。

Throws:

Throw名稱(chēng)	Throw描述
SecurityException	如果具有指定 PID 和 UID 的進(jìn)程沒(méi)有權(quán)限，則拋出此異常。

compelVerifyUriPermission

void compelVerifyUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)

檢查pid和uid標(biāo)識(shí)的進(jìn)程是否指定了讀寫(xiě)權(quán)限以及訪問(wèn)指定URI的權(quán)限，如果沒(méi)有權(quán)限則拋出SecurityException。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
uri	指示要檢查的 URI。 此參數(shù)不能為空。
readPermission	表示要檢查的讀取權(quán)限。
writePermission	表示要檢查的寫(xiě)權(quán)限。
pid	指示要檢查的進(jìn)程的 ID。
uid	指示要檢查的進(jìn)程的 UID。
modeFlags	指示要檢查的訪問(wèn)模式。 該值可以是 ohos.aafwk.content.Intent#FLAG_AUTH_READ_URI_PERMISSION、ohos.aafwk.content.Intent#FLAG_AUTH_WRITE_URI_PERMISSION 或它們的組合。
message	指示拋出 SecurityException 時(shí)要顯示的信息。

Throws:

Throw名稱(chēng)	Throw描述
SecurityException	如果具有指定 PID 和 UID 的進(jìn)程沒(méi)有權(quán)限，則拋出此異常。

getColor

int getColor(int resId)

根據(jù)指定的資源 ID 獲取此 Context 的顏色。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
resId	表示要獲取的顏色的資源ID。

返回:

返回此上下文的顏色值。

getString

String getString(int resId)

根據(jù)指定的資源 ID 獲取此 Context 的字符串。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
resId	表示要獲取的字符串的資源ID。

返回:

返回此上下文的字符串。

getString

String getString(int resId, Object... formatArgs)

根據(jù)指定的資源 ID 和 formatArgs 獲取此 Context 的字符串。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
resId	表示要獲取的字符串的資源ID。
formatArgs	指示用于替換的格式化對(duì)象。

返回:

返回此上下文的字符串。

getStringArray

String[] getStringArray(int resId)

根據(jù)指定的資源 ID 獲取此 Context 的字符串?dāng)?shù)組。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
resId	表示要獲取的字符串?dāng)?shù)組的資源ID。

返回:

返回此 Context 的字符串?dāng)?shù)組。

getIntArray

int[] getIntArray(int resId)

根據(jù)指定的資源 ID 獲取此 Context 的整數(shù)數(shù)組。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
resId	表示要獲取的整數(shù)數(shù)組的資源ID。

返回:

返回此 Context 的整數(shù)數(shù)組。

getProcessName

String getProcessName()

獲取當(dāng)前進(jìn)程的名稱(chēng)。

返回:

返回當(dāng)前進(jìn)程名稱(chēng)。

getAbilityPackageContext

Context getAbilityPackageContext()

獲取此ability的 Context 對(duì)象。

此方法不能用于獲取應(yīng)用程序的上下文。

返回:

返回此ability的上下文對(duì)象。

getHapModuleInfo

HapModuleInfo getHapModuleInfo()

獲取應(yīng)用程序的 HapModuleInfo 對(duì)象。

返回:

返回應(yīng)用程序的 HapModuleInfo 對(duì)象。

getCaller

Uri getCaller()

獲取有關(guān)此能力調(diào)用者的信息。

返回:

返回調(diào)用者信息。

setColorMode

void setColorMode(int mode)

設(shè)置顏色模式。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
mode	顏色模式的值。

getColorMode

int getColorMode()

獲取顏色模式。

返回:

返回顏色模式值。