新聞中心
Context

創(chuàng)新互聯(lián)公司成立于2013年,先為舒城等服務(wù)建站,舒城等地企業(yè),進(jìn)行企業(yè)商務(wù)咨詢服務(wù)。為舒城企業(yè)網(wǎng)站制作PC+手機(jī)+微官網(wǎng)三網(wǎng)同步一站式服務(wù)解決您的所有建站問題。
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)行信息。
字段摘要
| 修飾符和類型 | 字段 | 描述 |
|---|---|---|
| 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ù)將被寫入文件末尾,而不是被擦除。 |
| static int | MODE_PRIVATE | 指示默認(rèn)文件創(chuàng)建模式,其中創(chuàng)建的文件只能由調(diào)用應(yīng)用程序(或共享相同用戶 ID 的所有應(yīng)用程序)訪問。 |
方法總結(jié)
| 修飾符和類型 | 方法 | 描述 |
|---|---|---|
| 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)程是否有訪問指定URI的權(quán)限,如果沒有權(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)限訪問指定的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)識(shí)的進(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 對(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 模板斷開當(dāng)前ability與ability的連接。 |
| void | displayUnlockMissionMessage() | 向用戶顯示系統(tǒng)定義的消息,提示用戶如何退出鎖定任務(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)用程序的類型。 |
| String | getBundleCodePath() | 獲取包含當(dāng)前ability的包的路徑。 |
| IBundleManager | getBundleManager() | 獲得一個(gè) IBundleManager 實(shí)例。 |
| String | getBundleName() | 獲取當(dāng)前ability的捆綁包名稱。 |
| 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)前技能的技能的捆綁包名稱。 |
| 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í),獲取通過 Ability.onStoreDataWhenConfigChange() 保存的最新數(shù)據(jù)。 |
| String | getLocalClassName() | 獲取ability的本地類名。 |
| 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和名稱。 |
| String | getProcessName() | 獲取當(dāng)前進(jìn)程的名稱 |
| 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之間的過渡動(dòng)畫。 |
| void | setWakeUpScreen(boolean wakeUpScreen) | 設(shè)置此ability恢復(fù)時(shí)是否喚醒屏幕。 |
| void | startAbilities(Intent[] intents) | 啟動(dòng)多個(gè)ability。 |
| void | startAbility(Intent intent, int requestCode) | 開始一個(gè)新的ability。 |
| void | startAbility(Intent intent, int requestCode, AbilityStartSetting abilityStartSetting) | 使用特殊ability開始設(shè)置一個(gè)新ability。 |
| void | startAbility(Intent intent, AbilityStartSetting abilityStartSetting, IAbilityStartCallback iAbilityStartCallback) | 開始一個(gè)新的ability。 |
| boolean | stopAbility(Intent intent) | 銷毀另一個(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) | 通過調(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ù),則銷毀此 Service ability。 |
| void | unlockMission() | 通過退出鎖定任務(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) 和用戶 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ù)將被寫入文件末尾,而不是被擦除。
MODE_PRIVATE
static final int MODE_PRIVATE
指示默認(rèn)文件創(chuàng)建模式,其中創(chuàng)建的文件只能由調(diào)用應(yīng)用程序(或共享相同用戶 ID 的所有應(yīng)用程序)訪問。
方法詳情
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ù)名稱 | 參數(shù)描述 |
|---|---|
| name | 指示任務(wù)調(diào)度程序名稱,該參數(shù)用于定位問題。 |
| 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ù)名稱 | 參數(shù)描述 |
|---|---|
| name | 指示任務(wù)調(diào)度程序名稱。 該參數(shù)用于定位問題。 |
| 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ù)名稱 | 參數(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)用名稱、應(yīng)用權(quán)限等基本信息。
返回:
返回當(dāng)前應(yīng)用程序的 ApplicationInfo 對(duì)象。
getProcessInfo
ProcessInfo getProcessInfo()
獲取當(dāng)前進(jìn)程的信息,包括進(jìn)程ID和名稱。
返回:
返回當(dāng)前進(jìn)程的 ProcessInfo 對(duì)象。
getAbilityInfo
AbilityInfo getAbilityInfo()
獲取有關(guān)當(dāng)前ability的信息。
返回的信息包括類名、包名和其他有關(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ù)名稱 | 參數(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)程沒有特定權(quán)限時(shí),才需要調(diào)用 [requestPermissionsFromUser(java.lang.String],int) 來(lái)請(qǐng)求權(quán)限。
參數(shù):
| 參數(shù)名稱 | 參數(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ù)名稱 | 參數(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) 和用戶 ID (UID) 是否具有給定的權(quán)限。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| permission | 表示檢查的權(quán)限,此參數(shù)不能為空。 |
| pid | 表示進(jìn)程ID,該值必須大于 0。 |
| uid | 表示用戶標(biāo)識(shí)。 |
返回:
如果 PID 和 UID 有權(quán)限,則返回 0 (IBundleManager.PERMISSION_GRANTED); 否則返回 -1 (IBundleManager.PERMISSION_DENIED)。
getClassloader
ClassLoader getClassloader()
獲取一個(gè) ClassLoader 實(shí)例。
ClassLoader實(shí)例用于加載一個(gè)類,例如使用類名加載當(dāng)前ability的類。
返回:
返回一個(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í)行所有操作后,它可以使用此方法銷毀自身以釋放內(nèi)存。
terminateAbility
void terminateAbility(int requestCode)
通過調(diào)用 Ability.startAbilityForResult(ohos.aafwk.content.Intent, int, ohos.aafwk.ability.startsetting.AbilityStartSetting) 并傳遞相同的 requestCode 來(lái)破壞您之前啟動(dòng)的另一個(gè)能力。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| requestCode | 指示為啟動(dòng)ability而傳遞的請(qǐng)求代碼。 |
displayUnlockMissionMessage
void displayUnlockMissionMessage()
向用戶顯示系統(tǒng)定義的消息,提示用戶如何退出鎖定任務(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()
通過退出鎖定任務(wù)模式來(lái)解鎖此ability。
此方法僅對(duì)已通過 lockMission() 方法進(jìn)入鎖定任務(wù)模式的ability生效。
getLocalClassName
String getLocalClassName()
獲取ability的本地類名。 本地類名不以包名作為前綴。 此方法僅適用于頁(yè)面功能。
返回:
返回本地類名。
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ù)。
如果您沒有使用 Ability.startAbilityForResult(ohos.aafwk.content.Intent, int, ohos.aafwk.ability.startsetting.AbilityStartSetting) 啟動(dòng)調(diào)用能力,則返回 null。
返回:
返回調(diào)用ability的 ElementName; 如果沒有可用的調(diào)用能力,則返回 null。
getCallingBundle
String getCallingBundle()
獲取調(diào)用當(dāng)前ability的捆綁包名稱。
您可以使用獲取的捆綁包名稱來(lái)檢查是否允許調(diào)用ability接收您將發(fā)送的數(shù)據(jù)。
如果您沒有使用 Ability.startAbilityForResult(ohos.aafwk.content.Intent, int, ohos.aafwk.ability.startsetting.AbilityStartSetting) 啟動(dòng)調(diào)用ability,則返回 null。
返回:
返回調(diào)用ability的捆綁包名稱; 如果沒有可用的調(diào)用ability,則返回 null。
stopAbility
boolean stopAbility(Intent intent)
銷毀另一個(gè)使用 AbilityInfo.AbilityType.SERVICE 模板的能力。
當(dāng)前使用 AbilityInfo.AbilityType.SERVICE 或 AbilityInfo.AbilityType.PAGE 模板的能力可以調(diào)用此方法來(lái)銷毀另一個(gè)使用 AbilityInfo.AbilityType.SERVICE 模板的能力。 當(dāng)前的能力本身可以通過調(diào)用 terminateAbility() 方法來(lái)銷毀。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| intent | 表示 Intent 包含有關(guān)破壞能力的信息。 |
返回:
如果ability被成功摧毀,則返回 true; 否則返回 false。
startAbility
void startAbility(Intent intent, int requestCode)
開始一個(gè)新的ability。
使用 AbilityInfo.AbilityType.SERVICE 或 AbilityInfo.AbilityType.PAGE 模板的ability使用此方法啟動(dòng)特定ability。 系統(tǒng)根據(jù)意圖參數(shù)的值從已安裝的技能中定位目標(biāo)ability,然后啟動(dòng)。 您可以使用intent參數(shù)指定開始的ability。
參數(shù):
| 參數(shù)名稱 | 參數(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)
開始一個(gè)新的ability。
使用 AbilityInfo.AbilityType.SERVICE 或 AbilityInfo.AbilityType.PAGE 模板的ability啟動(dòng)特定ability。 系統(tǒng)根據(jù)意圖參數(shù)的值從已安裝的ability中定位目標(biāo)ability,然后啟動(dòng)。 您可以使用intent參數(shù)指定開始的ability。
參數(shù):
| 參數(shù)名稱 | 參數(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開始設(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ù)指定開始的ability。
參數(shù):
| 參數(shù)名稱 | 參數(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ù)名稱 | 參數(shù)描述 |
|---|---|
| intents | 表示包含目標(biāo)ability信息的 Intent 對(duì)象數(shù)組。 |
createBundleContext
Context createBundleContext(String bundleName, int flag)
為具有給定包名稱的應(yīng)用程序創(chuàng)建 Context 對(duì)象。
創(chuàng)建的Context對(duì)象與指定應(yīng)用程序加載后獲取的Context對(duì)象相同。 它們具有相同的資源和類加載器。 每次調(diào)用此方法時(shí)都會(huì)返回一個(gè)新的 Context 對(duì)象。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| bundleName | 指示應(yīng)用程序的捆綁包名稱。 |
| flag | 表示創(chuàng)建 Context 對(duì)象的標(biāo)志。 它可以是 0、以下任意值或以下值的任意組合:CONTEXT_IGNORE_SECURITY、CONTEXT_INCLUDE_CODE 和 CONTEXT_RESTRICTED。 值 0 表示為應(yīng)用程序創(chuàng)建上下文沒有限制。 |
返回:
返回為指定應(yīng)用程序創(chuàng)建的 Context 對(duì)象。
Throws:
| Throw名稱 | 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ù)名稱 | 參數(shù)描述 |
|---|---|
| permission | 表示要查詢的權(quán)限,此參數(shù)不能為空。 |
返回:
如果當(dāng)前應(yīng)用程序沒有權(quán)限并且用戶沒有關(guān)閉進(jìn)一步的請(qǐng)求,則返回 true; 如果當(dāng)前應(yīng)用程序已經(jīng)擁有該權(quán)限,該權(quán)限被系統(tǒng)拒絕,或者該權(quán)限被用戶拒絕并且用戶關(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ù)名稱 | 參數(shù)描述 |
|---|---|
| permissions | 指示要請(qǐng)求的權(quán)限列表,此參數(shù)不能為空。 |
| requestCode | 指示要傳遞給 Ability.onRequestPermissionsFromUserResult(int, String[], int[]) 回調(diào)方法的請(qǐng)求代碼,此代碼不能為負(fù)數(shù)。 |
Throws:
| Throw名稱 | 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ù)名稱 | 參數(shù)描述 |
|---|---|
| intent | 指示包含有關(guān)連接ability的信息的 Intent。 |
| conn | 指示目標(biāo)ability連接時(shí)的回調(diào)對(duì)象。 |
返回:
如果連接成功,則返回 true;否則返回 false。
disconnectAbility
void disconnectAbility(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ù):
| 參數(shù)名稱 | 參數(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ù)名稱 | 參數(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的捆綁包名稱。
返回:
返回當(dāng)前ability的捆綁包名稱。
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è)備上的其他地方需要磁盤空間,系統(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)建和訪問文件。 這些文件只能由當(dāng)前應(yīng)用程序訪問。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| name | 指示要檢索的目錄的名稱。 該目錄是作為應(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ù)名稱 | 參數(shù)描述 |
|---|---|
| type | 指示要返回的文件目錄的類型。 對(duì)于以下目錄或子目錄,此參數(shù)可以為空:文件的根目錄 Environment.DIRECTORY_PICTURES、Environment.DIRECTORY_DOCUMENTS、Environment.DIRECTORY_DOWNLOADS、Environment.DIRECTORY_MOVIES 或 Environment.DIRECTORY_MUSIC 類型的子目錄。 |
返回:
返回外部或共享存儲(chǔ)設(shè)備上應(yīng)用程序文件目錄的絕對(duì)路徑; 如果外部或共享存儲(chǔ)設(shè)備暫時(shí)不可用,則返回 null。
getExternalFilesDirs
File[] getExternalFilesDirs(String type)
獲取用于在所有外部或共享存儲(chǔ)設(shè)備上存儲(chǔ)應(yīng)用程序文件的目錄的絕對(duì)路徑。
應(yīng)用程序可以將其持久文件放在這些目錄中。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| type | 指示要返回的文件目錄的類型。 對(duì)于以下目錄或子目錄,此參數(shù)可以為空:文件的根目錄 Environment.DIRECTORY_PICTURES、Environment.DIRECTORY_DOCUMENTS、Environment.DIRECTORY_DOWNLOADS、Environment.DIRECTORY_MOVIES 或 Environment.DIRECTORY_MUSIC 類型的子目錄。 |
返回:
返回所有外部或共享存儲(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ù)名稱 | 參數(shù)描述 |
|---|---|
| fileName | 指示要?jiǎng)h除的文件的名稱,文件名不能包含路徑分隔符。 |
返回:
如果文件被成功刪除,則返回 true;否則返回 false。
Throws:
| Throw名稱 | 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ù),則銷毀此 Service ability。 此方法與調(diào)用 terminateAbility() 銷毀此 Service ability相同,只是此方法可幫助您避免在客戶端在 Ability.onCommand(ohos.aafwk.content.Intent, boolean) 中請(qǐng)求服務(wù)ability啟動(dòng)時(shí)銷毀它
參數(shù):
| 參數(shù)名稱 | 參數(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將被銷毀; 否則返回 false。
getDisplayOrientation
int getDisplayOrientation()
獲取此ability的當(dāng)前顯示方向。
返回:
返回當(dāng)前顯示方向。
setShowOnLockScreen
void setShowOnLockScreen(boolean showOnLockScreen)
設(shè)置是否在鎖定屏幕顯示時(shí)在鎖定屏幕頂部顯示該ability,保持該ability處于 ACTIVE 狀態(tài)。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| showOnLockScreen | 指定是否在鎖定屏幕頂部顯示此功能。 true 表示在鎖屏上顯示,false 表示不顯示。 |
setWakeUpScreen
void setWakeUpScreen(boolean wakeUpScreen)
設(shè)置此ability恢復(fù)時(shí)是否喚醒屏幕。
此方法僅對(duì)用戶在屏幕喚醒后可見的ability生效。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| wakeUpScreen | 指定是否喚醒屏幕。 true 表示喚醒它,false 表示不喚醒。 |
restart
void restart()
使用新實(shí)例重新啟動(dòng)此ability。 這類似于當(dāng)該ability由于系統(tǒng)配置更改而被破壞時(shí),重新啟動(dòng)該ability的實(shí)例的過程。
此方法僅對(duì)使用 AbilityInfo.AbilityType.PAGE 模板的ability生效。
setTransitionAnimation
void setTransitionAnimation(int enterAnim, int exitAnim)
設(shè)置兩個(gè)ability之間的過渡動(dòng)畫。
該方法必須在 startAbility(ohos.aafwk.content.Intent,int) 被調(diào)用后調(diào)用。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| enterAnim | 指示傳入ability的動(dòng)畫資源 ID。 |
| exitAnim | 表示傳出ability的動(dòng)畫資源 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è)置主題時(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è)置模式時(shí)有效。
返回:
pattern 返回此上下文的模式。
getAppType
String getAppType()
獲取此應(yīng)用程序的類型。
返回:
如果此應(yīng)用程序是系統(tǒng)應(yīng)用程序,則返回系統(tǒng); 如果在 Ohos AppGallery 中發(fā)布,則返回正常; 如果由第三方供應(yīng)商發(fā)布,則返回其他; 如果查詢失敗,則返回一個(gè)空字符串。
getResourceManager
ResourceManager getResourceManager(Configuration configuration)
根據(jù)指定的 Configuration 對(duì)象獲取資源管理器。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| configuration | 表示包含資源配置信息的Configuration對(duì)象。 |
返回:
返回獲取到的 ResourceManager 對(duì)象。
getLastStoredDataWhenConfigChanged
Object getLastStoredDataWhenConfigChanged()
當(dāng)系統(tǒng)配置發(fā)生變化時(shí),獲取通過 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ù)名稱 | 參數(shù)描述 |
|---|---|
| permission | 表示檢查的權(quán)限。 |
| message | 指示拋出 SecurityException 時(shí)要顯示的信息。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| SecurityException | 如果調(diào)用進(jìn)程沒有指定的權(quán)限,則拋出此異常。 |
compelVerifyUriPermission
void compelVerifyUriPermission(Uri uri, int modeFlags, String message)
檢查調(diào)用進(jìn)程是否有訪問指定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 時(shí)要顯示的信息。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| SecurityException | 如果調(diào)用進(jìn)程沒有權(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ù)名稱 | 參數(shù)描述 |
|---|---|
| permission | 表示檢查的權(quán)限。 |
| message | 指示拋出 SecurityException 時(shí)要顯示的信息。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| SecurityException | 如果調(diào)用進(jìn)程沒有指定的權(quán)限或者您當(dāng)前未參與 IPC,則引發(fā)此異常。 |
compelVerifyCallerUriPermission
void compelVerifyCallerUriPermission(Uri uri, int modeFlags, String message)
檢查IPC的調(diào)用進(jìn)程是否有權(quán)限訪問指定的URI,如果沒有權(quán)限則拋出SecurityException。 如果您當(dāng)前未參與 IPC,此方法也會(huì)引發(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 時(shí)要顯示的信息。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| SecurityException | 如果調(diào)用進(jìn)程沒有權(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ù)名稱 | 參數(shù)描述 |
|---|---|
| permission | 表示檢查的權(quán)限。 |
| pid | 指示要檢查的進(jìn)程的 ID。 |
| uid | 指示要檢查的進(jìn)程的 UID。 |
| message | 指示拋出 SecurityException 時(shí)要顯示的信息。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| SecurityException | 如果具有指定 PID 和 UID 的進(jìn)程沒有指定的權(quán)限,則拋出此異常。 |
compelVerifyUriPermission
void compelVerifyUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)
檢查pid和uid標(biāo)識(shí)的進(jìn)程是否有權(quán)限訪問指定的URI,如果沒有權(quán)限則拋出SecurityException。
參數(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 時(shí)要顯示的信息。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| SecurityException | 如果具有指定 PID 和 UID 的進(jìn)程沒有權(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)程是否指定了讀寫權(quán)限以及訪問指定URI的權(quán)限,如果沒有權(quán)限則拋出SecurityException。
參數(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 時(shí)要顯示的信息。 |
Throws:
| Throw名稱 | Throw描述 |
|---|---|
| SecurityException | 如果具有指定 PID 和 UID 的進(jìn)程沒有權(quán)限,則拋出此異常。 |
getColor
int getColor(int resId)
根據(jù)指定的資源 ID 獲取此 Context 的顏色。
參數(shù):
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| resId | 表示要獲取的顏色的資源ID。 |
返回:
返回此上下文的顏色值。
getString
String getString(int resId)
根據(jù)指定的資源 ID 獲取此 Context 的字符串。
參數(shù):
|
當(dāng)前標(biāo)題:創(chuàng)新互聯(lián)鴻蒙OS教程:鴻蒙OSContext 本文地址:http://m.5511xx.com/article/cdopeed.html |
|---|


咨詢
建站咨詢
