system_requirements()¶
可以使用 system_requirements()
方法调用系统包管理器在系统级别安装包。通常情况下,应该尽量减少这种操作,系统包不是建模的依赖项,但有时自动安装某些 Conan 包所需的系统包可能很方便。例如,当创建打包 opencv
库的配方时,我们可能会发现它在 Linux 上需要 gtk
库,但可能不希望为它们创建包,因为我们希望确保使用系统自带的库。我们的代码如下
from conan import ConanFile
from conan.tools.system.package_manager import Apt
class OpenCV(ConanFile):
name = "opencv"
version = "4.0"
def system_requirements(self):
apt = Apt(self)
apt.install(["libgtk-3-dev"], update=True, check=True)
有关不同系统包管理器内置帮助程序的完整参考,请阅读 tools.system.package_manager 文档。
收集系统需求¶
当 system_requirements()
使用某些内置的 package_manager
帮助程序时,可以收集有关已安装或所需系统需求的信息。如果我们有以下 conanfile.py
from conan import ConanFile
from conan.tools.system.package_manager import Apt
class MyPkg(ConanFile):
settings = "arch"
def system_requirements(self):
apt = Apt(self)
apt.install(["pkg1", "pkg2"])
可以使用以下命令显示已安装的系统包(使用默认的 tools.system.package_manager:mode
,将检查需求,但不会安装):
# Assuming apt is the default or using explicitly
# -c tools.system.package_manager:tool=apt-get
$ conan install . --format=json
"graph": {
"nodes": [
{
"ref": "",
"id": 0,
"settings": {
"arch": "x86_64"
},
"system_requires": {
"apt-get": {
"install": [
"pkg1",
"pkg2"
],
"missing": []
}
},
即使不安装二进制文件,也可以获得类似的结果,可以使用 report
或 report-installed
模式。 report
模式显示 install
包,这些包是需要安装的包,无论它们是否实际安装。 report
模式不会检查系统中是否存在这些包,因此甚至可以在其他操作系统上运行
$ conan graph info . -c tools.system.package_manager:mode=report --format=json
...
"system_requires": {
"apt-get": {
"install": [
"pkg1",
"pkg2"
]
}
}
另一方面, report-installed
模式将检查包是否已安装在系统中,但如果未找到则不会失败或引发任何错误
$ conan graph info . -c tools.system.package_manager:mode=report-installed --format=json
...
"system_requires": {
"apt-get": {
"install": [
"pkg1",
"pkg2"
],
"missing": [
"pkg1",
"pkg2"
]
}
}