Config API

警告

此功能是实验性的，可能会发生重大更改。有关更多信息，请参阅 Conan 稳定性 部分。

警告

子 API 不应自行初始化。它们旨在仅通过主 ConanAPI 属性访问。

class ConfigAPI(conan_api, helpers)

此 API 提供管理 Conan 主文件夹中 Conan 配置的方法。它允许从各种来源安装配置，检索全局配置值，以及列出可用的配置。它还提供清理 Conan 主文件夹的方法，将其重置为干净状态。

home()

返回包含配置文件的当前 Conan 主文件夹，例如远程仓库、设置、配置文件和软件包缓存。它仅用于调试目的。请记住，不允许写入、修改或删除软件包缓存中的软件包，并且为了自动化使用缓存中的软件包的任务，Conan 提供了部署器或自定义命令等机制。

install(path_or_url, verify_ssl, config_type=None, args=None, source_folder=None, target_folder=None)

从 git 仓库、http 服务器中的 zip 文件或本地文件夹安装 Conan 配置

fetch_packages(refs, lockfile=None, remotes=None, profile=None)

安装存储在 Conan 包内的配置。配置的安装将重新初始化整个 ConanAPI

get(name, default=None, check_type=None)

获取 global.conf 项目的值

show(pattern) → dict

获取 global.conf 中与模式匹配的配置的值

static conf_list()

列出所有可用的内置配置

clean()

将 Conan 主文件夹重置为干净状态，删除所有用户自定义配置、自定义文件，并重置已修改的文件

property settings_yml

获取 settings.yml 和 user_settings.yml 文件的内容，这些文件定义了设置的可能值。

请注意，这与 conanfile 中的设置不同，后者代表特定软件包的实际值，而此属性代表每个设置的可能值。

返回:

一个只读对象，表示设置方案，具有一个 possible_values() 方法，该方法返回一个包含每个设置的可能值的字典，以及一个 fields 属性，该属性返回一个有序列表，其中包含每个设置的字段。请注意，可以使用属性访问来访问嵌套设置，例如 settings_yml.compiler.possible_values()。