Walkthrough: Deploy a Visual C++ application by using the Visual C++ Redistributable Package

To run apps that use Visual C++ runtime libraries, the target machine must have a compatible Microsoft Visual C++ Redistributable Package installed. This step-by-step article describes one way to deploy both the Microsoft Visual C++ Redistributable Package and your Visual C++ application. You can use any installer technology to deploy your app. This walkthrough uses the IExpress Wizard to create a self-extracting executable installer that installs the Redistributable and an application.

Prerequisites

You must have these components to complete this walkthrough:

  • A computer that has Visual Studio installed.

  • Another computer that doesn't have the Visual C++ libraries.

To use the Microsoft Visual C++ Redistributable Package to deploy an application

  1. If you need a sample application to deploy, create and build an MFC application by following the steps in Walkthrough: Deploying a Visual C++ application by using a setup project. This walkthrough assumes your app is named MyMFCApp like the sample, but you can change the name to match your app.

  2. Create a file, name it setup.bat, and add the following commands to it. If your app has a different name, change MyMFCApp to the name of your app. If your app targets x86, change "Program Files" to "Program Files (x86)". Remove the leading colons (::) to uncomment the line that installs the Redistributable for your target architecture.

    @echo off
    REM Choose one of the following Redistributable files to install
    ::vc_redist.x86.exe    REM remove leading :: to install Redistributable for x86
    ::vc_redist.x64.exe    REM remove leading :: to install Redistributable for x64
    ::vc_redist.arm64.exe  REM remove leading :: to install Redistributable for ARM64
    mkdir "C:\Program Files\MyMFCApp"
    copy MyMFCApp.exe "C:\Program Files\MyMFCApp"
    
  3. Create a self-extracting setup file:

    1. At a command prompt or in the Run window, run iexpress.exe.

    2. Select Create new Self Extraction Directive file and then choose the Next button.

    3. Select Extract files and run an installation command and then choose Next.

    4. In the text box, enter the name of your app and then choose Next.

    5. On the Confirmation prompt page, select No Prompt and then choose Next.

    6. On the License agreement page, select Do not display a license and then choose Next.

    7. On the Packaged files page, add the following files and then choose Next.

      • Your app (.exe file).

      • The Redistributable for your app's target architecture. We recommend you download the latest supported Redistributable file from Microsoft for your deployment. You can also deploy the Redistributable file found in your Visual Studio installation. In Visual Studio 2015, this file is called vcredist_x86.exe, vcredist_x64.exe, or vcredist_arm.exe and is located in %VCINSTALLDIR%redist\1033\. In Visual Studio 2017 and later, this file is called vc_redist.x86.exe, vc_redist.x64.exe, or vc_redist.arm64.exe and is located in %VCToolsRedistDir%.

      • The setup.bat file that you created in the earlier step.

    8. On the Install Program to Launch page, in the Install Program text box, enter the following command line, and then choose Next.

      cmd.exe /c "setup.bat"

    9. On the Show window page, select Default and then choose Next.

    10. On the Finished message page, select No message. Choose Next.

    11. On the Package Name and Options page, enter a name for your self-extracting setup file, select the Store files using Long File Name inside Package option, and then choose Next. The end of the file name must be Setup.exe—for example, MyMFCAppSetup.exe.

    12. On the Configure restart page, select No restart. Choose Next.

    13. On the Save Self Extraction Directive page, select Save Self Extraction Directive (SED) file. Choose Next.

    14. On the Create package page, choose Next. Choose Finish.

  4. Test the self-extracting setup file on the other computer that doesn't have the Visual C++ libraries:

    1. On the other computer, download a copy of the setup file. Then, run the setup and follow the steps that it provides. Depending on the options selected, installation might require you to accept a User Account Control elevation request, or to run the installer by using the Run as administrator command.

    2. Run the app.

      The self-extracting setup file installs the app that's in the folder you specified in setup.bat. The app should run successfully because the Microsoft Visual C++ Redistributable Package installer is included in the self-extracting setup file.

      Important

      To determine which version of the runtime is installed, the installer checks the registry key \HKLM\SOFTWARE\Microsoft\VisualStudio\<version>\VC\Runtimes\<platform>\Version. If the currently installed version is newer than the version that the installer is attempting to install, the installer returns success without installing the older version and leaves an additional entry on the installed programs page in the Control Panel.

See also

Deployment examples