跳至主要內容

快速上手

大约 3 分钟

快速上手

后端模块项目

  1. 每个模块需要创建三个工程 XXXX-web、XXXX-service、XXXX-api
  2. XXXX-web 将dubbo服务转换http暴露给网关
  3. XXXX-service 编写具体的业务服务
  4. XXXX-api 编写dubbo接口类

image-20201209094229781

模块脚手架项目

service 模块

groupId：com.pcitc.si.archetype

artifactId：si-archetype-service-archetype

version：1.0.0-SNAPSHOT

web模块

groupId：com.pcitc.si.archetype

artifactId：si-archetype-web-archetype

version：1.0.0-SNAPSHOT

使用脚手架创建项目

第一种方式 Maven命令创建

创建项目示例命令

mvn archetype:generate -DgroupId=org.example -DartifactId=exp-service  -Dversion=1.0.0-SNAPSHOT  -DarchetypeGroupId=com.pcitc.si.archetype -DarchetypeArtifactId=si-archetype-service-archetype -DarchetypeVersion=1.0-SNAPSHOT

参数说明 groupId:创建项目的groupId artifactId:创建项目的artifactId version：创建项目的version

archetypeGroupId:使用脚手架的groupId archetypeArtifactId:使用脚手架的artifactId archetypeVersion:使用脚手架的version

第二种方式 使用IDE创建

1、创建项目

2 、添加脚手架

选择maven 点击 create from archetypt 后点击 add archetype按钮 添加脚手架(顶部) 如下信息 后点击OK

3、选中添加的脚手架 点击 next

4、自定义自己模块的groupid,artifactid,version
5、确认使用maven及配置文件

6 、确定项目名称及存储目录

7 点击finish 后等待完成项目构建。

后缀为-api模块为定义dubbo接口 ，后缀为-service则为实现接口模块。

前端模板项目

说明：该项目为前端子系统 基础模板项目使用，具体操作步骤可参考如下

1、模板GIT地址：http://git.pcitc-si.com/redsnower/si-front-web.git

2、项目模板克隆之后进行依赖包安装

3、安装公网依赖包（npm源） npm install

4、若出错，根据提示切换源

  npm config set registry http://maven.pcitc-si.com/repository/si-npm-snapshot/

5、安装npm私服上的依赖（目前包括public-menu）npm install 版本号

6、恢复npm源 npm config set registry https://registry.npmjs.org/

7、安装完成之后，打开登录入口地址：http://xxx.xxx.xxx.xxx:xxxx/login（换成自己的地址）

  登陆成功后从浏览器Cookie缓存中拿到Admin-Token的值，存放在项目utils/permission.js

img

  模板中app_code为核心财务项目205，新项目更换为对应值，文件路径为store/index.js

img

8、命令npm run dev，启动项目即可

9、开发过程中项目公共样式要放在在一个类名里面，集成项目通过不同的app_code加载类名，避免多系统类名样式冲突

img

img

10、 打包流程（提供给集成项目）

1>  确保router/exportRouter.js中需要引入所有路由模块

2>  确保store/index.js中需要引入所有状态模块

3>  Home.vue中提供rewriteRouters方法（默认注释），可跳转至/layout/hom，控制台有输出打包的所有文件路径，拿到后替换       			src/index.js文件内容。

img

4>  基本上前两步在平时开发中就能做到，第三步是打包前要做的关键步骤。

5>  针对不同环境打包修改地址，文件路径：src/api/axios.js

img

 6>  版本号三位(例：1.1.1) 第二位作为打包环境标识 ，同一环境打包第三位递增+1（可以自己命名规则）例：



7>  执行打包命令：npm run build-npm 

8>  无错误即可切换至私服：npm config set registry http://maven.pcitc-si.com/repository/si-npm-snapshot/

9>  发布前需要登陆一下 npm login 回车，然后依次输入账号：si  密码：pcitc123. 邮箱 dixin.hu@pcitc.com

10> 发布: npm publish

11> 还原npm源: npm config set registry https://registry.npmjs.org/

12> 访问http://maven.pcitc-si.com/ 查看是否发版已经成功