Qcadoo MES编译、运行、调试的相关配置

一、环境及参考文档

1、参考文档：

 

2、环境：

注：本文编译、运行、调试都是基于window环境的；

IDE采用的是idea；

jdk1.8（源码要求是1.8版本，11版本编译不过）；

maven是3.8.1；

数据库是postgresql9.5.4（源码要求是9.5版本，13版本运行不了）。

 

注：数据库安装，可以采用docker安装，也可以采用本地安装，数据库用户名：postgres， 密码：postgres123

1）Docker采用compose安装：

version: "3.8"

services:

  postgresql:

    image: postgres:9.5.4

    container_name: pgsql_qcadoo

    restart: always

    environment:

      POSTGRES_USER: postgres

      POSTGRES_PASSWORD: postgres123

      POSTGRES_DB: postgres

      PGDATA: /var/lib/postgresql/data/pgdata

    volumes:

      - D:/env/qcadoo/postgresql/data:/var/lib/postgresql/data

    ports:

      - 5432:5432

注：如果docker安装，可以本地安装一下psql命令，方便后面初始mes数据库的时候会用到；

 

2）本地安装

注：本地安装里面带有psql命令，后面初始mes数据库的时候会用到，可以将其设置到path路径下；

 

二、下载源码

Git clone依次下载下面所示路径的源码，默认下载的是master分支；

1、

2、

3、

4、

 

说明：

qcadoo-super-pom-open：父工程的pom设置信息；

qcadoo-maven-plugin：qcadoo基础框架的maven插件；

qcadoo：qcadoo基础框架平台；

mes：mes是在qcadoo基础上开发的基于mes业务的应用。

注意：

源码是放在github上的，下载过程中可能不会成功，多尝试几次，如果还是不行，可以通过socks5代理下载(前提要有一个可以访问外网的socks5代理器)，socks5代理设置与取消代理命令，命令如下：

代理设置：

git config --global http.proxy socks5://127.0.0.1:1080

git config --global https.proxy socks5://127.0.0.1:1080

取消代理：

git config --global --unset http.proxy

git config --global --unset https.proxy

三、编译工程

注：确定maven与jdk都已经安装，并且与参文档中的环境是一致的；

注：编译要按照下面顺序依次编译。

1、编译qcadoo-super-pom-open

1）打开cmd命令框，进入qcadoo-super-pom-open所在目录

2）执行命令mvn clean install

 

2、编译qcadoo-maven-plugin

1）打开cmd命令框，进入qcadoo-maven-plugin所在目录

2）执行命令mvn clean install

 

 

 

3、编译qcadoo

1）打开cmd命令框，进入qcadoo-maven-plugin所在目录

2）执行命令mvn clean install -DskipTests ,这里跳过测试

 

 

 

4、编译mes

1）打开cmd命令框，进入mes所在目录

2）执行命令mvn clean install -DskipTests ,这里跳过测试

 

 

 

5、编译mes-application

注：其实上一步骤已经编译并生成了war包，这一步主要是采用profile是tomcat的形式编译，编译过程中会下载tomcat环境，设置tomcat的启动参数（在bin目录在添加setenv.bat文件），并且把mes与tomcat打包在一起，生成zip文件；

1）打开cmd命令框，进入mes/mes-application所在目录

2）执行命令mvn clean install -DskipTests -Ptomcat -Dprofile=package

 

注：在编译过程中可能出现bootstrap无法下载的错误，这个是因为路径找不到tomcat的bootstrap.jar，这时可以手动离线安装bootstrap.jar，只要去tomcat官网下载对应版本(目前使用的是8.5.12)的tomcat，把tomcat的bin目录中的bootstrap.jar手动离线安装一下就可以了，如果出现其它jar无法下载的，方法类似；

命令如下：

mvn install:install-file -Dfile=D:/bootstrap.jar -DgroupId=org.apache.tomcat -DartifactId=bootstrap -Dversion=8.5.12 -Dpackaging=jar

 

注：在编译mes-application完后会生成mes-application.zip文件，这个是集成了tomcat的可运行版本。

 

四、运行mes

注：postgresql9.5版本的数据已安装，并且版本一致；

 

1、将mes-application.zip复制出来，并解压；

2、初始数据库

1）在源码路径或mes-application.zip中找到初始sql：

a)源码的路径：

“/mes/mes-application/src/main/resources/schema/demo_db_en.sql”

 

b)mes-application.zip路径：

"mes-application\webapps\ROOT\WEB-INF\classes\schema\demo_db_en.sql"

2）安装

a)创建数据库mes，注，用户名：postgres，密码：postgres123

 

b)psql -U postgres mes < demo_db_en.sql

 

 

注：如果没有安装psql 工具可以，通过第三方的连接工具连接，要创建数据命名为mes

 

3、运行

进入mes-application.zip解压后的目录，运行bin/startup.bat文件，

 

注：启动过程可能需要几分钟；

 

4、打开登录界面

 

注：登录用户名superadmin，密码：superadmin

 

五、调试源码

1、打开idea，并打开mes工程，注：idea的maven与jdk环境已设置

 

2、打开ProjectStructure

 

3、设置artifacts，可以把原有的artfacts全清除再添加；

 

添加web application:Exploded

 

 

将输出目录设置到mes/mes-application/target/mes-application-1.5-SNAPSHOT/

 

添加web application:Archive

 

将其名字修改为mes-application-1.5-SNAPSHOT

输出目录设置到mes/mes-application/target/

 

3、设置tomcat server

注：设置tomcat server中的路径为mes-application.zip的解压路径。

 

 

 

 

 

4、添加部署件，并将Application Context改为/ROOT

 

 

 

5、修改tomcat启动前的运行命令

   清空Before launch

 

 

  

 

添加Run mvn goal

 

设置工作目录为mes/mes-application，命令为install

 

 

 

 

6、启动调试

 

 

 

注：如果调试启动过程发生错误，大多原因都是war包中的mes插件没有编译进去，所以需要查看上面调试设置是否正确。