Redistribuir archivos de Visual C++

Archivos redistribuibles y licencias

La distribución del paquete redistribuible en tiempo de ejecución de Visual C++, los módulos de combinación y los archivos binarios individuales se limita a los usuarios con licencia Visual Studio y está sujeto a los términos de licencia de software de Microsoft.

Al implementar una aplicación, también debe implementar archivos necesarios para soportarla. Si Microsoft proporciona cualquiera de estos archivos, compruebe si tiene permiso para redistribuirlos. Puede encontrar un vínculo a los términos de licencia de Visual Studio en el IDE. En el cuadro de diálogo About Microsoft Visual Studio, seleccione el vínculo License Terms. También puede descargar los términos y licencias de software de Microsoft pertinentes de la Visual Studio License Directory.

Para obtener más información sobre los archivos redistribuibles, consulte Determinar qué bibliotecas de vínculos dinámicos (DLL) redistribuir e implementar ejemplos.

Localizar los archivos redistribuibles

Para implementar archivos redistribuibles, puede usar los paquetes redistribuibles instalados por Visual Studio. En versiones de Visual Studio desde 2017, estos archivos se denominan vc_redist.arm64.exe, vc_redist.x64.exe y vc_redist.x86.exe. En Visual Studio 2015, 2017 y 2019, también están disponibles en los nombres vcredist_x86.exe, vcredist_x64.exe y (solo 2015) vcredist_arm.exe.

La manera más fácil de localizar los archivos redistribuibles es utilizando variables de entorno establecidas en una ventana de comandos para desarrolladores. En Visual Studio 2022, los archivos redistribuibles se encuentran en la carpeta %VCINSTALLDIR%Redist\MSVC\v143. En la versión más reciente de Visual Studio 2019, puede encontrar los archivos redistribuibles en la carpeta %VCINSTALLDIR%Redist\MSVC\v142. En Visual Studio 2017 y Visual Studio 2019, los archivos también se encuentran en %VCToolsRedistDir%. En Visual Studio 2015, puede encontrar estos archivos en %VCINSTALLDIR%redist\<locale>, donde <locale> es la configuración regional de los paquetes redistribuibles.

En Visual Studio 2022 y 2019, los archivos de módulo de mezcla forman parte de un componente instalable opcional denominado Visual C++ <version> Módulos de mezcla redistribuibles en el instalador de Visual Studio. Los módulos de combinación se instalan de forma predeterminada como parte de una instalación de C++ en Visual Studio 2017 y Visual Studio 2015. Cuando se instalan en Visual Studio 2022, puede encontrar los módulos de combinación redistribuibles en %VCINSTALLDIR%Redist\MSVC\v143\MergeModules.

En la versión más reciente de Visual Studio 2019, los módulos de combinación redistribuibles se encuentran en %VCINSTALLDIR%Redist\MSVC\v142\MergeModules. En ambos Visual Studio 2019 y Visual Studio 2017, también se encuentran en %VCToolsRedistDir%MergeModules. En Visual Studio 2015, se encuentran en Program Files [(x86)]\Common Files\Merge Modules.

Instalación de los paquetes redistribuibles

Los paquetes redistribuibles de Visual C++ instalan y registran todas las bibliotecas de Visual C++. Si usa uno, ejecútelo como requisito previo en el sistema de destino antes de instalar la aplicación. Se recomienda usar estos paquetes para las implementaciones, ya que habilitan la actualización automática de las bibliotecas de Visual C++. Para obtener un ejemplo que muestra cómo usar estos paquetes, vea Tutorial: Implementación de una aplicación de Visual C++ mediante el paquete Redistribuible de Visual C++.

Cada paquete de Visual C++ Redistributable comprueba si existe una versión más reciente en el equipo. Si se encuentra una versión más reciente, el paquete no está instalado. En Visual Studio 2015 o posterior, los paquetes redistribuibles muestran un mensaje de error que indica que se produjo un error en la configuración. Si un paquete usa la marca para ejecutarse, no aparece ningún mensaje de error. En cualquier caso, el instalador de Microsoft registra el error y se devuelve un resultado de error al autor de la llamada.

En Visual Studio 2015 y versiones posteriores, puede evitar este error comprobando el registro para averiguar si está instalada una versión más reciente. El número de versión instalado actual se almacena en la clave .

El número de versión es 14.0 para Visual Studio 2015, 2017, 2019 y 2022, ya que la versión más reciente de Redistributable es binaria compatible con versiones anteriores de nuevo a 2015. La clave es , o dependiendo de las versiones instaladas para la plataforma. (Solo debe comprobar en la subclave si usa Regedit para ver la versión del paquete x86 instalado en una plataforma x64).

El número de versión se almacena en el valor de cadena y también en el conjunto de valores , , y . Para evitar un error en el momento de la instalación, debe omitir la instalación del paquete redistribuible si la versión instalada actualmente es más reciente.

Opciones de línea de comandos para los paquetes redistribuibles

Visual C++ Redistributable admite varias opciones de línea de comandos. Las opciones , , o presentan un cuadro de diálogo que enumera las opciones disponibles. Puede especificar la instalación, la reparación o la desinstalación de Redistributable. La opción copia el contenido completo del Redistributable en el directorio actual.

De forma predeterminada, el Redistributable instala su contenido y solicita al usuario información y si desea reiniciar después de la instalación. Puede especificar la opción , que muestra el progreso, pero no requiere interacción del usuario. También puede especificar una opción, que no muestra una interfaz de usuario ni requiere ninguna interacción del usuario. La opción suprime los intentos de reinicio. De forma predeterminada, se crea un archivo de registro en . Puede usar para iniciar sesión en un archivo específico.

Este comando de ejemplo instala x64 Redistributable. Muestra el progreso de la instalación, pero no requiere interacción del usuario ni reinicio:

vc_redist.x64.exe /install /passive /norestart

Instalación de los módulos de combinación redistribuibles

Los módulos de combinación redistribuibles deben incluirse en el paquete del instalador de Windows (o paquete de instalación similar) que se usa para implementar la aplicación. Para obtener más información, consulte Redistribuir mediante módulos de combinación. Para obtener un ejemplo, vea Tutorial: Implementación de una aplicación de Visual C++ mediante un proyecto de instalación.

Instalación de archivos redistribuibles individuales

También es posible instalar directamente los archivos DLL redistribuibles en la carpeta local de la aplicación. La carpeta local de la aplicación es la carpeta que contiene el archivo de aplicación ejecutable. Por motivos de mantenimiento, no se recomienda usar esta ubicación de instalación.

Posibles errores en tiempo de ejecución

Si Windows no encuentra uno de los archivos DLL redistribuibles requeridos por la aplicación, podría mostrar un mensaje similar al siguiente: "No se pudo iniciar esta aplicación porque no se encontró library.dll. Si vuelve a instalar la aplicación, puede que se corrijan los problemas".

Para resolver este tipo de error, asegúrese de que el instalador de la aplicación se compila correctamente. Compruebe que las bibliotecas redistribuibles se implementan correctamente en el sistema de destino. Para obtener más información, vea Descripción de las dependencias de una aplicación de Visual C++.

Contenido relacionado

• Redistribuir mediante módulos de combinación describe cómo usar los módulos de combinación redistribuibles de Visual C++ para instalar las bibliotecas en tiempo de ejecución de Visual C++ como archivos DLL compartidos en la carpeta.
• Redistribuir controles ActiveX de Visual C++ describe cómo redistribuir una aplicación que usa controles ActiveX.
• Redistribuir la biblioteca microsoft Foundation Class (MFC) describe cómo redistribuir una aplicación que usa MFC.
• Redistribuir una aplicación de biblioteca de plantillas activas (ATL) describe cómo redistribuir una aplicación que usa una ATL. En Visual Studio 2012 y versiones posteriores, no se requiere ninguna biblioteca ATL.
• Los ejemplos de implementación se vinculan a ejemplos que muestran cómo implementar aplicaciones de Visual C++.
• La implementación de aplicaciones de escritorio presenta conceptos y tecnologías de implementación de Visual C++.
• Enlaces a las descargas más recientes de Visual C++ Redistributable compatibles.