January 15, 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 see #3284 (comment) for details
- CEF now supports the Chromium Network Service: If you are upgrading from a version prior to
75.1.xplease make sure you read #2743. - Visual C++ 2015 or greater is required, see
Notesbelow for more information
Change Log
For a complete list of changes see the 87.1.x Milestone.
ℹ️ Notes
CefSharprequires a minimum ofVisual C++ 2015. See #1983 for details. You can bin deploy theVC++dependencies, read theFAQfor more details.VC++ 2017/2019are backwards compatible. For a list of files included in the packages see https://github.com/cefsharp/CefSharp/wiki/Output-files-description-table-%28Redistribution%29Chromiumhas removed support forWindows XP,Windows Vista,Windows Server 2003andWindows 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/Facebookwon't play video/audio. See #1479 for more info.MP3audio is supported,MP4video is not. - Anyone new to
CefSharpshould read the General Usage Guide - This project uses
GitLinkfor better debugging, you can step directly into much of the project source directly fromVisual Studiosee #1680 for details on how to enableGitLink
⚠️ Known Issues
WPFthe browser stops redrawing when running onIntel Iris Xe Integrated GPU(11th Gen). The issue has been reported to theWPFteam see dotnet/wpf#3817SpellCheckingnot working by default see https://bitbucket.org/chromiumembedded/cef/issues/3055/windows-spell-checker-not-working-add (the workaround will be applied by default in the final release)WinFormswhen running onWindows 10 Anniversarypressing certain key combinations freezes the browser see #1822 The issue has been reportedupstream, there are workarounds listed in #1822Save as PDFis 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-viewerWPFtouch scroll aborted if browser navigates within document https://bitbucket.org/chromiumembedded/cef/issues/2936/osr-touch-scrolling-initiated-by-touchFontsincorrectly loaded onWin7see 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.IgnoreCertificateErrorsno longer works, use theignore-certificate-errorscommand line arg as a workaround or alternatively useOnCertificateErrorto 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 Flashis now out of date and is blocked from loading as per the Chromium Flash RoadmapCefSettingsno longer implementsIDisposablesee #3220 for details- Move
IRenderHandler.OnCursorChangetoIDisplayHandler.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.dllhas been added
See #3319 for further details.
- For
Network Service APIchanges 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
RequestContextyou must ensure that RequestContextSettings.CachePath is equal to or a child of CefSettings.RootCachePath See #3111 (comment) for details