Context模塊

Context模塊提供了ability或application的上下文的能力，包括允許訪問(wèn)特定于應(yīng)用程序的資源、請(qǐng)求和驗(yàn)證權(quán)限等。

說(shuō)明：

本模塊首批接口從API version 6開(kāi)始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。
本模塊接口僅可在FA模型下使用。

使用說(shuō)明

Context對(duì)象是在featureAbility中創(chuàng)建實(shí)例，并通過(guò)featureAbility的getContext()接口返回，因此在使用Context時(shí)，必須導(dǎo)入@ohos.ability.featureAbility庫(kù)。示例如下：

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

開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

Context.getOrCreateLocalDir7+

getOrCreateLocalDir(callback: AsyncCallback): void

獲取應(yīng)用程序的本地根目錄（callback形式）。

如果是第一次調(diào)用，將創(chuàng)建目錄。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

Context.getOrCreateLocalDir7+

getOrCreateLocalDir(): Promise

獲取應(yīng)用程序的本地根目錄（Promise形式）。

如果是第一次調(diào)用，將創(chuàng)建目錄。

系統(tǒng)能力 ：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

驗(yàn)證系統(tǒng)中運(yùn)行的特定pid和uid是否允許指定的權(quán)限（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

驗(yàn)證系統(tǒng)中運(yùn)行的當(dāng)前pid和uid是否具有指定的權(quán)限（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

Context.verifyPermission7+

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

驗(yàn)證系統(tǒng)中運(yùn)行的特定pid和uid是否具有指定的權(quán)限（Promise形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

返回值：

示例：

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

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

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

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

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

Context.getApplicationInfo7+

getApplicationInfo(): Promise

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

系統(tǒng)能力 ：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

獲取當(dāng)前ability的捆綁包名稱(chēng)（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

Context.getBundleName7+

getBundleName(): Promise

獲取當(dāng)前ability的捆綁包名稱(chēng)（Promise形式）。

系統(tǒng)能力 ：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

獲取有關(guān)當(dāng)前進(jìn)程的信息，包括進(jìn)程ID和名稱(chēng)（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

Context.getProcessInfo7+

getProcessInfo(): Promise

獲取有關(guān)當(dāng)前進(jìn)程的信息，包括進(jìn)程id和名稱(chēng)（Promise形式）。

系統(tǒng)能力 ：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

獲取當(dāng)前ability的ohos.bundle.ElementName對(duì)象（callback形式）。

此方法僅適用于頁(yè)面功能。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

Context.getElementName7+

getElementName(): Promise

獲取當(dāng)前能力的ohos.bundle.ElementName對(duì)象（Promise形式）。

此方法僅適用于頁(yè)面功能。

系統(tǒng)能力 ：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

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

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

Context.getProcessName7+

getProcessName(): Promise

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

系統(tǒng)能力 ：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

獲取調(diào)用ability的包名稱(chēng)（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

Context.getCallingBundle7+

getCallingBundle(): Promise

獲取調(diào)用ability的包名稱(chēng)（Promise形式）。

系統(tǒng)能力 ：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

獲取該應(yīng)用程序的內(nèi)部存儲(chǔ)目錄（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

獲取該應(yīng)用程序的內(nèi)部存儲(chǔ)目錄（Promise形式）。

系統(tǒng)能力 ：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

獲取內(nèi)部存儲(chǔ)器上此應(yīng)用程序的文件目錄（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

獲取內(nèi)部存儲(chǔ)器上此應(yīng)用程序的文件目錄（Promise形式）。

系統(tǒng)能力 ：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或應(yīng)用的分布式文件路徑。

如果分布式文件路徑不存在，系統(tǒng)將創(chuàng)建一個(gè)路徑并返回創(chuàng)建的路徑（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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或應(yīng)用的分布式文件路徑。

如果分布式文件路徑不存在，系統(tǒng)將創(chuàng)建一個(gè)路徑并返回創(chuàng)建的路徑（Promise形式）。

系統(tǒng)能力 ：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

獲取此應(yīng)用的類(lèi)型（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

獲取此應(yīng)用的類(lèi)型（Promise形式）。

系統(tǒng)能力 ：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

獲取應(yīng)用的ModuleInfo對(duì)象（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

獲取應(yīng)用的ModuleInfo對(duì)象（Promise形式）。

系統(tǒng)能力 ：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

獲取應(yīng)用的版本信息（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

獲取應(yīng)用的版本信息（Promise形式）。

系統(tǒng)能力 ：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

查詢當(dāng)前歸屬Ability詳細(xì)信息（callback形式）。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

查詢當(dāng)前歸屬Ability詳細(xì)信息（Promise形式）。

系統(tǒng)能力 ：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

獲取應(yīng)用上下文信息。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

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

PermissionOptions7+

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

PermissionRequestResult7+

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

HapModuleInfo7+

Hap模塊信息

AppVersionInfo7+

審核編輯 黃宇