Tarea Lic de MSBuild ★Server

La tarea Lic se encuentra en Babel.Build.dll, el mismo ensamblado que proporciona la tarea Babel del ofuscador. Construye una línea de comandos de lic a partir de sus propiedades y elementos y ejecuta lic.exe, de modo que todo lo que describe la Referencia está disponible desde un archivo de proyecto. Se usa en dos casos:

• En sus propios proyectos de MSBuild, por ejemplo para emitir una licencia de prueba para la aplicación que se está probando, o para generar licencias de clientes desde un servidor de compilación.
• En los archivos de proyecto .lcproj, que lic --makeproject escribe a partir de una línea de comandos y lic --project vuelve a ejecutar; consulte Archivos de proyecto.

Registrar la tarea

Haga referencia al ensamblado de la tarea con un elemento UsingTask que apunte a Babel.Build.dll. En los paquetes zip de Babel está en la carpeta MSBuild, así que, con BabelDir establecida en la carpeta en la que se extrajo babel_net472_<version>.zip:

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

La tarea ejecuta lic.exe desde la carpeta indicada en LicDirectory. Si no se establece, la tarea busca junto a Babel.Build.dll y después en la carpeta que indica la variable de entorno BABEL_INSTALL_DIRECTORY. Como lic.exe está en la raíz del paquete zip extraído, y no en su carpeta MSBuild, establezca LicDirectory en esa raíz, como hace el ejemplo de más abajo.

Un ejemplo completo

El proyecto siguiente genera, después de la compilación, una licencia firmada para el ensamblado compilado. El titular de la licencia, el producto, las funciones, los campos y las restricciones son elementos de MSBuild cuyos metadatos se convierten en los pares key=value de las opciones correspondientes:

<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>

Esto equivale a la línea de comandos:

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

Establezca ProvideCommandLineArgs="true" y lea el elemento de salida CommandLineArgs para ver la línea de comandos exacta que construyó la tarea.

Propiedades de la tarea

Cada propiedad corresponde a la opción del mismo significado en la Referencia. Las propiedades escalares reciben una cadena; las propiedades de elementos reciben una lista de elementos.

Entrada y salida

Claves y firma

Contenido de la licencia

Elementos de restricción

El valor Include de un elemento Restriction selecciona la opción, sin distinguir mayúsculas de minúsculas, y los metadatos proporcionan sus pares key=value. Cualquier otro valor de Include se trata como el nombre de una restricción personalizada, que se pasa a --restriction con cada metadato como un par; los tipos personalizados necesitan un ensamblado de extensión incluido en Register.

Identificación del hardware

Herramienta y diagnóstico

Archivos de proyecto

Un archivo .lcproj es un proyecto de MSBuild corriente que registra la tarea Lic y la llama desde un destino MakeLicense, con los ajustes de la generación de una licencia. lic --makeproject escribe uno a partir de las opciones de la línea de comandos actual, junto al archivo de salida salvo que se indique un nombre, y genera igualmente la licencia. lic --project lee un archivo de este tipo y lo ejecuta, aplicando encima las demás opciones, sin invocar MSBuild; el archivo también se puede compilar con msbuild o dotnet build en un equipo donde la tarea esté registrada.

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

El archivo de proyecto conserva un registro reproducible de cómo se produjo una licencia, y hace que la generación específica de un cliente sea un único archivo que se puede versionar, revisar y volver a ejecutar.