Chromely

朱雀 2023-06-01 05:41 200阅读 0赞

# Chromely #

Chromely is a lightweight alternative to [Electron.NET][], [Electron][] for .NET/.NET Core developers.

Chromely is a .NET/.NET Core HTML5 Chromium desktop framework. It is focused on building apps based on [Xilium.CefGlue][], [CefSharp][] implementations of embedded Chromium ([CEF][]) without WinForms or WPF. Chromely uses Windows and Linux native GUI API as "thin" chromium hosts. It can be extended to use WinForms or WPF.

With Chromely you can build Single Page Application (SPA) HTML5 desktop apps with or without Node/npm. Building SPA apps using javascript frameworks like Angular, React, Vue or similar is easy. You can use Visual Studio Code or any IDE you are familiar with as long as Chromely knows the entry html file from the compiled/bundled files. For more info please see - [Chromely-Apps][].

Options of communicating (IPC) with rendering process are via:

1.  .NET/Javascript integration ([CefSharp][]) - more info @ [Expose .NET class to JavaScript][].
2.  Generic Message Routing ([Xilium.CefGlue][]) - more info @ [Generic Message Routing][].
3.  Ajax HTTP/XHR ([Xilium.CefGlue][], [CefSharp][]) - more info @ [Custom Scheme Handling][].
4.  Real-time with Websocket (ws) ([Xilium.CefGlue][]) - more info @ [Real-time with Websocket][].

#### [Roadmap & Help Wanted][Roadmap _ Help Wanted] ####

##### If you like Chromely, please give it a star - it helps! #####

Have a quick question? Wanna chat? Connect on [![Join the chat at https://gitter.im/chromely\_/Lobby][Join the chat at https_gitter.im_chromely_Lobby]][Join the chat at https_gitter.im_chromely_Lobby_Join the chat at https_gitter.im_chromely_Lobby]

Have an app/project/tool using Chromely - [please share!][please share]

### Platforms ###

Cross-platform - Windows, Linux. Built on CefGlue, CefSharp, NET Standard 2.0, .NET Core 2.0, .NET Framework 4.61 and above.

<table> 
 <thead> 
  <tr> 
   <th>Platform</th> 
   <th align="center">CefGlue.Winapi</th> 
   <th align="center">CefGlue.Gtk</th> 
   <th align="center">CefSharp.Winapi</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Windows(1)&nbsp;32-bit</td> 
   <td align="center">net461, netstandard2.0</td> 
   <td align="center">net461, netstandard2.0</td> 
   <td align="center">net461</td> 
  </tr> 
  <tr> 
   <td>Windows(1)&nbsp;64-bit</td> 
   <td align="center">net461, netstandard2.0</td> 
   <td align="center">---</td> 
   <td align="center">---</td> 
  </tr> 
  <tr> 
   <td>Linux(2)&nbsp;32-bit</td> 
   <td align="center">---</td> 
   <td align="center">netstandard2.0</td> 
   <td align="center">---</td> 
  </tr> 
  <tr> 
   <td>Linux(2)&nbsp;64-bit</td> 
   <td align="center">---</td> 
   <td align="center">netstandard2.0</td> 
   <td align="center">---</td> 
  </tr> 
  <tr> 
   <td>MacOSX(3)&nbsp;64-bit</td> 
   <td align="center">---</td> 
   <td align="center">---</td> 
   <td align="center">---</td> 
  </tr> 
  <tr> 
   <td>Linux ARM(4)</td> 
   <td align="center">---</td> 
   <td align="center">netstandard2.0</td> 
   <td align="center">---</td> 
  </tr> 
 </tbody> 
</table>

(1)  Windows 7, Service Pack 1 and newer  
 (2)  Ubuntu 16.04 and newer  
       (Mono currently not working, window resizing not working)  
 (3)  Work in progress...  
 (4)  i.e. Raspberry Pi 3+  
       (manual download of CEF builds for ARM available on [http://chromely.org/cefbuilds/index.html][http_chromely.org_cefbuilds_index.html])

For more info/documentation, please check [Chromely wiki][].

[![Chromely.Core][]][Chromely.Core 1] [![Chromely.CefGlue.Winapi][]][Chromely.CefGlue.Winapi 1] [![Chromely.CefSharp.Winapi][]][Chromely.CefSharp.Winapi 1] [![Chromely.Unofficial.CefGlue.NetStd][]][Chromely.Unofficial.CefGlue.NetStd 1]

[![Chromely + Angular][Chromely _ Angular]][Chromely-Apps]   
[![Chromely + React][Chromely _ React]][Chromely-Apps]   
[![Chromely + Vue][Chromely _ Vue]][Chromely-Apps]

### Demo Code ###

Get started with the [demos][].

### Creating a Simple App (Using CefGlue with Winapi host) ###

For more info see - [Getting Started][]

Notes on Upgrade to CefGlue version 70 and CefSharp version 71 (Chromely v4) - Please [see][].

class Program { static int Main(string[] args) { var startUrl = "https://google.com"; var config = ChromelyConfiguration .Create() .WithHostMode(WindowState.Normal, true) .WithHostTitle("chromely") .WithHostIconFile("chromely.ico") .WithAppArgs(args) .WithHostBounds(1000, 600) .WithStartUrl(startUrl); using (var window = ChromelyWindow.Create(config)) { return window.Run(args); } } }

*  [CefGlue Usage Readme][]
 *  [CefSharp Usage Readme][]

#### Run Starter Template (Using dotnet core cli). For more info, please see - [dotnet cli demo template install][] ####

dotnet new -i "Chromely.CefGlue.Win.Template::*" dotnet new chromelywin dotnet restore dotnet chromelycef.dll download v70 --cpu=x64 --dest="bin\Debug\netcoreapp2.1" dotnet build dotnet run

### Chromely Demos ###

For more info on demos - [Demos][] [![chromely_screens.gif][]][chromely_screens.gif 1]

### References ###

*  WinApi - [https://github.com/prasannavl/WinApi][https_github.com_prasannavl_WinApi]
 *  Cef - [https://bitbucket.org/chromiumembedded/cef][CEF]
 *  Xilium.CefGlue - [https://gitlab.com/xiliumhq/chromiumembedded/cefglue][https_gitlab.com_xiliumhq_chromiumembedded_cefglue]
 *  CefSharp - [https://github.com/cefsharp/CefSharp][CefSharp]
 *  Json Serializer - [https://github.com/lbv/litjson][https_github.com_lbv_litjson]
 *  Caliburn.Light Container - [https://github.com/tibel/Caliburn.Light/blob/master/src/Caliburn.Core/IoC/SimpleContainer.cs][https_github.com_tibel_Caliburn.Light_blob_master_src_Caliburn.Core_IoC_SimpleContainer.cs]

## Contributing ##

Contributions are always welcome, via PRs, issues raised, or any other means. To become a dedicated contributor, please [contact the Chromely team][] or [raise an issue][] mentioning your intent.

## License ##

Chromely is MIT licensed. For dependency licenses [please see][].

## Credits ##

Thanks to [JetBrains][] for the OSS license of Resharper Ultimate.

Improved and optimized using:

[![Resharper logo][]][Resharper logo 1]

转载于:https://www.cnblogs.com/Jeely/p/11358245.html

[Electron.NET]: https://github.com/ElectronNET/Electron.NET
[Electron]: https://github.com/electron/electron
[Xilium.CefGlue]: https://bitbucket.org/xilium/xilium.cefglue/wiki/Home
[CefSharp]: https://github.com/cefsharp/CefSharp
[CEF]: https://bitbucket.org/chromiumembedded/cef
[Chromely-Apps]: https://github.com/chromelyapps/Chromely/wiki/Chromely-Apps
[Expose .NET class to JavaScript]: https://github.com/chromelyapps/Chromely/wiki/Expose-.NET-class-to-JavaScript
[Generic Message Routing]: https://github.com/chromelyapps/Chromely/wiki/Generic-Message-Routing
[Custom Scheme Handling]: https://github.com/chromelyapps/Chromely/wiki/Custom-Scheme-Handling
[Real-time with Websocket]: https://github.com/chromelyapps/Chromely/wiki/Real-time-with-Websocket
[Roadmap _ Help Wanted]: https://github.com/chromelyapps/Chromely/wiki/Roadmap-and-Help-Wanted
[Join the chat at https_gitter.im_chromely_Lobby]: https://camo.githubusercontent.com/3d41698dd7291691cdb14d1e0964c9c356a55441/68747470733a2f2f6261646765732e6769747465722e696d2f6368726f6d656c795f2f4c6f6262792e737667
[Join the chat at https_gitter.im_chromely_Lobby_Join the chat at https_gitter.im_chromely_Lobby]: /images/20230601/a399ba7635694571a81f108dabecb95c.png
[please share]: https://github.com/chromelyapps/Chromely/issues/63
[http_chromely.org_cefbuilds_index.html]: http://chromely.org/cefbuilds/index.html
[Chromely wiki]: https://github.com/chromelyapps/Chromely/wiki
[Chromely.Core]: https://camo.githubusercontent.com/99e9449fae88c659d7d8cf99314b4e679dc2e625/687474703a2f2f696d672e736869656c64732e696f2f6e756765742f767072652f4368726f6d656c792e436f72652e7376673f7374796c653d666c6174266c6162656c3d4368726f6d656c792e436f7265
[Chromely.Core 1]: https://www.nuget.org/packages/Chromely.Core
[Chromely.CefGlue.Winapi]: https://camo.githubusercontent.com/3f885b38f23429fd5615e543793d7eb42fb2a88c/687474703a2f2f696d672e736869656c64732e696f2f6e756765742f767072652f4368726f6d656c792e436566476c75652e57696e6170692e7376673f7374796c653d666c6174266c6162656c3d4368726f6d656c792e436566476c75652e57696e617069
[Chromely.CefGlue.Winapi 1]: https://www.nuget.org/packages/Chromely.CefGlue.Winapi
[Chromely.CefSharp.Winapi]: https://camo.githubusercontent.com/b7b35cac2daea75148e2fea54df38ed74ff82a89/687474703a2f2f696d672e736869656c64732e696f2f6e756765742f767072652f4368726f6d656c792e43656653686172702e57696e6170692e7376673f7374796c653d666c6174266c6162656c3d4368726f6d656c792e43656653686172702e57696e617069
[Chromely.CefSharp.Winapi 1]: https://www.nuget.org/packages/Chromely.CefSharp.Winapi
[Chromely.Unofficial.CefGlue.NetStd]: /images/20230601/4cab491ba31f487e83d20bf0c0781726.png
[Chromely.Unofficial.CefGlue.NetStd 1]: https://www.nuget.org/packages/Chromely.Unofficial.CefGlue.NetStd/
[Chromely _ Angular]: https://camo.githubusercontent.com/744387317ac9f9827df3af1623c0a05b8b55547c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4368726f6d656c79253230417070732d4275696c7425323077697468253230416e67756c6172253230322532422d677265656e2e737667
[Chromely _ React]: https://camo.githubusercontent.com/3af162b398dfa4729aa26f59c4e0ef9d09b1cfd5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4368726f6d656c79253230417070732d4275696c742532307769746825323052656163742d677265656e2e737667
[Chromely _ Vue]: https://camo.githubusercontent.com/b815242dbcf0e518dc6c7f6fe3845d7fcb2ebbd5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4368726f6d656c79253230417070732d4275696c74253230776974682532305675652d677265656e2e737667
[demos]: https://github.com/chromelyapps/demo-projects
[Getting Started]: https://github.com/chromelyapps/Chromely/wiki/Getting-Started
[see]: https://github.com/chromelyapps/Chromely/wiki/Upgrade-to-CefGlue-v70-and-CefSharp-v71
[CefGlue Usage Readme]: https://github.com/chromelyapps/demo-projects/blob/master/regular-chromely/Chromely.CefGlue.Winapi.Demo/README.md
[CefSharp Usage Readme]: https://github.com/chromelyapps/demo-projects/blob/master/regular-chromely/Chromely.CefSharp.Winapi.Demo/README.md
[dotnet cli demo template install]: https://github.com/chromelyapps/Chromely/wiki/dotnet-cli-Starter-Template
[Demos]: https://github.com/chromelyapps/Chromely/wiki/Demos
[chromely_screens.gif]: https://github.com/chromelyapps/Chromely/raw/master/Screenshots/chromely_screens.gif
[chromely_screens.gif 1]: https://github.com/chromelyapps/Chromely/blob/master/Screenshots/chromely_screens.gif
[https_github.com_prasannavl_WinApi]: https://github.com/prasannavl/WinApi
[https_gitlab.com_xiliumhq_chromiumembedded_cefglue]: https://gitlab.com/xiliumhq/chromiumembedded/cefglue
[https_github.com_lbv_litjson]: https://github.com/lbv/litjson
[https_github.com_tibel_Caliburn.Light_blob_master_src_Caliburn.Core_IoC_SimpleContainer.cs]: https://github.com/tibel/Caliburn.Light/blob/master/src/Caliburn.Core/IoC/SimpleContainer.cs
[contact the Chromely team]: https://github.com/orgs/chromelyapps/people
[raise an issue]: https://github.com/chromelyapps/Chromely/issues
[please see]: https://github.com/chromelyapps/Chromely/blob/master/LICENSE.md
[JetBrains]: https://www.jetbrains.com/
[Resharper logo]: /images/20230601/bd46abdd4bd44b86b0dcbb05e3626db8.png
[Resharper logo 1]: https://www.jetbrains.com/resharper/