2015-01-27 12:43:47 +10:00
CefSharp Nuget Package
2015-02-24 23:16:56 +10:00
Background:
2015-04-26 08:02:30 +10:00
CefSharp is a .Net wrapping library for CEF (Chromium Embedded Framework) https://bitbucket.org/chromiumembedded/cef
2015-02-24 23:16:56 +10:00
CEF is a C/C++ library that allows developers to embed the HTML content rendering strengths of Google's Chrome open source WebKit engine (Chromium).
2015-02-24 01:34:36 -05:00
2015-02-24 23:16:56 +10:00
Post Installation:
2023-01-13 05:53:05 +10:00
- Add an app.manifest to your exe if you don't already have one, it's required for Windows 10 compatability, GPU detection, HighDPI support and tooltips. The https://github.com/cefsharp/CefSharp.MinimalExample project contains an example app.manifest file in the root of the WPF/WinForms/OffScreen examples.
2020-12-16 13:13:01 +10:00
- For `x86` or x64` set your projects PlatformTarget architecture to `x86` or `x64`.
2018-07-17 14:54:04 +10:00
- `AnyCPU` target is supported though requires additional code/changes see https://github.com/cefsharp/CefSharp/issues/1714 for details.
2023-01-13 05:53:05 +10:00
- Read the release notes for your version https://github.com/cefsharp/CefSharp/releases (Any known issues will be listed here)
- Read the `Need to know/limitations` section of the General usage guide (https://github.com/cefsharp/CefSharp/wiki/General-Usage#need-to-knowlimitations)
2015-02-24 23:16:56 +10:00
- Check your output `\bin` directory to make sure the appropriate references have been copied.
2015-03-05 09:24:08 +10:00
2016-02-22 08:09:02 +10:00
Deployment:
2021-09-03 10:51:18 +10:00
- Make sure a minimum of `Visual C++ 2019` is installed (`x86` or x64` depending on your build) or package the runtime dlls with your application, see the FAQ for details.
2016-02-22 08:09:02 +10:00
2015-03-05 09:24:08 +10:00
What's New:
2023-01-13 05:53:05 +10:00
See https://github.com/cefsharp/CefSharp/releases
IMPORTANT NOTE - Visual C++ 2019 or greater is required
IMPORTANT NOTE - .NET Framework 4.5.2 or greater is required.
IMPORTANT NOTE - Chromium support for Windows 7/8/8.1 ends with version 109, starting with version 110 a minimum of Windows 10 is required.
2015-01-27 12:43:47 +10:00
2015-02-24 23:16:56 +10:00
Basic Troubleshooting:
2016-06-01 07:21:16 +10:00
- Minimum of .Net 4.5.2
2021-09-03 10:51:18 +10:00
- Minimum of `Visual C++ 2019 Redist` is installed (either `x86` or `x64` depending on your application).
2015-02-24 23:16:56 +10:00
- Please ensure your binaries directory contains these required dependencies:
2021-02-26 13:23:47 +10:00
* libcef.dll (Chromium Embedded Framework Core library)
2015-02-24 01:34:36 -05:00
* icudtl.dat (Unicode Support data)
2021-02-26 13:23:47 +10:00
* chrome_elf.dll(Crash reporting library)
* snapshot_blob.bin, v8_context_snapshot.bin (V8 snapshot data)
2022-05-24 15:13:31 +10:00
* locales\en-US.pak, chrome_100_percent.pak, chrome_200_percent.pak, resources.pak, d3dcompiler_47.dll, libEGL.dll, libGLESv2.dll
2021-02-26 13:23:47 +10:00
- Whilst these are technically listed as optional, the browser is unlikely to function without these files.
- See https://github.com/cefsharp/CefSharp/wiki/Output-files-description-table-%28Redistribution%29 for details
* CefSharp.Core.dll, CefSharp.dll, CefSharp.Core.Runtime.dll
2015-02-24 01:34:36 -05:00
CefSharp.BrowserSubprocess.exe, CefSharp.BrowserSubProcess.Core.dll
- These are required CefSharp binaries that are the common core logic binaries of CefSharp.
2021-02-26 13:23:47 +10:00
* One of the following UI presentation libraries:
2015-02-24 01:34:36 -05:00
* CefSharp.WinForms.dll
* CefSharp.Wpf.dll
2015-02-24 23:16:56 +10:00
* CefSharp.OffScreen.dll
2021-02-26 13:23:47 +10:00
- Additional CEF files are described at: https://github.com/cefsharp/CefSharp/wiki/Output-files-description-table-%28Redistribution%29
2021-09-03 10:51:18 +10:00
- NOTE: CefSharp does not currently support CEF sandboxing.
2016-10-20 19:42:32 +10:00
- By default `CEF` has it's own log file, `Debug.log` which is located in your executing folder. e.g. `bin`
2015-01-27 12:43:47 +10:00
2015-02-24 01:34:36 -05:00
For further help please read the following content:
2023-01-13 05:53:05 +10:00
- Quick Start https://github.com/cefsharp/CefSharp/wiki/Quick-Start
2017-01-16 11:18:33 +10:00
- General Usage Guide https://github.com/cefsharp/CefSharp/wiki/General-Usage
2016-12-13 23:53:21 +10:00
- Minimal Example Projects showing the browser in action (https://github.com/cefsharp/CefSharp.MinimalExample)
2015-02-24 23:16:56 +10:00
- CefSharp GitHub https://github.com/cefsharp/CefSharp
- CefSharp's Wiki on github (https://github.com/cefsharp/CefSharp/wiki)
- FAQ: https://github.com/cefsharp/CefSharp/wiki/Frequently-asked-questions
- Troubleshooting guide (https://github.com/cefsharp/CefSharp/wiki/Trouble-Shooting)
- CefSharp vs Cef (https://github.com/cefsharp/CefSharp/blob/master/CONTRIBUTING.md#cefsharp-vs-cef)
2023-01-13 05:53:05 +10:00
- Got a question? Ask it on GitHub Discussions (https://github.com/cefsharp/CefSharp/discussions)
- If you have a reproducible bug then please open an issue on `GitHub` making sure to complete the bug report template.
2015-01-27 12:43:47 +10:00
Please consider giving back, it's only with your help will this project to continue.
2023-01-13 05:53:05 +10:00
Sponsor the project via GitHub sponsors (https://github.com/sponsors/amaitland)
2015-01-27 12:43:47 +10:00
Regards,
2023-01-13 05:53:05 +10:00
Alex Maitland