2 Star 19 Fork 19

WeBank / WeBASE-Web

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
development.md 3.40 KB
一键复制 编辑 原始数据 按行查看 历史
wagonghao 提交于 2021-04-06 16:07 . fix bug && add download solc nodejs

WeBASE-Web开发文档

本代码仅支持fisco-bcos 2.0以上版本,支持群组和群组切换。

1、开发环境搭建

1.1 依赖环境

环境 版本
nodejs 1.8及以上

nodejs下载地址:https://nodejs.org/en/download/

1.2 安装依赖包

1.2.1 拉取代码

执行命令:

git clone https://github.com/WeBankFinTech/WeBASE-Web.git

将代码放在你的工作目录,例如:D:\project

切换到项目目录:

cd D:\project\WeBASE-Web

使用命令:

npm install

下载依赖包

执行update修改依赖和下载相关文件:

npm run update

注意:必须执行update,否则编译打包都是失败,此脚本会修改部分依赖文件并且从cdn下载solc的编译文件,执行成功后,后面无需再执行。

1.3 启动项目

在项目根目录使用命令:

npm run dev

控制台出现:

Listening at http ://localhost:3006

在浏览器输入"http ://127.0.0.1:3006"。

默认端口是3006,可在config文件夹index.js中修改。

修改跨域配置,在config文件夹index.js中,在dev中的proxyTable修改,修改地址即可,请求的url路径必须加上前缀。

dev: {
        host: 'localhost', // can be overwritten by process.env.HOST
        port: 3006, // can be overwritten by process.env.PORT, if port is in use, a free one will be determined
        autoOpenBrowser: false,
        errorOverlay: true,
        notifyOnErrors: true,
        poll: false, // https://webpack.js.org/configuration/dev-server/#devserver-watchoptions-
        assetsSubDirectory: 'static',
        assetsPublicPath: '/',
        proxyTable: {
        '/mgr':{
            target:'http://127.0.0.1:8080/',  //在此修改跨域地址,这里是node_mgr服务ip和端口,且可以访问
            changeOrigin:true,
            pathRewrite:{
                '^/mgr':''
                }
            },
        },
    },

本地启动服务用127.0.0.1代替localhost,因为部分合约版本使用了web worker

1.4 模拟数据

模拟数据在mock.js中,在开发联调前使用,使用中注意mock.js的url和axios请求的url要保持一致。包括get拼接在url上面的参数

注意:开发时将mian.js中加上mock.js引用,打包时需要注释mock.js的引用。

axios请求地址:

overview请求url: /WeBASE-Web/network/general/1

mock.js地址:

Mock.mock('/WeBASE-Web/network/general/1',function (req,res) {     //url和上面axios相同
    return {
        "code":0,
        "message":"success",
        "data":{
            "orgCount":1,
            "nodeCount":1,
            "contractCount":11,
            "latestBlock":10,
            "transactionCount":10,
        }
    }
});

main.js引用mock.js:

Vue.use(ElementUI);
// require('./mock')    //直接require引入,开发时放开注释,打包时注释
/* eslint-disable no-new */
new Vue({
  el: '#app',
  router,
  template: '<App/>',
  components: { App }
})

2、项目打包部署

2.1 项目打包

切换到项目根目录,执行命令:

npm run build

进行打包,生成打包文件dist,在项目根目录下。

2.2 部署

请参考部署文档

JavaScript
1
https://gitee.com/WeBank/WeBASE-Web.git
git@gitee.com:WeBank/WeBASE-Web.git
WeBank
WeBASE-Web
WeBASE-Web
master

搜索帮助