Tareas de MSBuild

Las extensiones ofrecen una serie de tareas para MSBuild para trabajar con kbase de Genexus. Para poder utilizar las tareas hay que importar en el script del msbuild el archivo de definiciones "LsiExtensions.targets" que se incluye en la instalación de las extensiones. Las tareas declaradas se describen a continuación.

LsiLogSectionStart / LsiLogSectionEnd

Permiten registrar el log de Genexus de las tareas incluidas entre estas dos tareas. Este log puede mandarse por correo con la tarea LsiSendEmail.

Las otras tareas declaradas por las extensiones no debería incluirse dentro de estas tareas, ya que el log de dichas tareas siempre queda registrado, y siempre se envian en el correo.

Estas tareas pueden usarse varias veces dentro del archivo MsBuild, pero no recursivamente (secciones dentro de secciones).

    <LsiLogSectionStart SectionTitle="Build all" IsWeb="false"/>
      <BuildAll ForceRebuild="false" CompileMains="false" DetailedNavigation="false" />
      ...
    <LsiLogSectionEnd />

LsiSendEmail

Envia por correo el log capturado por las tareas LsiLogSectionStart / LsiLogSectionEnd y el resto de tareas declaradas en estas extensiones.

	<LsiSendEmail FromEmail="xxx@xxx.com" ToEmails="@(DestinationEmails)"
              EmailHost="xxx" EmailUserName="xxx@xxx.com"
              EmailPassword="xxx" 
              Ssl="true"
              Port="1234"
              TimeoutMiliseconds="10000"
/>              

LsiCompileTask

Es una tarea para compilar todos los mains de uno o varios generadores de la kbase. En caso de compilar un main con generador c# win, y si la propiedad "Assemblies structure" del generador vale "By main", intenta reparar errores en su RSP. Puede encontrar más información sobre la reparación de RSPs en la documentación de la toolwindow Work with mains.

<LsiCompileTask Generator="$(Generator)" RepairRsp="all"/>

LsiBuildQuerys

Genera todos los objetos Query del entorno actual, sin especificar / generar nada.

<LsiBuildQuerys />

LsiDeleteBackups

Sólo tiene sentido si se suele usar la operación de compilación personalizada de la toolwindow Work with mains. Esta compilación puede generar archivos de backup en el directorio del modelo. Esta tarea borra dichos archivos.

<LsiDeleteBackups />

LsiPrepareProduction

Ejecuta las tareas para preparar la producción de la KBase. Si la propiedad "RunWithErrors" es falsa, si alguna tarea anterior ha fallado, esta no se ejecutará. Si es cierta, se preparará la producción aunque haya habido errores. Su valor por defecto es falso.

<LsiPrepareProduction RunWithErrors="false" />

Ejemplo

Un ejemplo de archivo msbuild que usan las tarea sería el siguiente:

<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

	<!-- Import standard gx tasks and custom LSI tasks -->
	<Import Project="C:\Program Files (x86)\Artech\GeneXus\GeneXusXEv3\Genexus.Tasks.targets" />
	<Import Project="C:\Program Files (x86)\Artech\GeneXus\GeneXusXEv3\Packages\LsiExtensions.targets" />
  
  <PropertyGroup>
    
		<!-- Set the  kbase path -->
		<KBPath Condition=" '$(KBPath)' == '' ">D:\kbases\PruebasWinWebEv3</KBPath>
    
    <!--Set the model-->
    <KBEnvironment Condition=" '$(KBEnvironment)' == '' ">.Net Environment</KBEnvironment>
    
    <!--The generator to compile. If its empty, all generators will be compiled-->
    <!--<Generator>Default (C#)</Generator>-->
    
	</PropertyGroup>

  <!--Email addresses to send compilation reports-->
  <ItemGroup>
    <DestinationEmails Include="xxx@xxx.com" />
    <!--<DestinationEmails Include="yyy@xxx.com" />-->
  </ItemGroup>

  <!--Build kbase-->
  <Target Name="Build">
    
	<OpenKnowledgeBase Directory="$(KBPath)" />
    
    <SetActiveEnvironment EnvironmentName="$(KBEnvironment)" />
        
    <!--Start log section-->
    <LsiLogSectionStart SectionTitle="Build all" IsWeb="false"/>

      <!--Run a gx msbuild task-->
      <BuildAll ForceRebuild="false" CompileMains="false" DetailedNavigation="false" />
    
    <!--End log section-->
    <LsiLogSectionEnd />
    
    <!--Compile-->
    <LsiCompileTask Generator="$(Generator)" RepairRsp="all"/>

    <!--Generate query objects-->
    <LsiBuildQuerys />

    <!--Delete backup files-->
    <LsiDeleteBackups />

    <!--Send email-->
    <LsiSendEmail FromEmail="xxx@xxx.com" ToEmails="@(DestinationEmails)"
                  EmailHost="xxx" EmailUserName="xxx@xxx.com"
                  EmailPassword="xxx" />
    
	<CloseKnowledgeBase />
    
  </Target>

</Project>

El correo enviado tiene un formato parecido al siguiente: