Skip to content

Output files description table (Redistribution)

Alex Maitland edited this page Apr 14, 2020 · 51 revisions

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:

NOTE:

  • Scrollbars will be red without cef_100_percent.pak or cef_200_percent.pak (depending on your DPI). 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.

Visual C++

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 Framework

.Net 4.5.2 or greater is required