Context模塊

Context模塊提供了ability或application的上下文的能力，包括允許訪問特定于應用程序的資源、請求和驗證權限等。

說明：

本模塊首批接口從API version 6開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。
本模塊接口僅可在FA模型下使用。

使用說明

Context對象是在featureAbility中創建實例，并通過featureAbility的getContext()接口返回，因此在使用Context時，必須導入@ohos.ability.featureAbility庫。示例如下：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getOrCreateLocalDir()

開發前請熟悉鴻蒙開發指導文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

Context.getOrCreateLocalDir7+

getOrCreateLocalDir(callback: AsyncCallback): void

獲取應用程序的本地根目錄（callback形式）。

如果是第一次調用，將創建目錄。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getOrCreateLocalDir((err, data)= >{
    console.info("data=" + data);
})

Context.getOrCreateLocalDir7+

getOrCreateLocalDir(): Promise

獲取應用程序的本地根目錄（Promise形式）。

如果是第一次調用，將創建目錄。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getOrCreateLocalDir().then((data) = > {
    console.info("data=" + data);
});

Context.verifyPermission7+

verifyPermission(permission: string, options: PermissionOptions, callback: AsyncCallback): void

驗證系統中運行的特定pid和uid是否允許指定的權限（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
import bundle from '@ohos.bundle'
var context = featureAbility.getContext();
bundle.getBundleInfo('com.context.test', 1, (err,datainfo) = >{
	context.verifyPermission("com.example.permission", {uid:datainfo.uid});
});

Context.verifyPermission7+

verifyPermission(permission: string, callback: AsyncCallback): void

驗證系統中運行的當前pid和uid是否具有指定的權限（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.verifyPermission("com.example.permission")

Context.verifyPermission7+

verifyPermission(permission: string, options?: PermissionOptions): Promise

驗證系統中運行的特定pid和uid是否具有指定的權限（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
var Permission = {pid:1};
context.verifyPermission('com.context.permission',Permission).then((data) = > {
    console.info("====================== >verifyPermissionCallback==================== >");
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.requestPermissionsFromUser7+

requestPermissionsFromUser(permissions: Array, requestCode: number, resultCallback: AsyncCallback[[PermissionRequestResult]]): void

從系統請求某些權限（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.requestPermissionsFromUser(
    ["com.example.permission1",
     "com.example.permission2",
     "com.example.permission3",
     "com.example.permission4",
     "com.example.permission5"],
    1,(err, data)= >{
        console.info("==== >requestdata==== >" + JSON.stringify(data));
        console.info("==== >requesterrcode==== >" + JSON.stringify(err.code));
    }
)

Context.getApplicationInfo7+

getApplicationInfo(callback: AsyncCallback): void

獲取有關當前應用程序的信息（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getApplicationInfo()

Context.getApplicationInfo7+

getApplicationInfo(): Promise

獲取有關當前應用程序的信息（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getApplicationInfo().then((data) = > {
    console.info("===================== >getApplicationInfoCallback=================== >");
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getBundleName7+

getBundleName(callback: AsyncCallback): void

獲取當前ability的捆綁包名稱（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getBundleName()

Context.getBundleName7+

getBundleName(): Promise

獲取當前ability的捆綁包名稱（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getBundleName().then((data) = > {
    console.info("======================= >getBundleNameCallback==================== >");
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getProcessInfo7+

getProcessInfo(callback: AsyncCallback): void

獲取有關當前進程的信息，包括進程ID和名稱（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getProcessInfo()

Context.getProcessInfo7+

getProcessInfo(): Promise

獲取有關當前進程的信息，包括進程id和名稱（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getProcessInfo().then((data) = > {
    console.info("======================= >getProcessInfoCallback==================== >");
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getElementName7+

getElementName(callback: AsyncCallback): void

獲取當前ability的ohos.bundle.ElementName對象（callback形式）。

此方法僅適用于頁面功能。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getElementName()

Context.getElementName7+

getElementName(): Promise

獲取當前能力的ohos.bundle.ElementName對象（Promise形式）。

此方法僅適用于頁面功能。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getElementName().then((data) = > {
    console.info("======================= >getElementNameCallback==================== >");
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getProcessName7+

getProcessName(callback: AsyncCallback): void

獲取當前進程的名稱（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getProcessName()

Context.getProcessName7+

getProcessName(): Promise

獲取當前進程的名稱（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getProcessName().then((data) = > {
    console.info("======================= >getProcessNameCallback==================== >");
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getCallingBundle7+

getCallingBundle(callback: AsyncCallback): void

獲取調用ability的包名稱（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getCallingBundle()

Context.getCallingBundle7+

getCallingBundle(): Promise

獲取調用ability的包名稱（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getCallingBundle().then((data) = > {
    console.info("====================== >getCallingBundleCallback==================== >");
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getCacheDir

getCacheDir(callback: AsyncCallback): void

獲取該應用程序的內部存儲目錄（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getCacheDir((err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
});

Context.getCacheDir

getCacheDir(): Promise

獲取該應用程序的內部存儲目錄（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getCacheDir().then((data) = > {
    console.info("====================== >getCacheDirPromsie==================== >");
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getFilesDir

getFilesDir(callback: AsyncCallback): void

獲取內部存儲器上此應用程序的文件目錄（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getFilesDir((err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
});

Context.getFilesDir

getFilesDir(): Promise

獲取內部存儲器上此應用程序的文件目錄（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getFilesDir().then((data) = > {
    console.info("====================== >getFilesDirPromsie==================== >");
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getOrCreateDistributedDir7+

getOrCreateDistributedDir(callback: AsyncCallback): void

獲取Ability或應用的分布式文件路徑。

如果分布式文件路徑不存在，系統將創建一個路徑并返回創建的路徑（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getOrCreateDistributedDir((err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
});

Context.getOrCreateDistributedDir7+

getOrCreateDistributedDir(): Promise

獲取Ability或應用的分布式文件路徑。

如果分布式文件路徑不存在，系統將創建一個路徑并返回創建的路徑（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getOrCreateDistributedDir().then((data) = > {
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getAppType7+

getAppType(callback: AsyncCallback): void

獲取此應用的類型（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getAppType((err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
});

Context.getAppType7+

getAppType(): Promise

獲取此應用的類型（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getAppType().then((data) = > {
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getHapModuleInfo7+

getHapModuleInfo(callback: AsyncCallback): void

獲取應用的ModuleInfo對象（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getHapModuleInfo((err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
});

Context.getHapModuleInfo7+

getHapModuleInfo(): Promise

獲取應用的ModuleInfo對象（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getHapModuleInfo().then((data) = > {
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getAppVersionInfo7+

getAppVersionInfo(callback: AsyncCallback): void

獲取應用的版本信息（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getAppVersionInfo((err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
});

Context.getAppVersionInfo7+

getAppVersionInfo(): Promise

獲取應用的版本信息（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getAppVersionInfo().then((data) = > {
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getAbilityInfo7+

getAbilityInfo(callback: AsyncCallback): void

查詢當前歸屬Ability詳細信息（callback形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getAbilityInfo((err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
});

Context.getAbilityInfo7+

getAbilityInfo(): Promise

查詢當前歸屬Ability詳細信息（Promise形式）。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext();
context.getAbilityInfo().then((data) = > {
    console.info("==== >data==== >" + JSON.stringify(data));
});

Context.getApplicationContext7+

getApplicationContext(): Context

獲取應用上下文信息。

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import featureAbility from '@ohos.ability.featureAbility'
var context = featureAbility.getContext().getApplicationContext();

PermissionOptions7+

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

PermissionRequestResult7+

系統能力 ：SystemCapability.Ability.AbilityRuntime.Core

HapModuleInfo7+

Hap模塊信息

AppVersionInfo7+

審核編輯 黃宇