2013-04-12 01:07:43 +02:00
|
|
|
|
REDISTRIBUTION
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
This binary distribution contains the below components. Components listed under
|
|
|
|
|
the "required" section must be redistributed with all applications using CEF.
|
|
|
|
|
Components listed under the "optional" section may be excluded if the related
|
|
|
|
|
features will not be used.
|
|
|
|
|
|
2013-11-21 23:43:36 +01:00
|
|
|
|
Applications using CEF on OS X must follow a specific app bundle structure.
|
|
|
|
|
Replace "cefclient" in the below example with your application name.
|
|
|
|
|
|
|
|
|
|
cefclient.app/
|
|
|
|
|
Contents/
|
|
|
|
|
Frameworks/
|
|
|
|
|
Chromium Embedded Framework.framework/
|
|
|
|
|
Chromium Embedded Framework <= main application library
|
2018-07-30 22:15:19 +02:00
|
|
|
|
Libraries/
|
|
|
|
|
libEGL.dylib <= angle support libraries
|
|
|
|
|
libGLESv2.dylib <=^
|
|
|
|
|
libswiftshader_libEGL.dylib <= swiftshader support libraries
|
|
|
|
|
libswiftshader_libGLESv2.dylib <=^
|
2013-11-21 23:43:36 +01:00
|
|
|
|
Resources/
|
2014-07-08 00:17:33 +02:00
|
|
|
|
cef.pak <= non-localized resources and strings
|
|
|
|
|
cef_100_percent.pak <====^
|
|
|
|
|
cef_200_percent.pak <====^
|
2015-07-16 23:40:01 +02:00
|
|
|
|
cef_extensions.pak <=====^
|
2014-07-08 00:17:33 +02:00
|
|
|
|
devtools_resources.pak <=^
|
2014-02-05 21:35:45 +01:00
|
|
|
|
icudtl.dat <= unicode support
|
2017-09-06 23:40:58 +02:00
|
|
|
|
natives_blob.bin, snapshot_blob.bin, v8_context_snapshot.bin <= V8 initial snapshot
|
2013-11-21 23:43:36 +01:00
|
|
|
|
en.lproj/, ... <= locale-specific resources and strings
|
|
|
|
|
Info.plist
|
|
|
|
|
cefclient Helper.app/
|
|
|
|
|
Contents/
|
|
|
|
|
Info.plist
|
|
|
|
|
MacOS/
|
|
|
|
|
cefclient Helper <= helper executable
|
|
|
|
|
Pkginfo
|
|
|
|
|
Info.plist
|
|
|
|
|
MacOS/
|
|
|
|
|
cefclient <= cefclient application executable
|
|
|
|
|
Pkginfo
|
|
|
|
|
Resources/
|
|
|
|
|
binding.html, ... <= cefclient application resources
|
|
|
|
|
|
|
|
|
|
The "Chromium Embedded Framework.framework" is an unversioned framework that
|
|
|
|
|
contains CEF binaries and resources. Executables (cefclient, cefclient Helper,
|
2018-07-30 22:15:19 +02:00
|
|
|
|
etc) must load this framework dynamically at runtime instead of linking it
|
|
|
|
|
directly. See the documentation in include/wrapper/cef_library_loader.h for
|
|
|
|
|
more information.
|
2013-11-21 23:43:36 +01:00
|
|
|
|
|
2015-10-09 17:23:12 +02:00
|
|
|
|
The "cefclient Helper" app is used for executing separate processes (renderer,
|
|
|
|
|
plugin, etc) with different characteristics. It needs to have a separate app
|
2016-03-01 23:17:08 +01:00
|
|
|
|
bundle and Info.plist file so that, among other things, it doesn’t show dock
|
2015-10-09 17:23:12 +02:00
|
|
|
|
icons.
|
2013-11-21 23:43:36 +01:00
|
|
|
|
|
2013-04-12 01:07:43 +02:00
|
|
|
|
Required components:
|
|
|
|
|
|
2015-07-16 23:40:01 +02:00
|
|
|
|
The following components are required. CEF will not function without them.
|
2013-04-12 01:07:43 +02:00
|
|
|
|
|
2015-07-16 23:40:01 +02:00
|
|
|
|
* CEF core library.
|
|
|
|
|
* Chromium Embedded Framework.framework/Chromium Embedded Framework
|
2014-02-05 21:35:45 +01:00
|
|
|
|
|
2015-07-16 23:40:01 +02:00
|
|
|
|
* Unicode support data.
|
|
|
|
|
* Chromium Embedded Framework.framework/Resources/icudtl.dat
|
|
|
|
|
|
|
|
|
|
* V8 snapshot data.
|
|
|
|
|
* Chromium Embedded Framework.framework/Resources/natives_blob.bin
|
|
|
|
|
* Chromium Embedded Framework.framework/Resources/snapshot_blob.bin
|
2017-09-06 23:40:58 +02:00
|
|
|
|
* Chromium Embedded Framework.framework/Resources/v8_context_snapshot.bin
|
2014-12-13 21:18:31 +01:00
|
|
|
|
|
2013-04-12 01:07:43 +02:00
|
|
|
|
Optional components:
|
|
|
|
|
|
2015-07-16 23:40:01 +02:00
|
|
|
|
The following components are optional. If they are missing CEF will continue to
|
|
|
|
|
run but any related functionality may become broken or disabled.
|
|
|
|
|
|
|
|
|
|
* Localized resources.
|
|
|
|
|
Locale file loading can be disabled completely using
|
|
|
|
|
CefSettings.pack_loading_disabled.
|
|
|
|
|
|
|
|
|
|
* Chromium Embedded Framework.framework/Resources/*.lproj/
|
|
|
|
|
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" will be used. Without these files
|
|
|
|
|
arbitrary Web components may display incorrectly.
|
|
|
|
|
|
|
|
|
|
* Other resources.
|
|
|
|
|
Pack file loading can be disabled completely using
|
2013-04-12 01:07:43 +02:00
|
|
|
|
CefSettings.pack_loading_disabled.
|
|
|
|
|
|
2015-07-16 23:40:01 +02:00
|
|
|
|
* Chromium Embedded Framework.framework/Resources/cef.pak
|
|
|
|
|
* Chromium Embedded Framework.framework/Resources/cef_100_percent.pak
|
|
|
|
|
* Chromium Embedded Framework.framework/Resources/cef_200_percent.pak
|
|
|
|
|
These files contain non-localized resources used by CEF, Chromium and Blink.
|
|
|
|
|
Without these files arbitrary Web components may display incorrectly.
|
|
|
|
|
|
|
|
|
|
* Chromium Embedded Framework.framework/Resources/cef_extensions.pak
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
* Chromium Embedded Framework.framework/Resources/devtools_resources.pak
|
|
|
|
|
This file contains non-localized resources required for Chrome Developer
|
|
|
|
|
Tools. Without this file Chrome Developer Tools will not function.
|
|
|
|
|
|
2018-07-30 22:15:19 +02:00
|
|
|
|
* Angle support.
|
|
|
|
|
* Chromium Embedded Framework.framework/Libraries/libEGL.dylib
|
|
|
|
|
* Chromium Embedded Framework.framework/Libraries/libGLESv2.dylib
|
|
|
|
|
Without these files HTML5 accelerated content like 2D canvas, 3D CSS and WebGL
|
|
|
|
|
will not function.
|
|
|
|
|
|
|
|
|
|
* SwiftShader support.
|
|
|
|
|
* Chromium Embedded Framework.framework/Libraries/libswiftshader_libEGL.dylib
|
|
|
|
|
* Chromium Embedded Framework.framework/Libraries/libswiftshader_libGLESv2.dylib
|
|
|
|
|
Without these files WebGL will not function in software-only mode when the GPU
|
|
|
|
|
is not available or disabled.
|