Crear paquetes de programa previo

  • Artículo

El programa de instalación es un instalador genérico que se puede configurar para detectar e instalar componentes redistribuibles, como archivos de Windows Installer (.msi) y programas ejecutables. El instalador también se conoce como programa previo. Se programa mediante un conjunto de manifiestos XML que especifican los metadatos que administrarán la instalación del componente. Cada componente redistribuible, o requisito previo, que aparece en el cuadro de diálogo Requisitos previos de ClickOnce es un paquete del programa previo. Un paquete de programa previo es un grupo de directorios y archivos que contienen archivos de manifiesto que describen cómo se debe instalar el requisito previo.

El programa previo detecta primero si los requisitos previos están ya instalados. Si no lo están, el programa previo muestra el contrato de licencia. Después de que el usuario acepta los contratos de licencia, comienza la instalación de los requisitos previos. Si se detectan todos los requisitos previos, el programa previo inicia el instalador de la aplicación.

Creación de paquetes del programa previo personalizados

Puede generar los manifiestos del programa previo con el editor XML de Visual Studio. Para ver un ejemplo de cómo crear un paquete del programa previo, consulte Tutorial: Creación de un programa previo personalizado con un aviso de privacidad.

Para crear un paquete del programa previo, debe crear un manifiesto de producto y, para cada versión localizada de un componente, también un manifiesto de paquete.

  • El manifiesto del producto, product.xml, que contiene los metadatos del paquete que son independientes del idioma. Contiene los metadatos comunes a todas las versiones localizadas del componente redistribuible. Para crear este archivo, consulte Procedimiento: Creación de un manifiesto de producto.

  • El manifiesto del paquete, package.xml, que contiene los metadatos específicos del idioma; normalmente, contiene mensajes de error localizados. Un componente debe tener al menos un manifiesto del paquete por cada versión localizada de ese componente. Para crear este archivo, vea Procedimiento: Creación de un manifiesto de paquete.

Una vez creados estos archivos, coloque el archivo del manifiesto del producto en una carpeta con el nombre del programa previo personalizado. El archivo del manifiesto del paquete va en una carpeta con el nombre de la configuración regional. Por ejemplo, si el archivo del manifiesto del paquete es para la redistribución en inglés, coloque el archivo en una carpeta llamada en. Repita este proceso para cada configuración regional, como ja para japonés y de para alemán. El paquete del programa previo personalizado final podría tener la siguiente estructura de carpetas.

CustomBootstrapperPackage
  product.xml
  CustomBootstrapper.msi
  de
    eula.rtf
    package.xml
  en
    eula.rtf
    package.xml
  ja
    eula.rtf
    package.xml

Por último, copie los archivos redistribuibles en la ubicación de la carpeta del programa previo. Para obtener más información, consulte Cómo: crear un paquete de arranque localizado.

*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages*

or

*<VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages*

Nota:

La ruta de acceso indicada anteriormente en la ruta de instalación de Visual Studio funciona a partir de la versión de Visual Studio 2019 Update 7.

También puede encontrar la ubicación de la carpeta del programa previo con el valor de Ruta de acceso en la siguiente clave del Registro:

*HKLM\Software\Microsoft\GenericBootstrapper*

En los sistemas de 64 bits, use la siguiente clave del Registro:

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

Cada componente redistribuible aparece en su propia subcarpeta, en el directorio de los paquetes. Los archivos redistribuibles y de manifiesto del producto se colocan en esta subcarpeta. Las versiones localizadas de los manifiestos de componentes y de paquetes tienen que colocarse en subcarpetas con el nombre de la referencia cultural.

Una vez copiados estos archivos en la carpeta del programa previo, el paquete del programa previo aparece automáticamente en el cuadro de diálogo Requisitos previos de Visual Studio. Si el paquete del programa previo personalizado no aparece, cierre y vuelva a abrir el cuadro de diálogo Requisitos previos. Para obtener más información, consulta Cuadro de diálogo Requisitos previos.

La tabla siguiente muestra las propiedades que el programa previo rellena automáticamente.

Propiedad Descripción
ApplicationName Nombre de la aplicación.
ProcessorArchitecture El procesador y los bits por palabra de la plataforma de destino de un ejecutable. Los valores son los siguientes:

- Intel
- IA64
- AMD64
VersionNT Número de versión de los sistemas operativos Windows. La sintaxis de la versión es Principal.Secundaria.ServicePack.
VersionMSI La versión del ensamblado de Windows Installer (msi.dll) que se ejecuta durante la instalación.
AdminUser Esta propiedad se establece si el usuario tiene privilegios administrativos. Los valores son true o false.
InstallMode El modo de instalación indica desde dónde debe instalarse el componente. Los valores son los siguientes:

- HomeSite: los requisitos previos se instalan desde el sitio web del proveedor.
- SpecificSite: los requisitos previos se instalan desde la ubicación que seleccione.
- SameSite: los requisitos previos se instalan desde la misma ubicación que la aplicación.

Separación de los redistribuibles de las instalaciones de aplicaciones

Puede evitar que los archivos redistribuibles se implementen en proyectos de instalación. Para ello, cree una lista de redistribuibles en la carpeta RedistList de su directorio de .NET Framework:

%ProgramFiles%\Microsoft.NET\RedistList

La lista de redistribuibles es un archivo XML cuyo nombre debe seguir el formato siguiente: <Nombre de la compañía><Nombre del componente>.RedistList.xml. Por ejemplo, si el componente se llama Datawidgets y ha sido creado por Acme, use Acme.DataWidgets.RedistList.xml. El siguiente podría ser un ejemplo del contenido de la lista de redistribuibles:

<?xml version="1.0" encoding="UTF-8"?>
<FileList Redist="Acme.DataWidgets" >
<File AssemblyName="Acme.DataGrid" Version="1.0.0.0" PublicKeyToken="b03f5f7f11d50a3a" Culture="neutral" ProcessorArchitecture="MSIL" InGAC="true" />
</FileList>

Contenido relacionado