conan.tools.intel¶
IntelCC¶
此工具可帮助您在 Conan 中管理新的 Intel oneAPI DPC++/C++ 和 Classic 生态系统。
警告
此生成器为**实验性**功能,可能会有重大更改。
警告
Intel oneAPI DPC++/C++ (icx/icpx 或 dpcpp) 编译器不支持 macOS。对于 macOS 或 Xcode 支持,您需要使用 Intel C++ Classic 编译器。
注意
请记住,您需要事先安装 Intel oneAPI 软件。
此生成器会创建 conanintelsetvars.sh|bat
文件,该文件封装了 Intel 脚本 setvars.sh|bat
,用于设置所需的 Intel oneAPI 环境变量。该脚本是开始使用 Intel 编译器的第一步,因为它会在您的本地环境中设置一些重要变量。
总而言之,IntelCC
生成器
读取您的配置
[settings]
和[conf]
。利用这些信息生成一个
conanintelsetvars.sh|bat
脚本,其中包含加载 Intelsetvars.sh|bat
脚本的命令。然后,您或所选的生成器将能够运行该脚本并使用任何 Intel 编译器编译项目。
注意
在调用 Intel 编译器构建项目之前,您可以运行 conanintelsetvars.sh|bat
。当使用 self.run
运行任何命令时,Conan 也将在 conanfile 的 build(self)
方法中调用它。
首先,请确保您正在使用以下*配置文件*
[settings]
...
compiler=intel-cc
compiler.mode=dpcpp
compiler.version=2021.3
compiler.libcxx=libstdc++
build_type=Release
[buildenv]
CC=dpcpp
CXX=dpcpp
[conf]
tools.intel:installation_path=/opt/intel/oneapi
IntelCC
生成器可以在 conanfile 中按名称使用
class Pkg(ConanFile):
generators = "IntelCC"
[generators]
IntelCC
它也可以在 conanfile 的 generate()
方法中完全实例化
from conan import ConanFile
from conan.tools.intel import IntelCC
class App(ConanFile):
settings = "os", "arch", "compiler", "build_type"
def generate(self):
intelcc = IntelCC(self)
intelcc.generate()
现在,运行命令 conan install . -pr intelprofile 将生成 conanintelsetvars.sh|bat
脚本,该脚本将运行 Intel *setvars* 脚本并将所有变量加载到您的本地环境中。
自定义配置¶
只需更改 [conf]
条目,即可应用不同的安装路径和命令参数。例如
[settings]
...
compiler=intel-cc
compiler.mode=dpcpp
compiler.version=2021.3
compiler.libcxx=libstdc++
build_type=Release
[buildenv]
CC=dpcpp
CXX=dpcpp
[conf]
tools.intel:installation_path=/opt/intel/oneapi
tools.intel:setvars_args=--config="full/path/to/your/config.txt" --force
再次运行 conan install . -pr intelprofile,然后 conanintelsetvars.sh
脚本(如果我们使用 Linux 操作系统)将包含类似以下内容:
. "/opt/intel/oneapi/setvars.sh" --config="full/path/to/your/config.txt" --force
参考¶
- class IntelCC(conanfile)¶
管理 Intel oneAPI DPC++/C++/Classic 编译器变量生成的类
- arch¶
arch 设置
- property ms_toolset¶
根据所选模式获取 Microsoft Visual Studio 工具集
- generate(scope='build')¶
默认生成要在构建环境中加载的 Conan Intel 文件
- property installation_path¶
获取 Intel oneAPI 安装根路径
- property command¶
Intel oneAPI DPC++/C++ 编译器包含用于配置您的构建和开发环境变量的环境配置脚本
在 Linux 上,该文件是一个名为 setvars.sh 的 shell 脚本。
在 Windows 上,该文件是一个名为 setvars.bat 的批处理文件。
Linux ->
>> . /<install-dir>/setvars.sh <arg1> <arg2> … <argn><arg1> <arg2> … <argn>
编译器环境脚本文件接受一个可选的目标架构参数 <arg>: - intel64: 为基于 Intel 64 架构的目标生成代码并使用库。 - ia32: 为基于 IA-32 架构的目标生成代码并使用库。Windows ->
>> call <install-dir>\setvars.bat [<arg1>] [<arg2>]
其中 <arg1> 是可选的,可以是以下之一: - intel64: 为 Intel 64 架构(主机和目标)生成代码并使用库。 - ia32: 为 IA-32 架构(主机和目标)生成代码并使用库。对于 dpcpp 编译器,<arg1> 默认为 intel64。
<arg2> 是可选的。如果指定,它是以下之一: - vs2019: Microsoft Visual Studio* 2019 - vs2017: Microsoft Visual Studio 2017
- 返回:
str 要运行的 setvars.sh|bat 命令
conf¶
IntelCC
使用这些 配置条目
tools.intel:installation_path
: **(必填)** 用于告知 Conan 安装路径的参数,如果未定义,Conan 将尝试自动查找。tools.intel:setvars_args
: **(可选)** 用于将我们想要的任何内容作为参数传递给 setvars.sh|bat 文件。您可以从 Intel 官方文档中查看所有可能的参数。