配置策略

配置策略提供按預先定義的定制配置層級獲取對應定制配置目錄和文件路徑的能力。

說明：

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

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

導入模塊

import configPolicy from '@ohos.configPolicy';

getOneCfgFile

getOneCfgFile(relPath: string, callback: AsyncCallback)

使用callback形式返回指定文件名的最高優(yōu)先級配置文件路徑。 例如，config.xml在設備中存在以下路徑（優(yōu)先級從低到高）：/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)先級配置文件路徑。

系統(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)先級從低到高，使用callback形式返回指定文件名所有的文件列表。例如，config.xml在設備中存在以下路徑（優(yōu)先級從低到高）：/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)先級從低到高，使用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形式返回配置層級目錄列表。

系統(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形式返回配置層級目錄列表。

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

返回值：

示例：

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

審核編輯 黃宇