YonBIP旗舰版本地开发环境搭建教程-程序员充电站

第一章业务场景

复杂业务场景下，YonBuilder 标准版无法实现的功能，可通过YonBuilder 专业版开发来实
现，YonBuilder 专业版需要使用脚手架工程来完成扩展开发的能力。本文讲解脚手架工程在本
地环境下搭建的相关技术。

第二章环境配置

在数字化工作台（业务中台）中，确认YonBuilder 专业版产品已安装，并对相关功能进
行业务初始化，然后创建应用引擎，本次赋能环境应用引擎已创建完毕。
脚手架下载后解压到本地，目录结构如下图所示：

第三章前端环境搭建

3.1. 导入前端工程

通过VS Code 编辑器打开文件夹xxxxx-fe（xxxxx 为引擎对应的编）以fe 结尾的前端工程，
然后进行相关配置。

3.2. 修改配置文件

调用本地后端，需要修改config.env.js 中的相关参数。

1.配置文件位置：xxxxx-fe/src/common/config.env.js ，如下图：

2.修改配置内容如下：

如果不走本地后端服务地址，仅调试前端脚手架，也可以配置成线上的（c-kk-fn-px-be，
c-kk-fn-px 是引擎名），如下图：

3.配置文件修改如下：

注：黄色背景地址,如果是请求本地后端，请根据自己本地后端服务的实际地址及端口来

修改；如果是线上地址，请注意要替换域名以及引擎名_be。
此致，前端配置完毕。

3.3. 下载依赖包

注：下面命令请在VS Code 等编辑器终端中执行，如下图：

由于前端项目工程依赖中有用友私有化依赖包，本机如果未安装过ynpm 工具，需要全局安装ynpm 依
赖下载工具，如果之前安装过该工具可以省略，安装命令如下：

npm install ynpm-tool@4.0.5 -g

注：目前前端工程需指定ynpm 版本4.0.5
安装ynpm 成功后初始化项目工程组件。如果是用友内部网直接使用命令：

ynpm install

注：执行前将根目录文件“package-lock.json”删除掉。
若是外网（公网）环境使用命令：

ynpm install -outside

注：若已安装高版本ynpm 初始化的组件，需清理删除node_modules 文件夹再进行低版本的初始化；
若出现超时或报错时，尝试-outsidePre 指令；即ynpm install -outsidePre 。初始化一直不成功可通过下面
方法来完成：
1、下载初始化包
下载地址：https://pan.yonyou.com/s/pdTWO8LJTxY 密码：amse
2、复制到对应目录，如下图：

3.4. 启动前端工程

前端工程依赖下载成功后，构建前端工程，执行命令：
npm run build
构建完成后，启动node 中间层，使用命令：
npm run debug:server
然后，启动前端工程，使用命令：
npm run debug:extend

如下图：

启动成功，node 中间层终端会提示相关服务地址，如下图：

注：也可以直接执行：npm run debug 命令，该命令会自动执行启动server 和extend 两个服
务

第四章后端环境搭建

4.1. 导入工程

用idea，打开刚下载的脚手架后端工程目录（以be 结尾命名的文件夹），如下图：

打开工程后，进行maven 配置。

4.2. Maven 配置

将maven 私有库的settings.xml 文件下载到本地，下载地址在“开发工具”分享目录中，
如下图：

然后，配置工程maven。第一步，打开设置框，如下图：
第二步，配置用户设置文件settings_yonbip_2022.xml 并保存，如下图：

4.3. 修改配置文件

首先，修改本地开发配置config-dev.properties 文件，文件路径及配置项为：

修改如下配置项：

上面配置内容，默认下载脚手架会有相关信息；可参考技术中台->Devops 服务，找到后端应用“属性区域”找到对应配置项；也可通过YMS 查看相关的参数字符。
注：黄色背景的内容需要根据实际情况进行更改。
然后，修改工程配置文件application.properties ，文件路径及配置项为：

修改如下配置项：

上面配置内容是将本地配置的信息添加到工程配置项内，也可直接配置对应的值，以上内
容作为参考指导（练习脚手架也配置完毕，不需要修改配置）。

4.4. 启动后端工程

1、首先，进行maven 初始化工程，如下图：

如果maven 下载不了jar 包，请下载相关依赖到本地，并配置依赖：
1、下载地址为：https://pan.yonyou.com/s/bPCmRSkbStg 密码：xvpd
2、配置依赖如下图：

2、在bootstrap 工程下，找到MDFApplication.java 类，添加到Spring Boot 工程启动类，
并调整配置，如下图：

3、编辑器顶部选择MDFApplication，以debug 模式启动该工程，如下图：

启动完成后，在浏览器访问本地健康检查接口：
http://local.yyuap.com:8080/extend/healthycheck

此致，本地环境配置完毕。

第五章搭建验证

本地前、后端环境搭建完毕，验证下相关服务是否正常运行，需要本地访问下自建应用
中的单据页面，以需求单为例，通过预览列表页面获取连接地址：
https://bip-v3r2-2302.yyuap.com/mdf-node/meta/VoucherList/kkfnProductPurchaseRequisiti
onList?domainKey=c-kk-fn-px&busiObj=kkfnProductPurchaseRequisition&designPreview=true
替换连接地址前缀为“http://local.yyuap.com:3003”进行访问，页面正常加载显示数据列
表则前后端本地环境搭建成功，如下图：

若访问报”用户未登录”，则需要在http://local.yyuap.com 域名所在浏览器页签增加Cookies
配置yht_access_token（当前值是拷贝https://bip-v3r2-2302.yyuap.com 该域名下的
yht_access_token 的值）

若访问本地前端页面报错或空白页，请查看后端服务日志，若出现下面报错信息，请在
本地hosts 文件中添加对应的IP 指向，例如，下面问题：

在开发者中心任一服务控制台ping 该地址，获取到对应的ip 地址，如下图：

然后添加“172.20.45.136 dev-iuap-apcom-staffdoc.prod1.iuap-yks.local”到本地hosts 文
件中。