介绍

起步

本项目是基于 VueCli3.x + TypeScript构建的单页面项目。

Nodejs 和 npm 版本

本项目前端构建依赖 NodeJsnpm, 这里所有的包安装都使用npm命令安装的,请不要使用cnpm或者yarn

保证项目能够正常启动,必须保证NodeJs版本 >= 8.0 & npm >= 6.1, npm是随nodejs安装的。

下载地址:NodeJs 下载

为了保证npm能够正常安装包,可以使用淘宝镜像:

npm --registry https://registry.npm.taobao.org
1

项目强烈推荐使用NodeJs 10 + npm 6.9 及以上的版本。

项目文件目录

+-- dist_publish  #打包后的文件夹
+-- public  #公共文件夹
+-- src  #源代码
|   +-- assets # 资源文件夹(样式+图片)
|   +-- components # 组件文件夹
|   +-- request # 请求封装文件夹
|   +-- router # 路由文件夹
|   +-- store # vuex文件夹
|   +-- utils # 工具文件夹
|   +-- views # 页面模板+逻辑文件夹
|   +-- views # 组件
|   +-- App.vue #
|   +-- main.ts # 入口.ts文件
|   +-- project.d.ts # 部分申明的.d.ts文件
+-- .env.development  #部分开发配置
+-- babel.config.js  #babel配置
+-- package.js  #node依赖文件配置
+-- tsconfig.json  # typescript 规则配置
+-- vue.config.js   #vue cli配置文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

启动项目

先从git仓库拉取源代码:

 git clone http://139.224.43.8:88/qianxiang/html
1

然后使用·cmd命令行进入fengkong` 文件夹,执行安装依赖命令:

 npm install
1

耐心等待安装完成, 然后启动本地开发模式:

 npm run serve
1

然后就可以在浏览器访问demo页面了:

http://loclahost:8033/spa/demo
1

到这一步,恭喜你,你的开发环境配置成功了。 当然想要和原来的jsp项目混合开发,还需要配置一些环境,请查看后面的文档。

常用命令

提示

要使用这些命令,你需要确保安装了 Nodejs 环境

克隆代码

下载远端代码到本地:

 git clone http://XXXX/qianxiang/html 
1

切换npm的下载镜像为淘宝网站,加快下载速度:

npm config set registry https://registry.npm.taobao.org
1

安装依赖

第一次项目运行需要依赖各种包文件,可以使用命令:

 npm install  或者简写: npm i
1

启动开发环境

在本地启动项目,会帮你启动一个具有监听文件改变并实时刷新浏览器的本地服务器:

 npm run serve
1

打包代码

执行本命令,会帮你编译代码并打包文件, 可以用来发布:

 npm run build
1

运行代码样式和语法检测

执行本命令,会帮你检查代码是否合乎规范,会在控制台打印相关信息:

 npm run lint
1

拷贝打包文件到宿主环境文件夹

执行本命令,会将source.zip文件夹拷贝到指定项目的文件夹

 npm run copy-source
1

使用本命令前你需要先在项目根目录建一个名字为 .env.local 的文件 加入一行, 等号后面的值是目标rms项目的spa文件夹, 可自行修改:

ZIP_HOSTPATH = H:\qianxiang\web\qianxiang-v1-rms\WebContent\spa\
1