⚠️ Breaking Changes

• Core - Cancel pending tasks when browser crashed or v8 context gets released #5145

ℹ️ Notes

• You can bin deploy the Visual C++ dependencies, read the FAQ for more details.
• For a list of files included in the packages see Output files description table (Redistribution) Wiki
• Due to licensing issues default builds do not support proprietary codecs like H264/AAC, sites like Netflix/Twitter/Instagram/Facebook/Spotify/Apple Music won't play video/audio. See #1479 for more info. MP3 audio is supported, playing MP4 files are not supported.
• Anyone new to CefSharp should read the General Usage Guide
• This project uses Microsoft SourceLink for better debugging, you can step directly into much of the project source directly.

:x: Known Issues

• See https://github.com/cefsharp/CefSharp/issues/4795#issuecomment-2241756717 for some of the known issues after migrating to the Chrome bootstrap.
• See https://github.com/chromiumembedded/cef/issues for other known issues
• See https://github.com/cefsharp/CefSharp/issues?q=is%3Aissue+is%3Aopen+label%3Aknown-issue for other known issues

• 🛑 Upgrading from Alloy Bootstrap to Chrome bootstrap ignore cookies from the previous version as the encryption keys are likely different. See #4847 for possible workaround
• CEF now supports the Chromium process singleton, this brings with it changes to how CachePath/RootCachePath are accessed from multiple processes. See #4668 for more details
• 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 https://github.com/cefsharp/CefSharp/issues/3111#issuecomment-629713608 for details
• 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
• WPF the browser stops redrawing when running on Intel 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 https://github.com/dotnet/wpf/issues/3817 for workaround if you are unable to install the updated driver.