Building Cross-Platform Desktop Apps with Electron.NET

This article provides a walk-through for developing and deploying an application with Electron.NET.


Create an ASP. NET Core Web Application

For this exercise, I'm using Visual Studio Code. First, open a terminal window and run the following commands to create a new project called ElectronMvcDemo.

mkdir ElectronMvcDemo  

cd ElectronMvcDemo  

dotnet new webapp  

code .  


When prompted by Visual Studio Code, say Yes to load the required assets for the project. Press F5 to build and run the application, opening a browser on the default ASP. NET Core welcome page, hosted on localhost:5001. Close the page, return to VS Code and stop debugging.

Electronize It!

Now let's turn our boilerplate ASP. NET Core project into an Electron application. First, open the file ElectronMvcDemo.csproj and insert a package reference for the Electron.NET:

<ItemGroup>  

  <PackageReference Include="ElectronNET.API" Version="9.31.2" />  

</ItemGroup>  

 

Save the file( dotnet restore ).

Next, edit Program.cs and insert a using statement for the newly added package:

using ElectronNET.API;  


Locate the static method CreateHostBuilder and insert the following two lines before the call to UseStartup:

webBuilder.UseElectron(args);  

webBuilder.UseEnvironment("Development");  


The first line is necessary. The second is convenient during development, as it allows detailed error messages to be displayed.

Edit Startup.cs and insert the following using statements:

using ElectronNET.API;  

using ElectronNET.API.Entities;  

using System.Runtime.InteropServices

 

Locate the Configure method and add the following lines to the end of its body:

if (HybridSupport.IsElectronActive)  

{  

    CreateWindow();  

}  


Finally, add the following method to the Startup class to create the main Electron window:

private async void CreateWindow()  

{  

    var window = await Electron.WindowManager.CreateWindowAsync();  

    window.OnClosed += () => {  

        Electron.App.Quit();  

    };  

}

 

Install the Command Line Tool

In VS Code, create a new terminal window and type:

dotnet tool install ElectronNET.CLI -g  


This one-time step will install a .NET Core global tool that implements a command named electronize. To see a list of tools/commands installed on your system, type the following:

dotnet tool list -g


Run the Electronized Application

After installing the command-line tool, type these lines in the VS Code terminal window:

electronize init  

electronize start


The first line is a one-time step that creates a manifest file named electron.manifest.json and adds it to your project. The second line is used to launch the Electron application (don't use F5, as this will only open the ASP. NET Core application in the browser). Note that the content now appears in an application window, not a browser.

Comentarii

Postări populare de pe acest blog

5Inch HDMI LCD for RPI 800x480

DevExpress Theme Changer ...

.NET Core Dependency Injection with Func as constructor parameter