Generar archivos manifiestos para COM sin registro
manifest dll (5)
Tengo algunas aplicaciones (algunas nativas, algunas .NET) que usan archivos de manifiesto para que puedan implementarse en completo aislamiento , sin requerir ningún registro COM global. Por ejemplo, la dependencia del servidor com dbgrid32.ocx se declara de la siguiente manera en el archivo myapp.exe.manifest que se encuentra en la misma carpeta que myapp.exe:
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
<assemblyIdentity type="win32" name="myapp.exe" version="1.2.3.4" />
<dependency>
<dependentAssembly>
<assemblyIdentity type="win32" name="dbgrid32.ocx" version="5.1.81.4" />
</dependentAssembly>
</dependency>
</assembly>
El dbgrid32.ocx se implementa en la misma carpeta, junto con su propio archivo dbgrid32.ocx.manifest:
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
<assemblyIdentity type="win32" name="dbgrid32.ocx" version="5.1.81.4" />
<file name="dbgrid32.ocx">
<typelib
tlbid="{00028C01-0000-0000-0000-000000000046}"
version="1.0"
helpdir=""/>
<comClass progid="MSDBGrid.DBGrid"
clsid="{00028C00-0000-0000-0000-000000000046}"
description="DBGrid Control" />
</file>
</assembly>
Todo esto funciona bien, pero mantener estos archivos de manifiesto manualmente es un poco molesto. ¿Hay alguna manera de generar estos archivos automáticamente? Idealmente, me gustaría declarar la dependencia de la aplicación en una lista de servidores COM (nativos y .NET) y luego permitir que el resto se genere automáticamente. ¿Es posible?
Con la tarea MSBuild GenerateApplicationManifest , generé un manifiesto en la línea de comando idéntico al manifiesto que genera Visual Studio. Sospecho que Visual Studio usa GenerateApplicationManifest durante la compilación. A continuación se muestra mi script de compilación que se puede ejecutar desde la línea de comandos utilizando msbuild "msbuild build.xml"
Gracias a Dave Templin y su publicación que me indicaron la tarea GenerateApplicationManifest y la GenerateApplicationManifest de MSDN GenerateApplicationManifest .
build.xml
<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<Target Name="Build">
<ItemGroup>
<File Include=''MyNativeApp.exe''/>
<ComComponent Include=''Com1.ocx;Com2.ocx''/>
</ItemGroup>
<GenerateApplicationManifest
AssemblyName="MyNativeApp.exe"
AssemblyVersion="1.0.0.0"
IsolatedComReferences="@(ComComponent)"
Platform="x86"
ManifestType="Native">
<Output
ItemName="ApplicationManifest"
TaskParameter="OutputManifest"/>
</GenerateApplicationManifest>
</Target>
</Project>
Para completar los ProgID que mt.exe no incluye, puede llamar a ProgIDFromCLSID para buscarlos desde el registro. Esto requiere el registro COM tradicional antes de completar el archivo de manifiesto, pero posteriormente, el archivo de manifiesto será autosuficiente.
Este código C # agrega los ProgID a todas las clases COM en un manifiesto:
var manifest = XDocument.Load(fileName);
var namespaceManager = new XmlNamespaceManager(new NameTable());
namespaceManager.AddNamespace("s", "urn:schemas-microsoft-com:asm.v1");
foreach (var classElement in manifest.XPathSelectElements("s:assembly/s:file/s:comClass", namespaceManager)) {
var clsid = Guid.Parse(classElement.Attribute("clsid").Value);
int result = ProgIDFromCLSID(ref clsid, out string progId); if (result != S_OK) throw new COMException($"ProgID lookup failed for {clsid}.", result);
classElement.SetAttributeValue("progid", progId);
}
manifest.Save(fileName);
El código se basa en estas definiciones de interoperabilidad:
[DllImport("ole32.dll")] static extern int ProgIDFromCLSID([In] ref Guid clsid, [MarshalAs(UnmanagedType.LPWStr)] out string lplpszProgID);
const int S_OK = 0;
Parece que la solución perfecta aún no existe. Para resumir algunas investigaciones:
Make My Manifest ( link )
Esta herramienta escanea un proyecto VB6 para buscar dependencias COM, pero también admite la declaración manual de dependencias COM enlazadas tardíamente (es decir, aquellas utilizadas a través de CreateObject).
Curiosamente, esta herramienta pone toda la información sobre las dependencias dentro del manifiesto de la aplicación. El exe de la aplicación y sus dependencias se describen como un único conjunto que consta de varios archivos. No me había dado cuenta antes de que esto fuera posible.
Parece una herramienta muy buena, pero a partir de la versión 0.6.6 tiene las siguientes limitaciones:
- solo para aplicaciones VB6, comienza desde el archivo de proyecto VB6. Es una pena, porque mucho de lo que realmente no tiene nada que ver con VB6.
- aplicación de estilo asistente, no adecuada para integrarse en un proceso de compilación. Este no es un gran problema si sus dependencias no cambian mucho.
- freeware sin fuente, arriesgado confiar en él porque podría convertirse en abandware en cualquier momento.
No probé si es compatible con las bibliotecas .NET com.
regsvr42 ( enlace del proyecto de código )
Esta herramienta de línea de comandos genera archivos de manifiesto para bibliotecas COM nativas. Invoca a DllRegisterServer y luego espía el auto registro mientras agrega información en el registro. También puede generar un manifiesto de cliente para aplicaciones.
Esta utilidad no es compatible con las bibliotecas COM de .NET, ya que estas no exponen una rutina DllRegisterServer.
La utilidad está escrita en C ++. El código fuente está disponible.
mt.exe
Parte del SDK de Windows (se puede descargar desde MSDN ), que ya tienes si tienes Visual Studio instalado. Está documentado aquí . Puede generar archivos de manifiesto para bibliotecas COM nativas con este modo:
mt.exe -tlb:mycomlib.ocx -dll:mycomlib.ocx -out:mycomlib.ocx.manifest
Puede generar archivos de manifiesto para las bibliotecas COM de .NET con este modo:
mt.exe -managedassemblyname:netlib.dll -nodependency -out:netlib.dll.manifest
Sin embargo, hay algunos problemas con esta herramienta:
- El primer fragmento no generará atributos progid, rompiendo clientes que usan CreateObject con progids.
- El segundo fragmento generará elementos
<runtime>y<mvid>que deberán eliminarse antes de que los manifiestos realmente funcionen. - La generación de manifiestos de cliente para aplicaciones no es compatible.
Quizás las futuras versiones de SDK mejorarán esta herramienta, probé la de Windows SDK 6.0a (vista).
Puede usar spin off desatendido de Make My Manifest para generar manifiestos directamente en compilaciones automáticas. Utiliza un archivo de script para agregar componentes COM dependientes. Este es un extracto de la muestra ini con los comandos disponibles:
# Unattended MMM script
#
# Command names are case-insensitive. Reference of supported commands:
#
# Command: Identity
#
# Appends assemblyIdentity and description tags.
#
# Parameters <exe_file> [name] [description]
# exe_file file name can be quoted if containing spaces. The containing folder
# of the executable sets base path for relative file names
# name (optional) assembly name. Defaults to MyAssembly
# description (optional) description of assembly
#
# Command: Dependency
#
# Appends dependency tag for referencing dependent assemblies like Common Controls 6.0,
# VC run-time or MFC
#
# Parameters {<lib_name>|<assembly_file>} [version] [/update]
# lib_name one of { comctl, vc90crt, vc90mfc }
# assembly_file file name of .NET DLL exporting COM classes
# version (optional) required assembly version. Multiple version of vc90crt can
# be required by a single manifest
# /update (optional) updates assembly_file assembly manifest. Spawns mt.exe
#
# Command: File
#
# Appends file tag and collects information about coclasses and interfaces exposed by
# the referenced COM component typelib.
#
# Parameters <file_name> [interfaces]
# file_name file containing typelib. Can be relative to base path
# interfaces (optional) pipe (|) separated interfaces with or w/o leading
# underscore
#
# Command: Interface
#
# Appends comInterfaceExternalProxyStub tag for inter-thread marshaling of interfaces
#
# Parameters <file_name> <interfaces>
# file_name file containing typelib. Can be relative to base path
# interfaces pipe (|) separated interfaces with or w/o leading underscore
#
# Command: TrustInfo
#
# Appends trustInfo tag for UAC user-rights elevation on Vista and above
#
# Parameters [level] [uiaccess]
# level (optional) one of { 1, 2, 3 } corresponding to { asInvoker,
# highestAvailable, requireAdministrator }. Default is 1
# uiaccess (optional) true/false or 0/1. Allows application to gain access to
# the protected system UI. Default is 0
#
# Command: DpiAware
#
# Appends dpiAware tag for custom DPI aware applications
#
# Parameters [on_off]
# on_off (optional) true/false or 0/1. Default is 0
#
# Command: SupportedOS
#
# Appends supportedOS tag
#
# Parameters <os_type>
# os_type one of { vista, win7 }. Multiple OSes can be supported by a single
# manifest
#
link es una buena herramienta para hacer esto. También es posible escribir un script para procesar todos sus archivos DLL / OCX utilizando mt.exe para generar un manifiesto para cada uno y luego fusionarlos todos juntos. MMM es generalmente mejor / más fácil, porque también maneja muchos casos especiales / extraños.