-
-
Notifications
You must be signed in to change notification settings - Fork 2.9k
Output files description table (Redistribution)
List of CEF/CefSharp required and optional resources. The Nuget packages copy both the required and optional files to your bin directory by default.
It's important to note that whilst some of these files are officially classed as optional specific features won't run without them. It is recommended to redistribute all files with your application to avoid potential problems.
CefSharp Required Resources
The follow are required by CefSharp. |
|||
Filename | Required | Description | Version |
---|---|---|---|
CefSharp.BrowserSubprocess.exe | Yes | Browser SubProcess executable | All |
CefSharp.BrowserSubprocess.Core.dll | Yes | Browser SubProcess core dll | All |
CefSharp.Core.dll | Yes | Core library for CefSharp | All |
CefSharp.dll | Yes | Core library for CefSharp | All |
CefSharp.Wpf.dll | Required if you installed the CefSharp.Wpf Nuget package | All | |
CefSharp.WinForms.dll | Required if you installed the CefSharp.WinForms Nuget package | All | |
CefSharp.OffScreen.dll | Required if you installed the CefSharp.OffScreen Nuget package | All | |
CEF/Chromium Required Resources:
The following components are required. CEF will not function without them. |
|||
Filename | Required | Description | Version |
libcef.dll | Yes | CEF core library | All |
chrome_elf.dll | Yes | Crash reporting library | All |
icudtl.dat | Yes | Unicode support data | All |
natives_blob.bin | Yes | V8 snapshot data | All |
snapshot_blob.bin | Yes | All | |
v8_context_snapshot.bin | Yes | All | |
CEF Optional resources:
The following components are optional. If they are missing CEF will continue to run but any related functionality may become broken or disabled. |
|||
Filename | Required | Description | Version |
locales\*.pak | No |
Locales**
Locale file loading can be disabled completely using CefSettings.PackLoadingDisabled. The locales directory path can be customized using CefSettings.LocalesDirPath. Directory containing localized resources used by CEF, Chromium and Blink. A .pak file is loaded from this directory based on the CefSettings.Locale value. Only configured locales need to be distributed. If no locale is configured the default locale of "en-US" will be used. Without these files arbitrary Web components may display incorrectly. |
All |
cef.pak | No | These files contain non-localized resources used by CEF, Chromium and Blink. Without these files arbitrary Web components may display incorrectly. | All |
cef_100_percent.pak | No | All | |
cef_200_percent.pak | No | All | |
cef_extensions.pak | No | This file contains non-localized resources required for extension loading. Pass the `--disable-extensions` command-line flag to disable use of this file. Without this file components that depend on the extension system, such as the PDF viewer, will not function. | All |
devtools_resources.pak | No | This file contains non-localized resources required for Chrome Developer Tools. Without this file Chrome Developer Tools will not function. | All |
d3dcompiler_47.dll | No |
Angle and Direct3D support.
Without these files HTML5 accelerated content like 2D canvas, 3D CSS and WebGL will not function. |
All |
libEGL.dll | No | All | |
libGLESv2.dll | No | All | |
swiftshader\libEGL.dll | No |
SwiftShader support
Without these files WebGL will not function in software-only mode when the GPU is not available or disabled. |
All |
swiftshader\libGLESv2.dll | No | All |
This list might be out of date or incomplete, for further reference see:
- Scrollbars will be red without
cef_100_percent.pak
orcef_200_percent.pak
(depending on yourDPI
). If you disable pak loading you will also have the same problem. - ** Locales are conditionally required, features like context menus will show empty items without them. Fonts may show smaller than they should. The
CEF
documentation on the subject states: Without these files arbitrary Web components may display incorrectly.
You will need at a minimum Visual C++ Redistributable Packages for Visual Studio 2015. VC++ 2017/2019 are backwards compatible, if you are either installed that will be sufficient.
VC++
is distributed in both x86
and x64
variants, make sure you install the version matching your target architecture. (i.e. when targeting x86, x86 redistributable packages are needed).
.Net 4.5.2
or greater is required