January 09, 2021, CEF 87.1.13+g481a82a+chromium-87.0.4280.141 / Chromium 87.0.4280.141
- Adobe Flash is no longer supported as per the Chromium Flash Roadmap
- ⚠️ Nuget Packages have been restructured please make sure you read #3319 for details
- Net Core 3.1/Net 5 packages are now available for testing.
- CEF now supports the Chromium Network Service: If you are upgrading from a version prior to
75.1.x
please make sure you read #2743. - Visual C++ 2015 or greater is required, see
Notes
below for more information
Change Log
For a complete list of changes see the 87.1.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. For a list of files included in the packages see https://github.com/cefsharp/CefSharp/wiki/Output-files-description-table-%28Redistribution%29Chromium
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
⚠️ Known Issues
WPF
the browser stops redrawing when running onIntel Iris Xe Integrated GPU(11th Gen)
. The issue has been reported to theWPF
team see dotnet/wpf#3817WinForms
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-viewerWPF
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 ⚠️
Adobe Flash
is now out of date and is blocked from loading as per the Chromium Flash RoadmapCefSettings
no longer implementsIDisposable
see #3220 for details- Move
IRenderHandler.OnCursorChange
toIDisplayHandler.OnCursorChange
#3275 - The following arch specific (x86/x64) dlls have been converted to AnyCPU:
- CefSharp.dll
- CefSharp.WinForms.dll
- CefSharp.Wpf.dll
- CefSharp.OffScreen.dll
CefSharp.Core.Runtime.dll
has been added
See #3319 for further details.
- 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