获取可执行程序

用户可以自由选择以下任一方式获取FISCO BCOS可执行程序。推荐从GitHub下载预编译二进制。

  • 官方提供的静态链接的预编译文件，可以在Ubuntu 16.04和CentOS 7.2以上版本运行。
  • 官方提供docker镜像，欢迎使用。docker-hub地址
  • 源码编译获取可执行程序，参考源码编译。

下载预编译fisco-bcos

我们提供静态链接的预编译程序，在Ubuntu 16.04和CentOS 7经过测试。请从Release页面下载最新发布的预编译程序。

docker镜像

从v2.0.0版本开始，我们提供对应版本tag的docker镜像。对应于master分支，我们提供lastest标签的镜像，更多的docker标签请参考这里。

build_chain.sh脚本增加了-d选项，提供docker模式建链的选择，方便开发者部署。详情请参考这里。

注解

build_chain.sh脚本为了简单易用，启动docker使用了 --network=host 网络模式，实际使用中用户可能需要根据自己的网络场景定制改造。

源码编译

注解

源码编译适合于有丰富开发经验的用户，编译过程中需要下载依赖库，请保持网络畅通。受网络和机器配置影响，编译用时5-20分钟不等。

FSICO-BCOS使用通用CMake构建系统生成特定平台的构建文件，这意味着无论您使用什么操作系统工作流都非常相似：

  1. 安装构建工具和依赖包（依赖于平台）。
  2. 从FISCO BCOS克隆代码。
  3. 运行cmake生成构建文件并编译。

安装依赖

  • Ubuntu

推荐Ubuntu 16.04以上版本，16.04以下的版本没有经过测试，源码编译时依赖于编译工具和libssl。

  1. sudo apt install -y g++ libssl-dev openssl cmake git build-essential autoconf texinfo flex patch bison libgmp-dev
  • CentOS

推荐使用CentOS7以上版本。

  1. $ sudo yum install -y epel-release centos-release-scl
  2. $ sudo yum install -y openssl-devel openssl cmake3 gcc-c++ git flex patch bison gmp-static devtoolset-7
  • macOS

推荐xcode10以上版本。macOS依赖包安装依赖于Homebrew。

  1. brew install openssl git flex patch bison gmp

克隆代码

  1. git clone https://github.com/FISCO-BCOS/FISCO-BCOS.git

编译

编译完成后二进制文件位于FISCO-BCOS/build/bin/fisco-bcos。

  1. $ cd FISCO-BCOS
  2. $ git checkout master
  3. $ mkdir -p build && cd build
  4. $ source /opt/rh/devtoolset-7/enable  # CentOS请执行此命令，其他系统不需要
  5. # CentOS请使用cmake3
  6. $ cmake ..
  7. # 高性能机器可添加-j4使用4核加速编译
  8. $ make

注解

编译选项介绍

  • TESTS，默认off，单元测试编译开关。通过cmake -DTESTS=on ..打开单元测试开关。

  • DEMO，默认off，测试程序编译开关。通过cmake -DDEMO=on ..打开单元测试开关。

  • TOOL，默认off，工具程序编译开关。通过cmake -DTOOL=on ..打开工具开关，提供FISCO节点的rocksdb读取工具。

  • BUILD_STATIC，默认off，静态编译开关，只支持Ubuntu。通过cmake -DBUILD_STATIC=on ..打开静态编译开关。

  • 生成源码文档。

    1. # 安装Doxygen
    2. $ sudo apt install -y doxygen graphviz
    3. # 生成源码文档 生成的源码文档位于build/doc
    4. $ make doc