百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
E

electron-edge-js

> 编程语言
开源

在 Windows、MacOS 和 Linux 上在 Electron 中运行 .NET 代码

392 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

在 Windows、MacOS 和 Linux 上在 Electron 中运行 .NET 代码

.NET and Node.js in-process on Electron

Git Issues Closed Issues

This is a fork of edge-js adapted to support Electron

Overview

electron-edge-js allows you to run .NET code in Electron process on Windows, macOS, and Linux.
Call compiled .NET dlls or inline C# code directly from Electron process.

Version support policy

Electron officially supports 3 latest released versions. You can read more about Electron release schedule and support here Electron Releases.

electron-edge-js support policy

  • Windows supports 6 latest Electron releases.
  • macOS comes pre-compiled with 6 latest Electron releases.
    When using Electron version that is not pre-compiled electron-edge-js binaries will be compiled during npm install using node-gyp.
  • Linux will always compile electron-edge-js binaries during npm install using node-gyp.

[!WARNING]

  • Currently electron-edge-js on Linux does not support Electron 43 and above due to unknown bug.

[!NOTE]

  • Versions prior to Electron 29 are not supported.

Windows supported versions

Electron x86 x64 arm64
39.x - 43.x :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
44.x :x: :heavy_check_mark: :heavy_check_mark:

macOS binaries pre-compiled for

Electron x64 arm64
39.x - 44.x :heavy_check_mark: :heavy_check_mark:

Supports

Electron x64 arm64
29.x - 44.x :heavy_check_mark: :heavy_check_mark:

Linux

On Linux npm install will compile binaries with correct Electron headers for a given Electron version.

Linux supported versions

Electron x64 arm64
29.x - 42.x :heavy_check_mark: :heavy_check_mark:

Other Linux architectures might work but have not been tested.

Usage is the same as edge-js, replace require('edge-js') with require('electron-edge-js'):

bash
npm install electron-edge-js
diff
-var edge = require('edge-js');
+var edge = require('electron-edge-js');

var helloWorld = edge.func(function () {/*
    async (input) => {
        return ".NET Welcomes " + input.ToString();
    }
*/});

Quick start

Sample app that shows how to work with .NET Core using inline code and compiled C# libraries.
https://github.com/agracio/electron-edge-js-quick-start

Pre-requisites

  • Windows: Visual C++ Redistributable

Packaging Electron application

electron-edge-js needs to be specified as an external module, some examples

webpack

webpack.config.js

javascript
module.exports = {
  target: 'node',
  externals: {
    'electron-edge-js': 'commonjs2 electron-edge-js',
    'edge-cs': 'commonjs2 edge-cs',
  },
  node: {
    __dirname: true,
    __filename: true,
  },
}

From #138

webpack.config.js

javascript
externals: {
    'electron-edge-js': 'commonjs2 electron-edge-js',
},
node: {
    __dirname: false,
    __filename: false,
},
extraResources:[
    "./node_modules/electron-edge-js/**",
]

Electron main.js

javascript
// https://github.com/ScottJMarshall/electron-webpack-module-resolution
require("module").globalPaths.push(process.cwd()+'/node_modules');
var edge = require('electron-edge-js');

Vue.js

vue.config.js

javascript
module.export = {
    pluginOptions: {
        electronBuilder: {
            externals:["electron-edge-js"]
        }
    }
}

Vite

When using dotnet Core CLR environment variable process.env.EDGE_USE_CORECLR needs to be set in Vite config instead of code.

vite.config.ts

typescript
export default defineConfig(({ command }) => {
  process.env.EDGE_USE_CORECLR = 1;
  return {
    // ..
  }
});

Related issues to use for troubleshooting:
https://github.com/agracio/electron-edge-js/issues/39
https://github.com/agracio/electron-edge-js/issues/74
https://github.com/agracio/electron-edge-js/issues/21
https://github.com/agracio/electron-edge-js/issues/138

electron-builder

electron-builder example based on electron-edge-js-quick-start
https://github.com/agracio/electron-edge-js-quick-start-builder

electron-forge

electron-forge example based on electron-edge-js-quick-start
https://github.com/agracio/electron-edge-js-quick-start-forge

Async execution

If electron-edge-js module is used on main Electron thread it will cause Electron app to freeze when executing long-running .NET code even if your C# code is fully async.
To avoid this you can use worker thread packages such as threads.js or piscina

This issue is not present when using Electron IPC

Workaround from #97

main.js

javascript
const { fork } = require("child_process"); fork("../child.js", [], { env: {file: 'filename'}, })

child.js

javascript
const path = require('path');
const powerpoint = require('office-script').powerpoint;
const filePath = '../../directory/';

powerpoint.open(path.join(${remotePath}${process.env.file}.pptx), function(err) {
    if(err) throw err;
});

Window refresh issue

If electron-edge-js module is used on main Electron thread refreshing the window (F5, Ctrl+R, Command+R etc) will cause a hard crash in electron-edge-js module and Electron app.
Currently there is no solution to this issue other than using Electron IPC.

Documentation

For full documentation see edge-js repo.

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

C++coreclrcsharpdotnetdotnet-core

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言