`.NET 与 Node.js 在 Electron 中的无缝集成`

.NET 与 Node.js 在 Electron 中的无缝集成

electron-edge-js Run .NET and Node.js code in-process on Windows, MacOS, and Linux 项目地址: https://gitcode.com/gh_mirrors/el/electron-edge-js

本指南将引导您完成在 Electron 应用程序中集成 .NET 和 Node.js 的全过程，利用 electron-edge-js 这一强大工具。通过此文档，您将了解到如何安装、使用、理解其 API，以及正确的打包方法。

安装指南

为了开始您的旅程，确保您的开发环境已准备好支持 Electron 和 Node.js 开发。首先，通过以下命令安装 electron-edge-js：

npm install electron-edge-js

这个命令会自动下载对应您 Electron 使用的 Node.js 版本的预编译二进制文件，除非您是在 Linux 或 macOS 上工作，这时候 npm install 会根据当前 Electron 版本自动生成必要的绑定。

项目使用说明

一旦安装完毕，您只需简单地替换原本对 edge-js 的引用为 electron-edge-js。例如：

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

接下来，您可以像平常一样调用 .NET 功能，如下面的例子所示：

var helloWorld = edge.func(function () {/*
    async (input) => {
        return ".NET Welcomes " + input.ToString();
    }
*/});
helloWorld('User', function(error, result){
    if(error) throw error;
    console.log(result);
});

项目API使用文档

electron-edge-js 的核心在于它允许您以几乎相同的方式调用 .NET 方法，就像在边缘-JS中一样。主要变化在于确保兼容性和预先编译来适应 Electron 环境。具体的API细节和高级功能，请参考原始 edge-js 文档。记住，尽管库名不同，但大多数API用法保持一致。

项目打包方式

打包 Electron 应用时，特别注意要将 electron-edge-js 作为外部模块处理，避免将其打包进应用包内。对于不同的构建工具，有不同的配置方法：

Vue.js with electron-builder

在 vue.config.js 中添加：

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

并且可能需要在 main.js 处理路径：

require("module").globalPaths.push(process.cwd() + '/node_modules');
var edge = require('electron-edge-js');

使用Webpack

在 webpack.config.js 中，配置外部依赖和额外资源：

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

异步执行注意事项

请注意，在主进程使用 electron-edge-js 执行耗时的 .NET 代码可能导致界面冻结。解决办法是利用 worker thread，比如 threads.js 或 piscina ，或者通过 Electron 的 Inter-Process Communication (IPC) 来异步调用函数。

通过遵循上述步骤，您应该能够成功地在您的 Electron 应用中整合 .NET 功能，并享受高效的跨平台开发体验。遇到具体问题时，参考相关的 GitHub 讨论和已知问题可以提供额外的帮助。

electron-edge-js Run .NET and Node.js code in-process on Windows, MacOS, and Linux 项目地址: https://gitcode.com/gh_mirrors/el/electron-edge-js