获取可执行程序
用户可以自由选择以下任一方式获取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构建系统生成特定平台的构建文件,这意味着无论您使用什么操作系统工作流都非常相似:
- 安装构建工具和依赖包(依赖于平台)。
- 从FISCO BCOS克隆代码。
- 运行
cmake
生成构建文件并编译。
安装依赖
- Ubuntu推荐Ubuntu 16.04以上版本,16.04以下的版本没有经过测试,源码编译时依赖于编译工具和
libssl
。
- $ sudo apt install -y g++ libssl-dev openssl cmake git build-essential autoconf texinfo
- CentOS推荐使用CentOS7以上版本。
- $ sudo yum install -y epel-release
- $ sudo yum install -y openssl-devel openssl cmake3 gcc-c++ git
- macOS推荐xcode10以上版本。macOS依赖包安装依赖于Homebrew。
- $ brew install openssl git
克隆代码
- $ git clone https://github.com/FISCO-BCOS/FISCO-BCOS.git
编译
编译完成后二进制文件位于FISCO-BCOS/build/bin/fisco-bcos
。
- $ cd FISCO-BCOS
- $ git checkout master
- $ mkdir -p build && cd build
- # CentOS请使用cmake3
- $ cmake ..
- # 高性能机器可添加-j4使用4核加速编译
- $ make
编译选项介绍
BUILD_GM,默认off,国密编译开关。通过
cmake -DBUILD_GM=on ..
打开国密开关。TESTS,默认off,单元测试编译开关。通过
cmake -DTESTS=on ..
打开单元测试开关。DEMO,默认off,测试程序编译开关。通过
cmake -DDEMO=on ..
打开单元测试开关。BUILD_STATIC,默认off,静态编译开关,只支持Ubuntu。通过
cmake -DBUILD_STATIC=on ..
打开静态编译开关。生成源码文档。
- # 安装Doxygen
- $ sudo apt install -y doxygen graphviz
- # 生成源码文档 生成的源码文档位于build/doc
- $ make doc