桌面应用跨平台【免费下载链接】Electron.NET:electron: Build cross platform desktop apps with ASP.NET Core (Razor Pages, MVC, Blazor).项目地址https://gitcode.com/gh_mirrors/el/Electron.NET点击查看免费下载Electron.NET 为 ASP.NET CoreRazor Pages、MVC、Blazor应用提供了灵活的多启动方式支持通过「已打包/未打包」「控制台/ASP.NET」「.NET 先行/Electron 先行」三种维度的自由组合覆盖开发调试与生产部署的完整场景。本文以 docs/Using/Startup-Methods.md 为核心结合仓库源码StartupManager.cs、StartupMethod.cs、RuntimeControllerDotNetFirst.cs 等深入拆解每种模式的启动标志、进程流程与底层检测机制读完即可为你的项目选型正确的启动模式并掌握launchSettings.json与发布脚本的完整配置方案。启动方式全景8 种组合Electron.NET 支持8 种不同的启动场景覆盖以下三个维度的全部组合维度取值说明部署形态Packaged / Unpackaged是否已通过 electron-builder 等工具打包成独立应用应用类型Console / ASP.NET.NET 侧是控制台宿主还是 ASP.NET Core Web 宿主初始化顺序Dotnet-first / Electron-first启动时先拉起哪个进程谁掌握生命周期控制权2部署× 2应用类型× 2初始化顺序 8 种场景。从源码看枚举 StartupMethod.cs 定义了四种核心模式其中 Unpackaged 与 Packaged 各含 Electron-first 与 Dotnet-first 两个变体而 Console / ASP.NET 的区别则体现在运行时控制器的创建路径上——ASP.NET 应用通过 WebApplicationBuilderExtensions.cs 的UseElectron挂载控制台应用则直接使用ElectronNetRuntime.RuntimeController见 ElectronNetRuntime.cs。框架在启动时自动检测当前应采用的模式无需手工指定完整配置依据的是命令行标志与运行环境。命令行标志速查-unpackedelectronElectron 先行调试未打包直接从编译输出目录启动 Electron由 Electron 反过来拉起 .NET 进程适合调试 Electron 主进程与 Node.js 代码# 先启动 Electron再由它启动 .NET node node_modules/electron/cli.js main.js -unpackedelectron在StartupMethod.cs的注释中该模式被描述为类似于传统 Electron.NET 调试但不打包更快且允许选择调试适配器除非目标是调试 Node.js否则很少用到。其特点是从./bin/*编译输出目录直接运行无需中间打包环节。-unpackeddotnet.NET 先行调试未打包.NET 应用先启动再由它拉起 Electron。这是超快启动、就地调试 Hot Reload编辑并继续的新方式即使在 WSL 下也能全程在 Visual Studio 内完成调试见StartupMethod.cs中UnpackedDotnetFirst的注释# 先启动 .NET再由它启动 Electron dotnet run -unpackeddotnet-dotnetpacked.NET 先行的已打包执行发布产物中由 .NET 可执行文件先行启动再加载打包文件中的 Electron# 以 .NET 先行的方式运行已打包应用 MyApp.exe -dotnetpacked从 ElectronProcessActive.cs 可以看到该模式下 .NET 实际向 Electron 传递的命令行参数为-dotnetpacked -electronforcedport{socketPort} {extraArguments}其中-electronforcedport用于强制指定 Socket 桥接端口。无标志Electron 先行的已打包执行默认已打包应用直接运行可执行文件走传统 Electron 行为由 Electron 先行启动# 运行已打包应用无需任何特殊标志 MyApp.exe四种启动模式详解模式 1Unpackaged Electron-First开发适用场景调试 Electron 主进程与 Node.js 代码命令-unpackedelectron标志进程流程Electron 先启动Electron 拉起 .NET 进程.NET 通过 Socket 反向连接回 Electron应用运行由 Electron 掌握控制权。此时 .NET 侧对应UnpackedElectronFirst模式运行时控制器为 RuntimeControllerElectronFirst.cs它不主动创建 Electron 进程而是通过ElectronProcessPassive绑定 Electron 传入的进程 IDelectronPID并利用SocketBridgeService(port, token)建立通信port 与 token 均由 Electron 通过命令行参数提供。模式 2Unpackaged .NET-First开发适用场景调试 ASP.NET/C# 代码享受 Hot Reload命令-unpackeddotnet标志进程流程.NET 应用先启动.NET 拉起 Electron 进程Electron 连接回 .NET应用运行由 .NET 掌握控制权。对应UnpackedDotnetFirst模式与 RuntimeControllerDotNetFirst.cs。ElectronProcessActive会从编译输出目录下的.electron文件夹定位 Electron 可执行文件并携带main.js -unpackeddotnet --trace-warnings -electronforcedport{socketPort}参数启动在非 Windows 平台上还会先执行chmod -R x为 Electron dist 目录添加可执行权限见 ElectronProcessActive.cs。模式 3Packaged .NET-First生产适用场景已部署应用由 .NET 控制生命周期命令-dotnetpacked标志进程流程.NET 可执行文件先启动.NET 从打包文件中拉起 ElectronElectron 从app.asar或解包目录加载.NET 维持进程控制权。对应PackagedDotnetFirst模式。在StartupMethod.cs的注释中这一模式提供了更好的整体应用生命周期管理方式。此时ElectronProcessActive通过ElectronRootDirResolver解析打包后的 Electron 根目录找到ElectronExecutableWindows 下会追加.exe后缀并携带-dotnetpacked -electronforcedport{socketPort}参数启动参见 ElectronProcessActive.cs 与 StartupManager.cs 中的SetElectronExecutable。模式 4Packaged Electron-First生产适用场景传统 Electron 应用行为命令无需特殊标志进程流程Electron 可执行文件先启动Electron 从打包文件中拉起 .NET.NET 在 Electron 的进程上下文中运行Electron 维持 UI 控制权。对应PackagedElectronFirst模式被StartupMethod.cs称为Electron.NET 的经典启动方式。运行时控制器同样是RuntimeControllerElectronFirst——从 StartupManager.cs 的CreateRuntimeController可以看到PackagedElectronFirst与UnpackedElectronFirst共用同一控制器二者的差异只体现在 Electron 传入的 PID、端口与令牌等参数上。源码解读框架如何自动检测启动模式模式自动检测的逻辑集中在 StartupManager.cs 的Initialize()中启动时依次完成收集构建信息GatherBuildInfo、收集进程参数CollectProcessData、设置 Electron 可执行文件路径SetElectronExecutable、最终调用DetectAppTypeAndStartup判定模式并输出一行Evaluated StartupMethod: ...便于确认。决策逻辑谁先启动// StartupManager.DetectAppTypeAndStartup简化示意 var isLaunchedByDotNet LaunchOrderDetector.CheckIsLaunchedByDotNet(); var isUnPackaged UnpackagedDetector.CheckIsUnpackaged(); if (isLaunchedByDotNet) { return isUnPackaged ? StartupMethod.UnpackedDotnetFirst : StartupMethod.PackagedDotnetFirst; } return isUnPackaged ? StartupMethod.UnpackedElectronFirst : StartupMethod.PackagedElectronFirst;LaunchOrderDetector判断启动发起方LaunchOrderDetector.cs 通过三个探针投票决定是否由 .NET 发起探针判定说明是否存在electronPort参数有 → Electron 先行Electron 先行启动时会把端口传给 .NET是否存在electronPID参数有 → Electron 先行Electron 先行时把自己的进程 ID 传给 .NET调试器是否已附加附加 → .NET 先行开发调试中默认视为 .NET 发起最终scoreDotNet scoreElectron时判定为 Dotnet-first。这些参数名定义在 ElectronNetRuntime.cselectronPort、electronHost、electronPID、electronAuthToken。UnpackagedDetector判断是否已打包UnpackagedDetector.cs 用五个探针其中一个计双份打分构建配置为Debug→ 未打包Release→ 已打包基目录位于resources/bin→ 已打包基目录存在.electron目录 → 未打包在ElectronRootDir下能找到 Electron 可执行文件 → 已打包调试器附加 → 未打包命令行参数包含unpacked→ 未打包包含dotnetpacked→ 已打包。最终按scoreUnpackaged scorePackaged判定。这也是无需显式指定打包状态的实现基础——框架通过环境探测而非硬编码开关完成决策。配置示例ASP.NET 与控制台应用ASP.NET 应用启动在Program.cs中通过WebApplicationBuilder的UseElectron扩展方法接入。仓库提供了四种重载支持回调携带进程参数或IServiceProvider见 WebApplicationBuilderExtensions.cs// Program.cs var builder WebApplication.CreateBuilder(args); // 为不同启动模式统一配置 builder.WebHost.UseElectron(args, async () { var browserWindow await Electron.WindowManager.CreateWindowAsync( new BrowserWindowOptions { Show false }); await browserWindow.WebContents.LoadURLAsync(http://localhost:8001); browserWindow.OnReadyToShow () browserWindow.Show(); }); var app builder.Build(); app.Run();说明http://localhost:8001对应仓库默认的 Web 端口常量DefaultWebPort 8001ElectronNetRuntime.cs而 Socket 桥接默认端口为DefaultSocketPort 8000。控制台应用启动控制台宿主不依赖 ASP.NET 宿主直接操作RuntimeController完成生命周期管理可对照 ElectronNET.ConsoleApp/Program.cs 的真实写法// Program.cs public static async Task Main(string[] args) { var runtimeController ElectronNetRuntime.RuntimeController; await runtimeController.Start(); await runtimeController.WaitReadyTask; await InitializeApplication(); // 例如创建主窗口 await runtimeController.WaitStoppedTask; }RuntimeController属性与ElectronNetRuntime的公开状态均在 ElectronNetRuntime.cs 中定义。launchSettings.json 双模式调试仓库示例 src/ElectronNET.ConsoleApp/Properties/launchSettings.json 展示了同时配置 .NET 先行与 Electron 先行两种调试入口的方式// launchSettings.json { profiles: { DotNet (unpackaged): { commandName: Project, environmentVariables: { ASPNETCORE_ENVIRONMENT: Development } }, Electron (unpackaged): { commandName: Executable, executablePath: node, commandLineArgs: node_modules/electron/cli.js main.js -unpackedelectron, workingDirectory: $(TargetDir).electron, environmentVariables: { ASPNETCORE_ENVIRONMENT: Development } }, WSL: { commandName: WSL2, environmentVariables: { ASPNETCORE_ENVIRONMENT: Development, ASPNETCORE_URLS: http://localhost:8001/ } } } }注意 Electron 先行配置中的workingDirectory指向$(TargetDir).electron这是未打包调试时 Electron 二进制的存放位置与 ElectronProcessActive.cs 中Path.Combine(dir.FullName, .electron)的定位逻辑一一对应。启动流程示意上图startup_modes.png展示了部署类型、应用类型与初始化顺序的组合如何影响进程生命周期横向区分已打包/未打包纵向区分 .NET 先行/Electron 先行两者交汇处即为对应进程的启停顺序。开发工作流调试工作流ASP.NET 先行调试推荐——在launchSettings.json中配置-unpackeddotnet即可在 Visual Studio 中直接按 F5 运行并享受 Hot Reload// launchSettings.json { ASP.Net (unpackaged): { commandName: Project, commandLineArgs: -unpackeddotnet } }Electron 先行调试——通过Executable配置直接以 Node 启动 Electron// launchSettings.json { Electron (unpackaged): { commandName: Executable, executablePath: node, commandLineArgs: node_modules/electron/cli.js main.js -unpackedelectron } }两种入口可以共存于同一份launchSettings.json按需切换。生产部署Dotnet-first 部署——先dotnet publish生成 RID 特定产物再进入发布目录安装依赖并执行 electron-builder 打包最后以-dotnetpacked运行# 构建并打包 dotnet publish -c Release -r win-x64 cd publish\Release\net8.0\win-x64 npm install npx electron-builder # 以 dotnet-first 方式运行 MyApp.exe -dotnetpackedElectron-first 部署默认——无需任何特殊标志# 直接运行已打包应用 MyApp.exe进程生命周期管理自动清理Electron.NET 会自动管理进程生命周期见 RuntimeControllerBase.cs 及其两个子类主窗口关闭时优雅关闭graceful shutdown正确清理子进程——ElectronProcessActive.StopCore调用ProcessRunner.Cancel终止 ElectronRuntimeControllerDotNetFirst.HandleStopped会在 Electron 或 Socket 桥任一停止时级联停止另一端进程失败的错误处理——ElectronProcessActive.StartInternal内置 2 分钟超时保护超时自动 Cancel 进程并越过等待屏障跨平台兼容的进程管理——非 Windows 平台自动处理chmod可执行权限并通过CheckRuntimeIdentifier校验构建 RID 与当前平台是否匹配ElectronProcessActive.cs。手动控制通过ElectronNetRuntime.RuntimeController访问运行时控制器可手动等待就绪、停止运行时。所有等待任务WaitStartedTask/WaitReadyTask/WaitStoppingTask/WaitStoppedTask与状态转换Uninitialized → Starting → Started → Ready → Stopping → Stopped统一由 LifetimeServiceBase.cs 提供非法状态回退会抛出异常以保证状态机严格单调递增var runtime ElectronNetRuntime.RuntimeController; // 等待 Electron 就绪 await runtime.WaitReadyTask; // 停止 Electron 运行时 await runtime.Stop(); await runtime.WaitStoppedTask;通信桥接细节无论哪种模式.NET 与 Electron 之间最终都通过SocketBridgeService(port, token)建立 Socket.IO 连接。Electron-first 模式下Electron 会打印一行Electron Socket: listening on port ... at ... using token由 ElectronProcessActive.cs 中的正则^Electron Socket: listening on port (\d) at (\S) using ([a-f0-9])$解析出端口、主机与认证令牌从而完成握手。故障排查常见启动问题Electron process not found确保 Node.js 22.x 已安装检查 .NET 构建是否成功确认RuntimeIdentifier设置正确发布时通过-r win-x64等参数指定运行时的 RID 校验逻辑见 ElectronProcessActive.cs 的CheckRuntimeIdentifier。Port conflicts端口冲突为不同启动模式使用不同端口检查是否有其他实例占用默认端口Socket 默认8000Web 默认8001见 ElectronNetRuntime.cs核实防火墙设置。Process wont terminate进程无法终止改用 dotnet-first 模式以获得更可靠的清理RuntimeControllerDotNetFirst的HandleStopped会级联停止 Socket 桥与 Electron 进程检查是否存在未处理异常确认所有窗口均已正确关闭。最佳实践选择合适的模式场景推荐模式理由开发调试 C#.NET-first-unpackeddotnet支持 Hot Reload启动更快开发调试 Node.jsElectron-first-unpackedelectron可直接调试 Electron 主进程生产.NET-first-dotnetpacked更好的进程控制与生命周期管理生产传统行为Electron-first无标志保持传统 Electron 行为跨平台.NET-first各平台行为一致环境配置如需固定运行环境可在.csproj中设置!-- .csproj -- PropertyGroup ElectronNETCoreEnvironmentProduction/ElectronNETCoreEnvironment /PropertyGroup结合 Configuration.md 可进一步控制构建属性与 Electron 版本等信息。下一步阅读调试不同启动模式针对不同部署场景打包将既有应用迁移到新启动方式ASP.NET 应用接入 与 控制台应用接入总结Electron.NET 的启动系统通过「已打包/未打包 × 控制台/ASP.NET × .NET 先行/Electron 先行」三个维度组织出 8 种启动场景并以命令行标志 环境探测LaunchOrderDetector.cs、UnpackagedDetector.cs自动选择最合适的模式。无论你是需要 Hot Reload 的 .NET 开发者、需要直接调试 Node.js 的 Electron 开发者还是追求进程可控性的生产部署团队都能在四类StartupMethod中找到对应方案——这就是 Electron.NET 为 .NET 开发者提供理想调试与部署体验的基础。赞分享桌面应用跨平台【免费下载链接】Electron.NET:electron: Build cross platform desktop apps with ASP.NET Core (Razor Pages, MVC, Blazor).项目地址https://gitcode.com/gh_mirrors/el/Electron.NET点击查看免费下载相关推荐ngx-loading-bar版本迁移指南从Angular 13到16的平滑升级ngx loading bar版本迁移指南从Angular 13到16的平滑升级 ngx loading bar是一款为Angular应用提供自动页面加载进度Electron.NET WindowManager 完全指南窗口创建、生命周期管理与 BrowserView 集成Electron.NET WindowManager 完全指南窗口创建、生命周期管理与 BrowserView 集成 Electron.WindowManag桌面应用跨平台Electron.NET 应用生命周期管理Electron.App API 完整实战指南Electron.NET 应用生命周期管理Electron.App API 完整实战指南 导读 Electron.App 是 Electron.NET 中控制桌面应用跨平台上一篇ROS2 Bag2 使用教程下一篇CANN/Ascend C矩阵计算流程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考