Obecná stránka vlastností (projekt)
Tento článek se týká projektů sady Visual Studio pro Windows. V případě linuxových projektů naleznete odkaz na stránku vlastností jazyka C++ pro Linux. Projekty CMake najdete v tématu Projekty CMake v sadě Visual Studio. Projekty Androidu najdete v tématu Obecné vlastnosti projektu (Android C++). Projekty pravidel androidu naleznete v tématu Obecné vlastnosti projektu (Makefile android C++). V sadě Visual Studio 2019 se některé vlastnosti projektů bez UPW (prostředí Windows Runtime nebo Univerzální platforma Windows) přesunuly na stránku vlastností Upřesnit.
Pokud chcete otevřít dialogové okno Stránky vlastností projektu, vyberte projekt (ne řešení) v Průzkumník řešení. Potom v řádku nabídek vyberte nabídku Vlastnosti názvu projektu projektu>. Nebo klikněte pravým tlačítkem na uzel projektu v Průzkumník řešení a v místní nabídce vyberte Vlastnosti.
V dialogovém okně Stránky vlastností se na stránce vlastností Vlastnosti konfigurace>zobrazují vlastnosti projektu na základě typu projektu. Tyto vlastnosti se shromažďují pod jedním nebo dvěma nadpisy v závislosti na typu projektu:
OBECNÉ
Výchozí nastavení projektu
OBECNÉ
Nadpis Obecné obsahuje některé kombinace těchto vlastností:
Cílová platforma
Určuje platformu, na které projekt běží. Například Windows, Android nebo iOS. Hodnota Windows 10 znamená, že projekt cílí na Univerzální platforma Windows. Pokud cílíte na jiné verze Windows, verze není uvedená a hodnota v tomto poli se zobrazí jako windows. Tato vlastnost je pole jen pro čtení, které je nastavené při vytváření projektu.
Verze cílové platformy
Určuje verzi sady Windows SDK použitou k sestavení projektu. Tato vlastnost se zobrazí pouze v případě, že ho typ projektu podporuje. Můžete vybrat verzi 10.0 a zadat nejnovější verzi sady Windows SDK. Pokud vaše aplikace může využívat funkce v této verzi sady Windows SDK, ale může běžet i v dřívějších verzích bez těchto funkcí, například s určitou ztrátou funkčnosti, pak hodnota této vlastnosti a minimální cílové platformy. Vlastnost Verze se může lišit. Pokud ano, měl by váš kód zkontrolovat verzi platformy, na které běží za běhu, a zakázat funkce, které nejsou dostupné ve starších verzích platformy.
Cílová platforma Min. Verze
Určuje nejnižší verzi platformy, na které může projekt běžet. Tato vlastnost se zobrazí pouze v případě, že ho typ projektu podporuje. Tuto hodnotu nastavte, pokud vaše aplikace může využívat funkce v novější verzi sady Windows SDK, ale stále běží na starších verzích, třeba s určitou ztrátou funkčnosti. Pokud je nastavená nižší hodnota, měl by váš kód zkontrolovat verzi platformy, ve které běží za běhu. Potom zakažte funkce, které nejsou dostupné ve starších verzích platformy.
Systém projektů C++ tuto možnost nevynucuje. Je součástí konzistence s jinými jazyky, jako jsou C# a JavaScript, a jako vodítko pro každého, kdo váš projekt používá. Microsoft C++ nevygeneruje chybu, pokud použijete funkci, která není k dispozici v minimální verzi.
Verze sady Windows SDK
Pro cílovou platformu Windows tato vlastnost určuje verzi sady Windows SDK, kterou váš projekt vyžaduje. Když Instalační program pro Visual Studio nainstaluje úlohu C++, nainstaluje také požadované části sady Windows SDK. Pokud máte na počítači další verze sady Windows SDK, zobrazí se každá nainstalovaná verze v rozevíracím seznamu.
Pokud chcete cílit na Windows 7 nebo Windows Vista, použijte hodnotu 8.1, protože sada Windows SDK 8.1 je zpětně kompatibilní s těmito platformami. Pokud cílíte na starší verzi, definujte odpovídající hodnotu pro _WIN32_WINNT
hodnotu in targetver.h
. Pro Windows 7 je to 0x0601. Další informace naleznete v tématu Úpravy WINVER
a _WIN32_WINNT
.
Sadu nástrojů platformy Windows XP, která je součástí Instalační program pro Visual Studio, můžete nainstalovat jako volitelnou součást pro sestavování projektů systému Windows XP a Windows 2003 Server. Informace o získání a použití této sady nástrojů platformy naleznete v tématu Konfigurace programů pro systém Windows XP. Další informace o změně sady nástrojů platformy najdete v tématu Postupy: Úprava cílové architektury a sady nástrojů platformy.
Výstupní adresář
Určuje adresář, ve kterém nástroje sestavení, jako je linker, umístí všechny konečné výstupní soubory vytvořené během procesu sestavení. Tento adresář obvykle obsahuje výstup nástrojů, jako je linker, knihovník nebo BSCMake. Ve výchozím nastavení je tato vlastnost adresář určený kombinací $(SolutionDir)$(Configuration)\
makra .
Programový přístup k této vlastnosti naleznete v tématu OutputDirectory.
Zprostředkující adresář
Určuje adresář, ve kterém nástroje, jako je kompilátor, umístí všechny zprostředkující soubory vytvořené během procesu sestavení. Tento adresář obvykle obsahuje výstup nástrojů, jako je kompilátor C/C++, MIDL a kompilátor prostředků. Ve výchozím nastavení je tato vlastnost adresář určený makrem $(Configuration)\
.
Programový přístup k této vlastnosti naleznete v tématu IntermediateDirectory.
Cílový název
Určuje název souboru, který tento projekt vygeneruje. Ve výchozím nastavení je tato vlastnost název souboru určený makrem $(ProjectName)
.
Cílové rozšíření
Určuje příponu souboru, která tento projekt generuje, například .exe
nebo .dll
. U některých typů projektů sady Visual Studio 2019 se tato vlastnost přesunula na stránku vlastností Upřesnit.
Rozšíření k odstranění při čištění
Příkaz nabídky Sestavit>vyčištění odstraní soubory z zprostředkujícího adresáře, kde je vytvořena konfigurace projektu. Systém sestavení odstraní soubory, které mají zadaná rozšíření při spuštění příkazu Vyčistit nebo při opětovném sestavení. Systém sestavení také odstraní jakýkoli známý výstup sestavení bez ohledu na to, kde se nachází. Odstraněné soubory zahrnují všechny zprostředkující výstupy, jako .obj
jsou soubory. K oddělení rozšíření použijte středníky (;
). V rozšířeních můžete zadat zástupné znaky (*
, ?
).
Programový přístup k této vlastnosti naleznete v tématu DeleteExtensionsOnClean. U některých typů projektů sady Visual Studio 2019 se tato vlastnost přesunula na stránku vlastností Upřesnit.
Soubor protokolu sestavení
Umožňuje zadat jiné než výchozí umístění pro soubor protokolu, který se vytvoří při každém sestavení projektu. Výchozí umístění je určeno kombinací $(IntDir)$(MSBuildProjectName).log
makra . U některých typů projektů sady Visual Studio 2019 se tato vlastnost přesunula na stránku vlastností Upřesnit.
Umístění adresáře můžete změnit pomocí maker projektu. Další informace najdete v tématu Běžná makra pro příkazy a vlastnosti sestavení.
Sada nástrojů platformy
Určuje sadu nástrojů použitou k sestavení aktuální konfigurace. Tato vlastnost umožňuje projektu cílit na jinou verzi knihoven a kompilátoru Visual C++. Ve výchozím nastavení cílí projekty visual Studio C++ na nejnovější sadu nástrojů nainstalovanou sadou Visual Studio. Místo toho můžete zvolit některou sadu nástrojů nainstalovanou několika předchozími verzemi sady Visual Studio. Některé starší sady nástrojů mohou vytvářet spustitelné soubory, které běží v systému Windows XP nebo Vista. Další informace o tom, jak změnit sadu nástrojů platformy, naleznete v tématu Postupy: Úprava cílové architektury a sady nástrojů platformy.
Povolení spravovaného přírůstkového sestavení
U spravovaných projektů tato vlastnost umožňuje detekci externí viditelnosti při generování sestavení. Pokud není změna spravovaného projektu viditelná pro jiné projekty, závislé projekty se znovu nevybudují. Tato možnost může výrazně zlepšit časy sestavení v řešeních, která zahrnují spravované projekty. V projektech sady Visual Studio 2019 se tato vlastnost přesunula na stránku vlastností Upřesnit.
Typ konfigurace
Určuje výstup projektu a požadované nástroje. V projektech UPW se tato vlastnost zobrazí pod nadpisem Výchozí projekt. Existuje několik typů konfigurace, ze kterých si můžete vybrat v závislosti na typu projektu:
Aplikace (.exe)
Zobrazí sadu nástrojů linkeru: kompilátor C/C++, MIDL, kompilátor prostředků, linker, BSCMake, generátor proxy webových služeb XML, vlastní sestavení, prebuild, prelink a události postbuildu.
Dynamická knihovna (.dll)
Zobrazí sadu nástrojů linkeru, určuje možnost linkeru /DLL
a přidá _WINDLL
definici preprocesoru do příkazového řádku CL.
Makefile (Soubor pravidel)
Zobrazí sadu nástrojů souboru pravidel (NMake).
Statická knihovna (.lib)
Zobrazí sadu nástrojů knihovny. Je to stejné jako sada nástrojů linkeru, kromě toho, že nahrazuje linker knihovnou knihovníka a vynechá generátor proxy webových služeb XML.
Nástroj
Zobrazí sadu nástrojů nástroje (MIDL, vlastní sestavení, předbuild a události postbuildu).
Programový přístup k této vlastnosti naleznete v tématu ConfigurationType.
Standard jazyka C++
Určuje, který jazykový standard jazyka C++ se má použít. Výchozí hodnota je /std:c++14
. Určete /std:c++17
použití funkcí C++17, /std:c++20
použití funkcí C++20 a /std:c++latest
použití navrhovaných funkcí C++23 nebo jiných experimentálních funkcí. Další informace najdete v tématu /std
(Určení standardní verze jazyka).
Standard jazyka C
Určuje, který jazykový standard jazyka C se má použít. Výchozí hodnota je Starší verze MSVC, která implementuje C89, některé z C99 a rozšíření specifických pro Microsoft. Určete /std:c11
použití funkcí C11 a /std:c17
použití funkcí C17. Další informace najdete v tématu /std
(Určení standardní verze jazyka)
Výchozí nastavení projektu
Typ konfigurace
Určuje výstup projektu a požadované nástroje. V projektech UPW se tato vlastnost zobrazí pod nadpisem Výchozí projekt. Existuje několik typů konfigurace, ze kterých si můžete vybrat v závislosti na typu projektu:
Aplikace (.exe)
Zobrazí sadu nástrojů linkeru: kompilátor C/C++, MIDL, kompilátor prostředků, linker, BSCMake, generátor proxy webových služeb XML, vlastní sestavení, prebuild, prelink a události postbuildu.
Dynamická knihovna (.dll)
Zobrazí sadu nástrojů linkeru, určuje možnost linkeru /DLL
a přidá _WINDLL
definici preprocesoru do příkazového řádku CL.
Makefile (Soubor pravidel)
Zobrazí sadu nástrojů souboru pravidel (NMake).
Statická knihovna (.lib)
Zobrazí sadu nástrojů knihovny. Je to stejné jako sada nástrojů linkeru, kromě toho, že nahrazuje linker knihovnou knihovníka a vynechá generátor proxy webových služeb XML.
Nástroj
Zobrazí sadu nástrojů nástroje (MIDL, vlastní sestavení, předbuild a události postbuildu).
Programový přístup k této vlastnosti naleznete v tématu ConfigurationType.
Použití knihovny MFC
Určuje, zda projekt MFC staticky nebo dynamicky odkazuje na knihovnu MFC DLL. Projekty, které nejsou projekty MFC, vyberte Použít standardní knihovny Windows. V projektech sady Visual Studio 2019 se tato vlastnost přesunula na stránku vlastností Upřesnit.
Programový přístup k této vlastnosti naleznete v tématu useOfMfc.
Znaková sada
Určuje, zda má být nastaveno makro preprocesoru _UNICODE
_MBCS
. Tam, kde je to vhodné, má vliv také na vstupní bod linkeru. V projektech sady Visual Studio 2019 se tato vlastnost přesunula na stránku vlastností Upřesnit.
Programový přístup k této vlastnosti naleznete v tématu CharacterSet.
Podpora modulu CLR (Common Language Runtime)
Způsobí použití možnosti kompilátoru /clr
. V projektech sady Visual Studio 2019 se tato vlastnost přesunula na stránku vlastností Upřesnit.
Programový přístup k této vlastnosti naleznete v tématu ManagedExtensions.
Verze rozhraní .NET Target Framework
Ve spravovaných projektech určuje verzi rozhraní .NET Framework, která se má cílit. V projektech sady Visual Studio 2019 se tato vlastnost přesunula na stránku vlastností Upřesnit.
Optimalizace celého programu
Určuje možnost kompilátoru /GL
a /LTCG
možnost linkeru. Ve výchozím nastavení je tato vlastnost zakázaná pro konfigurace ladění a povolena pro konfigurace vydané verze. V projektech sady Visual Studio 2019 se tato vlastnost přesunula na stránku vlastností Upřesnit.
Podpora aplikací pro Windows Store
Určuje, jestli tento projekt podporuje aplikace prostředí Windows Runtime (Univerzální platforma Windows nebo UPW). Další informace najdete v tématu /ZW
(prostředí Windows Runtime Kompilace) a dokumentaci k UPW pro vývojáře windows.
Kompatibilní s desktopovou plochou Windows
Umožňuje výstup tohoto projektu prostředí Windows Runtime také podporovat desktopové aplikace. Tato vlastnost nastaví <DesktopCompatible>
hodnotu v souboru projektu. Vlastnost Kompatibilní s desktopovou verzí Windows je dostupná od sady Visual Studio 2019 verze 16.9.