persagy_electron

备注及第三方库版本号说明

1、需把镜像源切换到taobao
	切换方法，先安装nrm 然后使用nrm use taobao
2、第三方库说明
	nodejs需大于14.0
	"electron":"12.0.1",
	"electron-packager":"15.2.0",
	"body-parser": "1.19.0",
	"ejs": "^3.1.5",
	"express": "4.17.1",
	"log4js": "^6.3.0",
	"request": "^2.88.2",
	"ffi-napi":"3.1.0",
	"extract-zip": "^2.0.1"

安装

1.打开cmd命令窗口
2.cd到要使用persagy_electron的项目目录
3.查看npx是否可用 
	输入命令 npm -v			查看npm版本信息，版本需>=5.2
	输入命令 npx -v 		输出版本信息的话代表npx命令可用，否则请执行 npm install -g npx
4.执行命令：
	npx persagy_electron
	persagy_electron为模块名称

运行

开发环境

	1.cd 到项目根目录下，执行：npm run electron_dev
	2.在vs_code里，点击 运行 ->  调试

生产环境

	找到打包的生成目录，运行其内的项目名称.exe文件即可，该exe文件的运行不依赖node等环境，即：电脑上没有安装node环境，依然可运行该exe文件

设置vscode调试

vscode顶部点击 运行 -> 打开配置 ->NodeJs环境     把以下配置复制进去，覆盖掉已有的全部配置

{
	// 使用 IntelliSense 了解相关属性。 
	// 悬停以查看现有属性的描述。
	// 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
	"version": "0.2.0",
	"configurations": [
		{
			"type": "node",
			"request": "launch",
			"name": "启动程序",
			"cwd": "${workspaceFolder}",
			"runtimeExecutable": "npm",
			"runtimeArgs": ["run","electron_dev"],
			//跟踪调试对象的所有子过程，并自动附加到在调试模式下启动的子过程
			"autoAttachChildProcesses": true,
			//自动断点到第一行代码处
			"stopOnEntry": false
		  }
	]
}

打包

cd到项目根目录下，执行：npm run electron_build_win   会对项目进行打包，默认生成到项目根目录下的electronBuild目录内

配置说明

开发环境下的配置位于  electron_server/electron_build_config.js内
生产环境下的配置位于 生成的打包目录/config.js内

persagy_electron程序和persagy_electron程序通信、普通网页和persagy_electron程序通信说明

被调用方

声明供调用方进行远程调用的方法 
	声明方式：electron_render.electron_controll_fn_stat(fn);
	传入的fn可以是页面上存在的任意一个方法，此处以公司现用的框架来举例，假设供远程调用的方法为test，示例如下：
	export default {
		name:'',
		data(){
			return {
				myName:'测试控制的名称'
			};
		},
		methods:{
			test:function(x,y){
				console.log('我是：'+this.myName+'，我要控制的x为：'+x+'我要控制的y为：'+y);
			}
		},
		mounted:function(){
			var _this=this;
			Vue.nextTick(function () {
				electron_render.electron_controll_fn_stat(_this.test);
			});
		}
	}

调用方

以任意的形式或第三方库发送http请求到被调用方
	此处以公司现用的前端框架来举例说明，且假设要调用的方法为上述被调用方里的test，代码如下：
		1.在persagy_config.js里增加
			'/api/electron_comm': {
				target: 'http://192.168.0.48:8088',
				pathRewrite: { '^/api/': '/' }
			}
			
			说明：
				electron_comm固定，api可以不写
				target里的ip地址为被调用方的ip地址，端口号为被调用方监听的端口号
		2.在需要调用远程方法的地方发送请求
			axios.request({
			  url: "/api/electron_comm/3DMODEL/test",
			  method: "post",
			  data: [0, 1]
			})
			.then((res) => {})
			.catch((err) => {});
			
			说明：
				url中的/api/electron_comm为persagy_config.js里的配置，3DMODEL是指令类型(见下述操作指令类型说明)，test为要调用的远程控制方法名称
				data固定为数组类型，数组顺序、长度要和调用的远程控制方法的参数保持一致；此例中对应test方法的参数，第一项对应参数x，第二项对应参数y。
				收到返回 {r:1} 代表调用成功了

操作指令类型说明

3DMODEL		3D模型之间进行远程通信控制