Skip to content

Compare: Frequently asked questions

New page
Showing with 22 additions and 8 deletions.
  1. +22 −8 Frequently-asked-questions.md
30 changes: 22 additions & 8 deletions Frequently-asked-questions.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -141,11 +141,22 @@ Older version do not support the `WPF` designer this is unfortunate, and a conse

#### 6. How do I include the [Visual Studio C++ 2012/2013 redistributables](http://support.microsoft.com/kb/2019667) on the target app?

`CefSharp` requires the `VC++ Runtime`. You have a few options for installing/including this with your app:
`CefSharp` requires the `Microsoft VC++ Runtime`.

- You can install `VC++` on every machine on which you wish to run your `CefSharp` based application. Once installed updates can then be managed via `Windows Update`.
- You can either set the `Visual Studio C++` redistributables as pre-requisites of the installer (i.e. ClickOnce or WiX Toolset)
- By copying over to your project the contents of this folder (Only present if you have the matching version of Visual Studio installed):
| CefSharp Version | VC++ Version | .Net Version |
|--------------------------------------|--------------|--------------|
| 64.0.0 and above | 2015 | 4.5.2 |
| 51.0.0 to 63.0.0 | 2013 | 4.5.2 |
| 45.0.0 to 49.0.0 | 2013 | 4.0.0 |
| 43.0.0 and below | 2012 | 4.0.0 |

For `Microsoft's` official guide see [Redistributing Visual C++ Files](https://msdn.microsoft.com/en-us/library/ms235299.aspx) on `MSDN`. To download visit [Visual Studio C++ 2012/2013/2015 redistributables](http://support.microsoft.com/kb/2019667)

A brief summary of your options for installing/including `VC++` with your application are:

- Install the `Microsoft Visual C++ Redistributable Package` on every machine on which you wish to run your `CefSharp` based application. Once installed updates can then be managed via `Windows Update`.
- You can either set the `Visual Studio C++` redistributables as pre-requisites of the installer (i.e. ClickOnce or WiX Toolset)
- Copying over to your project the contents of this folder (Only present if you have the matching version of Visual Studio installed on your computer):

```
# For VC++ 2012 (x86)
Expand All @@ -157,13 +168,16 @@ C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\redist\x64\Microsoft.VC11
C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\redist\x86\Microsoft.VC120.CRT
# For VC++ 2013 (x64)
C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\redist\x64\Microsoft.VC120.CRT
```
With the 3rd approach you won't need to install the prerequisite `Visual C++ 2012/2013 Runtime Files` to your client. For the time being the plan is to stay on VC2013 for official CefSharp binary releases. We might switch to VC2015 when feasible. If you build your own from source what you deploy of course has to match your build environment. For the official `Nuget` releases see the [Releases Branches](https://github.com/cefsharp/CefSharp#release-branches) table for details.
# For VC++ 2015 (x86)
C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist\x86\Microsoft.VC140.CRT
# For VC++ 2015 (x64)
C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist\x64\Microsoft.VC140.CRT
```

For more information see the [Redistributing Visual C++ Files](https://msdn.microsoft.com/en-us/library/ms235299.aspx) on `MSDN`. To download visit [Visual Studio C++ 2012/2013 redistributables](http://support.microsoft.com/kb/2019667)
With the 3rd approach you won't need to install the prerequisite `Visual C++ 2012/2013/2015 Runtime Files` to your client. If you build your own from source what you deploy of course has to match your build environment. For the official `Nuget` releases see the [Releases Branches](https://github.com/cefsharp/CefSharp#release-branches) table for details.

A new option is `JetBrains` have a [Microsoft.VC120.CRT.JetBrains](https://www.nuget.org/packages/Microsoft.VC120.CRT.JetBrains/12.0.21005.2) package on `Nuget.org`, appears to include the relevant files, you would still need to hook up some sort of post build task to copy them to your bin folder.
For `VC++ 2013` `JetBrains` have a [Microsoft.VC120.CRT.JetBrains](https://www.nuget.org/packages/Microsoft.VC120.CRT.JetBrains/12.0.21005.2) package on `Nuget.org`, appears to include the relevant files, you would still need to hook up some sort of post build task to copy them to your bin folder.

**Note** When building from source make sure you compile in `Release` mode when deploying to machines that don't have `Visual Studio` installed. `Visual C++` uses a different set of run-time libraries for Debug and Release builds. The `Debug` run-time libraries are only installed with `Visual Studio`. If you use the official `Nuget packages` they're already built in `Release` mode and you can subsequently build your app in debug mode as only the `Visual C++` projects need to be compiled in `Release` mode.

Expand Down
Back to top