Ange bygghändelser (Visual Basic)

Bygghändelser i Visual Basic kan användas för att köra skript, makron eller andra åtgärder som en del av kompileringsprocessen. Förkompileringshändelser inträffar före kompilering. händelser efter bygget inträffar efter kompilering.

Du kan referera till "makron" (egentligen MSBuild-egenskapsnamn) i skripten. Om du vill referera till en egenskap använder du syntaxen $(PropertyName), som ersätts med egenskapsvärdet när händelseskriptet körs. En lista över vanliga värden finns i Vanliga egenskaper för MSBuild. Det kan finnas andra egenskaper som definieras i projektfilen, i alla importerade filer i projektfilen, i miljövariabler eller som skickas på kommandoraden -p med hjälp av MSBuild-växeln under kommandoradsversioner.

Exempel: Så här ändrar du manifestinformation med hjälp av en händelse efter bygget

Följande procedur visar hur du anger den lägsta versionen av operativsystemet i programmanifestet med hjälp av ett .exe kommando som anropas från en händelse efter bygget ( .exe.manifest filen i projektkatalogen). Den lägsta operativsystemversionen är ett nummer i fyra delar, till exempel 4.10.0.0. För att göra detta ändrar kommandot avsnittet <dependentOS> i manifestet:

<dependentOS>
   <osVersionInfo>
      <os majorVersion="4" minorVersion="10" buildNumber="0" servicePackMajor="0" />
   </osVersionInfo>
</dependentOS>

Så här skapar du ett .exe kommando för att ändra programmanifestet

1. Skapa ett konsolprogram för kommandot. På menyn Arkiv klickar du på Nyoch klickar sedan på Projekt.

2. I dialogrutan Nytt projekt i noden Visual Basic väljer du Windows och sedan mallen Console Application. Ge projektet namnet ChangeOSVersionVB.

3. I Module1.vblägger du till följande rad i de andra Imports-uttrycken överst i filen:

   Imports System.Xml
   

4. Lägg till följande kod i Sub Main:

   Sub Main()
      Dim applicationManifestPath As String
      applicationManifestPath = My.Application.CommandLineArgs(0)
      Console.WriteLine("Application Manifest Path: " & applicationManifestPath.ToString)
   
      'Get version name
      Dim osVersion As Version
      If My.Application.CommandLineArgs.Count >= 2 Then
         osVersion = New Version(My.Application.CommandLineArgs(1).ToString)
      Else
         Throw New ArgumentException("OS Version not specified.")
      End If
      Console.WriteLine("Desired OS Version: " & osVersion.ToString())
   
      Dim document As XmlDocument
      Dim namespaceManager As XmlNamespaceManager
      namespaceManager = New XmlNamespaceManager(New NameTable())
      With namespaceManager
         .AddNamespace("asmv1", "urn:schemas-microsoft-com:asm.v1")
         .AddNamespace("asmv2", "urn:schemas-microsoft-com:asm.v2")
      End With
   
      document = New XmlDocument()
      document.Load(applicationManifestPath)
   
      Dim baseXPath As String
      baseXPath = "/asmv1:assembly/asmv2:dependency/asmv2:dependentOS/asmv2:osVersionInfo/asmv2:os"
   
      'Change minimum required OS Version.
      Dim node As XmlNode
      node = document.SelectSingleNode(baseXPath, namespaceManager)
      node.Attributes("majorVersion").Value = osVersion.Major.ToString()
      node.Attributes("minorVersion").Value = osVersion.Minor.ToString()
      node.Attributes("buildNumber").Value = osVersion.Build.ToString()
      node.Attributes("servicePackMajor").Value = osVersion.Revision.ToString()
   
      document.Save(applicationManifestPath)
   End Sub
   

   Kommandot tar två argument. Det första argumentet är sökvägen till programmanifestet (dvs. mappen där byggprocessen skapar manifestet, vanligtvis <ProjectName>.publish). Det andra argumentet är den nya versionen av operativsystemet.

5. På menyn Build klickar du på Build Solution.

6. Kopiera .exe-filen till en katalog som C:\TEMP\ChangeOSVersionVB.exe.

   Anropa sedan det här kommandot i en händelse efter bygget för att ändra programmanifestet.

Så här anropar du en händelse efter bygget för att ändra programmanifestet

1. Skapa ett Windows-program för projektet som ska publiceras. På menyn Arkiv klickar du på Nyoch klickar sedan på Projekt.

2. I dialogrutan Nytt projekt i noden Visual Basic väljer du Windows Desktop och sedan mallen Windows Forms App. Ge projektet namnet VBWinApp.

3. När projektet är markerat i Solution Explorerklickar du på Egenskaperpå menyn Project .

4. På Project Designer-går du till sidan Publicera och anger Publiceringsplats till C:\TEMP.

5. Publicera projektet genom att klicka på Publicera nu.

   Manifestfilen skapas och placeras i C:\TEMP\VBWinApp_1_0_0_0\VBWinApp.exe.manifest. Om du vill visa manifestet högerklickar du på filen och klickar på Öppna medoch klickar sedan på Välj programmet från en listaoch klickar sedan på Anteckningar.

   Sök i filen efter elementet <osVersionInfo>. Versionen kan till exempel vara:

   <os majorVersion="4" minorVersion="10" buildNumber="0" servicePackMajor="0" />
   

6. I Project Designer-går du till fliken Kompilera och klickar på knappen Skapa händelser för att öppna dialogrutan Build Events.

7. Ange följande kommando i rutan Kommandorad för händelse efter byggnad:

   C:\TEMP\ChangeOSVersionVB.exe "$(TargetPath).manifest" 5.1.2600.0

   När du skapar projektet ändrar det här kommandot den lägsta versionen av operativsystemet i programmanifestet till 5.1.2600.0.

   Makrot $(TargetPath) uttrycker den fullständiga sökvägen för den körbara fil som skapas. Anger $(TargetPath).manifest därför programmanifestet som skapats i bin-katalogen . När du publicerar kopieras det här manifestet till den publiceringsplats som du angav tidigare.

8. Publicera projektet igen. Gå till sidan Publicera och klicka på Publicera nu.

   Visa manifestet igen. Om du vill visa manifestet går du till publiceringskatalogen, högerklickar på filen och klickar på Öppna med och sedan Välj programmet från en listaoch klickar sedan på Anteckningar.

   Versionen bör nu läsa:

   <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" />
   

Relaterat innehåll

• Kompileringssida, Project Designer (Visual Basic)
• Publicera sida, Project Designer
• Dialogruta för kommando för händelse före/efter byggnad
• Så här anger du build-händelser (C#)