June 17, 2021, CEF 91.1.16+gc95b2a1+chromium-91.0.4472.101 / Chromium 91.0.4472.101
- ⚠️ Nuget Packages have been restructured if upgrading from version prior to 87 please make sure you read #3319 for details
- 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. - For
CefSharp.Wpf.NetCore/CefSharp.WinForms.NetCore/CefSharp.OffScreen.NetCore
nuget packages then Visual C++ 2019 is required, - For
CefSharp.Wpf/CefSharp.WinForms/CefSharp.OffScreen
nuget packages then Visual C++ 2015 or greater is required, seeNotes
below for more information
Change Log
There are a number of upstream
breaking changes included in this release.
The following resources have been removed in version 90, anyone upgrading from a prior version be aware:
cef.pak,
cef_100_percent.pak,
cef_200_percent.pak,
cef_extensions.pak,
devtools_resources.pak
They have been replaced by:
chrome_100_percent.pak,
chrome_200_percent.pak,
resources.pak
For a list of changes see the 91.1.x Milestone. See also Release Notification.
ℹ️ Notes
WPF
the browser stops redrawing when running onIntel Iris Xe Integrated GPU(11th Gen)
.Intel
have released an updated driver, see https://www.intel.com/content/www/us/en/support/articles/000058136/graphics/graphics-for-11th-generation-intel-processors.html See dotnet/wpf#3817 for workaround if you are unable to install the updated driver.- Adobe Flash is no longer supported as per the Chromium Flash Roadmap
- SSE3 is now required on x86 processors (see https://crbug.com/1123353)
- For
CefSharp.Wpf.NetCore/CefSharp.WinForms.NetCore/CefSharp.OffScreen.NetCore
nuget packages then Visual C++ 2019 is required, - For
CefSharp.Wpf/CefSharp.WinForms/CefSharp.OffScreen
nuget packages then Visual C++ 2015 or greater is required, seeNotes
below for more information - You can bin deploy the
VC++
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%29 - 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/Spotify/Apple Music
won't play video/audio. See #1479 for more info.MP3
audio is supported, playingMP4
files are not supported. - 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
CEF
creates aDownload
directory in the User Directory see https://bitbucket.org/chromiumembedded/cef/issues/3094/cef-force-creates-a-donwloads-directory-inWinForms
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
Cef.AddCrossOriginWhitelistEntry
doesn't work correctly see https://bitbucket.org/chromiumembedded/cef/issues/2918/cefaddcrossoriginwhitelistentry-not-fully- 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 ⚠️
- Rename CefSettings.ProductVersion to CefSettings.UserAgentProduct [#3530]
- Remove CefSharpSettings.LegacyJavascriptBindingEnabled [#3531]
- Update CefThreadIds enum [#3597]
- Update IAudioHandler to implement IDisposable [#3598]
Adobe Flash
has been removed as per the Chromium Flash Roadmap- 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