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).logmakra . 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

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 programu Kdo le

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.

Viz také

Referenční dokumentace stránky vlastností projektu C++