/electron-edge-js

Run .NET and Node.js code in-process on Windows, MacOS, and Linux

Primary LanguageC++Apache License 2.0Apache-2.0

.NET and Node.js in-process on Electron

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

Compatible with

  • Electron 1.6.x - Node.js v7.4.0.
  • Electron 1.7.x - Node.js v7.9.0.
  • Electron 1.8.x - Node.js v8.2.1.
  • Electron 2.x - Node.js v8.9.3.
  • Electron 3.x - Node.js v10.2.0.
  • Electron 4.0.4+ - Node.js v10.11.0.
  • Electron 5.x - Node.js v12.0.0.
  • Electron 6.x - Node.js v12.4.0.
  • Electron 7.x - Node.js v12.8.1
  • Electron 8.x - Node.js v12.13.0
  • Electron 9.x - Node.js v12.14.1
  • Electron 10.x - Node.js v12.16.3
  • Electron 11.x - Node.js v12.18.3
  • Electron 12.x - Node.js v14.16.0

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

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

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

Requirements (Windows)

You must install Microsoft Visual C++ Redistributable (x86)

Why use electron-edge-js?

Electron is built using specific version of Node.js. In order to use edge in Electron project you would need to recompile it using the same Node.js version and Electron headers.

electron-edge-js comes precompiled with correct Node.js versions and headers.

Quick start

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

Packaging Electron application

Packaging example based on the app above.
https://github.com/zenb/electron-edge-js-quick-start

Related issues to use for troubleshooting:
agracio#39
agracio#74
agracio#21

Async execution

Underlying 'edge' component is written as synchronous C++ Node.js module and will cause Electron app to freeze when executing long running .NET code.
For workaround refer to this issue: agracio#97

Documentation

For full documentation please see see original edge-js repo.