Použití sady nástrojů Microsoft C++ z příkazového řádku

Aplikace jazyka C a C++ můžete vytvářet na příkazovém řádku pomocí nástrojů, které jsou součástí Visual Studio. Sada nástrojů kompilátoru Microsoft C++ (MSVC) je také ke stažení jako samostatný balíček. Pokud ho nechcete používat, Visual Studio integrované vývojové prostředí (IDE) nemusíte instalovat.

Stažení a instalace nástrojů

Jak používat nástroje příkazového řádku

Když zvolíte jednu z úloh C++ v Instalační program pro Visual Studio, nainstaluje se sada nástrojů Visual Studio platformy. Sada nástrojů platformy obsahuje všechny nástroje C a C++ pro konkrétní Visual Studio verzi. Mezi tyto nástroje patří kompilátory C/C++, linkery, assemblery a další nástroje sestavení a odpovídající knihovny. Všechny tyto nástroje můžete použít na příkazovém řádku. Používá je také interně integrované vývojové prostředí Visual Studio ideu. Pro sestavení kódu pro cíle x86, x64, ARM a ARM64 existují samostatné kompilátory a nástroje hostované pro x86 a x64. Každá sada nástrojů pro konkrétní hostitele a cílovou architekturu sestavení je uložená ve vlastním adresáři.

Aby nástroje fungovaly správně, vyžadují, aby bylo nastaveno několik specifických proměnných prostředí. Tyto proměnné slouží k přidání nástrojů do cesty a k nastavení souboru zahrnutí, souboru knihovny a umístění sady SDK. Aby bylo nastavení těchto proměnných prostředí snadné, instalační program během instalace vytvoří přizpůsobené soubory příkazů nebodávkové soubory. Spuštěním jednoho z těchto souborů příkazů můžete nastavit konkrétní hostitele a cílovou architekturu sestavení, Windows SDK a sadu nástrojů platformy. Pro usnadnění si instalační program také vytvoří zástupce ve vašem nabídka Start. Zástupci spustí okna příkazového řádku vývojáře pomocí těchto souborů příkazů pro konkrétní kombinace hostitele a cíle. Tyto klávesové zkratky zajišťují, že jsou všechny požadované proměnné prostředí nastavené a připravené k použití.

Požadované proměnné prostředí jsou specifické pro vaši instalaci a architekturu sestavení, kterou zvolíte. Mohou být také změněny aktualizacemi nebo upgrady produktů. Proto místo nastavování proměnných prostředí sami doporučujeme použít zástupce nebo soubor příkazu nainstalovaného příkazového řádku.

Nainstalované sady nástrojů, soubory příkazů a klávesové zkratky závisí na procesoru počítače a možnostech, které jste vybrali během instalace. Nástroje hostované v x86 a křížové nástroje, které sestaví kód x86 a x64, se vždy instaluje. Pokud máte 64bitovou verzi Windows, budou nainstalovány také nástroje hostované v x64 a nástroje, které sestaví kód x86 a x64. Pokud zvolíte volitelné nástroje C++ Universal Windows Platform, nainstaluje se také nástroje x86 a x64, které sestaví kód ARM a ARM64. Ostatní úlohy mohou tyto a další nástroje nainstalovat.

Cesta a proměnné prostředí pro sestavení příkazového řádku

Nástroje MSVC příkazového řádku používají proměnné prostředí , , , a a také jiné proměnné prostředí specifické pro nainstalované nástroje, platformy a PATHTMP sady INCLUDELIBLIBPATH SDK. I jednoduchá instalace Visual Studio nastavit dvacet nebo více proměnných prostředí. Hodnoty těchto proměnných prostředí jsou specifické pro vaši instalaci a vaši volbu konfigurace sestavení a mohou být změněny aktualizacemi nebo upgrady produktů. Proto důrazně doporučujeme k jejich nastavení použít zástupce příkazového řádku pro vývojáře nebo jeden z přizpůsobených souborů příkazů. Nedoporučujeme je nastavovat v prostředí Windows prostředí.

Pokud chcete zjistit, které proměnné prostředí nastavuje zástupce příkazového řádku pro vývojáře, můžete použít SET příkaz . Otevřete prosté okno příkazového řádku a zachyťte výstup SET příkazu pro směrný plán. Otevřete okno příkazového řádku vývojáře a zachyťte výstup SET příkazu pro porovnání. Rozdílový nástroj, jako je například nástroj integrovaný do integrovaného vývojového prostředí Visual Studio IDE, může být užitečný k porovnání proměnných prostředí a k zobrazení toho, co je nastavené příkazový řádek pro vývojáře. Informace o konkrétních proměnných prostředí používaných kompilátorem a linkerem najdete v tématu Proměnné prostředí CL.

Klávesové zkratky příkazového řádku pro vývojáře

Klávesové zkratky příkazového řádku se instaluje do složky Visual Studio verzi ve vašem Windows nabídka Start. Tady je seznam klávesových zkratek základního příkazového řádku a architektur sestavení, které podporují:

• Developer Command Prompt – Nastaví prostředí pro použití 32bitových nástrojů nativních pro x86 k sestavení 32bitového nativního kódu x86.
• x86 Native Tools Command Prompt – Nastaví prostředí pro použití 32bitových nástrojů nativních pro x86 k sestavení 32bitového nativního kódu x86.
• x64 Native Tools Command Prompt – Nastaví prostředí pro použití 64bitových nástrojů nativních pro x64 k sestavení 64bitového nativního kódu x64.
• x86_x64 Cross Tools Command Prompt – Nastaví prostředí pro použití 32bitových nástrojů nativních pro x86 k sestavení 64bitového nativního kódu x64.
• x64_x86 Cross Tools Command Prompt – Nastaví prostředí pro použití 64bitových nástrojů nativních pro x64 k sestavení 32bitového nativního kódu x86.

Otevření okna příkazového řádku vývojáře

1. Na ploše otevřete nabídku Windows Start a potom přejděte k vyhledání a otevření složky pro vaši verzi Visual Studio, například Visual Studio 2019.

2. Ve složce zvolte Developer Command Prompt pro vaši verzi Visual Studio. Tato zkratka spustí okno příkazového řádku vývojáře, které používá výchozí architekturu sestavení 32bitových nástrojů nativních pro x86 k sestavení 32bitového nativního kódu x86. Pokud dáváte přednost jiné než výchozí architektuře sestavení, zvolte jeden z nativních nebo křížových nástrojů příkazového řádku a určete hostitele a cílovou architekturu.

Pokud chcete ještě rychlejší způsob, jak otevřít příkazový řádek pro vývojáře, zadejte do vyhledávacího pole na ploše příkazový řádek pro vývojáře. Pak zvolte výsledek, který chcete.

Umístění souborů vývojářských příkazů

Pokud dáváte přednost nastavení prostředí sestavení v existujícím okně příkazového řádku, můžete použít jeden ze souborů příkazů vytvořených instalačním programem. Doporučujeme nastavit prostředí v novém okně příkazového řádku. Nedoporučujeme později přepínat prostředí ve stejném příkazovém okně.

Primární soubor příkazů příkazového řádku pro vývojáře VsDevCmd.bat je umístěný v podadresáři Common7\Tools. Pokud nejsou zadány žádné parametry, nastaví prostředí pro použití nástrojů x86-Native k sestavení 32 kódu x86.

Tyto soubory příkazů nastavují výchozí parametry a volají VsDevCmd.bat nastavení zadaného prostředí architektury sestavení. Typická instalace může zahrnovat tyto soubory příkazů:

Použití vývojářských nástrojů v existujícím příkazovém okně

Nejjednodušší způsob, jak zadat konkrétní architekturu sestavení v existujícím příkazovém okně, je použít vcvarsall.bat soubor. Použijte vcvarsall.bat k nastavení proměnných prostředí pro konfiguraci příkazového řádku pro nativní 32 nebo 64 bitovou kompilaci. Argumenty umožňují určit více kompilací procesorů x86, x64, ARM nebo ARM64. můžete cílit na Microsoft Store, Univerzální platforma Windows nebo Windows platformu desktopových platforem. můžete dokonce určit, které Windows SDK se mají použít, a vybrat verzi sady nástrojů platformy.

při použití bez argumentů vcvarsall.bat nakonfiguruje proměnné prostředí tak, aby používaly aktuální kompilátor x86-native pro 32 Windows cílových počítačů. Můžete přidat argumenty a nakonfigurovat prostředí tak, aby používalo některé z nativních nebo přesných nástrojů pro více kompilátorů. vcvarsall.bat Pokud zadáte konfiguraci, která není nainstalovaná, nebo není ve vašem počítači k dispozici, zobrazí se chybová zpráva.

vcvarsall syntaktick

vcvarsall.bat [architecture] [platform_type] [winsdk_version] [-vcvars_ver=vcversion] [spectre_mode]

architecture
Tento nepovinný argument určuje hostitelskou a cílovou architekturu, která se má použít. Pokud Architektura není zadaná, použije se výchozí prostředí sestavení. Jsou podporovány tyto argumenty:

platform_type
Tento volitelný argument umožňuje zadat store nebo uwp jako typ platformy. Ve výchozím nastavení je prostředí nastavené na sestavování desktopových nebo konzolových aplikací.

winsdk_version
volitelně určuje verzi Windows SDK, která se má použít. ve výchozím nastavení se používá nejnovější nainstalovaná Windows SDK. chcete-li určit Windows SDK verzi, můžete použít celé číslo Windows SDK 10.0.10240.0 , například, nebo zadat, 8.1 aby používal sadu SDK Windows 8.1.

vcversion
volitelně určuje Visual Studio sadu nástrojů kompilátoru, která se má použít. ve výchozím nastavení je prostředí nastaveno na použití aktuální sady nástrojů kompilátoru Visual Studio.

použijte -vcvars_ver = 14.0 k určení sady nástrojů kompilátoru Visual Studio 2015.

spectre_mode
Ponechte tento parametr na používání knihoven bez zmírňování Spectre. Použijte hodnotu spectre pro použití knihoven se zmírněními hrozeb Spectre.

Nastavení prostředí sestavení v existujícím okně příkazového řádku

1. na příkazovém řádku pomocí příkazu CD přejděte do instalačního adresáře Visual Studio. Pak znovu použijte disk CD pro změnu v podadresáři, který obsahuje soubory příkazů specifické pro konfiguraci. pro Visual Studio 2019 a Visual Studio 2017 použijte podadresář VC\Auxiliary\Build . pro Visual Studio 2015 použijte podadresář VC .

2. Zadejte příkaz pro preferované vývojové prostředí. pokud například chcete sestavit kód ARM pro UWP na 64 platformě pomocí nejnovější Windows SDK a Visual Studio sady nástrojů kompilátoru, použijte tento příkazový řádek:

   vcvarsall.bat amd64_arm uwp

Vytvoření vlastního zástupce příkazového řádku

Dávkové soubory specifické pro architekturu nastaví architecture parametr a volají vcvarsall.bat . Do těchto dávkových souborů můžete předat stejné možnosti jako do , nebo vcvarsall.bat můžete jednoduše volat vcvarsall.bat přímo. Pokud chcete zadat parametry pro zástupce vlastního příkazu, přidejte je na konec příkazu v dvojitých uvozovkách. Tady je například zástupce pro sestavení kódu ARM pro UPW na 64bitové platformě s použitím nejnovější Windows SDK. Pokud chcete použít starší verzi sady nástrojů kompilátoru, zadejte číslo verze. V zástupce použijte něco podobného jako tento příkaz:

Upravte cestu tak, aby odpovídala vašemu Visual Studio adresáři. Soubor vcvarsall.bat obsahuje další informace o konkrétních číslech verzí.

Nástroje příkazového řádku

Pokud chcete sestavit projekt C/C++ na příkazovém řádku, Visual Studio tyto nástroje příkazového řádku:

CL
Pomocí kompilátoru (cl.exe) můžete kompilovat soubory zdrojového kódu a propojovat je s aplikacemi, knihovnami a knihovnami DLL.

Link
Pomocí linkeru (link.exe) můžete zkompilované objektové soubory a knihovny propojit s aplikacemi a knihovnami DLL.

Při sestavování na příkazovém řádku není příkaz F1 k dispozici pro okamžitou nápovědu. Místo toho můžete k získání informací o upozorněních, chybách a zprávách použít vyhledávací modul. Můžete si také stáhnout a použít offline soubory nápovědy. Pokud chcete použít vyhledávání v docs.microsoft.com, zadejte svůj dotaz do vyhledávacího pole v horní části článku.

Nástroje pro správu projektů příkazového řádku

Ve výchozím nastavení používá Visual Studio IDE nativní systémy sestavení projektu založené na MSBuild. Můžete volat přímo MSBuild k sestavení projektů bez použití integrovaného vývojového prostředí. Příkaz můžete použít také devenv k použití Visual Studio k vytváření projektů a řešení. Visual Studio také systémy sestavení založené na CMake nebo NMake.

MSBuild
Pomocí MSBuild (msbuild.exe) a souboru projektu (.vcxproj) nakonfigurujte sestavení a vyvolání sady nástrojů bez načtení Visual Studio IDE. Je ekvivalentní spuštění projektu sestavení nebo příkazu Sestavit řešení v integrovaném vývojovém Visual Studio ideu. MSBuild integrovaného vývojového prostředí má při sestavování na příkazovém řádku výhody. Nemusíte instalovat úplné integrované vývojové prostředí (IDE) na všechny buildové servery a kanály buildu. Vyhnete se dodatečné režii integrovaného vývojového prostředí (IDE). MSBuild běží v kontejnerizovaných prostředích sestavení a podporuje binární protokolovací nástroj.

DEVENV
Pomocí funkce DEVENV (devenv.exe) v kombinaci s přepínačem příkazového řádku, jako je nebo , spusťte určité příkazy sestavení bez zobrazení /Build/Clean Visual Studio IDE.

CMake
CMake (cmake.exe) je open source nástroj pro různé platformy, který definuje procesy sestavení, které běží na více platformách. CMake může konfigurovat a řídit nativní nástroje sestavení pro podporované platformy, jako jsou MSBuild a Značka. Další informace o CMake najdete v dokumentaci ke CMake.

NMAKE
Pomocí nástroje NMAKE (nmake.exe) můžete sestavovat projekty C++ pomocí tradičního souboru pravidel.

V této části

Tyto články ukazují, jak vytvářet aplikace na příkazovém řádku, a popisují, jak přizpůsobit prostředí sestavení příkazového řádku. Některé ukazují, jak používat 64bitové sady nástrojů a cílí na platformy x86, x64, ARM a ARM64. Popisují také použití nástrojů pro sestavení příkazového řádku, které MSBuild a NMAKE.

Návod: Kompilace nativního programu C++ na příkazovém řádku
Poskytuje příklad, který ukazuje, jak vytvořit a zkompilovat program jazyka C++ na příkazovém řádku.

Návod: Kompilace programu C na příkazovém řádku
Popisuje, jak zkompilovat program napsaný v programovacím jazyce C.

Návod: Kompilace programu C++/CLI na příkazovém řádku
Popisuje, jak vytvořit a zkompilovat program C++/CLI, který používá .NET Framework.

Návod: Kompilace programu C++/CX na příkazovém řádku
Popisuje, jak vytvořit a zkompilovat program C++/CX, který používá Windows Runtime.

NMAKE – referenční zdroje
Obsahuje odkazy na články, které popisují nástroj Microsoft Program Maintenance Utility (NMAKE.EXE).

MSBuild na příkazovém řádku – C++
Obsahuje odkazy na články, které popisují použití msbuild.exe z příkazového řádku.

Související oddíly

/MD, /MT, /LD (použití knihovny run-time)
Popisuje způsob použití těchto možností kompilátoru pro použití knihovny pro ladění nebo vydání za běhu.

Možnosti kompilátoru C/C++
Obsahuje odkazy na články, které popisují možnosti kompilátoru C a C++ a CL.exe.

Možnosti linkeru MSVC
Obsahuje odkazy na články, které popisují možnosti linkeru a LINK.exe.

Další nástroje sestavení MSVC
Obsahuje odkazy na nástroje sestavení C/C++, které jsou součástí Visual Studio.

Viz také

Projekty a systémy sestavení