TraceWPP task

A Windows Illesztőprogram-készlet (WDK) biztosítja a TraceWPP-feladatot, így futtathatja a tracewpp.exe eszközt, amikor az illesztőprogramot msBuild használatával hozza létre. A tracewpp.exe eszköz a WPP szoftverkövetés implementálására szolgál.

A WppEnabled egy új metaadat a ClCompile elemhez, amely lehetővé teszi a forrásfájlok nyomkövetését. The Wpp task runs through the entire ClCompile Item Collections and invokes tracewpp.exe for each Item for which the WppEnabled metadata is set to TRUE.

A WppEnabled metaadatait a rendszer hozzáadta a ClCompile elemhez, mert a WPP-feladat a CL-feladathoz hasonló típusú bemeneti fájlokon fut, ebben az esetben .c, .cpp és .h fájlokon.

Note You access the Item metadata for tracewpp by using the ClCompile item in project files. Az MSBuild a célon belül a TraceWpp elemet használja a feladatnak való átadáshoz.

Az alábbi példa bemutatja, hogyan szerkesztheti a metaadatokat a .vcxproj fájlban.

<ItemGroup>
    <ClCompile Include="a.c" />
      <WppEnabled>false</WppEnabled>
    <ClCompile Include="b.c">
        <WppEnabled>true</WppEnabled>
        <WppKernelMode>true</WppKernelMode>
        <WppAdditionalIncludeDirectories>c:\test\</WppAdditionalIncludeDirectories>
    </ClCompile>
    <ClCompile Include="test1.c" />
    <ClCompile Include="test2.c">
        <WppEnabled>true</WppEnabled>
        <WppDllMacro>true</WppDllMacro>
    </ClCompile>
</ItemGroup>

A parancssori meghívás a következő:

tracewpp.exe  km /Ic:\test\b.c
tracewpp.exe  dll test2.c

The example above shows that MSBuild invokes tracewpp.exe only on b.c and test2.c because the WppEnabled metadata is set to TRUE for these inputs. Azt is vegye figyelembe, hogy a két bemenet metaadatai eltérőek. Ezért a kapcsolók ezeknél a bemeneteknél is eltérőek lesznek. Más szóval minden bemenetet meghívhat saját metaadatokkal.

WPP-tevékenységparaméter	Item Metadata	Tool Switch
Sources Kötelező ITaskItem[] paraméter. A forrásfájlok listáját adja meg.	@(TraceWpp)
AddAlternateNameToMessageGUID Nem kötelező sztringparaméter. Alternatív rövid nevet ad meg az üzenet GUID azonosítójához a nyomkövetési szolgáltatótól érkező üzenetekhez.	%(TraceWpp.WppAddAlternateNameToMessageGUID)	-o:String
AdditionalConfigurationFile Nem kötelező sztringparaméter. Egy további konfigurációs fájlt ad meg. A WPP az alapértelmezett fájlon kívül a megadott fájlt is használja, defaultwpp.ini.	%(TraceWpp.WppAdditionalConfigurationFile)	-ini:Path
AdditionalIncludeDirectories Nem kötelező sztring[] paraméter. Hozzáad egy könyvtárat azoknak a könyvtáraknak a listájához, amelyeket a WPP a belefoglaló fájlokra keres.	%(TraceWpp.WppAdditionalIncludeDirectories)	-I
AlternateConfigurationFile Nem kötelező sztringparaméter. Egy alternatív konfigurációs fájlt ad meg. A WPP ezt a fájlt használja a defaultwpp.ini fájl helyett.	%(TraceWpp.WppAlternateConfigurationFile)	-defwpp:Path
GenerateUsingTemplateFile Nem kötelező sztringparaméter. Minden olyan forrásfájl esetében, amelyet a WPP a zárójelek {}között megadott névvel dolgoz fel, a WPP létrehoz egy másik fájlt a megadott fájlnévkiterjesztéssel.	%(TraceWpp.WppGenerateUsingTemplateFile)	-gen{File.tpl}*.ext
MinimalRebuildFromTracking Nem kötelező logikai paraméter. If the value is TRUE, WPP performs a tracked incremental build. Ellenkező esetben a WPP újraépítést hajt végre.	%(TraceWpp.WppMinimalRebuildFromTracking)
NumericBaseForFormatStrings Nem kötelező int paraméter. Numerikus alapot hoz létre a formátumsztringek számozásához.	%(TraceWpp.WppNumericBaseForFormatStrings)	-argbase:Number
AddControlGUID Nem kötelező sztringparaméter. Definiál egy WPP_CONTROL_GUIDS makrót a megadott vezérlő GUID azonosítójával, és WPP_DEFINE_BIT "Hiba", "Szokatlan" és "Zaj" nevű bejegyzéseket.	%(TraceWpp.WppAddControlGUID)	-ctl:GUID
AdditionalOptions Nem kötelező sztringparaméter. A parancssori lehetőségek listája.	%(TraceWpp.WppAdditionalOptions)
ConfigurationDirectories Nem kötelező sztring[] paraméter. Megadja a konfigurációs és sablonfájlok helyét.	%(TraceWpp.WppConfigurationDirectories)	-cfgdir:[Path]
DllMacro Nem kötelező logikai paraméter. Meghatározza a WPP_DLL makrót.	%(TraceWpp.WppDllMacro)	-dll
FileExtensions Nem kötelező sztring[] paraméter. Megadja azokat a fájltípusokat, amelyeket a WPP forrásfájlként ismer fel. A WPP figyelmen kívül hagyja a más fájlnévkiterjesztéssel rendelkező fájlokat.	%(TraceWpp.WppFileExtensions)	-ext:.ext1 [.ext2]
IgnoreExclamationmarks Nem kötelező logikai paraméter. Arra utasítja a WPP-t, hogy figyelmen kívül hagyja a felkiáltójeleket, más néven "shrieks"-eket, amelyeket összetett formázásban használnak, például %!timestamp!%.	%(TraceWpp.WppIgnoreExclamationmarks)	-noshrieks
KernelMode Nem kötelező logikai paraméter. Meghatározza a WPP_KERNEL_MODE makrót, amely kernelmódú összetevőket követ nyomon. Alapértelmezés szerint csak a felhasználói módú összetevők lesznek nyomon követve.	%(TraceWpp.WppKernelMode)	-km
OutputDirectory Nem kötelező sztringparaméter. Megadja a WPP által létrehozott kimeneti fájlok könyvtárát.	%(TraceWpp.WppOutputDirectory)	-odir:Path
PreprocessorDefinitions Nem kötelező sztring[] paraméter. A forrásfájl előfeldolgozási szimbólumát határozza meg.	%(TraceWpp.WppPreprocessorDefinitions)	/D
PreserveExtensions Nem kötelező sztring[] paraméter. TMH-fájlok létrehozásakor megőrzi a megadott fájlnévkiterjesztéseket.	%(TraceWpp.WppPreserveExtensions)	-preserveext:ext1[,ext2]
ScanConfigurationData Nem kötelező sztringparaméter. Konfigurációs adatokat keres, például egyéni adattípusokat egy olyan fájlban, amely nem konfigurációs fájl, valamint defaultwpp.ini.	%(TraceWpp.WppScanConfigurationData)	-scan:File
SearchString Nem kötelező sztringparaméter. Arra utasítja a WPP-t, hogy keressen rá a megadott sztring forrásfájljaira a nyomkövetés kezdeményezéséhez.	%(TraceWpp.WppSearchString)	-lookfor:String
ToolPath Nem kötelező sztringparaméter. Lehetővé teszi annak a mappának a teljes elérési útját, amelyben az eszköz található.	$(WPPToolPath)
TraceFunction Nem kötelező sztring[] paraméter. Meghatározza a nyomkövetési üzenetek létrehozásához használható függvényeket.	%(TraceWpp.WppTraceFunction)	-func:FunctionDescription
TrackerLogDirectory Nem kötelező sztringparaméter. Naplókönyvtár a követő számára tlogok írásához.	%(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess Nem kötelező logikai paraméter. Ha igaz, nyomon követi a feladat fájlhozzáférési mintáit.	$(TrackFileAccess)

kapcsolódó témakörök

WPP Preprocessor

WPP szoftver nyomkövetés