August 26, 2020, CEF 84.4.1+gfdc7504+chromium-84.0.4147.105 / Chromium 84.0.4147.105
CEF
now supports the Chromium Network Service
which brings a huge number of breaking API
changes, please make sure you read #2743 for details if you are upgrading from a version prior to 75.1.x
.
Visual C++ 2015
or greater is required, see Notes
below for more information
Change Log
For a complete list of changes see the 84.4.x Milestone.
Notes
CefSharp
requires a minimum ofVisual C++ 2015
. See #1983 for details. You can bin deploy theVC++
dependencies, read theFAQ
for more details.VC++ 2017/2019
are backwards compatible.Chromium
has removed support forWindows XP
,Windows Vista
,Windows Server 2003
andWindows Server 2008
. See https://chrome.googleblog.com/2015/11/updates-to-chrome-platform-support.html- Starting in June 2019 Google will block logins from CEF based browsers to Google Services, this includes Gmail, Drive, Docs, see https://security.googleblog.com/2019/04/better-protection-against-man-in-middle.html?m=1 for further discussion see https://groups.google.com/a/chromium.org/d/msg/embedder-dev/STyM5ZNTHMM/POj1v_cqBgAJ
- Due to licensing issues default builds do not support proprietary codecs like
H264/AAC
, sites likeNetflix/Twitter/Instagram/Facebook
won't play video/audio. See #1479 for more info.MP3
audio is supported,MP4
video is not. - Anyone new to
CefSharp
should read the General Usage Guide - This project uses
GitLink
for better debugging, you can step directly into much of the project source directly fromVisual Studio
see #1680 for details on how to enableGitLink
WPF
now has touch support which is enabled by default. Support for Stylus is not enabled by default, see #228 (comment) for further details
Known Issues
WPF
there is some visible tearing/glitches on resize,GPU Compositing
has been disabled by default as a workaround #3114WinForms
when running onWindows 10 Anniversary
pressing certain key combinations freezes the browser see #1822 The issue has been reportedupstream
, there are workarounds listed in #1822Save as PDF
is not working when viewing PDF with Print Preview enabled see https://bitbucket.org/chromiumembedded/cef/issues/2867/save-as-pdf-is-not-working-in-pdf-viewer- WPF/OffScreen transparent background not working https://bitbucket.org/chromiumembedded/cef/issues/2938/osr-transparent-background-broken-since
WPF
touch scroll aborted if browser navigates within document https://bitbucket.org/chromiumembedded/cef/issues/2936/osr-touch-scrolling-initiated-by-touchFonts
incorrectly loaded onWin7
see https://bitbucket.org/chromiumembedded/cef/issues/2858/fonts-not-loading-look-wrong-on-windows-7window.focus()
does not bring popup window to front see https://bitbucket.org/chromiumembedded/cef/issues/2931/windowfocus-does-not-bring-the-window-to- OnProtocolExecution Page goes blank after link click see https://bitbucket.org/chromiumembedded/cef/issues/2715/onprotocolexecution-page-goes-blank-after
- Crash on Win10 when computer wakes from sleep see https://bitbucket.org/chromiumembedded/cef/issues/2924/crash-on-libcef-when-windows-10-wakes-from
- Background colour cannot be override for popups see https://bitbucket.org/chromiumembedded/cef/issues/2482/background_color-cannot-be-overridden-for
- WPF Browser goes blank if used in combination with TabControl see #2779
CefSettings.IgnoreCertificateErrors
no longer works, use theignore-certificate-errors
command line arg as a workaround or alternatively useOnCertificateError
to selectively allow a certificate and/or display a dialog to your users see https://stackoverflow.com/a/35564187/852806 for an example.- See https://bitbucket.org/chromiumembedded/cef/issues?status=new&status=open for other known issues
- See https://github.com/cefsharp/CefSharp/issues?q=is%3Aissue+is%3Aopen+label%3Aknown-issue for other known issues
Breaking Changes
- For
Network Service API
changes see #2743 - All paths (CachePath, BrowserSubProcessPath, etc) must be absolute paths, if using a non-absolute path an exception will be throw. See #3102 for details.
- When using a
RequestContext
you must ensure that RequestContextSettings.CachePath is equal to or a child of CefSettings.RootCachePath See #3111 (comment) for details Adobe Flash
is disabled by default, it can be re-enabled if required #3048
(Flash support is scheduled to be removed from Chromium)- Migrating from ResourceHandler.GetMimeType to Cef.GetMimeType for mimeType mapping see #3041
- PdfPrintSettings.MarginTop/MarginLeft/MarginRight/MarginBottom changed from double to int to match the CEF API #3196
- See also https://github.com/cefsharp/CefSharp/issues?q=is%3Aissue+label%3Abreaking-change+milestone%3A83.3.x+is%3Aclosed