MSBuild a parancssorban – C++

Általában azt javasoljuk, hogy a Visual Studióval állítsa be a projekt tulajdonságait, és hívja meg az MSBuild rendszert. Az MSBuild eszközt azonban közvetlenül a parancssorból is használhatja. A létrehozási folyamatot egy projektfájlban (.vcxproj) található információk vezérlik, amelyeket létrehozhat és szerkeszthet. A projektfájl a buildelési fázisok, a feltételek és az események alapján adja meg a buildelési beállításokat. Emellett nulla vagy több parancssori beállítás argumentumot is megadhat.

msbuild.exe [ project_file ] [ beállítások ]

A /target (vagy /t) és /property (vagy /p) parancssori beállításaival felülbírálhatja a projektfájlban megadott tulajdonságokat és célokat.

A projektfájl alapvető funkciója egy cél megadása, amely egy adott, a projektre alkalmazott művelet, valamint a művelet végrehajtásához szükséges bemenetek és kimenetek. A projektfájlok megadhatnak egy vagy több célhelyet, amelyek tartalmazhatnak egy alapértelmezett célt is.

Minden cél egy vagy több feladat sorozatából áll. Minden feladatot egy .NET-keretrendszerosztály jelöl, amely egy végrehajtható parancsot tartalmaz. A CL-feladat például tartalmazza a cl.exe parancsot.

A tevékenységparaméter az osztályfeladat tulajdonsága, és általában a végrehajtható parancs parancssori lehetőségét jelöli. A FavorSizeOrSpeed feladat CL paramétere például az /Os és az /Ot fordító beállításainak felel meg.

További feladatparaméterek támogatják az MSBuild infrastruktúrát. A tevékenységparaméter például olyan tevékenységek készletét adja meg, Sources amelyeket más tevékenységek is felhasználhatnak. Az MSBuild tevékenységről további információt a Tevékenységhivatkozás című témakörben talál.

A legtöbb feladat bemeneteket és kimeneteket igényel, például fájlneveket, elérési utakat és sztringeket, numerikus vagy logikai paramétereket. Gyakori bemenet például egy lefordítandó .cpp forrásfájl neve. Egy fontos bemeneti paraméter egy sztring, amely megadja a buildkonfigurációt és a platformot, például: "Hibakeresés|Win32". A bemeneteket és kimeneteket egy vagy több felhasználó által definiált XML-elem Item határozza meg egy ItemGroup elemben.

A projektfájl felhasználó által definiált tulajdonságokat és ItemDefinitionGroupelemeket is megadhat. A tulajdonságok és elemek név-érték párokat alkotnak, amelyek változóként használhatók a buildben. A pár névösszetevője egy makrót határoz meg, az értékösszetevő pedig deklarálja a makró értékét. A tulajdonságmakró $(name) jelöléssel érhető el, az elemmakró pedig %(név) jelöléssel érhető el.

A projektfájl más XML-elemei tesztelhetik a makrókat, majd feltételesen beállíthatják a makrók értékét, vagy szabályozhatják a build végrehajtását. A makrónevek és a literális sztringek összefűzhetők olyan szerkezetek létrehozásához, mint az elérési út és a fájlnév. A parancssorban a /property beállítás beállít vagy felülbírál egy projekttulajdonságot. Az elemekre nem lehet hivatkozni a parancssorban.

Az MSBuild rendszer feltételesen végrehajthat egy célt egy másik cél előtt vagy után. Emellett a rendszer létrehozhat egy célt attól függően, hogy a cél által használt fájlok újabbak-e, mint az általa kibocsátott fájlok.

Az MSBuild szolgáltatással kapcsolatos további információkért lásd:

• MSBuild Az MSBuild fogalmainak áttekintése.

• MSBuild-referencia Referenciaadatok az MSBuild rendszerről.

• Projektfájl sémahivatkozása Felsorolja az MSBuild XML-sémaelemeket az attribútumokkal együtt, valamint a szülő- és gyermekelemeket. Különösen figyelje meg az ItemGroup, a PropertyGroup, a Target és a Task elemeket.

• Command-Line referencia A msbuild.exehasználható parancssori argumentumokat és beállításokat ismerteti.

• Tevékenységhivatkozás Az MSBuild-feladatokat ismerteti. Különösen figyelje meg ezeket a tevékenységeket, amelyek a Microsoft C++-ra jellemzőek: BscMake-tevékenység, CL-tevékenység, CPPClean-tevékenység, LIB-tevékenység, csatolási tevékenység, MIDL-tevékenység, MT-tevékenység, RC-tevékenység, SetEnv-tevékenység, VCMessage-tevékenység

Ebben a részben

Időszak	Definíció
Útmutató: Az MSBuild használata C++ projekt létrehozásához	Bemutatja, hogyan hozhat létre Visual Studio C++ projektet az MSBuild használatával.
Útmutató: Buildesemények használata az MSBuild-projektekben	Bemutatja, hogyan adhat meg egy olyan műveletet, amely a build particuler szakaszában történik: a build megkezdése előtt; a hivatkozási lépés megkezdése előtt; vagy a build befejezése után.
Útmutató: Egyéni buildelési lépés hozzáadása az MSBuild-projektekhez	Bemutatja, hogyan adhat hozzá felhasználó által definiált szakaszt a buildelési sorozathoz.
Útmutató: Egyéni buildeszközök hozzáadása az MSBuild-projektekhez	Bemutatja, hogyan társíthat egy buildelési eszközt egy adott fájlhoz.
Útmutató: Egyéni eszközök integrálása a projekttulajdonságokba	Bemutatja, hogyan adhat hozzá beállításokat egy egyéni eszközhöz a projekt tulajdonságaihoz.
Útmutató: A Target Framework és a Platform Toolset módosítása	Bemutatja, hogyan fordíthat le egy projektet több keretrendszerhez vagy eszközkészlethez.

Lásd még

Az MSVC-eszközkészlet használata a parancssorból