ElectronSharp.API
31.3.0.50594
See the version list below for details.
dotnet add package ElectronSharp.API --version 31.3.0.50594
NuGet\Install-Package ElectronSharp.API -Version 31.3.0.50594
<PackageReference Include="ElectronSharp.API" Version="31.3.0.50594" />
paket add ElectronSharp.API --version 31.3.0.50594
#r "nuget: ElectronSharp.API, 31.3.0.50594"
// Install ElectronSharp.API as a Cake Addin #addin nuget:?package=ElectronSharp.API&version=31.3.0.50594 // Install ElectronSharp.API as a Cake Tool #tool nuget:?package=ElectronSharp.API&version=31.3.0.50594
<img src="https://github.com/theolivenbaum/electron-sharp/blob/main/assets/electron-sharp-logo.svg" width="100" height="100"/>
ElectronSharp
Build cross platform desktop apps with .NET 7 and ASP.NET Core (Razor Pages, MVC), Blazor or h5.
ElectronSharp is a wrapper around a "normal" Electron application with an embedded ASP.NET Core application. It uses a socket-based IPC bridge we can invoke Electron APIs from .NET.
The CLI extensions hosts the toolset to build and start ElectronSharp-based applications.
ElectronSharp is a hard fork from the original Electron.NET project, mantained by me and used to build the Curiosity app.
📦 NuGet:
🛠 Requirements to run:
The current ElectronSharp CLI builds Windows/macOS/Linux binaries. The API uses .NET 7, so our minimum base OS is the same as .NET 7.
Also you should have installed:
👩🏫 Usage
To activate and communicate with the Electron API, include the ElectronSharp.API NuGet package in your ASP.NET Core app. Check out the Electron.SampleApp for an example of how to use ElectronSharp.
PM> Install-Package ElectronSharp.API
Program.cs
You start ElectronSharp up with an UseElectron
WebHostBuilder-Extension.
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseElectron(args);
webBuilder.UseStartup<Startup>();
});
Startup.cs
Open the Electron Window in the Startup.cs file:
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
...
// Open the Electron-Window here
Task.Run(async () => await Electron.WindowManager.CreateWindowAsync());
}
🚀 Start the Application
To start the application make sure you have installed the "ElectronSharp.CLI" packages as global tool:
dotnet tool install ElectronSharp.CLI -g
At the first time, you need an ElectronSharp project initialization. Type the following command in your app folder:
electron-sharp init
- Now a electronnet.manifest.json should appear in your ASP.NET Core project
- Now run the following:
electron-sharp start
Hint
If invoking any of those commands gives you strange errors (like .NET 5 not installed, but your project is .NET 6), it means you've typed electronize instead of electron-sharp.
Note
Only the first electronize start is slow. The next will go on faster.
🔭 Develop ElectronSharp apps using a file watcher
The file watcher is included with version 8.31.1 of ElectronSharp. For example, a file change can trigger compilation, test execution, or deployment. The ElectronSharp window will automatically refresh and new code changes will be visible more quickly. The following ElectronSharp CLI command is required:
electron-sharp start /watch
Note
Only the first electronize start is slow. The next will go on faster.
🐞 Debug
Start your ElectronSharp application with the ElectronSharp CLI command. In Visual Studio attach to your running application instance. Go in the Debug Menu and click on Attach to Process.... Sort by your projectname on the right and select it on the list.
📔 Usage of the Electron-API
A complete documentation will follow. Until then take a look in the source code of the sample application:
ElectronSharp Sample App
⛏ Build
Here you need the ElectronSharp CLI as well. Type the following command in your ASP.NET Core folder:
electronize build /target win
There are additional platforms available:
electron-sharp build /target win
electron-sharp build /target osx
electron-sharp build /target osx-arm64
electron-sharp build /target linux
Those four "default" targets will produce packages for those platforms. Note that the osx-arm64
is for Apple Silicon Macs.
For certain NuGet packages or certain scenarios you may want to build a pure x86 application. To support those things you can define the desired .NET runtime, the electron platform and electron architecture like this:
electron-sharp build /target custom "win7-x86;win32" /electron-arch ia32
The end result should be an electron app under your /bin/desktop folder.
Note
macOS builds can't be created on Windows machines because they require symlinks that aren't supported on Windows (per this Electron issue). macOS builds can be produced on either Linux or macOS machines.
Develop
Install dotnet tool locally
- Build the CLI tool using
dotnet build
, this should create a nuget package in the artifact directory - Execute in the main electronnet solution folder
dotnet tool update --add-source ./artifacts/ -g electronsharp.cli -v d
👨💻 Original (Electron.NET) Authors
- Gregor Biswanger - (Microsoft MVP, Intel Black Belt and Intel Software Innovator) is a freelance lecturer, consultant, trainer, author and speaker. He is a consultant for large and medium-sized companies, organizations and agencies for software architecture, web- and cross-platform development. You can find Gregor often on the road attending or speaking at international conferences. - Cross-Platform-Blog - Twitter @BFreakout
- Robert Muehsig - Software Developer - from Dresden, Germany, now living & working in Switzerland. Microsoft MVP & Web Geek. - codeinside Blog - Twitter @robert0muehsig
See also the list of contributors who participated in the original project.
🙋♀️🙋♂ Contributing
Feel free to submit a pull request if you find any bugs (to see a list of active issues, visit the Issues section. Please make sure all commits are properly documented.
🎉 License
MIT-licensed
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- Microsoft.Extensions.Logging (>= 6.0.0)
- Newtonsoft.Json (>= 13.0.1)
- Nito.AsyncEx (>= 5.1.2)
- SixLabors.ImageSharp (>= 1.0.4)
- System.Collections (>= 4.3.0)
- System.Reactive (>= 5.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
32.0.1.51369 | 244 | 8/23/2024 |
31.3.1.50855 | 148 | 7/29/2024 |
31.3.0.50755 | 149 | 7/28/2024 |
31.3.0.50594 | 126 | 7/25/2024 |
31.2.1.50335 | 232 | 7/16/2024 |
31.2.0.50292 | 114 | 7/15/2024 |
31.1.0.50269 | 75 | 7/13/2024 |
31.1.0.49989 | 219 | 6/27/2024 |
30.0.6.49104 | 492 | 5/22/2024 |
30.0.6.49034 | 77 | 5/19/2024 |
30.0.6.48961 | 207 | 5/16/2024 |
30.0.4.48738 | 146 | 5/14/2024 |
30.0.2.48552 | 152 | 5/9/2024 |
30.0.2.48434 | 136 | 5/7/2024 |
30.0.2.48296 | 83 | 5/2/2024 |
30.0.1.47933 | 232 | 4/19/2024 |
30.0.0.47870 | 95 | 4/17/2024 |
29.3.0.47750 | 190 | 4/12/2024 |
29.1.5.47165 | 300 | 3/22/2024 |
29.1.5.47134 | 165 | 3/21/2024 |
29.1.4.46985 | 216 | 3/14/2024 |
29.0.1.46142 | 790 | 2/22/2024 |
28.2.0.44969 | 997 | 1/27/2024 |
28.1.3.44599 | 229 | 1/11/2024 |
28.0.0.44380 | 323 | 12/14/2023 |
27.1.0.43670 | 1,102 | 11/17/2023 |
27.1.0.43644 | 112 | 11/16/2023 |
27.1.0.43604 | 177 | 11/16/2023 |
27.0.4.43553 | 160 | 11/13/2023 |
27.0.4.43552 | 107 | 11/13/2023 |
27.0.4.43498 | 215 | 11/9/2023 |
27.0.2.43249 | 160 | 10/24/2023 |
27.0.1.43128 | 448 | 10/19/2023 |
27.0.0.43002 | 228 | 10/13/2023 |
26.3.0.42624 | 364 | 10/5/2023 |
26.3.0.42623 | 128 | 10/5/2023 |
26.2.4.42548 | 192 | 10/2/2023 |
26.2.2.42382 | 231 | 9/20/2023 |
26.2.1.42149 | 212 | 9/16/2023 |
26.2.1.42101 | 176 | 9/15/2023 |
26.2.0.41770 | 220 | 9/7/2023 |
26.1.0.41750 | 119 | 9/6/2023 |
26.1.0.41739 | 230 | 9/6/2023 |
26.1.0.41637 | 162 | 9/5/2023 |
26.1.0.41603 | 120 | 9/4/2023 |
26.1.0.41265 | 287 | 8/28/2023 |
26.1.0.41264 | 147 | 8/28/2023 |
26.1.0.41263 | 138 | 8/28/2023 |
26.1.0.41243 | 157 | 8/28/2023 |
26.1.0.41010 | 239 | 8/24/2023 |
26.0.0.40902 | 210 | 8/22/2023 |
25.3.1.40533 | 389 | 8/8/2023 |
25.3.1.40262 | 233 | 7/20/2023 |
25.3.0.40090 | 155 | 7/16/2023 |
25.2.0.39535 | 566 | 6/27/2023 |
25.2.0.39487 | 154 | 6/26/2023 |
25.0.1.39151 | 312 | 6/2/2023 |
25.0.0.39150 | 188 | 6/2/2023 |
25.0.0.38955 | 225 | 5/30/2023 |
24.4.0.38875 | 206 | 5/25/2023 |
24.4.0.38874 | 179 | 5/25/2023 |
24.0.0.37423 | 784 | 4/11/2023 |
23.1.3.36686 | 747 | 3/15/2023 |
23.1.3.36685 | 237 | 3/15/2023 |
23.1.3.36684 | 246 | 3/15/2023 |
23.1.3.36622 | 257 | 3/9/2023 |
23.0.0.36276 | 446 | 2/15/2023 |
23.0.0.36236 | 314 | 2/14/2023 |
23.0.0.36228 | 284 | 2/13/2023 |
23.0.0.36192 | 304 | 2/13/2023 |
23.0.0.35946 | 366 | 2/7/2023 |
22.2.0.35891 | 352 | 2/5/2023 |
22.2.0.35887 | 309 | 2/4/2023 |
22.1.0.35531 | 445 | 1/27/2023 |
22.0.2.35227 | 714 | 1/15/2023 |
22.0.0.35063 | 353 | 1/5/2023 |
22.0.0.35062 | 333 | 1/5/2023 |
22.0.0.35061 | 358 | 1/5/2023 |
22.0.0.35059 | 334 | 1/5/2023 |
22.0.0.35057 | 362 | 1/5/2023 |