Cómo: Especificar eventos de compilación (Visual Basic)

  • Artículo

Actualización: Julio de 2008

Los eventos de generación en Visual Basic pueden utilizarse para ejecutar secuencias de comandos, macros u otras acciones como una parte del proceso de compilación. Los eventos anteriores a la generación se producen antes de la compilación; los eventos posteriores a la generación se producen después de la compilación.

Los eventos de compilación se especifican en el cuadro de diálogo Eventos de compilación, disponible en la página Compilación del Diseñador de proyectos.

Cómo especificar eventos anteriores y posteriores a la generación

Para especificar un evento de generación

  1. Con un proyecto seleccionado en el Explorador de soluciones, en el menú Proyecto haga clic en Propiedades.

  2. Haga clic en la ficha Compilar.

  3. Haga clic en el botón Eventos de generación para abrir el cuadro de diálogo Eventos de generación.

  4. Escriba los argumentos de la línea de comandos para la acción anterior o posterior a la generación y haga clic en Aceptar.

    Nota:

    Agregue una instrucción call delante de todos los comandos posteriores a la generación que ejecutan archivos .bat. Por ejemplo: call C:\MyFile.bat o call C:\MyFile.bat call C:\MyFile2.bat.
    Nota:

    Si el evento previo o posterior a la compilación no se completa correctamente, puede finalizar la compilación haciendo que la acción del evento salga con un código distinto de cero (0), que indica una acción correcta.

Ejemplo: Cómo cambiar la información del manifiesto mediante un evento posterior a la generación

El procedimiento siguiente muestra cómo establecer la versión mínima del sistema operativo en el manifiesto de la aplicación por medio de un comando .exe al que llama un evento posterior a la generación (archivo .exe.manifest en el directorio de proyecto). La versión mínima del sistema operativo es un número constituido por cuatro partes, como 4.10.0.0. Para ello, el comando modificará la sección <dependentOS> del manifiesto:

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

Para crear un comando .exe para cambiar el manifiesto de la aplicación

  1. Cree una aplicación de consola para el comando. En el menú Archivo, seleccione Nuevo y, a continuación, haga clic en Proyecto.

  2. En el cuadro de diálogo Nuevo proyecto, en el nodo Visual Basic, seleccione Windows y, a continuación, la plantilla Aplicación de consola. Asigne al proyecto el nombre ChangeOSVersionVB.

  3. En Module1.vb, agregue la línea siguiente a las otras instrucciones Imports de la parte superior del archivo:

    Imports System.Xml

  4. Agregue el código siguiente en 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

    El comando acepta dos argumentos. El primer argumento es la ruta de acceso al manifiesto de aplicación (es decir, la carpeta donde el proceso de compilación crea el manifiesto, que suele ser NombreDelProyecto.publish). El segundo argumento es la nueva versión del sistema operativo.

  5. En el menú Generar, haga clic en Generar solución.

  6. Copie el archivo .exe en un directorio como C:\TEMP\ChangeOSVersionVB.exe.

A continuación, invoque este comando en un evento posterior a la compilación, para modificar el manifiesto de la aplicación.

Para invocar un evento posterior a la compilación a fin de modificar el manifiesto de la aplicación

  1. Cree una aplicación para Windows para el proyecto que se va a publicar. En el menú Archivo, seleccione Nuevo y, a continuación, haga clic en Proyecto.

  2. En el cuadro de diálogo Nuevo proyecto, en el nodo Visual Basic, seleccione Windows y, a continuación, la plantilla Aplicación para Windows. Asigne al proyecto el nombre VBWinApp.

  3. Con el proyecto seleccionado en el Explorador de soluciones, en el menú Proyecto haga clic en Propiedades.

  4. En el Diseñador de proyectos, vaya a la página Publicar y establezca Ubicación de publicación en C:\TEMP\.

  5. Publique el proyecto, haciendo clic en Publicar ahora.

    Se generará el archivo de manifiesto y se colocará en C:\TEMP\VBWinApp_1_0_0_0\VBWinApp.exe.manifest. Para ver el manifiesto, haga clic con el botón secundario del mouse en el archivo, y seleccione sucesivamente Abrir con, Seleccionar el programa de una lista y Bloc de notas.

    Busque el elemento <osVersionInfo> en el archivo. Por ejemplo, la versión podrían ser:

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

  6. En el Diseñador de proyectos, seleccione la ficha Compilación y haga clic en el botón Eventos de generación para abrir el cuadro de diálogo Eventos de generación.

  7. En el cuadro Línea de comandos del evento posterior a la generación, escriba el comando siguiente:

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

    Al generar el proyecto, este comando cambiará la versión mínima del sistema operativo en el manifiesto de la aplicación a 5.1.2600.0.

    La macro $(TargetPath) expresa la ruta de acceso completa para el ejecutable creado. Por consiguiente, $(TargetPath).manifest especificará el manifiesto de aplicación creado en el directorio bin. Al publicarlo, se copiará este manifiesto en la ubicación de publicación que estableció anteriormente.

  8. Publique otra vez el proyecto. Vaya a la página Publicar y haga clic en Publicar ahora.

    Vea de nuevo el manifiesto. Para ver el manifiesto, vaya al directorio de publicación, haga clic con el botón secundario del mouse en el archivo y seleccione sucesivamente Abrir con, Seleccionar el programa de una lista y Bloc de notas.

    La versión indicada debe ser ahora:

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

Vea también

Tareas

Cómo: Especificar eventos de compilación (C#)

Referencia

Página Compilación, Diseñador de proyectos (Visual Basic)

Panel Publicar, Diseñador de proyectos

Línea de comandos del evento anterior/posterior a la generación (Cuadro de diálogo)

Otros recursos

Administrar las propiedades de compilación

Historial de cambios

Fecha

Historial

Motivo

Julio de 2008

Se agrega nota sobre códigos de salida.

Comentarios de los clientes.