Redistribution des fichiers Visual C++

Fichiers redistribuables et licences

La distribution du package Redistribuable visual C++ Runtime, des modules de fusion et des fichiers binaires individuels est limitée aux utilisateurs de Visual Studio sous licence et est soumise à ces conditions de licence.

Lorsque vous déployez une application, vous devez également déployer les fichiers qui sont requis pour sa prise en charge. Si l’un de ces fichiers est fourni par Microsoft, vérifiez si vous êtes autorisé à le redistribuer. Vous trouverez un lien vers les conditions de licence Visual Studio dans l’IDE. Utilisez le lien Conditions de licence dans la boîte de dialogue À propos de Microsoft Visual Studio. Vous pouvez également télécharger les CLUF et licences appropriés à partir du répertoire des licences Visual Studio.

Pour plus d’informations sur les fichiers redistribuables, consultez Déterminer les DLL à redistribuer et Exemples de déploiement.

Localisez les fichiers redistribuables

Pour déployer des fichiers redistribuables, vous pouvez utiliser les packages redistribuables installés par Visual Studio. Dans les versions de Visual Studio depuis 2017, ces fichiers sont nommés vc_redist.arm64.exe, vc_redist.x64.exe et vc_redist.x86.exe. Dans Visual Studio 2015, 2017 et 2019, ils sont également disponibles sous les noms vcredist_x86.exe, vcredist_x64.exe et (2015 uniquement) vcredist_arm.exe.

La méthode la plus simple pour localiser les fichiers redistribuables consiste à utiliser les variables d’environnement définies dans une invite de commandes de développeur. Dans Visual Studio 2022, les fichiers redistribuables se trouvent dans le dossier %VCINSTALLDIR%Redist\MSVC\v143. Dans la dernière version de Visual Studio 2019, vous trouverez les fichiers redistribuables dans le dossier %VCINSTALLDIR%Redist\MSVC\v142. Dans Visual Studio 2017 et Visual Studio 2019, ils se trouvent également dans %VCToolsRedistDir%. Dans Visual Studio 2015, ces fichiers se trouvent dans %VCINSTALLDIR%redist\<locale>, où <locale> correspond à la locale des packages redistribuables.

Dans Visual Studio 2022 et 2019, les fichiers de modules de fusion font partie d’un composant facultatif installable nommé C++ <version> Redistributable MSMs dans le programme d’installation de Visual Studio. Les modules de fusion sont installés par défaut dans le cadre de l’installation de C++ dans Visual Studio 2017 et Visual Studio 2015. Une fois installés dans Visual Studio 2022, vous trouverez les modules de fusion redistribuables dans %VCINSTALLDIR%Redist\MSVC\v143\MergeModules. Dans la dernière version de Visual Studio 2019, les modules de fusion redistribuables se trouvent dans %VCINSTALLDIR%Redist\MSVC\v142\MergeModules. Dans Visual Studio 2019 et Visual Studio 2017, ils se trouvent également dans %VCToolsRedistDir%MergeModules. Dans Visual Studio 2015, ils se trouvent dans Program Files [(x86)]\Common Files\Merge Modules.

Installez les packages redistribuables

Les packages redistribuables Visual C++ installent et inscrivent toutes les bibliothèques Visual C++. Si vous en utilisez un, exécutez-le comme prérequis sur le système cible avant d’installer votre application. Nous vous recommandons d'utiliser ces packages pour les déploiements car ils permettent une mise à jour automatique des bibliothèques Visual C++. Pour obtenir un exemple d’utilisation de ces packages, consultez Procédure pas à pas : Déploiement d’une application Visual C++ à l’aide du package redistribuable Visual C++.

Chaque package Visual C++ Redistributable vérifie l’existence d’une version plus récente sur l’ordinateur. Si une version plus récente est trouvée, le package ne sera pas installé. Dans Visual Studio 2015 ou version ultérieure, les packages redistribuables affichent un message d’erreur indiquant que l’installation a échoué. Si un package est exécuté à l’aide de l’indicateur /quiet, aucun message d’erreur ne s’affiche. Dans les deux cas, une erreur est enregistrée par le programme d'installation de Microsoft, et un résultat d'erreur est retourné à l'appelant. Dans Visual Studio 2015 et versions ultérieures, vous pouvez éviter cette erreur en vérifiant dans le registre si une version plus récente est installée. Le numéro de la version actuellement installée est stocké dans la clé HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes\{x86|x64|arm64}. Le numéro de version est 14.0 pour Visual Studio 2015, 2017, 2019 et 2022, car la dernière version redistribuable est compatible en mode binaire avec les versions antérieures jusqu’à 2015. La clé est arm64, x86 ou x64 selon les versions de vcredist installées pour la plate-forme. (Vous devez vérifier sous la sous-clé Wow6432Node uniquement si vous utilisez Regedit pour afficher la version du package x86 installé sur une plate-forme x64.) Le numéro de version est stocké dans la valeur de chaîne REG_SZVersion et également dans l’ensemble des valeurs Major, Minor, Bld et RbldREG_DWORD. Pour éviter une erreur lors de l’installation, vous devez ignorer l’installation du package redistribuable si la version actuellement installée est plus récente.

Options de ligne de commande pour les packages redistribuables

Le Visual C++ Redistributable prend en charge plusieurs options de ligne de commande. Les options /?, /h ou /help affichent une boîte de dialogue contextuelle qui répertorie les options disponibles. Vous pouvez spécifier /install pour installer, /repair pour réparer ou /uninstall pour désinstaller le package redistribuable. L’option /layout copie le contenu complet du package redistribuable dans le répertoire actuel. Par défaut, le Redistributable installe son contenu et demande à l’utilisateur des informations et s’il souhaite redémarrer après l’installation. Vous pouvez spécifier l’option /passive, qui affiche la progression, mais ne nécessite aucune autre interaction de l’utilisateur. Vous pouvez également spécifier une option /quiet, qui n’affiche aucune interface utilisateur et ne nécessite aucune interaction de l’utilisateur. L’option /norestart supprime toute tentative de redémarrage. Par défaut, un fichier journal est créé dans %TEMP%. Vous pouvez utiliser /log filename.txt pour enregistrer les journaux dans un fichier spécifique.

Cette commande d’exemple installe le fichier redistribuable x64. Elle affiche la progression de l’installation, mais ne nécessite aucune interaction de l’utilisateur ni aucun redémarrage :

vc_redist.x64.exe /install /passive /norestart

Installez les modules de fusion redistribuables

Les modules de fusion redistribuables doivent être inclus dans le package Windows Installer (ou un package d’installation similaire) que vous utilisez pour déployer votre application. Pour plus d’informations, consultez Redistribution à l’aide de modules de fusion. Pour obtenir un exemple, consultez Procédure pas-à-pas : Déploiement d’une application Visual C++ à l’aide d’un projet d’installation.

Installer des fichiers redistribuables individuels

Il est également possible d’installer directement les DLL redistribuables dans le dossier local de l’application. Le dossier local de l’application est le dossier qui contient le fichier exécutable de votre application. Pour des raisons de maintenance, nous vous déconseillons d’utiliser cet emplacement d’installation.

Erreurs d’exécution potentielles

Si Windows ne parvient pas à trouver l’une des DLL de bibliothèque redistribuable requise par votre application, il peut afficher un message similaire à celui-ci : « Cette application n’a pas pu démarrer car library.dll n’a pas été trouvé. La réinstallation de l’application peut résoudre ce problème. »

Pour résoudre ce type d’erreur, assurez-vous que le programme d’installation de votre application est correctement compilé. Vérifiez que les bibliothèques redistribuables sont correctement déployées sur le système cible. Pour plus d’informations, consultez Fonctionnement des dépendances d’une application Visual C++.

Articles connexes

Redistribution à l’aide de modules de fusion
Décrit comment utiliser les modules de fusion Visual C++ Redistributable pour installer les bibliothèques d’exécution Visual C++ en tant que DLL partagées dans le dossier %windir%\system32\.

Redistribution des contrôles ActiveX Visual C++
Décrit comment redistribuer une application qui utilise les contrôles ActiveX.

Redistribution de la bibliothèque MFC
Décrit comment redistribuer une application qui utilise MFC.

Redistribution d’une application ATL
Décrit comment redistribuer une application qui utilise ATL. Dans Visual Studio 2012 et versions ultérieures, aucune bibliothèque ATL n’est requise.

Exemples de déploiement
Fournit des liens vers des exemples qui illustrent le déploiement d'applications Visual C++.

Déploiement d’applications de bureau
Présente les concepts et les technologies de déploiement de Visual C++.

Téléchargements redistribuables Visual C++ les plus récents pris en charge
Liens vers les derniers téléchargements Redistribuables Visual C++ pris en charge.