鴻蒙OS Context

Context

public interface Context

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

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

字段摘要

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

方法總結(jié)

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

字段詳細信息

CONTEXT_IGNORE_SECURITY

static final int CONTEXT_IGNORE_SECURITY

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

值為 0x00000002。

CONTEXT_INCLUDE_CODE

static final int CONTEXT_INCLUDE_CODE

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

值為 0x00000001。

CONTEXT_RESOUCE_ONLY

static final int CONTEXT_RESOUCE_ONLY

CONTEXT_RESTRICTED

static final int CONTEXT_RESTRICTED

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

值為 0x00000004。

MODE_APPEND

static final int MODE_APPEND

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

MODE_PRIVATE

static final int MODE_PRIVATE

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

方法詳情

createParallelTaskDispatcher

TaskDispatcher createParallelTaskDispatcher(String name, TaskPriority priority)

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

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

參數(shù):

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

返回:

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

createSerialTaskDispatcher

TaskDispatcher createSerialTaskDispatcher(String name, TaskPriority priority)

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

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

參數(shù):

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

返回:

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

getGlobalTaskDispatcher

TaskDispatcher getGlobalTaskDispatcher(TaskPriority priority)

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

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

參數(shù):

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

返回:

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

getMainTaskDispatcher

TaskDispatcher getMainTaskDispatcher()

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

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

返回:

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

getUITaskDispatcher

TaskDispatcher getUITaskDispatcher()

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

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

返回:

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

getApplicationInfo

ApplicationInfo getApplicationInfo()

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

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

返回:

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

getProcessInfo

ProcessInfo getProcessInfo()

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

返回:

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

getAbilityInfo

AbilityInfo getAbilityInfo()

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

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

返回:

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

getResourceManager

ResourceManager getResourceManager()

獲得資源管理器。

返回:

返回一個 ResourceManager 對象。

getPreferencesDir

File getPreferencesDir()

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

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

返回:

返回首選項文件。

getDatabaseDir

File getDatabaseDir()

獲取本地數(shù)據(jù)庫路徑。

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

返回:

返回本地數(shù)據(jù)庫文件。

getDistributedDir

File getDistributedDir()

獲取分布式文件路徑。

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

返回:

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

switchToDeviceEncryptedStorageContext

void switchToDeviceEncryptedStorageContext()

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

switchToCredentialEncryptedStorageContext

void switchToCredentialEncryptedStorageContext()

將上下文存儲更改為受憑證保護的存儲。

isDeviceEncryptedStorage

boolean isDeviceEncryptedStorage()

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

返回:

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

isCredentialEncryptedStorage

boolean isCredentialEncryptedStorage()

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

返回:

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

verifyCallingPermission

int verifyCallingPermission(String permission)

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

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

參數(shù):

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

返回:

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

verifySelfPermission

int verifySelfPermission(String permission)

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

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

參數(shù):

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

返回:

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

verifyCallingOrSelfPermission

int verifyCallingOrSelfPermission(String permission)

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

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

參數(shù):

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

返回:

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

verifyPermission

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

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

參數(shù):

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

返回:

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

getClassloader

ClassLoader getClassloader()

獲取一個 ClassLoader 實例。

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

返回:

返回一個 ClassLoader 實例。

getApplicationContext

Context getApplicationContext()

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

返回:

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

terminateAbility

void terminateAbility()

破壞當(dāng)前ability。

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

terminateAbility

void terminateAbility(int requestCode)

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

參數(shù):

參數(shù)名稱	參數(shù)描述
requestCode	指示為啟動ability而傳遞的請求代碼。

displayUnlockMissionMessage

void displayUnlockMissionMessage()

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

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

lockMission

void lockMission()

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

此方法僅在ability在前臺運行時生效。

unlockMission

void unlockMission()

通過退出鎖定任務(wù)模式來解鎖此ability。

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

getLocalClassName

String getLocalClassName()

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

返回:

返回本地類名。

getElementName

ElementName getElementName()

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

返回:

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

getCallingAbility

ElementName getCallingAbility()

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

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

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

返回:

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

getCallingBundle

String getCallingBundle()

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

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

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

返回:

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

stopAbility

boolean stopAbility(Intent intent)

銷毀另一個使用 AbilityInfo.AbilityType.SERVICE 模板的能力。

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

參數(shù):

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

返回:

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

startAbility

void startAbility(Intent intent, int requestCode)

開始一個新的ability。

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

參數(shù):

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

startAbility

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

開始一個新的ability。

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

參數(shù):

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

startAbility

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

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

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

參數(shù):

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

startAbilities

void startAbilities(Intent[] intents)

啟動多種ability。

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

參數(shù):

參數(shù)名稱	參數(shù)描述
intents	表示包含目標ability信息的 Intent 對象數(shù)組。

createBundleContext

Context createBundleContext(String bundleName, int flag)

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

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

參數(shù):

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

返回:

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

Throws:

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

canRequestPermission

boolean canRequestPermission(String permission)

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

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

參數(shù):

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

返回:

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

requestPermissionsFromUser

void requestPermissionsFromUser(String[] permissions, int requestCode)

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

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

參數(shù):

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

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果 requestCode 為負。

connectAbility

boolean connectAbility(Intent intent, IAbilityConnection conn)

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

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

參數(shù):

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

返回:

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

disconnectAbility

void disconnectAbility(IAbilityConnection conn)

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

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

參數(shù):

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

setDisplayOrientation

void setDisplayOrientation(AbilityInfo.DisplayOrientation newOrientation)

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

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

參數(shù):

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

getBundleManager

IBundleManager getBundleManager()

獲得一個 IBundleManager 實例。

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

返回:

返回一個 IBundleManager 實例。

getBundleName

String getBundleName()

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

返回:

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

getBundleCodePath

String getBundleCodePath()

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

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

返回:

返回包文件的路徑。

getBundleResourcePath

String getBundleResourcePath()

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

返回:

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

getDataDir

File getDataDir()

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

返回:

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

getCacheDir

File getCacheDir()

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

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

返回:

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

getCodeCacheDir

File getCodeCacheDir()

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

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

返回:

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

getExternalMediaDirs

File[] getExternalMediaDirs()

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

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

返回:

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

getNoBackupFilesDir

File getNoBackupFilesDir()

獲取應(yīng)用程序創(chuàng)建并將自動備份到遠程存儲的絕對路徑。

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

返回:

保存不會自動備份到遠程存儲的應(yīng)用程序文件的目錄的路徑。

getFilesDir

File getFilesDir()

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

返回:

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

getDir

File getDir(String name, int mode)

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

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

參數(shù):

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

返回:

返回請求目錄的 File 對象。

getExternalCacheDir

File getExternalCacheDir()

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

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

返回:

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

getExternalCacheDirs

File[] getExternalCacheDirs()

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

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

返回:

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

getExternalFilesDir

File getExternalFilesDir(String type)

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

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

參數(shù):

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

返回:

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

getExternalFilesDirs

File[] getExternalFilesDirs(String type)

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

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

參數(shù):

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

返回:

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

deleteFile

boolean deleteFile(String fileName)

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

參數(shù):

參數(shù)名稱	參數(shù)描述
fileName	指示要刪除的文件的名稱，文件名不能包含路徑分隔符。

返回:

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

Throws:

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

getAbilityManager

IAbilityManager getAbilityManager()

獲得ability管理器。

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

返回:

返回一個 IAbilityManager 實例。

terminateAbilityResult

boolean terminateAbilityResult(int startId)

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

參數(shù):

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

返回:

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

getDisplayOrientation

int getDisplayOrientation()

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

返回:

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

setShowOnLockScreen

void setShowOnLockScreen(boolean showOnLockScreen)

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

參數(shù):

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

setWakeUpScreen

void setWakeUpScreen(boolean wakeUpScreen)

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

此方法僅對用戶在屏幕喚醒后可見的ability生效。

參數(shù):

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

restart

void restart()

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

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

setTransitionAnimation

void setTransitionAnimation(int enterAnim, int exitAnim)

設(shè)置兩個ability之間的過渡動畫。

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

參數(shù):

參數(shù)名稱	參數(shù)描述
enterAnim	指示傳入ability的動畫資源 ID。
exitAnim	表示傳出ability的動畫資源 ID。

isUpdatingConfigurations

boolean isUpdatingConfigurations()

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

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

返回:

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

setTheme

void setTheme(int themeId)

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

參數(shù):

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

getTheme

Theme getTheme()

獲取此 Context 的主題。

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

返回:

theme 返回此 Context 的主題。

getThemeId

int getThemeId()

獲取此 Context 的主題 ID。

返回:

int 返回此 Context 的主題 ID。

setPattern

void setPattern(int patternId)

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

參數(shù):

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

getPattern

Pattern getPattern()

獲取此 Context 的模式。

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

返回:

pattern 返回此上下文的模式。

getAppType

String getAppType()

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

返回:

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

getResourceManager

ResourceManager getResourceManager(Configuration configuration)

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

參數(shù):

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

返回：

返回獲取到的 ResourceManager 對象。

getLastStoredDataWhenConfigChanged

Object getLastStoredDataWhenConfigChanged()

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

返回:

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

printDrawnCompleted

void printDrawnCompleted()

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

compelVerifyPermission

void compelVerifyPermission(String permission, String message)

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

參數(shù):

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

Throws:

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

compelVerifyUriPermission

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

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

參數(shù):

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

Throws:

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

compelVerifyCallerPermission

void compelVerifyCallerPermission(String permission, String message)

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

參數(shù):

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

Throws:

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

compelVerifyCallerUriPermission

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

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

參數(shù):

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

Throws:

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

compelVerifyPermission

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

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

參數(shù):

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

Throws:

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

compelVerifyUriPermission

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

檢查pid和uid標識的進程是否有權(quán)限訪問指定的URI，如果沒有權(quán)限則拋出SecurityException。

參數(shù):

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

Throws:

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

compelVerifyUriPermission

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

檢查pid和uid標識的進程是否指定了讀寫權(quán)限以及訪問指定URI的權(quán)限，如果沒有權(quán)限則拋出SecurityException。

參數(shù):

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

Throws:

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

getColor

int getColor(int resId)

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

參數(shù):

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

返回:

返回此上下文的顏色值。

getString

String getString(int resId)

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

參數(shù):

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

返回:

返回此上下文的字符串。

getString

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

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

參數(shù):

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

返回:

返回此上下文的字符串。

getStringArray

String[] getStringArray(int resId)

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

參數(shù):

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

返回:

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

getIntArray

int[] getIntArray(int resId)

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

參數(shù):

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

返回:

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

getProcessName

String getProcessName()

獲取當(dāng)前進程的名稱。

返回:

返回當(dāng)前進程名稱。

getAbilityPackageContext

Context getAbilityPackageContext()

獲取此ability的 Context 對象。

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

返回:

返回此ability的上下文對象。

getHapModuleInfo

HapModuleInfo getHapModuleInfo()

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

返回:

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

getCaller

Uri getCaller()

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

返回:

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

setColorMode

void setColorMode(int mode)

設(shè)置顏色模式。

參數(shù):

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

getColorMode

int getColorMode()

獲取顏色模式。

返回:

返回顏色模式值。