Task MSBuild Lic ★Server

Il task Lic si trova in Babel.Build.dll, lo stesso assembly che fornisce il task Babel dell’offuscatore. Costruisce una riga di comando lic dalle sue proprietà e dai suoi elementi ed esegue lic.exe, quindi tutto ciò che il Riferimento della riga di comando descrive è disponibile da un file di progetto. Viene usato in due casi:

• I tuoi progetti MSBuild, per esempio per emettere una licenza di test per l’applicazione sotto test, oppure per generare le licenze dei clienti da un server di build.
• I file di progetto .lcproj, che lic --makeproject scrive a partire da una riga di comando e lic --project esegue di nuovo; vedi File di progetto.

Registrare il task

Referenzia l’assembly del task con un elemento UsingTask che punta a Babel.Build.dll. Nei pacchetti zip di Babel si trova nella cartella MSBuild, quindi con BabelDir impostata sulla cartella in cui è stato estratto babel_net472_<version>.zip:

<UsingTask TaskName="Lic" AssemblyFile="$(BabelDir)\MSBuild\Babel.Build.dll" />

Il task esegue lic.exe dalla cartella impostata con LicDirectory. Se manca, il task cerca accanto a Babel.Build.dll e poi nella cartella indicata dalla variabile d’ambiente BABEL_INSTALL_DIRECTORY. Poiché lic.exe si trova nella radice del pacchetto zip estratto e non nella sua cartella MSBuild, imposta LicDirectory su quella radice, come fa l’esempio qui sotto.

Un esempio completo

Il progetto seguente genera, al termine della build, una licenza firmata per l’assembly compilato. Intestatario, prodotto, funzionalità, campi e restrizioni sono elementi MSBuild i cui metadati diventano le coppie key=value delle opzioni corrispondenti:

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <UsingTask TaskName="Lic" AssemblyFile="$(BabelDir)\MSBuild\Babel.Build.dll" />
 
  <PropertyGroup>
    <BabelDir>C:\Tools\babel_net472</BabelDir>
    <LicenseKeyFile>$(MSBuildProjectDirectory)\keys\signing.pem</LicenseKeyFile>
    <LicenseOutputFile>$(OutDir)MyApp.licenses</LicenseOutputFile>
  </PropertyGroup>
 
  <ItemGroup>
    <Licensee Include="Contoso">
      <Id>C-1001</Id>
      <Company>Contoso Ltd</Company>
      <Email>info@contoso.com</Email>
    </Licensee>
    <Product Include="MyApp">
      <Id>MYAPP</Id>
      <Version>2.1</Version>
      <Url>https://contoso.example</Url>
    </Product>
    <Feature Include="Pro">
      <Data>1</Data>
    </Feature>
    <Field Include="Seats">
      <Value>25</Value>
    </Field>
    <Restriction Include="Trial">
      <TrialDays>30</TrialDays>
      <RunInstances>2</RunInstances>
    </Restriction>
    <Restriction Include="Hardware">
      <HardwareKey>GPHI6-128DI-6196C-KN5LV-BCDRE</HardwareKey>
    </Restriction>
  </ItemGroup>
 
  <Target Name="MakeLicense" AfterTargets="Build">
    <Lic LicDirectory="$(BabelDir)"
         InputFile="$(TargetPath)"
         OutputFile="$(LicenseOutputFile)"
         KeyFile="$(LicenseKeyFile)"
         Sign="rsa"
         ExpireDate="365"
         Encoding="utf-8"
         Licensee="@(Licensee)"
         Product="@(Product)"
         Features="@(Feature)"
         Fields="@(Field)"
         Restrictions="@(Restriction)" />
  </Target>
</Project>

Equivale alla riga di comando:

lic MyApp.dll --keyfile keys\signing.pem --sign rsa --expiredate 365 --encoding utf-8 --licensee name=Contoso --licensee id=C-1001 --licensee company="Contoso Ltd" --licensee email=info@contoso.com --product name=MyApp --product id=MYAPP --product version=2.1 --product url=https://contoso.example --feature def=... --field def=... --trial days=30 --trial instances=2 --hardware key=GPHI6-128DI-6196C-KN5LV-BCDRE --output MyApp.licenses

Imposta ProvideCommandLineArgs="true" e leggi l’elemento di output CommandLineArgs per vedere l’esatta riga di comando costruita dal task.

Proprietà del task

Ogni proprietà corrisponde all’opzione con lo stesso significato nel Riferimento della riga di comando. Le proprietà scalari accettano una stringa; le proprietà di tipo elemento accettano un elenco di elementi.

Input e output

Chiavi e firma

Contenuto della licenza

Elementi di restrizione

Il valore Include di un elemento Restriction seleziona l’opzione, senza distinzione tra maiuscole e minuscole, e i metadati ne forniscono le coppie key=value. Qualsiasi altro valore di Include è trattato come il nome di una restrizione personalizzata e passato a --restriction, con ogni metadato come coppia; i tipi personalizzati richiedono un assembly di estensione elencato in Register.

Identificazione dell’hardware

Strumento e diagnostica

File di progetto

Un file .lcproj è un normale progetto MSBuild che registra il task Lic e lo chiama da un target MakeLicense, con le impostazioni di una generazione di licenza. lic --makeproject ne scrive uno a partire dalle opzioni della riga di comando corrente, accanto al file di output se non indichi un nome, e genera comunque la licenza. lic --project legge un file di questo tipo e lo esegue, applicando sopra le eventuali altre opzioni, senza richiamare MSBuild; il file può anche essere compilato con msbuild o dotnet build su un computer in cui il task è registrato.

lic MyApp.dll --keyfile keys.pem --sign --licensee name=Contoso --expiredate 365 --output MyApp.licenses --makeproject MyApp.lcproj
lic --project MyApp.lcproj --licensee name="Fabrikam" --output Fabrikam.licenses

Il file di progetto conserva una traccia riproducibile di come è stata prodotta una licenza, e riduce una generazione specifica per un cliente a un unico file che puoi mettere sotto controllo di versione, rivedere ed eseguire di nuovo.