111 lines
4.5 KiB
Plaintext
111 lines
4.5 KiB
Plaintext
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.
|
||
|
||
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
|
||
Resources/
|
||
cef.pak <= non-localized resources and strings
|
||
cef_100_percent.pak <====^
|
||
cef_200_percent.pak <====^
|
||
cef_extensions.pak <=====^
|
||
devtools_resources.pak <=^
|
||
crash_inspector, crash_report_sender <= breakpad support
|
||
icudtl.dat <= unicode support
|
||
natives_blob.bin, snapshot_blob.bin <= V8 initial snapshot
|
||
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,
|
||
etc) are linked to the "Chromium Embedded Framework" library using
|
||
install_name_tool and a path relative to @executable_path.
|
||
|
||
The "cefclient Helper" app is used for executing separate processes (renderer,
|
||
plugin, etc) with different characteristics. It needs to have a separate app
|
||
bundle and Info.plist file so that, among other things, it doesn’t show dock
|
||
icons.
|
||
|
||
Required components:
|
||
|
||
The following components are required. CEF will not function without them.
|
||
|
||
* CEF core library.
|
||
* Chromium Embedded Framework.framework/Chromium Embedded Framework
|
||
|
||
* 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
|
||
|
||
Optional components:
|
||
|
||
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
|
||
CefSettings.pack_loading_disabled.
|
||
|
||
* 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.
|
||
|
||
* Breakpad support.
|
||
* Chromium Embedded Framework.framework/Resources/crash_inspector
|
||
* Chromium Embedded Framework.framework/Resources/crash_report_sender
|
||
* Chromium Embedded Framework.framework/Resources/Info.plist
|
||
Without these files breakpad support (crash reporting) will not function.
|
||
|
||
* Widevine CDM support.
|
||
* widevinecdmadapter.plugin
|
||
Without this file playback of Widevine projected content will not function.
|
||
See the CefRegisterWidevineCdm() function in cef_web_plugin.h for usage.
|