配置策略

配置策略提供按預(yù)先定義的定制配置層級(jí)獲取對(duì)應(yīng)定制配置目錄和文件路徑的能力。

說(shuō)明：

本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

本模塊接口均為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

導(dǎo)入模塊

import configPolicy from '@ohos.configPolicy';

getOneCfgFile

getOneCfgFile(relPath: string, callback: AsyncCallback)

使用callback形式返回指定文件名的最高優(yōu)先級(jí)配置文件路徑。 例如，config.xml在設(shè)備中存在以下路徑（優(yōu)先級(jí)從低到高）：/system/etc/config.xml、/sys_pod/etc/config.xml，最終返回/sys_pod/etc/config.xml。

系統(tǒng)能力 ：SystemCapability.Customization.ConfigPolicy

參數(shù)：

示例：

configPolicy.getOneCfgFile('etc/config.xml', (error, value) = > {
    if (error == undefined) {
        console.log("value is " + value);
    } else {
        console.log("error occurs "+ error);
    }
});

getOneCfgFile

getOneCfgFile(relPath: string): Promise

使用Promise形式返回指定文件名的最高優(yōu)先級(jí)配置文件路徑。

系統(tǒng)能力 ：SystemCapability.Customization.ConfigPolicy

參數(shù)：

返回值：

示例：

configPolicy.getOneCfgFile('etc/config.xml').then(value = > {
    console.log("value is " + value);
}).catch(error = > {
    console.log("getOneCfgFile promise " + error);
});

getCfgFiles

getCfgFiles(relPath: string, callback: AsyncCallback>)

按優(yōu)先級(jí)從低到高，使用callback形式返回指定文件名所有的文件列表。例如，config.xml在設(shè)備中存在以下路徑（優(yōu)先級(jí)從低到高）：/system/etc/config.xml、 /sys_pod/etc/config.xml，最終返回/system/etc/config.xml, /sys_pod/etc/config.xml。

系統(tǒng)能力 ：SystemCapability.Customization.ConfigPolicy

參數(shù)：

示例：

configPolicy.getCfgFiles('etc/config.xml', (error, value) = > {
    if (error == undefined) {
        console.log("value is " + value);
    } else {
        console.log("error occurs "+ error);
    }
});

getCfgFiles

getCfgFiles(relPath: string): Promise>

按優(yōu)先級(jí)從低到高，使用Promise形式返回指定文件名所有的文件列表。

系統(tǒng)能力 ：SystemCapability.Customization.ConfigPolicy

參數(shù)：

返回值：

示例：

configPolicy.getCfgFiles('etc/config.xml').then(value = > {
    console.log("value is " + value);
}).catch(error = > {
    console.log("getCfgFiles promise " + error);
});

getCfgDirList

getCfgDirList(callback: AsyncCallback>)

使用callback形式返回配置層級(jí)目錄列表。

系統(tǒng)能力 ：SystemCapability.Customization.ConfigPolicy

參數(shù)：

示例：

configPolicy.getCfgDirList((error, value) = > {
    if (error == undefined) {
        console.log("value is " + value);
    } else {
        console.log("error occurs "+ error);
    }
});

getCfgDirList

getCfgDirList(): Promise>

使用Promise形式返回配置層級(jí)目錄列表。

系統(tǒng)能力 ：SystemCapability.Customization.ConfigPolicy

返回值：

示例：

configPolicy.getCfgDirList().then(value = > {
    console.log("value is " + value);
}).catch(error = > {
    console.log("getCfgDirList promise " + error);
});

審核編輯 黃宇