# myApps4.4开发环境配置文档
--------

## 开发环境设置

安装JDK

此处以Java SDK1.8为例：  

1. 解压安装JDK

2. 配置环境变量

   新建一个系统变量，变量名为JAVA_HOME，变量值为JDK的安装目录，如C:\JAVA\jdk1.8.0_65  

   打开系统变量Path，添加%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;

## 安装Redis

命令行方式运行

1. 解压Redis-x64-3.2.100.zip
2. 运行redis-server.exe（启动Redis）
3. 运行redis-cli.exe检查是否启动成功
服务方式运行

1. 解压Redis-x64-3.2.100.zip
2. 运行installService.bat（安装windows服务）
3. 运行redis-cli.exe检查是否启动成功

## 安装MySQL

此处以Windows为例：  

1. 解压mysql-5.7.14-win32.zip
2. 运行StartMysSQL.bat（注册MySql服务，并运行Mysql服务）  
3. 本地访问的账号为root，密码为空；外网访问的账号为root，密码为123456

## 安装Consul

命令行方式运行

1. 解压consul_1.4.3_windows_amd64.zip
2. cmd输入命令：consul agent -dev（开发模式启动Consul） 
3. 浏览器访问 http://localhost:8500 。检查是否运行成功

服务方式运行

1. 解压consul_1.4.3_windows_amd64.zip
2. 运行installService.bat
3. 浏览器访问 http://localhost:8500 。 检查是否运行成功

## IDE选择

天翎公司建议的IDE工具是Spring Tools Suit4（安装Subslipse插件实现对SVN的支持），前端开发工具建议用Visual Studio Code。虽然InteliJ IDEA也是一个不错的IDE工具，考虑到尊重版权的原因不在公司范围内推荐。

## 导入项目

从svn：https://www.teemlink.com:8443/svn/platform/trunk2018 检出工程到本地，将项目部署到工具中并下载相关的依赖。

使用开发工具例如：Spring Tools Suit4，步骤如下：File->Import->Maven->Existing Maven Project引入到workspace中。出现错误后，根据STS的Problems窗口提示，修正之（通常是maven 需要Update、JDK版本不匹配、Project Facade等）

## 修改项目配置文件

每一个obpm-xxx-consul都是可以单独启动的模块，进入\obpm-xxx-consul\src\main\resources\application.yaml 将数据库连接参数修改为本地的数据库，myapps.storage.root: 修改为自己本地的obpm-demo路径\obpm-xxx-consul\src\main\resources\hibernate.properties 中数据库连接参数修改为本地的数据库连接。

将\obpm-demo\proxool.properties 中数据库连接参数修改为本地的数据库连接。

## 运行项目

在修改完配置文件后，

在首次checkout项目后，执行一下项目根目录下的install-clean.bat或install.bat文件，目的是为了将obpm-xxx-web的资源文件copy到/obpm-xxx-consul\target\classes\static下，然后找到工程的入口文件，\obpm-xxx-consul\src\main\java\cn\myapps文件夹下的xxxWithConsulApp.java，右键点击文件->Run As->Spring Boot App。

在更新或者修改了obpm-xxx-web目录下面的文件之后，可以执行一下对应的obpm-xxx-consul目录下面的build.bat，目的是为了将最新的资源文件copy到/obpm-xxx-consul\target\classes\static下。

## 进入前台页面的启动顺序

首先启动网关 obpm-gateway ,然后启动登录模块 obpm-signon-consul,再启动运行时obpm-runtime-consul

访问路径为：localhost:8080

后台企业域地址为:localhost:8080/obpm/admin

也可以单独启动obpm-runtime-consul模块

访问路径为：localhost:8083/obpm

后台企业域地址为:localhost:8083/obpm/admin

## 进入软件管理页面

启动obpm-designer-consul模块

访问路径为：localhost:8082/designer