ZPN项目 1：在CMake中配置使用Intel One API的注意事项

环境

• Intel One API 2023.2
• CMake 3.27.7
• Visual Studio 2022 Community (with C++ desktop)

样例

程序代码

#include <iostream>

int main()
{
    std::cout << "Hello, CMake!" << std::endl;
    std::cin.get();
    return 0;
}

MakeList

cmake_minimum_required(VERSION 3.23)

# Heroius: set() function should be called before project() to take effect, otherwise default compilers will be used.

# specify Intel oneAPI compiler
# Heroius: use '/' instead of '\\' in file paths to avoid incorrect mutiple letter escaping.
# Heroius: however these compiler flags seem only placeholders and not used at all.
set(CMAKE_C_COMPILER "C:/Program Files (x86)/Intel/oneAPI/compiler/latest/windows/bin/dpcpp.exe" CACHE STRING "" FORCE)
set(CMAKE_CXX_COMPILER "C:/Program Files (x86)/Intel/oneAPI/compiler/latest/windows/bin/dpcpp.exe" CACHE STRING "" FORCE)

# Heroius: the toolchain string determines used c++ compiler, but leaves c compiler unset.
set(CMAKE_GENERATOR_TOOLSET "Intel(R) oneAPI DPC++ Compiler 2023")

# Heroius: skip c compiler checking, since c compiler is just a mock.
set(CMAKE_C_COMPILER_WORKS TRUE)

# Set the project name and version
# Heroius: move project() instruction here to make flags take effect.
project(HelloCMake)

# look for Intel oneAPI CMake toolchain files
# Heroius: strange error occurs if c compiler checking is not skipped.
find_package(IntelSYCL REQUIRED)

# Add the executable
add_executable(HelloCMake HelloCMake.cpp)

# Heroius: there should be a way that can include sycl libs to generation path, so that the app can run itself.
# add_sycl_to_target(TARGET HelloCMake SOURCES HelloCMake.cpp)

set_target_properties(HelloCMake PROPERTIES
    RUNTIME_OUTPUT_DIRECTORY_DEBUG ${CMAKE_BINARY_DIR}/bin
    RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_BINARY_DIR}/bin
    # ... add other configurations if needed
)

# Set executable path
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)

Configure脚本

:: 设置 OPENCV_ROOT 环境变量
Set OPENCV_ROOT=C:\OpenCV\Build
:: 如果存在 Build，删除
if exist Build rd /S /Q Build 
:: 如果不存在 Build，创建
if not exist Build md Build

Call "C:\Program Files (x86)\Intel\oneAPI\setvars.bat" intel64 vs2022

:: 当前文件夹为 Source，子文件夹 .\Build 为构建目录
cmake -S . -B .\Build 

编译脚本

:: 进入构建目录
cd Build
:: 构建，项目文件在当前目录
cmake --build .
pause

运行脚本

@ECHO OFF

:: 加载ONEAPI环境，使得引用库在运行环境可见；将加载过程的输出重定向隐藏
Call "C:\Program Files (x86)\Intel\oneAPI\setvars.bat" intel64 vs2022 >NUL 2>&1

cd ./build/bin/

hellocmake.exe

注意事项

• 要使用Intel One API，需要CMake版本不低于3.23
• CMakeList中，在调用project()之前设置好编译器参数
• Intel One API 2023.2 未提供专用于C的编译器，因此须跳过CMake中的C编译器检查
• 实际确定编译器的是CMAKE_GENERATOR_TOOLSET变量，但是各编译器变量的设置也不能跳过
• CMakeList中的路径变量，使用反斜杠作为路径分隔符，以避免多次转义导致的错误
• 使用find_package(IntelSYCL REQUIRED)添加对Intel One API的引用
• 生成的程序需要在One API环境运行，因在生成目录中没有复制必要的库文件（此问题或有其他解决方案，欢迎留言指正）