Get Started on Windows*

Before You Begin

The compiler integrates into the following versions of Microsoft Visual Studio*:

Note

Support for Microsoft Visual Studio 2017 is deprecated as of the Intel® oneAPI 2022.1 release and will be removed in a future release.

For full functionality within Visual Studio, including debugging and development, Visual Studio Community Edition or higher is required. Visual Studio Express Edition allows only command-line builds. For all versions, Microsoft C++ support must be selected as part of the Visual Studio install. For Visual Studio 2017 and later, you must use a custom install to select this option.

You typically do not need to set the environment variables on Windows, as the compiler command-line window sets these variables for you automatically. If you need to set the environment variables, run the environment script as described in the suite-specific Get Started documentation.

The default installation directory (<install_dir>) is C:\Program Files (x86)\Intel\oneAPI.

Option 1: Use the Command Line in Microsoft Visual Studio

To invoke the compiler using the command line from within Microsoft Visual Studio, open a command prompt and invoke the compiler using this syntax:

C/C++

icx [options] file1 [file2...] [/link link_options]

SYCL

icx -fsycl [options] file1 [file2...] [/link link_options]

For example, the sample SYCL code provided in this guide is compiled with the following command:

icx -fsycl simple-sycl-app.cpp /Fesimple-sycl-app.exe

Note

When using -fsycl, -fsycl-targets=spir64 is assumed unless the -fsycl-targets is explicitly set in the command.

For more information about compiler drivers, visit Invoke the Compiler

Option 2: Use Microsoft Visual Studio

Project Support for the Intel® DPC++/C++ Compiler in Microsoft Visual Studio

New Microsoft Visual Studio projects for DPC++ are automatically configured to use the Intel® oneAPI DPC++/C++ Compiler.

New Microsoft Visual C++* (MSVC) projects must be manually configured to use the Intel® oneAPI DPC++/C++ Compiler.

Note

.NET-based CLR C++ project types are not supported by the Intel® oneAPI DPC++/C++ Compiler. The specific project types will vary depending on your version of Visual Studio, for example: CLR Class Library, CLR Console App, or CLR Empty Project.

Use the Intel® DPC++/C++ Compiler in Microsoft Visual Studio

Exact steps may vary depending on the version of Microsoft Visual Studio in use.

  1. Create a Microsoft Visual C++ (MSVC) project or open an existing project.
  2. In Solution Explorer, select the project(s) to build with the Intel® oneAPI DPC++/C++ Compiler.
  3. Open Project > Properties .
  4. In the left pane, expand the Configuration Properties category and select the General property page.
  5. In the right pane change the Platform Toolset to the compiler you want to use:
    • For C++ with SYCL, select Intel® oneAPI DPC++ Compiler to invoke dpcpp-cl.
    • For C/C++, there are two toolsets.

      Select Intel C++ Compiler <major version> (example 2021) to invoke icx.

      Select Intel C++ Compiler <major.minor> (example 19.2) to invoke icl.

      Alternatively, you can specify a compiler version as the toolset for all supported platforms and configurations of the selected project(s) by selecting Project > Intel Compiler > Use Intel oneAPI DPC++/C++ Compiler.

  6. Rebuild, using either Build > Project only > Rebuild for a single project or Build > Rebuild Solution for a solution.

Select Compiler Version

If you have multiple versions of the Intel® oneAPI DPC++/C++ Compiler installed, you can select which version you want from the Compiler Selection dialog box:

  1. Select a project, then go to Tools > Options > Intel Compilers and Libraries > <compiler> > Compilers, where <compiler> values are C++ or DPC++.
  2. Use the Selected Compiler drop-down menu to select the appropriate version of the compiler.
  3. Select OK.

Switch Back to the Microsoft Visual Studio C++ Compiler

If your project is using the Intel® oneAPI DPC++/C++ Compiler, you can choose to switch back to the Microsoft Visual C++ compiler:

  1. Select your project in Microsoft Visual Studio.
  2. Right-click and select Intel Compiler > Use Visual C++ from the context menu.

This action updates the solution file to use the Microsoft Visual Studio C++ compiler. All configurations of affected projects are automatically cleaned unless you select Do not clean project(s). If you choose not to clean projects, you will need to rebuild updated projects to ensure all source files are compiled with the new compiler.

Build a Program From the Command Line

Follow the steps in Compile and Execute Sample SYCL Code to test your compiler installation.