地信圈H5，相关说明

地信圈H5，项目基本框架基于vuejs + element-ui + vuex + vue-router + boostrap源码构成，H5作为地信圈客户端一个辅助功能，结合微信公众平台完成，包含活动，活动报名，会员企业，动态资讯三块，每个模块都是独立存在，不与其他两功能有任和交互，入口为公众号底部菜单

构建流程

本项目使用的是vue-cli构建，对于环境需要安装node,由于vuejs要求，node版本不得低于6.0.0，建议用8.0.0以上版本(为了方便对node版本切换，可以使用nvm控制node版本，nvm地址)

从svn或git仓库中将项目检出

在cmd或terminal切换到项目目录下，使用npm install项目所依赖的模块，由于项目依赖较多，可能安装较慢(安装一次即可)。

模块安装完成后，npm run dev运行即可，默认端口是8080，如果端口被占用，将自动使用其他端口，具体在启动完成后就可看到

打包,npm run build在根目录下回多出一个dist文件夹，为打包后的文件

npm run build --report打包后文件分析表图，优化使用

注意：由于npm仓库默认为国外的服务器，所以部分模块下载可能受阻导致安装失败，在下载之前可将npm仓库设置为国内仓库，npm config set registry http://registry.npm.taobao.org/,完成后，根据需要可将仓库切换回国外仓库,命令：npm config set registry https://registry.npmjs.org/，另外如果有模块一直安装失败，建议先将npm uninstall name卸载模块后再使用npm install name安装，例如'node-sass'模块容易安装失败，第一次安装失败后，先使用卸载命令，彻底卸载模块，后再重新单独安装

模块列表

异步请求框架：axios

表单验证框架：vee-validate,其中自定义规则src/validate.js

cookie操作模块：js-cookie

等，还有一下项目使用不频繁模块，例如： 'jquery','html2canvas','jspdf'就不一一列举额，具体可查看根目录中package.json文件，也可在node_modules中查看相关源码

目录说明

build目录：

webpack打包配置文件，一般不用修改，如有特殊需求，根据需要修改

config目录：

webpack打包配置参数，一般不用修改，如有特殊需求，根据需要修改，一般修改index.js

dist目录：

打包后生成的目录，里面是已经打包好的文件，一般刚下载项目是没有这个目录的

src目录：

开发的主要目录

static目录：

存放一些静态文件，打包时路径相对不变

src目录说明

assets目录：

程序所需的资源文件，会作为程序的一部分被打包

bootstrap-scss：

bootstrap4的css源文件目录，本项目并未全部使用bootstrap,只是将其中的css源码引入，方便定制修改

components:

组件库，查看组件库目录

libs目录：

功能插件，当前包含PagedList.js(查询插件)

plugins目录：

通用插件集合，包含errorPage.js(请求错误处理)，eventbus.js(事件中央总线)，htmlTopdf.js(html转dpf)，paramsConvert.js(参数处理插件)，Util.js(通用小工具插件)，说明，本插件库和libs有本质区别1. 本插件库，功能相对单一，全部为函数，不具备对象的使用原则，而libs则完全以对象的使用方式使用2. 本插件库的所有插件将全部挂载到Vue原型链上，可以通过Vue.XXX,或通过vm.$XXX都可访问，但libs不可以3. libs下的插件可以提供相对较多的参数供调用者使用，如：loading，调用者可通过vm.XXX.loading获取请求的状态，但本目录库不提供任何可中间调用参数，只提供返回结果

router：

路由配置目录，所有的路由配置都在这个目录完成

store:

vuex状态管理配置目录，其中modules为height:整体布局参数，user: 登录用户信息，具体数据，可在Chrome浏览器安装vuetool，启动程序后打开控制台的vue选项，可以看到相关的数据信息，相关操作请自行搜寻

App.vue:

组件入口

element-variables.scss：

自定义的样式，为sass格式

main.js:

总的配置文件，打包的入口文件

self.css:

自定义的样式，为css格式(本样式文件为遗留文件，不做任何修改，扩充样式全部写在element-variables.scss)，后期优化可能会将本文件清除

validate.js:

自定义验证规则的配置文件，需要额外扩充验证规则统一在本文件下配置

components目录说明

abort: 关于我们，这个当前位移动端提供的页面

advisory: 资讯目录

common: 公共目录，暂未使用

ec: 企业主页

errorPage: 错误处理页面

event: 活动目录

scroll: 滚动容器组件

公共服务目录

topic: 话题目录

其余大部分内容同地信圈web端相同，可参考地信圈README.md