鴻蒙OS AbilityContext

AbilityContext

java.lang.Object

|---ohos.app.AbilityContext

public abstract class AbilityContext
extends Object
implements Context

為當(dāng)前對象提供應(yīng)用上下文并獲取應(yīng)用環(huán)境信息的抽象類。 這個類實現(xiàn)了 Context 接口。

應(yīng)用程序可以通過AbilityContext獲取資源、啟動能力、創(chuàng)建或獲取線程模型、獲取應(yīng)用程序包信息和運行信息。 能力是能力上下文的子類。 因此，能力是能力上下文的一個實例。

字段摘要

從接口 ohos.app.Context 繼承的字段
CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESOUCE_ONLY, CONTEXT_RESTRICTED, MODE_APPEND, MODE_PRIVATE

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù)	描述
AbilityContext()	AbilityContext 的默認(rèn)構(gòu)造函數(shù)。
AbilityContext(Context context)	用于創(chuàng)建和初始化能力的構(gòu)造函數(shù)。

方法總結(jié)

修飾符和類型	方法	描述
void	attachBaseContext(Context base)	將上下文對象附加到當(dāng)前ability。
boolean	canRequestPermission(String permission)	與權(quán)限管理模塊確認(rèn)是否需要請求提示才能授予某個權(quán)限。
void	compelVerifyCallerPermission(String permission, String message)	檢查是否已將指定權(quán)限授予調(diào)用進(jìn)程進(jìn)行進(jìn)程間通信 (IPC)，如果未授予權(quán)限，則拋出 SecurityException。
void	compelVerifyCallerUriPermission(Uri uri, int modeFlags, String message)	檢查IPC的調(diào)用進(jìn)程是否有權(quán)限訪問指定的URI，如果沒有權(quán)限則拋出SecurityException。
void	compelVerifyPermission(String permission, int pid, int uid, String message)	檢查pid和uid標(biāo)識的進(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)識的進(jìn)程是否有權(quán)限訪問指定的URI，如果沒有權(quán)限則拋出SecurityException。
void	compelVerifyUriPermission(Uri uri, int modeFlags, String message)	檢查調(diào)用進(jìn)程是否有訪問指定URI的權(quán)限，如果沒有權(quán)限則拋出SecurityException。
void	compelVerifyUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)	檢查pid和uid標(biāo)識的進(jìn)程是否指定了讀寫權(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)前ability的捆綁包名稱。
ClassLoader	getClassloader()	獲取一個 ClassLoader 實例。
File	getCodeCacheDir()	獲取設(shè)備內(nèi)部存儲上特定于應(yīng)用程序的代碼緩存目錄。
int	getColor(int resId)	根據(jù)指定的資源 ID 獲取此 Context 的顏色。
int	getColorMode()	獲取顏色模式。
Context	getContext()	獲取應(yīng)用程序上下文。
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)建并將自動備份到遠(yuǎn)程存儲的絕對路徑。
Pattern	getPattern()	獲取此 Context 的模式。
File	getPreferencesDir()	獲取應(yīng)用程序偏好文件的存放路徑。
ProcessInfo	getProcessInfo()	獲取當(dāng)前進(jìn)程的信息，包括進(jìn)程ID和名稱。
String	getProcessName()	獲取當(dāng)前進(jìn)程的名稱。
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)度程序。
void	init()	初始化當(dāng)前ability。
boolean	isCredentialEncryptedStorage()	檢查上下文是否使用憑據(jù)加密存儲。
boolean	isDeviceEncryptedStorage()	檢查上下文是否使用受設(shè)備保護(hù)的存儲。
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 callback)	開始一個新的ability。
boolean	stopAbility(Intent intent)	銷毀另一個使用 AbilityInfo.AbilityType.SERVICE 模板的ability。
void	switchToCredentialEncryptedStorageContext()	將上下文存儲更改為受憑證保護(hù)的存儲。
void	switchToDeviceEncryptedStorageContext()	將上下文存儲更改為設(shè)備保護(hù)存儲。
void	terminateAbility()	破壞當(dāng)前ability。
void	terminateAbility(int requestCode)	通過調(diào)用 Ability.startAbilityForResult(ohos.aafwk.content.Intent, int, ohos.aafwk.ability.startsetting.AbilityStartSetting) 并傳遞相同的 requestCode 來破壞您之前啟動的另一個ability。
boolean	terminateAbilityResult(int startId)	如果啟動的次數(shù)等于給定 startId 表示的次數(shù)，則銷毀此 Service ability。
void	unlockMission()	通過退出鎖定任務(wù)模式來解鎖此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) 和用戶 ID (UID) 是否具有給定的權(quán)限。
int	verifySelfPermission(String permission)	檢查當(dāng)前進(jìn)程是否具有給定的權(quán)限。

從類 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

構(gòu)造函數(shù)詳細(xì)信息

AbilityContext

public AbilityContext()

AbilityContext 的默認(rèn)構(gòu)造函數(shù)。

AbilityContext

public AbilityContext(Context context)

用于創(chuàng)建和初始化能力的構(gòu)造函數(shù)。

參數(shù):

參數(shù)名稱	參數(shù)描述
context	指示應(yīng)用程序上下文，此參數(shù)不能為空。

方法詳情

attachBaseContext

public void attachBaseContext(Context base)

將上下文對象附加到當(dāng)前ability。

一般在Ability加載完成后調(diào)用該方法，為當(dāng)前Ability提供應(yīng)用上下文。

參數(shù):

參數(shù)名稱	參數(shù)描述
base	表示一個上下文對象。

getContext

public final Context getContext()

獲取應(yīng)用程序上下文。

返回:

返回應(yīng)用程序上下文。 該對象是構(gòu)造函數(shù)創(chuàng)建的初始化ability，或者作為attachBaseContext(ohos.app.Context)的輸入?yún)?shù)傳遞的上下文對象。

init

public void init()

初始化當(dāng)前ability。

getUITaskDispatcher

public final TaskDispatcher getUITaskDispatcher()

從接口復(fù)制的描述：上下文

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

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

指定者:

接口上下文中的getUITaskDispatcher

返回:

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

getMainTaskDispatcher

public final TaskDispatcher getMainTaskDispatcher()

從接口復(fù)制的描述：上下文

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

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

指定者:

接口 Context 中的 getMainTaskDispatcher

返回:

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

createParallelTaskDispatcher

public TaskDispatcher createParallelTaskDispatcher(String name, TaskPriority priority)

從接口復(fù)制的描述：上下文

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

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

指定者:

接口 Context 中的 createParallelTaskDispatcher

參數(shù):

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

返回:

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

createSerialTaskDispatcher

public TaskDispatcher createSerialTaskDispatcher(String name, TaskPriority priority)

從接口復(fù)制的描述：上下文

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

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

指定者:

接口 Context 中的 createSerialTaskDispatcher

參數(shù):

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

返回:

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

getGlobalTaskDispatcher

public TaskDispatcher getGlobalTaskDispatcher(TaskPriority priority)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getGlobalTaskDispatcher

參數(shù):

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

返回:

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

getApplicationInfo

public ApplicationInfo getApplicationInfo()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的getApplicationInfo

返回:

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

getAbilityInfo

public AbilityInfo getAbilityInfo()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的getAbilityInfo

返回:

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

getProcessInfo

public ProcessInfo getProcessInfo()

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getProcessInfo

返回:

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

getResourceManager

public ResourceManager getResourceManager()

從接口復(fù)制的描述：上下文

獲得資源管理器。

指定者：

接口上下文中的getResourceManager

返回:

返回一個 ResourceManager 對象。

getPreferencesDir

public File getPreferencesDir()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的 getPreferencesDir

返回：

返回首選項文件。

getDatabaseDir

public File getDatabaseDir()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getDatabaseDir

返回:

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

getDistributedDir

public File getDistributedDir()

從接口復(fù)制的描述：上下文

獲取分布式文件路徑。

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

指定者：

接口 Context 中的 getDistributedDir

返回:

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

switchToDeviceEncryptedStorageContext

public void switchToDeviceEncryptedStorageContext()

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 switchToDeviceEncryptedStorageContext

switchToCredentialEncryptedStorageContext

public void switchToCredentialEncryptedStorageContext()

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 switchToCredentialEncryptedStorageContext

isDeviceEncryptedStorage

public boolean isDeviceEncryptedStorage()

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 isDeviceEncryptedStorage

返回:

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

isCredentialEncryptedStorage

public boolean isCredentialEncryptedStorage()

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 isCredentialEncryptedStorage

返回:

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

verifyCallingPermission

public int verifyCallingPermission(String permission)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 verifyCallingPermission

參數(shù):

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

返回:

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

verifySelfPermission

public int verifySelfPermission(String permission)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 verifySelfPermission

參數(shù):

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

返回:

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

verifyCallingOrSelfPermission

public int verifyCallingOrSelfPermission(String permission)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 verifyCallingOrSelfPermission

參數(shù):

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

返回:

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

verifyPermission

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

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的 verifyPermission

參數(shù):

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

返回:

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

getClassloader

public ClassLoader getClassloader()

從接口復(fù)制的描述：上下文

獲取一個 ClassLoader 實例。

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

指定者：

接口上下文中的getClassloader

返回:

返回一個 ClassLoader 實例。

getApplicationContext

public Context getApplicationContext()

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getApplicationContext

返回:

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

terminateAbility

public void terminateAbility()

從接口復(fù)制的描述：上下文

破壞當(dāng)前ability。

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

指定者：

接口上下文中的 terminateAbility

terminateAbility

public void terminateAbility(int requestCode)

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的 terminateAbility

參數(shù):

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

displayUnlockMissionMessage

public void displayUnlockMissionMessage()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的 displayUnlockMissionMessage

lockMission

public void lockMission()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的 lockMission

unlockMission

public void unlockMission()

從接口復(fù)制的描述：上下文

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

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

指定者：

界面上下文中的unlockMission

terminateAbilityResult

public final boolean terminateAbilityResult(int startId)

從接口復(fù)制的描述：上下文

如果啟動的次數(shù)等于給定 startId 表示的次數(shù)，則銷毀此 Service ability。 此方法與調(diào)用 Context.terminateAbility() 銷毀此 Service ability相同。

指定者：

接口上下文中的 terminateAbilityResult

參數(shù):

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

返回:

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

getLocalClassName

public String getLocalClassName()

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getLocalClassName

返回：

返回本地類名。

getElementName

public ElementName getElementName()

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getElementName

返回:

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

getCallingAbility

public ElementName getCallingAbility()

從接口復(fù)制的描述：上下文

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

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

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

指定者：

接口上下文中的 getCallingAbility

返回:

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

getCallingBundle

public String getCallingBundle()

從接口復(fù)制的描述：上下文

獲取調(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。

指定者：

接口上下文中的getCallingBundle

返回:

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

stopAbility

public boolean stopAbility(Intent intent)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的 stopAbility

參數(shù):

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

返回:

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

startAbility

public void startAbility(Intent intent, int requestCode)

從接口復(fù)制的描述：上下文

開始一個新的ability。

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

指定者：

接口上下文中的 startAbility

參數(shù):

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

startAbility

public void startAbility(Intent intent, AbilityStartSetting abilityStartSetting, IAbilityStartCallback callback)

從接口復(fù)制的描述：上下文

開始一個新的ability。

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

指定者：

接口上下文中的 startAbility

參數(shù):

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

startAbility

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

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的 startAbility

參數(shù):

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

startAbilities

public void startAbilities(Intent[] intents)

從接口復(fù)制的描述：上下文

啟動多種ability。

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

指定者：

接口上下文中的 startAbilities

參數(shù):

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

createBundleContext

public Context createBundleContext(String bundleName, int flag)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 createBundleContext

參數(shù):

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

返回:

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

getDataDir

public File getDataDir()

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getDataDir

返回：

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

getBundleResourcePath

public String getBundleResourcePath()

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 getBundleResourcePath

返回:

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

canRequestPermission

public boolean canRequestPermission(String permission)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 canRequestPermission

參數(shù):

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

返回:

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

requestPermissionsFromUser

public void requestPermissionsFromUser(String[] permissions, int requestCode)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的 requestPermissionsFromUser

參數(shù):

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

connectAbility

public boolean connectAbility(Intent intent, IAbilityConnection conn)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的connectAbility

參數(shù):

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

返回:

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

disconnectAbility

public void disconnectAbility(IAbilityConnection conn)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的disconnectAbility

參數(shù):

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

setDisplayOrientation

public void setDisplayOrientation(AbilityInfo.DisplayOrientation newOrientation)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的 setDisplayOrientation

參數(shù):

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

getBundleManager

public IBundleManager getBundleManager()

從接口復(fù)制的描述：上下文

獲得一個 IBundleManager 實例。

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

指定者：

接口上下文中的getBundleManager

返回:

返回一個 IBundleManager 實例。

getBundleName

public String getBundleName()

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getBundleName

返回:

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

getBundleCodePath

public String getBundleCodePath()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getBundleCodePath

返回:

返回包文件的路徑。

getCacheDir

public File getCacheDir()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getCacheDir

返回:

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

getCodeCacheDir

public File getCodeCacheDir()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getCodeCacheDir

返回:

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

getExternalMediaDirs

public File[] getExternalMediaDirs()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getExternalMediaDirs

返回:

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

getNoBackupFilesDir

public File getNoBackupFilesDir()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getNoBackupFilesDir

返回:

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

getFilesDir

public File getFilesDir()

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 getFilesDir

返回:

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

getDir

public File getDir(String name, int mode)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的getDir

參數(shù):

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

返回:

返回請求目錄的 File 對象。

getExternalCacheDir

public File getExternalCacheDir()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getExternalCacheDir

返回:

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

getExternalCacheDirs

public File[] getExternalCacheDirs()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getExternalCacheDirs

返回:

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

getExternalFilesDir

public File getExternalFilesDir(String type)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getExternalFilesDir

參數(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

public File[] getExternalFilesDirs(String type)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 getExternalFilesDirs

參數(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。 返回的第一個路徑與 Context.getExternalFilesDir(java.lang.String) 返回的路徑相同。

deleteFile

public boolean deleteFile(String fileName)

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的deleteFile

參數(shù):

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

返回:

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

getAbilityManager

public IAbilityManager getAbilityManager()

從接口復(fù)制的描述：上下文

獲得ability管理器。

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

指定者：

接口上下文中的 getAbilityManager

返回:

返回一個 IAbilityManager 實例。

getDisplayOrientation

public int getDisplayOrientation()

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getDisplayOrientation

返回:

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

setShowOnLockScreen

public void setShowOnLockScreen(boolean showOnLockScreen)

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 setShowOnLockScreen

參數(shù):

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

setWakeUpScreen

public void setWakeUpScreen(boolean wakeUpScreen)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 setWakeUpScreen

參數(shù):

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

restart

public void restart()

從接口復(fù)制的描述：上下文

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

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

指定者：

在界面上下文中重啟

setTransitionAnimation

public void setTransitionAnimation(int enterAnim, int exitAnim)

從接口復(fù)制的描述：上下文

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

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

指定者：

接口 Context 中的 setTransitionAnimation

參數(shù):

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

isUpdatingConfigurations

public boolean isUpdatingConfigurations()

從接口復(fù)制的描述：上下文

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

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

指定者：

接口上下文中的 isUpdatingConfigurations

返回:

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

setTheme

public void setTheme(int themeId)

從接口復(fù)制的描述：上下文

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

指定者：

界面上下文中的 setTheme

參數(shù):

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

getTheme

public Theme getTheme()

從接口復(fù)制的描述：上下文

獲取此 Context 的主題。

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

指定者：

接口上下文中的getTheme

返回:

theme 返回此 Context 的主題。

setPattern

public void setPattern(int patternId)

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的 setPattern

參數(shù):

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

getPattern

public Pattern getPattern()

從接口復(fù)制的描述：上下文

獲取此 Context 的模式。

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

指定者：

接口上下文中的getPattern

返回:

pattern 返回此上下文的模式。

getAppType

public String getAppType()

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

指定者：

接口上下文中的getAppType

返回:

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

getResourceManager

public ResourceManager getResourceManager(Configuration configuration)

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getResourceManager

參數(shù):

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

返回:

返回獲取到的 ResourceManager 對象。

getLastStoredDataWhenConfigChanged

public Object getLastStoredDataWhenConfigChanged()

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 getLastStoredDataWhenConfigChanged

返回:

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

printDrawnCompleted

public void printDrawnCompleted()

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 printDrawnCompleted

compelVerifyPermission

public void compelVerifyPermission(String permission, String message)

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 compelVerifyPermission

參數(shù):

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

compelVerifyUriPermission

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

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 compelVerifyUriPermission

參數(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 時要顯示的信息。

compelVerifyCallerPermission

public void compelVerifyCallerPermission(String permission, String message)

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 compelVerifyCallerPermission

參數(shù):

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

compelVerifyCallerUriPermission

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

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 compelVerifyCallerUriPermission

參數(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 時要顯示的信息。

compelVerifyPermission

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

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 compelVerifyPermission

參數(shù):

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

compelVerifyUriPermission

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

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 compelVerifyUriPermission

參數(shù):

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

compelVerifyUriPermission

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

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 compelVerifyUriPermission

參數(shù):

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

getColor

public int getColor(int resId)

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getColor

參數(shù):

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

返回:

返回此上下文的顏色值。

getString

public String getString(int resId)

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getString

參數(shù):

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

返回:

返回此上下文的字符串

getString

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

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getString

參數(shù):

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

返回:

返回此上下文的字符串

getStringArray

public String[] getStringArray(int resId)

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 getStringArray

參數(shù):

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

返回:

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

getIntArray

public int[] getIntArray(int resId)

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 getIntArray

參數(shù):

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

返回:

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

getProcessName

public String getProcessName()

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getProcessName

返回:

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

getAbilityPackageContext

public Context getAbilityPackageContext()

從接口復(fù)制的描述：上下文

獲取此ability的 Context 對象。

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

指定者：

接口 Context 中的 getAbilityPackageContext

返回:

返回此ability的上下文對象。

getHapModuleInfo

public HapModuleInfo getHapModuleInfo()

從接口復(fù)制的描述：上下文

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

指定者：

接口 Context 中的 getHapModuleInfo

返回:

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

getCaller

public Uri getCaller()

從接口復(fù)制的描述：上下文

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

指定者：

接口上下文中的getCaller

返回:

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

getThemeId

public int getThemeId()

從接口復(fù)制的描述：上下文

獲取此 Context 的主題 ID。

指定者：

接口上下文中的getThemeId

返回:

int 返回此 Context 的主題 ID。

setColorMode

public void setColorMode(int mode)

從接口復(fù)制的描述：上下文

設(shè)置顏色模式。

指定者：

接口上下文中的 setColorMode

參數(shù):

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

getColorMode

public int getColorMode()

從接口復(fù)制的描述：上下文

獲取顏色模式。

指定者：

接口上下文中的getColorMode

返回:

返回顏色模式值。