NCCloud开发环境搭建

工具安装

JDK1.8

  1. 解压ufjdk1.8.jar,可以直接使用,也可以自行下载1.8版本的JDK。
  2. 配置Java环境变量,这个就不多说了。*此步骤也可以不做,开发环境启动后使用eclipse中设置的jre。

Node.js

1、找到所需版本的NodeJs安装文件(*.msi),双击运行,可自行选择安装路径,然后按照提示一直进行下一步操作,全都使用默认设置即可。

2、检查环境变量

系统环境变量Path中有刚才安装的nodejs路径:

NCCloudNCCloud开发环境搭建插图

3、检测是否安装成功

输入命令,能够正常输出版本信息:

NCCloudNCCloud开发环境搭建插图1

VS Code

找到所需版本的VsCode安装文件(.exe),双击运行,按提示安装即可。

*建议直接安装中文插件

NCCloudNCCloud开发环境搭建插图2

*以上步骤出现任何问题都可以自行百度处理。

Eclipse

找到所需版本的Eclipse压缩包(.rar),解压备用。

NC Cloud Home

找到NCCloud2111HOME.jar,解压备用。

前端脚手架

找到NCCloud2111前端脚手架.rar,解压备用。

环境配置

有兴趣的可以先查阅“NCCloud2111新人系列:附1-产品安装”(如果找不到,那就是还没写完,没发布),其中讲述了产品是如何在项目上进行安装使用的,简单讲就是home、数据库是如何产生的。

数据库配置

找到Oracle数据库(版本11G)备份文件压缩包NCCloud2111DMP.jar,将数据库备份文件进行还原、导入即可。

如果项目组、或者部门有标准NCCloud2111版本的数据库环境,可以直接在数据源配置中使用。

home配置

jar包部署

1)如果:home/hotwebs/nccloud/WEB-INF/lib下有jar包,把整个lib剪切到home/external下;

2)如果:home/hotwebs/nccloud/WEB-INF/classes下有classes文件,停后端服务,把整个classes剪切到home/external下;

总之要保证home/hotwebs/nccloud/WEB-INF/下没有classes和lib下的jar包

目前针对这个操作,有一个批处理文件deploy.bat自动处理,但是我在使用的时候发现存在一些问题,这个可以根据实际情况酌情处理。

deploy.bat的用途解释:https://nccdev.yonyou.com/video/detail/106

解压jar包部署工具,将deploy.bat和tool.jar拷贝的home根目录,双击运行deploy.bat。

jar部署工具v1.rar

用于迁移WEB-INF/lib下的jar包到external/lib下,使用中可能会报错找不到指定路径的错误:

NCCloudNCCloud开发环境搭建插图3

解决方式:

删除以下路径:home/hotwebs/nccloud/WEB-INF/extend/yyconfig/modules/hrpub,

或者

将refer_hrpub.xml文件拷贝到报错路径中。

jar部署工具v2.rar

修复了v1版本报错的问题。

我在使用的过程中运行报错,无法使用。

jar部署工具v3.rar

在v2的基础上增加了迁移WEB-INF/lib/classes路径到external/classes下。

我在使用的过程中运行报错,无法使用。

应用服务配置

配置开发应用服务端的ip、端口等信息。

运行home/bin/sysConfig.bat,弹出以下对话框,按照箭头顺序进行操作:

服务器名称:必须为server;

协议类型:通常选择HTTP,目前我还没试过别的;

IP地址:开发环境一般配置本地就可以,127.0.0.1或localhost;

端口:不冲突就行;

NCCloudNCCloud开发环境搭建插图4

数据源配置

配置开发应用服务与数据库的绑定关系。

运行home/bin/sysConfig.bat,弹出以下对话框,点击读取,然后看界面按钮、信息进行操作:

design数据源:开发环境必须有一个数据源为design,home与eclipse绑定后会自动增加;
其他信息根据实际情况录入;

NCCloudNCCloud开发环境搭建插图5

关闭流量压缩配置

修改文件:hotwebs/nccloud/WEB-INFconfig/miscellaneous.xml;

NCCloudNCCloud开发环境搭建插图6

eclipse配置

运行eclipse,选择一个工作空间,然后会有一个友互通的登录提示,使用域账户应该就可以登录,用户名需要增加@yonyou.com,或者直接点击取消。

绑定home

点击 windows->Preferences:

UAP HOME:选择之后,会自动带出home中配置的数据源信息,此处与上面讲到的数据源配置基本一样;

OID标志:数据库主键生成策略中第5、6位的值,一般项目组会有要求,没有的话随意即可;

设为开发库:环境支持多数据源,此按钮是为了方便将某数据源配置直接拷贝到design中,作为开发连接数据库使用;

NCCloudNCCloud开发环境搭建插图7

配置JRE

点击 windows->Preferences,添加1.8版本的jdk,并设置为默认。

*绑定home之后,会自动添加ufjdk,此时只需要进行检查,不需要添加新的JDK。

NCCloudNCCloud开发环境搭建插图8

检查FIELD_CLIENT_IP、FIELD_CLIENT_PORT、FIELD_NC_HOME的值。

FIELD_CLIENT_IP:sysConfig中配置的应用服务IP地址

FIELD_CLIENT_PORT:sysConfig配置的应用服务端口

FIELD_NC_HOME:UAP HOME路径

NCCloudNCCloud开发环境搭建插图9

*进行上一步操作之后,Default VM arguments会有值,此时项目启动报错,上一步检查完成后这里如果有值的话,应该删掉,删掉之后就可以正常启动了。

NCCloudNCCloud开发环境搭建插图10

开发者设置

数据源设置、并测试通过后,配置开发者信息,选择机构、开发者之后保存即可。

NCCloudNCCloud开发环境搭建插图11

新建工程

新建一个开发环境运行的项目工程:

第一次打开工作空间时,通过点击Package Explorer中的Create a project…进行新建项目,后续可以通过右键 New->Project进行新建项目。

NCCloudNCCloud开发环境搭建插图12

选完之后有点儿慢,得稍微等会…

项目名称:字母+数字;

模块名称:字母+数字;

一般情况下项目名称与模块名称保持一致即可。

NCCloudNCCloud开发环境搭建插图13

启动项、VM参数配置

选择项目,点击右键:

NCCloudNCCloud开发环境搭建插图14
  1. 录入Main相关信息

Name:工程名+“_Server”

Project:选择对应工程

Main Class:ufmiddle.start.tomcat.StartDirectServer

NCCloudNCCloud开发环境搭建插图15
  1. 修改Arguments
NCCloudNCCloud开发环境搭建插图16

VM arguments:


-Dnc.exclude.modules=${FIELD_EX_MODULES}

-Dnc.runMode=develop

-Dnc.codefactor=develop

-Dnc.server.location=${FIELD_NC_HOME}

-DEJBConfigDir=${FIELD_NC_HOME}/ejbXMLs

-DExtServiceConfigDir=${FIELD_NC_HOME}/ejbXMLs

-Duap.hotwebs=nccloud,fs,uapws

-Duap.disable.codescan=false

-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl

-Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl

-Xms128M -Xmx512M -XX:NewSize=96M

-XX:MaxPermSize=256M

-Dorg.owasp.esapi.resources=${FIELD_NC_HOME}/ierp/bin/esapi

-Dfile.encoding=UTF-8

-Duser.timezone=GMT+8

启动工程

选择项目,右键->Debug AS(或者Run As)->NC Cloud中间件服务器

NCCloudNCCloud开发环境搭建插图17

或者使用快速启动方式

NCCloudNCCloud开发环境搭建插图18

控制台输出Server start up in **ms 时,说明服务器已经启动成功。

NCCloudNCCloud开发环境搭建插图19

前端配置

打开前端工程

运行VS Code,点击 Open folder…

NCCloudNCCloud开发环境搭建插图20

选择脚手架目录

NCCloudNCCloud开发环境搭建插图21
NCCloudNCCloud开发环境搭建插图22

平台文件同步

将以下文件夹拷贝到脚手架的src目录下,全部覆盖。

home/hotwebs/nccloud/resources/platform;

下载依赖

点击 终端->新建终端。

NCCloudNCCloud开发环境搭建插图23
NCCloudNCCloud开发环境搭建插图24

在终端输入:npm install,点击回车就开始下载了,需要的时间可能会稍长,耐心等待…
观察终端的输出信息,出现下图所示字样说明下载成功。

NCCloudNCCloud开发环境搭建插图25

配置config.json

buildEntryPath:配置需要编译的应用路径

proxy:配置应用服务器的IP地址和端口,与home中配置一致

devPort:前端开发应用访问端口

其他信息暂时先不用关注。

NCCloudNCCloud开发环境搭建插图26

启动项目

项目启动时需要配置 buildEntryPath 中的代码路径,否则,项目无法启动。

在开发过程中我们从git下载项目代码放到src目录下并配置到buildEntryPath 中,在此环境中我们先简单处理一下,让项目能够正常启动起来:

1)将文件夹home/hotwebs/nccloud/resources/uapbd拷贝到脚手架的src目录下;

2)配置config.json
编辑器的原因导致输入有问题,拷贝的时候注意去掉/*后面空格
buildEntryPath:”./src/uapbd/refer/* /* /index.js”

3)在终端输入命令:npm run dev

终端显示 Compiled successfully. 则启动成功。

NCCloudNCCloud开发环境搭建插图27

启动成功后,会自动启动浏览器并打开首页,如果未自动打开,则手动在浏览器中输入地址:
http://localhost:3006/nccloud/resources/uap/rbac/login/main/index.html

NCCloudNCCloud开发环境搭建插图28

Hi,欢迎进入NC Cloud!