chromelyapps/Chromely

📋 Changes

• Upgrade to v5.1 - https://github.com/chromelyapps/Chromely/issues/225.
• Fixes for Fullscreen/Kiosk modes - https://github.com/chromelyapps/Chromely/commit/b383c3f6e165895f8a216e50ba551a6e26c0a65a
• Adding a configurable option - UseOnlyCefMessageLoop - https://github.com/chromelyapps/Chromely/commit/df44870ad1928fb95badae7b8c4be7c65f4d5b92

📦 Overview

• [Projects Structure](#projects)
• [New Features](#features)
• [Fixes](#fixes)
• [Deprecation & Discontinued](#discontinued)
• [Quick migration guide](#migration)
• <a name="projects"/>

📦 Projects Structure

• All projects are now .NET Standard 2.0
• Chromely.Core - no dependencies.
• Chromely.CefGlue - depends on Chromely.Core and embeds CefGlue source code and CefGlue default handlers.
• Chromely - primary - depends on Chromely.CefGlue and includes native gui implementation for Win, Linux and MacOS. All other non-CefGlue customization will be done here.
• <a name="features"/>

✨ New Features

• MacOS support using native Cocoa API
• Full IOC - https://github.com/chromelyapps/Chromely/pull/106
• MVC- styled controller actions as discussed in https://github.com/chromelyapps/Chromely/issues/91
• [LitJson](https://github.com/LitJSON/litjson) was replaced by [System.Text.Json](https://www.nuget.org/packages/System.Text.Json/).
• Optional configuration file - [chromelyconfig.json](https://github.com/chromelyapps/demo-projects/blob/master/regular-chromely/CrossPlatDemo/chromelyconfig.json)
• Storable App/User settings - [IChromelyAppSettings](https://github.com/chromelyapps/Chromely/blob/master/src/Chromely.Core/IChromelyAppSettings.cs).
• Configuration has received a facelift, see migration guide below for more info.
• <a name="fixes"/>

🐛 Fixes

• Fixed WinAPIHost not respecting WindowTitle (Windows)
• ToolTips (html-title) working and positioned correctly. (Linux)
• <a name="discontinued"/>

🗑️ Deprecation & Discontinued

• Winapi was removed in favour of .NET Core 3. Win32 pinvoke functionalities will be sourced in [pinvoke.net](https://www.pinvoke.net/), [shintadono's Win32](https://github.com/shintadono/Win32) and other MIT licensed projects.
• CefSharp is no longer supported.
• Default Sup-process was removed for Windows. Sub-process is configurable and developers who need it can include sub-process fullpath in configuration.
• Real-time with Websocket server was removed.
• <a name="migration"/>

📦 Quick migration Guide

• This guide provides an introduction to Chromely 5 and a set of guidelines to migrate from v4.x to v5.x.
• [Important upgrade information](#migrateInfo)
• [Setting up a Chromely application](#migrateSetup)
• [Configuring a Chromely application](#migrateConfig)
• <a name="migrateInfo"/>

📦 Important upgrade information

• Chromely removed the support for CefSharp, existing CefSharp projects will need to be migrated to CefGlue.
• A Chromely project now requires either .NET Core 3.0 or .NET Framework 4.6.1 and above.
• <a name="migrateSetup"/>

📦 Setting up a Chromely application

• Chromely v4 (before)
• ```csharp
• class Program
• {
• static int Main(string[] args)
• {
• var startUrl = "https://google.com";
• var config = ChromelyConfiguration
• + 29 more

📦 Configuring a Chromely application

• Please see the wiki article about [Configuration](https://github.com/chromelyapps/Chromely/wiki/configuration) for other solutions on how to configure Chromely.
• ```csharp
• using Chromely.Core;
• using Chromely.Core.Configuration;
• namespace My_Chromely_App
• {
• class Program
• {
• + 20 more

📋 Changes

• Breaking changes! - ChromelyConfiguration.Create() browser window creation - https://github.com/chromelyapps/Chromely#creating-a-simple-app-using-cefglue-with-winapi-host.
• Added ChromelyConfiguration options - WithLoadingCefBinariesIfNotFound, WithFramelessHost.
• Added configurable Runtime CEF binaries downloader with WithLoadingCefBinariesIfNotFound.
• Added frameless window configurable with WithFramelessHost.

📋 Changes

• ChromelyConfiguration is now Singleton - only one instance per Chromely app.
• Breaking changes! - More info - https://github.com/mattkol/Chromely/wiki/Upgrade-to-CefGlue-v68-and-CefSharp-v67
• ChromelyConfiguration is now Singleton - only one instance per Chromely app.
• Allows for event registration
• Added option for Maximize and Fullscreen/Kiosk mode Window states.
• Breaking changes! - More info - https://github.com/mattkol/Chromely/wiki/Upgrade-to-CefGlue-v68-and-CefSharp-v67
• ChromelyConfiguration is now Singleton - only one instance per Chromely app.
• Allows for event registration
• + 3 more

📋 Changes

• Websocket handler interface added.
• CefGlue is not included, Chromely.Unofficial.CefGlue.NetStd is no longer needed.
• Websocket implementation - implements Cef CefServer - https://bitbucket.org/chromiumembedded/cef/issues/2278/expose-internal-http-websockets-server
• Changed menu context handler - devtool now only available during debug.
• Changed menu context handler - creation of popup window removed.
• Added frame handling - needed to run JavaScript methods.
• Changed menu context handler - devtool now only available during debug.
• Changed menu context handler - creation of popup window removed.
• + 1 more

📋 Changes

• Removed dependency on WinApi
• Added DependecyCheck flag to ChromelyConfiguration (CefPerformDependencyCheck)
• Added support for Chromely.Unofficial.CefGlue.NetStd (CefGlue) >= 63.0.3239.132 version.
• Added DependecyCheck flag to ChromelyConfiguration in Chromely.Core (CefPerformDependencyCheck)
• Added support for CefSharp >= 63.0.0 version.
• Added DependecyCheck flag to ChromelyConfiguration in Chromely.Core (CefPerformDependencyCheck)
• This version still uses legacy .NET Javascript binding (LegacyJavascriptBindingEnabled = true)

📋 Changes

• Removed dependency checks on CefSharp - was failing in debugging
• Minor fixes
• Improved documentation