Deploymentcenter/client-dotnet/Deploymentcenter.Client/Deploymentcenter.BuildInfo.targets

<Project>
  <!--
    Erzeugt vor jeder Uebersetzung eine BuildInfo-Klasse mit Version,
    UTC-Build-Datum und Git-Commit.

    Einbindung in der .csproj des Consumers:

      <Import Project="..\Deploymentcenter.Client\Deploymentcenter.BuildInfo.targets" />

    Die Klasse entsteht im Namensraum des einbindenden Projekts
    ($(RootNamespace)), nicht in dem des SDK.

    Die vorherige Fassung erzeugte "public static partial class BuildInfo" im
    Namensraum Deploymentcenter.Client.Models. Dort liefert das SDK aber bereits
    eine gleichnamige, nicht partielle Klasse aus: im Consumer entstand ein
    zweiter Typ mit demselben vollen Namen in einer zweiten Assembly (CS0433),
    und der generierte statische Konstruktor setzte Eigenschaften, die in seiner
    Teilklasse gar nicht deklariert waren (CS0103). Einbinden war damit
    unmoeglich - obwohl der UpdateService-Leitfaden genau dazu riet. Der
    generierte Code deklariert seine Werte jetzt selbst und braucht keine
    Gegenstelle im SDK.

    Ueberschreibbare Eigenschaften:
      DeploymentcenterBuildInfoNamespace  Zielnamensraum (Vorgabe: RootNamespace)
      DeploymentcenterBuildInfoClass      Klassenname   (Vorgabe: BuildInfo)
      BuildChannel                        prod, beta, ... (Vorgabe: prod)
      GenerateDeploymentcenterBuildInfo   auf false setzen, um abzuschalten
  -->

  <PropertyGroup>
    <GenerateDeploymentcenterBuildInfo Condition="'$(GenerateDeploymentcenterBuildInfo)' == ''">true</GenerateDeploymentcenterBuildInfo>
    <DeploymentcenterBuildInfoClass Condition="'$(DeploymentcenterBuildInfoClass)' == ''">BuildInfo</DeploymentcenterBuildInfoClass>
  </PropertyGroup>

  <Target Name="GenerateDeploymentcenterBuildInfo"
          BeforeTargets="CoreCompile"
          Condition="'$(GenerateDeploymentcenterBuildInfo)' == 'true'">

    <PropertyGroup>
      <!-- Zielnamensraum: ausdrueckliche Angabe, sonst RootNamespace, sonst Projektname. -->
      <DeploymentcenterBuildInfoNamespace Condition="'$(DeploymentcenterBuildInfoNamespace)' == ''">$(RootNamespace)</DeploymentcenterBuildInfoNamespace>
      <DeploymentcenterBuildInfoNamespace Condition="'$(DeploymentcenterBuildInfoNamespace)' == ''">$(MSBuildProjectName)</DeploymentcenterBuildInfoNamespace>

      <BuildInfoFile>$(IntermediateOutputPath)DeploymentcenterBuildInfo.g.cs</BuildInfoFile>
      <BuildDateUtc>$([System.DateTime]::UtcNow.ToString("o"))</BuildDateUtc>

      <!-- Version aus <Version>, ersatzweise <AssemblyVersion>, sonst 0.0.0. -->
      <BuildVersion Condition="'$(BuildVersion)' == ''">$(Version)</BuildVersion>
      <BuildVersion Condition="'$(BuildVersion)' == ''">$(AssemblyVersion)</BuildVersion>
      <BuildVersion Condition="'$(BuildVersion)' == ''">0.0.0</BuildVersion>

      <BuildChannel Condition="'$(BuildChannel)' == ''">prod</BuildChannel>
    </PropertyGroup>

    <!--
      ContinueOnError, damit ein Build ohne Git-Arbeitskopie oder ohne
      installiertes Git nicht scheitert. IgnoreExitCode allein genuegte nicht:
      fehlt die ausfuehrbare Datei, bricht Exec selbst ab.
    -->
    <Exec Command="git rev-parse HEAD"
          ConsoleToMSBuild="true"
          IgnoreExitCode="true"
          ContinueOnError="true"
          StandardErrorImportance="low">
      <Output TaskParameter="ConsoleOutput" PropertyName="DcGitCommitLong" />
    </Exec>

    <Exec Command="git rev-parse --short HEAD"
          ConsoleToMSBuild="true"
          IgnoreExitCode="true"
          ContinueOnError="true"
          StandardErrorImportance="low">
      <Output TaskParameter="ConsoleOutput" PropertyName="DcGitCommitShort" />
    </Exec>

    <PropertyGroup>
      <DcGitCommitLong Condition="'$(DcGitCommitLong)' == ''">UNKNOWN_COMMIT</DcGitCommitLong>
      <DcGitCommitShort Condition="'$(DcGitCommitShort)' == ''">UNKNOWN</DcGitCommitShort>
      <!-- Zeilenumbrueche aus der Git-Ausgabe entfernen, sie wuerden das Literal sprengen. -->
      <DcGitCommitLong>$(DcGitCommitLong.Trim())</DcGitCommitLong>
      <DcGitCommitShort>$(DcGitCommitShort.Trim())</DcGitCommitShort>
    </PropertyGroup>

    <ItemGroup>
      <BuildInfoLine Include="// &lt;auto-generated /&gt;" />
      <BuildInfoLine Include="// Erzeugt von Deploymentcenter.BuildInfo.targets - nicht von Hand aendern." />
      <BuildInfoLine Include="namespace $(DeploymentcenterBuildInfoNamespace)" />
      <BuildInfoLine Include="{" />
      <BuildInfoLine Include="    /// &lt;summary&gt;Zur Uebersetzungszeit eingebettete Build-Daten.&lt;/summary&gt;" />
      <BuildInfoLine Include="    public static class $(DeploymentcenterBuildInfoClass)" />
      <BuildInfoLine Include="    {" />
      <BuildInfoLine Include="        public const string Version = &quot;$(BuildVersion)&quot;%3B" />
      <BuildInfoLine Include="        public const string GitCommit = &quot;$(DcGitCommitLong)&quot;%3B" />
      <BuildInfoLine Include="        public const string GitCommitShort = &quot;$(DcGitCommitShort)&quot;%3B" />
      <BuildInfoLine Include="        public const string BuildDateUtc = &quot;$(BuildDateUtc)&quot;%3B" />
      <BuildInfoLine Include="        public const string Channel = &quot;$(BuildChannel)&quot;%3B" />
      <!-- Include darf nicht leer sein, daher ein Leerzeichen statt einer Leerzeile. -->
      <BuildInfoLine Include=" " />
      <BuildInfoLine Include="        public static string Summary" />
      <BuildInfoLine Include="        {" />
      <BuildInfoLine Include="            get { return &quot;v&quot; + Version + &quot; (&quot; + GitCommitShort + &quot;) built on &quot; + BuildDateUtc + &quot; [&quot; + Channel + &quot;]&quot;%3B }" />
      <BuildInfoLine Include="        }" />
      <BuildInfoLine Include="    }" />
      <BuildInfoLine Include="}" />
    </ItemGroup>

    <WriteLinesToFile File="$(BuildInfoFile)"
                      Lines="@(BuildInfoLine)"
                      Overwrite="true"
                      WriteOnlyWhenDifferent="true" />

    <ItemGroup>
      <Compile Include="$(BuildInfoFile)" />
      <FileWrites Include="$(BuildInfoFile)" />
    </ItemGroup>
  </Target>
</Project>