Fordító- és buildtulajdonságok beállítása

A Visual Studio IDE-ben megtekintheti és szerkesztheti a projekt fordításához és létrehozásához szükséges tulajdonságokat. Ez az információ tartalmazza az alkalmazás nevét, bővítményét (például DLL, LIB, EXE), fordítói beállításokat, hivatkozási beállításokat, hibakereső beállításokat és egyéni buildelési lépéseket.

Ezeket a tulajdonságokat tulajdonságlapokkal tekintheti meg és módosíthatja. A tulajdonságlapok eléréséhez a főmenüben válassza a Project, majd a Tulajdonságok lehetőséget. Vagy a Megoldáskezelő kattintson a jobb gombbal a projektcsomópontra, és válassza a Tulajdonságok lehetőséget.

Alapértelmezett tulajdonságok

Projekt létrehozásakor a rendszer különböző tulajdonságok értékeit rendeli hozzá. Az alapértelmezett értékek némileg eltérnek a projekt típusától és az alkalmazásvarázslóban választott lehetőségektől függően. Az Active Template Library (ATL) projekt például rendelkezik a Microsoft Interface Definition Language (MIDL) fájlokkal kapcsolatos tulajdonságokkal, de ezek a tulajdonságok hiányoznak egy alapszintű konzolalkalmazásban. A Tulajdonságlapok ablak Speciális panelje az alapértelmezett tulajdonságokat jeleníti meg:

Képernyőkép a Visual Studio projekttulajdonságok párbeszédpaneljéről, amelyen a Speciális ablaktábla van kijelölve. Az olyan tulajdonságok, mint az MFC használata, a karakterkészlet és így tovább, kiemelve vannak.

Tulajdonságok alkalmazása konfigurációk és célplatformok létrehozásához

Egyes tulajdonságok, például az alkalmazás neve, az összes buildváltozatra és célplatformra érvényesek, legyen szó hibakeresésről vagy kiadási buildről. A legtöbb tulajdonság azonban konfigurációfüggő. A megfelelő kód létrehozásához a fordítónak ismernie kell a program által futtatott platformot és a használni kívánt fordítóbeállításokat. Ezért amikor beállít egy tulajdonságot, ügyeljen arra, hogy az új érték mely konfigurációra és platformra vonatkozzanak. Csak a Win32-buildek hibakeresésére kell alkalmazni, vagy az ARM64 hibakeresésére és az x64 hibakeresésére is? Az Optimalizálási tulajdonság például alapértelmezés szerint a Teljes sebesség (/O2) értékre van állítva egy kiadási konfigurációban, de a hibakeresési konfigurációban le van tiltva.

Mindig láthatja és módosíthatja azt a konfigurációt és platformot, amelyre egy tulajdonságértéknek vonatkoznia kell. Az alábbi ábrán a tulajdonságok lapjai láthatók, felül a konfigurációs és a platforminformációs vezérlőkkel. Ha itt állítja be az Optimalizálási tulajdonságot, az csak az x64-buildek hibakeresésére, az aktuálisan aktív konfigurációra vonatkozik, ahogy a piros nyilak is mutatják.

Képernyőkép a Visual Studio tulajdonságlapjai párbeszédpanelről.

Az alábbi ábra ugyanannak a projektnek a tulajdonságlapját mutatja, de a konfiguráció „Release” értékre van módosítva. Figyelje meg az Optimalizálási tulajdonság eltérő értékét. Ne feledje, hogy az aktív konfiguráció továbbra is Debug. Itt bármilyen konfigurációhoz megadhat tulajdonságokat; nem kell az aktívnak lennie.

Képernyőkép a Visual Studio projekt tulajdonságlapjai párbeszédpanelről. A Konfiguráció legördülő lista ki van választva, és Kiadásra van állítva. Az optimalizálási beállítás a Maximális sebesség/O2 értékre van állítva.

Célplatformok

A célplatform arra az eszközre és operációs rendszerre utal, amelyen a végrehajtható rendszer fut. Egy projektet több platformhoz is létrehozhat. A C++ projektekhez elérhető célplatformok a projekt típusától függenek. Ilyenek például a Win32, az x64, az ARM, az ARM64, az Android és az iOS. Az a x86-os célplatform, amelyet a Microsoft Configuration Managerben láthat, azonos a Win32 platformmal a natív C++-projektekben. A Win32 a 32 bites Windowst, az x64 pedig a 64 bites Windowst jelenti. A két platformról további információt a 32 bites alkalmazások futtatása című témakörben talál.

A Konfigurációkezelőben látható Any CPU célplatform érték nincs hatással a natív C++ projektekre. Ez csak a C++/CLI és más .NET-projekttípusok esetében releváns. További információt a (CLR-rendszerkép típusának megadása) című témakörben talál/CLRIMAGETYPE.

További információ a hibakeresési buildek tulajdonságainak beállításáról:

A C++ fordító és a linker beállításai

A C++ fordító és a linker beállításai a bal oldali panel C/C++ és Linker csomópontjai alatt találhatók a Konfiguráció tulajdonságai csoportban. Ezek a beállítások közvetlenül a fordító által kapott parancssori beállításokra fordítják le. Ha egy adott beállítás dokumentációját szeretné elolvasni, jelölje ki a beállítást a középső panelen, és nyomja le az F1 billentyűt. Vagy böngészhet a dokumentációban az MSVC-fordító beállításai és az MSVC-linker beállításai között.

A Tulajdonságlapok párbeszédpanelen csak az aktuális projekt szempontjából releváns tulajdonságlapok láthatók. Ha például a projekt nem rendelkezik fájllal .idl , a MIDL tulajdonságlap nem jelenik meg. Az egyes tulajdonságoldalak beállításairól további információt a Tulajdonságlapok (C++) című témakörben talál.

Könyvtár- és elérési-út-értékek

Az MSBuild támogatja a fordítási idő állandóinak használatát bizonyos sztringértékekhez, például könyvtárakhoz és elérési utakhoz, úgynevezett makrókhoz. A makrók hivatkozhatnak a Visual Studio vagy az MSBuild rendszer által meghatározott értékekre, vagy egy felhasználó által definiált értékre. A makrók így néznek ki: $(macro-name) vagy %(item-macro-name). A tulajdonságlapok elérhetővé teszik ezeket a makrókat, amelyekre a Tulajdonságszerkesztővel hivatkozhat és módosíthatja őket. Használjon makrókat a kézzel beállított értékek, például a címtár elérési útjai helyett. A makrók megkönnyítik a tulajdonságbeállítások megosztását a gépek és a Visual Studio verziói között. Azt is jobban biztosíthatja, hogy a projektbeállítások megfelelően vegyenek részt a tulajdonságöröklésben.

Az alábbi ábrán egy Visual Studio C++ projekt tulajdonságlapjai láthatók. A bal oldali panelen ki van jelölve a VC++ könyvtárakszabály , a jobb oldali panel pedig az adott szabályhoz társított tulajdonságokat sorolja fel. A tulajdonságértékek gyakran makrók, például $(VC_SourcePath):

Képernyőkép a Visual Studio tulajdonságlapjai párbeszédpanelről a különböző könyvtárakra vonatkozó szabályokhoz.

A Tulajdonságszerkesztővel megtekintheti az összes elérhető makró értékét.

Előre definiált makrók

  • Globális makrók
    A globális makrók a projektkonfiguráció összes elemére érvényesek. A globális makró szintaxisa $(name). A "$(VCInstallDir)" egy példa a globális makróra, amely a Visual Studio-telepítés gyökérkönyvtárát tárolja. A globális makró egy PropertyGroup-nek felel meg az MSBuild-ben.

  • Elemmakrók
    Az elemmakrók szintaxisa %(name). Egy fájl esetében az elemmakró csak az adott fájlra vonatkozik. Például használhatja a %(AdditionalIncludeDirectories) kifejezést olyan könyvtárak meghatározására, amelyek csak egy adott fájlra vonatkoznak. Az ilyen típusú elemmakró az MSBuild metaadatainak ItemGroup felel meg. Ha egy projektkonfiguráció kontextusában használják, az elemmakró egy adott típusú összes fájlra vonatkozik. A C/C++ preprocesszordefiníciók konfigurációs tulajdonsága például olyan elemmakrót %(PreprocessorDefinitions) vehet fel, amely a projekt összes .cpp fájlját érinti. Az ilyen típusú elemmakró az MSBuild metaadatainak ItemDefinitionGroup felel meg. További információ: Elemdefiníciók.

Felhasználó által definiált makrók

Hozzon létre felhasználó által definiált makrókat változóként a projekt buildjeiben. Létrehozhat például egy felhasználó által definiált makrót, amely értéket biztosít egy egyéni buildelési lépéshez vagy egy egyéni buildelési eszközhöz. A felhasználó által definiált makró egy név-érték pár. Egy projektfájlban használja a $(name) jelölést az érték eléréséhez.

A felhasználó által definiált makrók egy tulajdonságlapon találhatók. Ha a projekt még nem tartalmaz tulajdonságlapot, létrehozhat egyet a Visual Studio-projekt beállításainak megosztása vagy újrafelhasználása című témakörben leírt lépések végrehajtásával.

Felhasználó által definiált makró létrehozása

  1. Nyissa meg a Tulajdonságkezelő ablakot. A menüsávon válassza azEgyéb Windows>tulajdonságkezelő>. Nyissa meg egy tulajdonságlap helyi menüjét (a neve véget ér), majd válassza a .userTulajdonságok lehetőséget. Megnyílik a Tulajdonságlapok párbeszédpanel.

  2. A párbeszédpanel bal oldali ablaktábláján válassza a Felhasználói makrók lehetőséget. A jobb oldali panelen válassza a Makró hozzáadása gombot a Felhasználói makró hozzáadása párbeszédpanel megnyitásához.

  3. A párbeszédpanelen adja meg a makró nevét és értékét. Ha szeretné, válassza a Beállítás makró környezeti változóként a build környezetben jelölőnégyzetet.

Tulajdonságszerkesztő

A Tulajdonságszerkesztővel módosíthatja bizonyos sztringtulajdonságokat, és makrókat jelölhet ki értékként. A Tulajdonságszerkesztő eléréséhez válasszon ki egy tulajdonságot egy tulajdonságlapon, majd kattintson a jobbra található lefelé mutató nyílra. Ha a legördülő lista a <Szerkesztés> elemet tartalmazza, kiválaszthatja a tulajdonság Tulajdonságszerkesztőjének megjelenítéséhez.

Képernyőkép a Visual Studio projekttulajdonságok lapjáról a VC plusz könyvtárak esetében.

A Tulajdonságszerkesztőben válassza a Makrók gombot az elérhető makrók és azok aktuális értékeinek megtekintéséhez. Az alábbi ábra a További beillesztési könyvtárak tulajdonságszerkesztőjét mutatja, miután a Makrók gombot választották ki. Ha be van jelölve a Öröklés a szülőtől vagy a projekt alapértelmezett beállításaiból jelölőnégyzet, és új értéket ad hozzá, az hozzáfűződik a jelenleg örökölt értékekhez. Ha törli a jelölőnégyzet jelölését, az új érték felülírja az örökölt értékeket. A legtöbb esetben hagyja bejelölve a jelölőnégyzetet.

Képernyőkép a Tulajdonságszerkesztő párbeszédpanelről a Makrók gomb kiválasztása után.

Belefoglalási könyvtár hozzáadása az alapértelmezett könyvtárak készletéhez

Ha egy include könyvtárat ad hozzá egy projekthez, ne írja felül az összes alapértelmezett könyvtárat. Fűzze hozzá az új elérési utat, például C:\MyNewIncludeDir\, majd fűzze hozzá a makrót $(IncludePath) a tulajdonságértékhez.

Az összes ingatlan gyorsan átböngészhető és kereshető

A Minden beállítás tulajdonságlap (a Tulajdonságlapok párbeszédpanel >C/C++ csomópontja alatt) gyors módot kínál az aktuális környezetben elérhető tulajdonságok tallózására és keresésére. Speciális keresőmezővel és egyszerű szintaxissal segíti a találatok szűrését:

  • Nincs előtag: Csak a tulajdonságnevekben keressen (kis- és nagybetűket nem érzékelyítő részstring).

  • '/' vagy '-': Keresés csak fordítókapcsolókban (kis- és nagybetű érzékeny előtag).

  • v: Keresés csak értékekben (kis- és nagybetűt nem különböztet meg).

Környezeti változók beállítása buildekhez

Az MSVC fordító (cl.exe) felismer bizonyos környezeti változókat, különösen LIB, LIBPATH, PATHés INCLUDE. Amikor az IDE használatával készít, a VC++ könyvtárak tulajdonságlapján beállított tulajdonságok beállítják ezeket a környezeti változókat. Ha a(z) LIB, LIBPATH és INCLUDE értékek már be vannak állítva, például egy Fejlesztői parancssor által, a buildfolyamat lecseréli őket a megfelelő MSBuild-tulajdonságok értékeire. A buildelési folyamat a VC++ Directories Executable Directories tulajdonság értékét a(z) PATH elejére illeszti. Felhasználó által definiált környezeti változót úgy állíthat be, hogy létrehoz egy felhasználó által definiált makrót, majd bejelöli azt a jelölőnégyzetet, amely szerint a makró környezeti változóként van beállítva a buildkörnyezetben.

Környezeti változók beállítása hibakeresési munkamenethez

A projekt Tulajdonságlapok párbeszédpaneljének bal oldali ablaktábláján bontsa ki a Konfiguráció tulajdonságai elemet , majd válassza a Hibakeresés lehetőséget.

A jobb oldali panelen módosítsa a Környezet vagy a Környezet egyesítése projekt beállításait, majd kattintson az OK gombra.

Cikkek ebben a szakaszban

Lásd még

  • Last updated on