intel Begin met die oneAPI DPC ++/C++-samesteller

INLEIDING

Die Intel® oneAPI DPC++/C++-samesteller bied optimaliserings wat jou toepassings help om vinniger op Intel® 64-argitekture op Windows* en Linux* te werk, met ondersteuning vir die nuutste C-, C++- en SYCL-taalstandaarde. Hierdie samesteller produseer geoptimaliseerde kode wat aansienlik vinniger kan loop deur voordeel te trektage van die steeds toenemende kerntelling en vektorregisterwydte in Intel® Xeon®-verwerkers en versoenbare verwerkers. Die Intel®-samesteller sal jou help om toepassingswerkverrigting 'n hupstoot te gee deur voortreflike optimalisering en Enkelinstruksie Meervoudige Data (SIMD) vektorisering, integrasie met Intel® Prestasiebiblioteke, en deur gebruik te maak van die OpenMP* 5.0/5.1 parallelle programmeringsmodel.

Die Intel® oneAPI DPC++/C++-samesteller stel C++-gebaseerde SYCL*-bron saam files vir 'n wye reeks rekenaarversnellers.
Die Intel® oneAPI DPC++/C++-samesteller is deel van die Intel® oneAPI Toolkits.

Vind meer

Inhoudbeskrywing en skakels

Vrystellingsaantekeninge                                  Besoek die vrystellingnotas-bladsy vir bekende kwessies en die mees onlangse inligting. Intel® oneAPI-programmeergids    Verskaf besonderhede oor die Intel® oneAPI DPC++/C++-samesteller programmeringsmodel, insluitend besonderhede oor SYCL*- en OpenMP*-aflaai, programmering vir verskeie teikenversnellers, en inleidings tot die Intel® oneAPI-biblioteke. Intel® oneAPI DPC++/C++                Verken Intel® oneAPI DPC++/C++-samestellerkenmerke en -opstelling en Samesteller Ontwikkelaar Gids en          kry meer gedetailleerde inligting oor samesteller opsies, eienskappe, en Verwysing                                        meer. oneAPI-kode Samples                      Verken die nuutste oneAPI-kode samples. •               Intel® oneAPI Data Parallel C+      Vra vrae en vind antwoorde in die Intel® oneAPI Data Parallel C+ + Forum                                      + en Intel® C++ samestellerforums. •               Intel® C++ samestellerforum   Intel® oneAPI DPC++/C++                Verken tutoriale, opleidingsmateriaal en ander Intel® oneAPI Samesteller dokumentasie                  DPC++/C++ samesteller dokumentasie. SYCL Spesifikasie Weergawe 1.2.1       Die SYCL-spesifikasie verduidelik hoe SYCL OpenCL-toestelle integreer PDF                                                  met moderne C++. https://www.khronos.org/sycl/         'n verbyview van SYCL. Die GNU* C++-biblioteek – Gebruik         Die GNU* C++-biblioteekdokumentasie oor die gebruik van dubbele ABI. Dubbele ABI

Lae vir Yocto*-projek                  Voeg oneAPI-komponente by 'n Yocto-projekbou met behulp van die meta-intel lae.

Kennisgewings en vrywarings
Intel-tegnologieë kan moontlik geaktiveerde hardeware, sagteware of diens benodig.

• Geen produk of komponent kan absoluut veilig wees nie.
• Jou koste en resultate kan verskil.

© Intel Corporation. Intel, die Intel-logo en ander Intel-merke is handelsmerke van Intel Corporation of sy filiale. Ander name en handelsmerke kan as die eiendom van ander geëis word.

Geen lisensie (uitdruklik of geïmpliseer, deur estoppel of andersins) tot enige intellektuele eiendomsregte word deur hierdie dokument toegestaan ​​nie.
Die produkte wat beskryf word, kan ontwerpfoute of foute bevat wat bekend staan ​​as errata wat kan veroorsaak dat die produk van gepubliseerde spesifikasies afwyk. Huidige gekarakteriseerde errata is op aanvraag beskikbaar.

Intel verwerp alle uitdruklike en geïmpliseerde waarborge, insluitend sonder beperking, die geïmpliseerde waarborge van verhandelbaarheid, geskiktheid vir 'n spesifieke doel, en nie-skending, sowel as enige waarborg wat voortspruit uit die verloop van prestasie, verloop van transaksies of gebruik in handel.

Begin met Linux

Voor jy begin

Stel omgewingsveranderlikes
Voordat jy die samesteller kan gebruik, moet jy eers die omgewingsveranderlikes stel deur die omgewingskrip te verkry deur die inisialiseringshulpmiddel te gebruik. Dit inisialiseer al die gereedskap in een stap.

1. Bepaal jou installasie gids, :
   • a. As jou samesteller op die verstekligging deur 'n wortelgebruiker of sudo-gebruiker geïnstalleer is, sal die samesteller onder/opt/intel/oneapi geïnstalleer word. In hierdie geval, is /opt/intel/oneapi.
   • b. Vir nie-wortelgebruikers word u tuisgids onder intel/oneapi gebruik. In hierdie geval,
     sal $HOME/intel/oneapi wees.
   • c. Vir groep- of onderneminggebruikers het u administrateurspan moontlik die samestellers op 'n gedeelde netwerk geïnstalleer file stelsel. Gaan met jou plaaslike administrateur personeel vir die ligging van installasie
     ( ).
2. Kry die omgewingsinstellingskrip vir jou dop:
   • a. bash: bron /setvars.sh intel64
   • b. csh/tcsh: bron /setvars.csh intel64

Installeer GPU-bestuurders of inproppe (opsioneel)
Jy kan oneAPI-toepassings ontwikkel deur C++ en SYCL* te gebruik wat op Intel, AMD* of NVIDIA* GPU's sal loop. Om toepassings vir spesifieke GPU's te ontwikkel en te laat loop, moet jy eers die ooreenstemmende drywers of inproppe installeer:

• Om 'n Intel GPU te gebruik, installeer die nuutste Intel GPU-bestuurders.
• Om 'n AMD GPU te gebruik, installeer die oneAPI vir AMD GPU's-inprop.
• Om 'n NVIDIA GPU te gebruik, installeer die oneAPI vir NVIDIA GPU's-inprop.

Opsie 1: Gebruik die opdragreël
Die Intel® oneAPI DPC++/C++-samesteller bied verskeie drywers:

Roep die samesteller aan deur die volgende sintaksis te gebruik:
{samestellerbestuurder} [opsie] file1 [file2…]

Byvoorbeeldample:
icpx hallo-wêreld.cpp

Vir SYCL-samestelling, gebruik die -fsycl-opsie met die C++-bestuurder:
icpx -fsycl hallo-wêreld.cpp

LET WEL: Wanneer -fsycl gebruik word, word -fsycl-targets=spir64 aanvaar tensy die -fsycl-targets eksplisiet in die opdrag gestel is.
As jy 'n NVIDIA- of AMD-GPU teiken, verwys na die ooreenstemmende GPU-inprop begingids vir gedetailleerde samestellingsinstruksies:

• oneAPI vir NVIDIA GPU's Begingids
• oneAPI vir AMD GPU's Begingids

Opsie 2: Gebruik die Eclipse* CDT
Volg hierdie stappe om die samesteller van binne die Eclipse* CDT op te roep.

Installeer die Intel® Compiler Eclipse CDT-inprop.

1. Begin Eclipse
2. Kies Hulp > Installeer nuwe sagteware
3. Kies Voeg by om die Voeg webwerf-dialoog oop te maak
4. Kies Argief, blaai na die gids /samesteller/ /linux/ide_support, kies die .zip file wat begin met com.intel.dpcpp.compiler, kies dan OK
5. Kies die opsies wat met Intel begin, kies Volgende en volg dan die installasie-instruksies
6. As jy gevra word of jy Eclipse* wil herbegin, kies Ja

Bou 'n nuwe projek of maak 'n bestaande projek oop.

1. Maak bestaande projek oop of skep nuwe projek op Eclipse
2. Regskliek op Projek > Eienskappe > C/C++ Bou > Gereedskapskettingredigeerder
3. Kies Intel DPC++/C++-samesteller vanaf die regterpaneel

Stel bou-konfigurasies.

1. Maak bestaande projek op Eclipse oop
2. Regskliek op Projek > Eienskappe > C/C++ Bou > Instellings
3. Skep of bestuur boukonfigurasies in die regte paneel

Bou 'n program vanaf die opdraglyn
Gebruik die volgende stappe om jou samestellerinstallasie te toets en 'n program te bou.

1. Gebruik 'n teksredigeerder om 'n file genaamd hello-world.cpp met die volgende inhoud:
2. Stel hello-world.cpp saam:
   icpx hallo-wêreld.cpp -o hallo-wêreld
   Die -o opsie spesifiseer die file naam vir die gegenereerde uitset.
3. Nou het jy 'n uitvoerbare genaamd hello-world wat uitgevoer kan word en sal onmiddellik terugvoer gee:

Watter uitsette
U kan samestelling rig en beheer met samestelleropsies. Byvoorbeeldample, jy kan die voorwerp skep file en voer die finale binêre in twee stappe uit:

1. Stel hello-world.cpp saam:Die -c opsie verhoed koppeling by hierdie stap.
2. Gebruik die icpx-samesteller om die gevolglike toepassingsobjekkode te koppel en 'n uitvoerbare uit te voer:
   Die -o opsie spesifiseer die gegenereerde uitvoerbare file naam. Verwys na samestelleropsies vir besonderhede oor beskikbare opsies.

Kom aan die gang op Windows

Voor jy begin

Stel omgewingsveranderlikes
Die samesteller integreer in die volgende weergawes van Microsoft Visual Studio*:

• Visual Studio 2022
• Visual Studio 2019
• Visual Studio 2017

LET WEL Ondersteuning vir Microsoft Visual Studio 2017 word opgeskort vanaf die Intel® oneAPI 2022.1-vrystelling en sal in 'n toekomstige vrystelling verwyder word.

Vir volle funksionaliteit binne Visual Studio, insluitend ontfouting en ontwikkeling, word Visual Studio Community Edition of hoër vereis. Visual Studio Express Edition laat slegs opdragreëlbou toe. Vir alle weergawes moet Microsoft C++-ondersteuning gekies word as deel van die Visual Studio-installasie. Vir Visual Studio 2017 en later moet jy 'n pasgemaakte installasie gebruik om hierdie opsie te kies.
U hoef gewoonlik nie die omgewingsveranderlikes op Windows in te stel nie, aangesien die samesteller-opdragreëlvenster hierdie veranderlikes outomaties vir u stel. As jy die omgewingsveranderlikes moet stel, voer die omgewingskrip uit soos beskryf in die suite-spesifieke Kom aan die gang-dokumentasie.
Die verstek installasie gids ( ) is C:\Program Files (x86)\Intel\oneAPI.

Installeer GPU-bestuurders (opsioneel)
Om toepassings vir Intel GPU's te ontwikkel en te laat loop, moet jy eers die nuutste Intel GPU-drywers installeer.

Opsie 1: Gebruik die opdragreël in Microsoft Visual Studio

Die Intel® oneAPI DPC++/C++-samesteller bied verskeie drywers:

Roep die samesteller aan deur die volgende sintaksis te gebruik:

Om die samesteller met behulp van die opdragreël van binne Microsoft Visual Studio aan te roep, maak 'n opdragprompt oop en voer jou samestellingopdrag in. Byvoorbeeldample:

Vir SYCL-samestelling, gebruik die -fsycl-opsie met die C++-bestuurder:

LET WEL: Wanneer -fsycl gebruik word, word -fsycl-targets=spir64 aanvaar tensy die -fsycl-targets eksplisiet in die opdrag gestel is.

Opsie 2: Gebruik Microsoft Visual Studio
Projekondersteuning vir die Intel® DPC++/C++-samesteller in Microsoft Visual Studio
Nuwe Microsoft Visual Studio-projekte vir DPC++ word outomaties gekonfigureer om die Intel® oneAPI DPC++/C++-samesteller te gebruik.
Nuwe Microsoft Visual C++* (MSVC)-projekte moet met die hand gekonfigureer word om die Intel® oneAPI DPC++/C++-samesteller te gebruik.

LET WEL: NET-gebaseerde CLR C++-projektipes word nie deur die Intel® oneAPI DPC++/C++-samesteller ondersteun nie. Die spesifieke projektipes sal wissel na gelang van jou weergawe van Visual Studio, bvample: CLR Class Library, CLR Console App, of CLR Empty Project.

Gebruik die Intel® DPC++/C++-samesteller in Microsoft Visual Studio
Presiese stappe kan verskil na gelang van die weergawe van Microsoft Visual Studio wat gebruik word.

1. Skep 'n Microsoft Visual C++ (MSVC) projek of maak 'n bestaande projek oop.
2. In Solution Explorer, kies die projek(te) om met die Intel® oneAPI DPC++/C++-samesteller te bou.
3. Maak Projek > Eienskappe oop.
4. Brei die Konfigurasie-eienskappe-kategorie in die linkerpaneel uit en kies die Algemene eiendom-bladsy.
5. In die regter paneel verander die Platform Toolset na die samesteller wat jy wil gebruik:
   • Vir C++ met SYCL, kies Intel® oneAPI DPC++-samesteller.
   • Vir C/C++ is daar twee gereedskapstelle.
     Kies Intel C++-samesteller (bvample 2021) om icx aan te roep.
     Kies Intel C++-samesteller (bvample 19.2) om icl.
     Alternatiewelik kan jy 'n samestellerweergawe as die gereedskapstel vir alle ondersteunde platforms en konfigurasies van die geselekteerde projek(te) spesifiseer deur Projek > Intel-samesteller > Gebruik Intel oneAPI DPC++/C++-samesteller te kies.
6. Herbou, met óf Bou > Slegs projek > Herbou vir 'n enkele projek óf Bou > Herbou-oplossing vir 'n oplossing.

Kies samestellerweergawe
As jy veelvuldige weergawes van die Intel® oneAPI DPC++/C++-samesteller geïnstalleer het, kan jy kies watter weergawe jy wil hê in die samesteller-seleksie-dialoogkassie:

1. Kies 'n projek en gaan dan na Gereedskap > Opsies > Intel-samestellers en biblioteke > > Samestellers, waar waardes is C++ of DPC++.
2. Gebruik die keuselys Geselekteerde samesteller om die toepaslike weergawe van die samesteller te kies.
3. Kies OK.

Skakel terug na die Microsoft Visual Studio C++-samesteller
As jou projek die Intel® oneAPI DPC++/C++-samesteller gebruik, kan jy kies om terug te skakel na die Microsoft Visual C++-samesteller:

1. Kies jou projek in Microsoft Visual Studio.
2. Regskliek en kies Intel Compiler > Gebruik Visual C++ in die konteks kieslys.

Hierdie aksie werk die oplossing op file om die Microsoft Visual Studio C++ samesteller te gebruik. Alle konfigurasies van geaffekteerde projekte word outomaties skoongemaak, tensy jy Moenie projek(te) skoonmaak nie kies. As jy kies om nie projekte skoon te maak nie, sal jy opgedateerde projekte moet herbou om alle bron te verseker files word saamgestel met die nuwe samesteller.

Bou 'n program vanaf die opdraglyn
Gebruik die volgende stappe om jou samestellerinstallasie te toets en 'n program te bou.

1. Gebruik 'n teksredigeerder om 'n file genaamd hello-world.cpp met die volgende inhoud:
   #insluit int main() std::cout << "Hallo, wêreld!\n"; terugkeer 0;
2. Stel hello-world.cpp saam:
   icx hallo-wêreld.cpp
3. Nou het jy 'n uitvoerbare genaamd hello-world.exe wat uitgevoer kan word en sal onmiddellik terugvoer gee:
   hallo-wêreld.exe

Watter uitsette:
Hallo, wêreld!

U kan samestelling rig en beheer met samestelleropsies. Byvoorbeeldample, jy kan die voorwerp skep file en voer die finale binêre in twee stappe uit:

1.  Stel hello-world.cpp saam:
   icx hallo-wêreld.cpp /c /Fohello-wêreld.obj
   Die /c-opsie verhoed koppeling by hierdie stap en /Fo spesifiseer die naam vir die objek file.
2. Gebruik die icx-samesteller om die gevolglike toepassingsobjekkode te koppel en 'n uitvoerbare uit te voer:
   icx hello-world.obj /Fehello-world.exe
3. Die /Fe-opsie spesifiseer die gegenereerde uitvoerbare file naam. Verwys na samestelleropsies vir besonderhede oor beskikbare opsies.

Stel en voer Sampdie Kode

Veelvuldige kode samples word voorsien vir die Intel® oneAPI DPC++/C++-samesteller sodat jy samestellerkenmerke kan verken en jouself kan vergewis van hoe dit werk. Byvoorbeeldample:

Volgende stappe

• Gebruik die nuutste oneAPI-kode Samples en volg saam met die Intel® oneAPI Training Resources.
• Verken die Intel® oneAPI DPC++/C++-samesteller-ontwikkelaargids en verwysing oor die Intel®-ontwikkelaarsone.

Dokumente / Hulpbronne

intel Begin met die oneAPI DPC ++/C++-samesteller [pdf] Gebruikersgids Kom aan die gang met die oneAPI DPC C-samesteller, kom aan die gang met die, oneAPI DPC C-samesteller

Verwysings

• Gebruikershandleiding