卓尔高考网

Electron 框架中调用 Python 构建桌面应用

篇首语:本文由小编为大家整理,主要介绍了Electron 框架中调用 Python 构建桌面应用相关的知识,希望对你有一定的参考价值。

参考技术A

不同的语言、框架都有自己擅长的领域:Electron 基于 Chromium 和 Node.js 能以 Web 开发的模式打造桌面应用,开发用户界面又快捷又简单;Python 则在数据分析、自动化脚本等领域有非常多的应用。两者的社区生态都十分强大,由两者共同构建应用,在界面开发、功能、性能上能够强强联合;

为了简单验证技术可行性,我们来编写一个 Demo:

目的:验证 Electron 打造的桌面应用能够调用 Python,思路是使用 RPC 或 HTTP 或 WebSocket 进行通信

Demo 功能:输入 x、y 坐标,程序会移动鼠标到屏幕的 x,y 位置(通过 python 库 pyautogui 实现)

Demo 运行环境:MacOS、pyInstaller: 版本 4.5.1、python: 版本 3.9.7

源码:-------- 项目源码 --------

注意:移动鼠标需要授予应用控制权限,在 MacOS 下设置 偏好设置 -> 隐私 -> 辅助功能 -> 允许对应的应用。

技术栈:NodeJS、Electron、Python、aiohttp(HTTP、WebSocket)、pyautogui(控制鼠标)

为了使 NodeJS 和 Python 能够通信,Python 需要启动一个本地通信服务,Demo 中 py/api.py 能够启动一个本地 HTTP 服务:

然后我们需要执行 Python 代码以启动服务,为了使 NodeJS 可以执行 Python,我们使用 pyinstaller 将 Python 打包成可执行文件:

Python 启动了本地 HTTP 服务后,Chromium 和 Node.js 就可以通过请求的方式,与 python 连接通信了:

简单来说三个步骤:

本项目只是一个验证思路的 Demo,真的需要在项目上实践,还需要考虑以下几个点:

应该使用 RPC 通信而不是 HTTP 或者 WebSocket,Demo 使用 HTTP 只是搭建方便。实践中在建立连接、保持连接、异常重连都需要编写更多的逻辑来处理。为什么 Demo 没有使用 zerorpc? 这个库已经 4 年没有维护了,不兼容新版 NodeJS。

项目通过 pyinstaller 打包成可执行文件来调用 python。实际上其他能编译为可执行文件的语言也一样。还可以使用 WebAssembly 将其他语言编译成 .wasm,在 NodeJS 中引入执行。

原创从零开始搭建Electron+Vue+Webpack项目框架,一套代码,同时构建客户端web端

导航:

(一)Electron跑起来
(二)从零搭建Vue全家桶+webpack项目框架
(三)Electron+Vue+Webpack,联合调试整个项目
(四)Electron配置润色
(五)预加载及自动更新
(六)构建、发布整个项目(包括client和web)

摘要上篇文章说到了如何新建工程,并启动一个最简单的Electron应用。“跑起来”了Electron,那就接着把Vue“跑起来”吧。有一点需要说明的是,webpack是贯穿这个系列始终的,我也是本着学习的态度,去介绍、总结一些常用到的配置及思路,有不恰当的地方,或者待优化的地方,欢迎留言。项目完整代码:https://github.com/luohao8023/electron-vue-template

下面开始~~~

一、安装依赖

vue、webpack:不多说了

vue-loader:解析、转换.vue文件

vue-template-compiler:vue-loader的依赖包,但又独立于vue-loader,简单的说,作用就是使用这个插件将template语法转为render函数

webpack-dev-server:快速搭建本地运行环境的工具

webpack-hot-middleware:搭配webpack-dev-server使用,实现热更新

chalk:命令行输出带有颜色的内容

依赖包就介绍这么多,后面需要什么可以自行下载,这里不多赘述了。

 

二、完善工程目录

  

webpack.render.config.js:渲染进程打包配置

dev.js:本地调试脚本

views:页面代码

index.js:vue工程入口文件

index.ejs:打包生成html文件时的模板

三、配置Vue工程

1、编写入口文件,render>index.js

import Vue from "vue";import index from "./views/index.vue";//取消 Vue 所有的日志与警告Vue.config.silent = true;new Vue({    el: "#app",    render: h => h(index)});

2、编写根组件,render>views>index.vue

3、编写html模板文件,render>index.ejs,webpack解析、打包vue文件时,以此模板生成html文件

        模板文件                        

4、编写webpack配置文件,builder>webpack.render.config.js,建议按照本文这种方式,把配置文件单独抽出来,这样的话,本地调试和打包可以共用一套配置,只需要传递不同参数就可以了,不要把所有的配置和打包逻辑写在一个文件里,太长、太乱、太难维护

/*Name:    渲染进程配置Author: haoluoDate:   2019-10-30 */const path = require("path");const HtmlWebpackPlugin = require("html-webpack-plugin");const devMode = process.env.NODE_ENV === "development";module.exports = {    mode: devMode ? "development" : "production",    entry: {        main: "./src/render/index.js"    },    output: {        path: path.join(__dirname, "../app/"),        publicPath: devMode ? "/" : "",        filename: "./js/[name].[hash:8].js"    },    module: {        rules: [            {                test: /\.vue$/,                exclude: /node_modules/,                loader: "vue-loader"            }        ]    },    plugins: [        new HtmlWebpackPlugin({            template: "./src/render/index.ejs",            filename: "./index.html",            title: "electron-vue-template",            inject: false,            hash: true,            mode: devMode        })    ]}

适当解释一下:

mode:环境参数,针对不同的环境,webpack内部有一些不同的机制,并对相应环境做相应的优化

entry:入口,webpack执行构建的第一步将从入口文件开始,递归查询并解析所有依赖的模块。配置方式有多种,可参考webpack文档,这里我们配置的路径是"./src/render/index.js",意思是src目录下,render文件夹下的index.js,而webpack配置文件是在builder文件夹下,那这个“./”的相对路径到底是相对于谁呢?这就得说一下webpack中的路径问题了,context 是 webpack 编译时的基础目录,入口起点(entry)会相对于此目录查找,那这个context又是个什么东西?webpack源码有关默认配置中有这么一句话

this.set("context", process.cwd());

这就是context的默认值,工程的根目录,那这个entry的配置就很好理解了。

output:打包的输入配置,路径建议设置为绝对路径。

module和plugins就不多说了。

5、编写本地调试脚本

/*** Tip:    调试渲染进程* Author: haoluo* Data:   2019-10-30**/process.env.NODE_ENV = "development";const webpack = require("webpack");const WebpackDevServer = require("webpack-dev-server");const webpackHotMiddleware = require("webpack-hot-middleware");const chalk = require("chalk");
const http = require("http");
function devRender() {    console.log("启动渲染进程调试......");    const webpackDevConfig = require("./webpack.render.config.js");    const compiler = webpack(webpackDevConfig);    new WebpackDevServer(        compiler, {            contentBase: webpackDevConfig.output.path,            publicPath: webpackDevConfig.output.publicPath,            open: true,//打开默认浏览器            inline: true,//刷新模式            hot: true,//热更新            quiet: true,//除第一次编译外,其余不显示编译信息            progress: true,//显示打包进度            setup(app) {                app.use(webpackHotMiddleware(compiler));                app.use("*", (req, res, next) => {                    if (String(req.originalUrl).indexOf(".html") > 0) {                        getHtml(res);                    } else {                        next();                    }                });            }        }    ).listen(8099, function(err) {        if (err) return console.log(err);        console.log(`Listening at http://localhost:8099`);    });    compiler.hooks.done.tap("doneCallback", (stats) => {        const compilation = stats.compilation;        Object.keys(compilation.assets).forEach(key => console.log(chalk.blue(key)));        compilation.warnings.forEach(key => console.log(chalk.yellow(key)));        compilation.errors.forEach(key => console.log(chalk.red(`${key}:${stats.compilation.errors[key]}`)));        console.log(chalk.green(`${chalk.white("渲染进程调试完毕\n")}time:${(stats.endTime-stats.startTime)/1000} s`));    });}function getHtml(res) {    http.get(`http://localhost:8099`, (response) => {        response.pipe(res);    }).on("error", (err) => {        console.log(err);    });}devRender();

都是一些常规操作,可以阅读一下代码。

6、配置启动命令,在package.json中新增dev命令,启动本地调试(先起了再说,报错什么的,见招拆招)

  "scripts": {    "start": "electron ./src/main/main.js",    "dev": "node ./builder/dev.js"  },

然后命令行运行npm run dev。。。。。。反正我这儿是报错了。。。说是找不到html-webpack-plugin模块,那就运行npm i html-webpack-plugin -D安装一下,如果步骤一没有做的话,后面可能还会遇到很多模块找不到的情况,解决方法很简单,缺什么安装什么就好了。安装完所有的模块之后,启动,还是报错了。。。。。。

ModuleNotFoundError: Module not found: Error: Can"t resolve "vue" in ...ModuleNotFoundError: Module not found: Error: Can"t resolve "vue-loader" in ...

检查了下package.json文件和node_modules,发现我的vue-loader没有装,然后就是装一下(如果没有遇到这个步骤,可以忽略)

再次运行

  

这个报错就很友好了吗,就是vue-loader告诉你,必须安装vue-template-compiler插件,不然就不工作,那就装一下。

接着运行,就知道没那么容易成功

  

vue-loader报错说缺少了插件,让检查是否配置了VueLoaderPlugin插件,搜一下这是个什么鬼,看这里,15+版本的vue-loader需要配合VueLoaderPlugin使用,然后看了一下我使用的vue-loader版本15.7.1,那就配一下这个东西。

  

接着运行,终于没有报错了,但是页面为啥子是白的,我的h1标签呢?冷静下来分析一下问题,页面没有东西说明我打包时生成的html文件有问题(devServer会把打包出来的静态文件保存在内存里),而html文件是根据ejs模板生成的,那会不会是模板配置有问题?

  

看一下我们的模板,结构是没什么问题啊,但是,没有引用css和js文件啊,也就是我们辛辛苦苦解析vue文件,打包css和js,最后却没有引用。。。好吧,那就再配置一下ejs模板,把相应的文件引入一下

<%function getFilePath(filename,libsPath){    let _filenameSearchIndex=filename.indexOf("?");    let _libsPathSearchIndex=libsPath.indexOf("?");    let _filename=filename.substr(0,_filenameSearchIndex<1?filename.length:_filenameSearchIndex);    let _libsPath=libsPath.substr(0,_libsPathSearchIndex<1?libsPath.length:_libsPathSearchIndex);    let htmlfilename=path.relative(_filename,_libsPath);    return libsPath;}let path = require("path"),jsArr = [],cssArr = [];let filename="./index.html";    //修正目录结构    for(let i=0;i){        let name=getFilePath(filename,String(htmlWebpackPlugin.files.css[i]));        cssArr.push(name);    }    for(let i=0;i){        let name=getFilePath(filename,String(htmlWebpackPlugin.files.js[i]));        jsArr.push(name);    }%>        <%= htmlWebpackPlugin.options.title %>                        <% cssArr.forEach(css=>{ %>    <% }) %>    

<% jsArr.forEach(js=>{ %> <% }) %>

我们可以在ejs中拿到html-webpack-plugin插件的一些信息,比如插件配置、生成的文件等,然后拿到js和css文件,并引入进来,这里建议看一下ejs模板语法。

我们接着运行,终于出来了。

  

7、配置打包脚本

在builder文件夹下新建build.js,引入配置,直接运行webpack打包即可,不需要devServer。

/*** Tip:    打包* Author: haoluo* Data:   2019-10-30**/process.env.NODE_ENV = "production";const chalk = require("chalk");const del = require("del");const webpack = require("webpack");const renderConfig = require("./webpack.render.config.js");del(["./app/*"]); //删除历史打包数据viewBuilder().then(data => {    console.log("打包输出===>", data)}).catch(err => {    console.error("打包出错,输出===>", err);    process.exit(1);});function viewBuilder() {    return new Promise((resolve, reject) => {        console.log("打包渲染进程......");        const renderCompiler = webpack(renderConfig);        renderCompiler.run((err, stats) => {            if (err) {                console.log("打包渲染进程遇到Error!");                reject(chalk.red(err));            } else {                let log = "";                stats.compilation.errors.forEach(key => {                    log += chalk.red(`${key}:${stats.compilation.errors[key]}`) + "\n";                })                stats.compilation.warnings.forEach(key => {                    log += chalk.yellow(key) + "\n";                })                Object.keys(stats.compilation.assets).forEach(key => {                    log += chalk.blue(key) + "\n";                })                log += chalk.green(`time:${(stats.endTime-stats.startTime)/1000} s\n`) + "\n";                resolve(`${log}`);            }        })    })}

在package.json中新增打包命令

"scripts": {    "start": "electron ./src/main/main.js",    "dev": "node ./builder/dev.js",    "build": "node ./builder/build.js"  },

npm run build执行打包,这次还真是出奇的顺利啊,看一下app文件夹,已经生成了静态文件,然后直接在浏览器打开index.html文件,正常显示。

 

四、使用vuex,vue-router,axios

说好的全家桶呢,这里我们不用vue-resource了,使用axios。

1、使用vuex

安装vuex依赖,在src>render文件夹下新建store文件夹,并在store文件夹下新增:

actions.js

export default {}

index.js

import Vue from "vue";import Vuex from "vuex";import actions from "./actions.js";import mutations from "./mutations.js";Vue.use(Vuex);// 这里为全局的,模块内的请在模块内动态注册const store = new Vuex.Store({    strict: true,    state: {        userInfo: {            name: "haoluo",            address: "beijing"        }    },    getters: {},    mutations,    actions});export default store;

mutations.js

export default {    //设置用户信息    setUserInfo(state, config) {        if (!config) {            state.userInfo = {};        }        for (var objName in config) {            state.userInfo[objName] = config[objName];        }    }}

以上三个文件的实力代码,比官网教程还简单,可以自行研究一下文档。

文件建好之后,需要把store挂载到vue实例上,找到vue工程的入口文件,src>render>index.js

import Vue from "vue";import store from "./store/index.js";import index from "./views/index.vue";//取消 Vue 所有的日志与警告Vue.config.silent = true;new Vue({    el: "#app",    store: store,    render: h => h(index)});

然后我们就可以使用啦,找到根组件,src>render>views>index.vue

mapState是state的辅助函数,是个语法糖,借助mapState我们可以更方面的获取属性,而不需要写一堆啰里吧嗦的东西,通过计算属性computed接收userInfo,然后就可以使用啦,运行本地调试,发现页面上已经可以正常显示了

属性有了之后我们可以使用,但如果想要改变vuex中存储的属性呢?为了保证单向数据流以及方便对数据的追踪等一些其他原因,不建议直接修改vuex的属性,而是需要通过mutations,这里也有一个辅助函数mapMutations,用法同mapState类似,只不过需要用methods去接收,作为一个全局方法使用

当点击按钮的时候。userInfo中的address被修改了,页面渲染的值也相应的改变了

 

2、使用vue-router

安装vue-router依赖,在render文件夹下新增router文件夹,并在其中新增index.js

module.exports = [    {        path: "/index.html",        name: "index",        meta: {            title: "首页",            author: "--",            parentRouter: "--"        },        component: (resolve) => {            require.ensure([], () => {                return resolve(require("../views/index.vue"))            }, "index")        },        children: []    }];

在入口文件render>index.js中引入并挂载

// render>index.jsimport Vue from "vue";import VueRouter from "vue-router";import store from "./store/index.js";import routers from "./router/index.js";import index from "./views/index.vue";Vue.use(VueRouter);let router = new VueRouter({    routes: routers})//取消 Vue 所有的日志与警告Vue.config.silent = true;new Vue({    el: "#app",    router: router,    store: store,    render: h => h(index)});

运行一下,页面可以正常显示,在地址栏输入http://localhost:8099/index.html时,也是没有问题的,现在新增加一个页面,订单页

再配置下路由

module.exports = [    {        path: "/index.html",        name: "index",        meta: {            title: "首页",            author: "--",            parentRouter: "--"        },        component: (resolve) => {            require.ensure([], () => {                return resolve(require("../views/index.vue"))            }, "index")        },        children: []    },    {        path: "/order.html",        name: "order",        meta: {            title: "订单页",            author: "--",            parentRouter: "--"        },        component: (resolve) => {            require.ensure([], () => {                return resolve(require("../views/order.vue"))            }, "order")        },        children: []    }];

并在首页index.vue中增加跳转按钮,运行之后,发现跳不过去,尴尬~~~,路由跳转,需要有去接收才行啊

改造一下吧,views下新增home.vue,把index.vue中的内容拷贝过去,index.vue改为下面这样

router文件改为下面这样

module.exports = [    {        path: "/index.html",        name: "index",        meta: {            title: "首页",            author: "--",            parentRouter: "--"        },        component: (resolve) => {            require.ensure([], () => {                return resolve(require("../views/index.vue"))            }, "index")        },        children: [            {                path: "/home.html",                name: "home",                meta: {                    title: "home页",                    author: "--",                    parentRouter: "--"                },                component: (resolve) => {                    require.ensure([], () => {                        return resolve(require("../views/home.vue"))                    }, "home")                },                children: []            },            {                path: "/order.html",                name: "order",                meta: {                    title: "订单页",                    author: "--",                    parentRouter: "--"                },                component: (resolve) => {                    require.ensure([], () => {                        return resolve(require("../views/order.vue"))                    }, "order")                },                children: []            }        ]    }];

再次运行,页面已经可以正常跳转了。

3、axios,这里暂时不说,后续electron和vue联调的时候会补上。

几点说明:

  1、截止目前,webpack配置以及dev和build脚本仅仅是调通大致的流程,还有很多可优化可考究的地方,后续完善项目的过程中会对打包流程逐渐润色;

  2、vue全家桶在实际项目中高级用法很多,细节也很多,这里只是最简单的用法,如若用到实际项目中,还要基于目前情况再做细化;

  3、本系列文章旨在记录、回顾整个项目框架搭建流程,把握整体结构,很多地方需要根据实际项目再做处理;

  4、如有错误或不当的地方,欢迎指出,共同进步!

 

以上是关于Electron 框架中调用 Python 构建桌面应用的主要内容,如果未能解决你的问题,请参考以下文章

您可能还会对下面的文章感兴趣: