Electron.NET是一個嵌入了ASP.NET Core的Electron的封裝，通過Electron.NET可以構建基於.NET5的跨平臺的桌面應用，使得開發人員只需要使用ASP.NET Core和 Blazor就可以勝任桌面應用的開發工作。
開發環境
建立新專案
-
建立資料夾
mkdir ElectronNETDemon
-
建立解決方案
dotnet new sln
-
建立專案ElectronNETDemon
dotnet new blazorserver -f net5.0 -o ElectronNETDemon
-
將專案“ElectronNETDemon/ElectronNETDemon.csproj”新增到解決方案中。
dotnet sln ElectronNETDemon.sln add ElectronNETDemon
-
切換到專案目錄
cd ElectronNETDemon
-
將包“ElectronNET.API”的 PackageReference 新增到專案ElectronNETDemon
dotnet add package ElectronNET.API
-
修改Program.cs使用Electron擴充套件
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseElectron(args);
webBuilder.UseStartup<Startup>();
});
-
修改Startup.cs，開啟Electron視窗
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
...
// Open the Electron-Window here
Task.Run(async () => await Electron.WindowManager.CreateWindowAsync());
}
-
刪除應用上的 https 相關配置
- launchSettings.json
- Startup.cs
app.UseHsts();
app.UseHttpsRedirection();
-
啟動應用程式
- 要啟動應用程式，請確保已將'ElectronNET.CLI'軟體包安裝為全域性工具：
dotnet tool install ElectronNET.CLI -g
- 然後初始化Electron.NET專案,electronnet.manifest.json應該出現在你的 ASP.NET Core專案中。
electronize init
- 執行以下命令啟動程式
electronize start
第一次啟動期間可能需要等待漫長的時間，如啟動失敗可以設定 npm 的源映象
npm install -g cnpm --registry=https://registry.npm.taobao.org
-
構建桌面應用
輸入以下命令構建各平臺的桌面應用，預設為這些平臺生成 x64 包。
electronize build /target win
electronize build /target osx
electronize build /target linux
如需構建 X86 的包，請使用以下命令
electronize build /target custom "win7-x86;win32" /electron-arch ia32
將包“AntDesign”的 PackageReference 新增到專案ElectronNETDemon
dotnet add package AntDesign --version 0.1.0-*
-
修改Startup.cs，在專案中註冊Antdesign
public void ConfigureServices(IServiceCollection services)
{
services.AddAntDesign();
...
}
-
在 wwwroot/index.html(WebAssembly) 或 Pages/_Host.cshtml(Server) 中引入靜態檔案
<link href="_content/AntDesign/css/ant-design-blazor.css" rel="stylesheet">
<script src="_content/AntDesign/js/ant-design-blazor.js"></script>
-
在 _Imports.razor 中加入名稱空間
@using AntDesign
-
為了動態地顯示彈出元件，需要在 App.razor 中新增一個
元件。
<Router AppAssembly="@typeof(Program).Assembly" PreferExactMatches="@true">
<Found Context="routeData">
<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)"/>
</Found>
<NotFound>
<LayoutView Layout="@typeof(MainLayout)">
<p>Sorry, there's nothing at this address.</p>
</LayoutView>
</NotFound>
</Router>
<AntContainer />
-
最後我們就可以在 razor 頁面中使用 AntDesign，在Index.razor加入以下程式碼，觸發按鈕的點選事件
@inject MessageService _message
@page "/"
<h1>Hello, world!</h1>
Welcome to your new app.
<SurveyPrompt Title="How is Blazor working for you?" />
<Button Type="primary" OnClick="Success">Hello World!</Button>
@code {
private async Task Success()
{
await _message.Success("This is a success message");
}
}
本文 GitHub 程式碼
https://github.com/huangmingji/ElectronNETDemon