源码编译适合于有丰富开发经验的用户,编译过程中需要下载依赖库,请保持网络畅通。
受网络和机器配置影响,编译用时5-20分钟不等。
请务必保证机器能够访问githubusercontent.com,否则可能会因为网络不通阻塞编译!
FSICO-BCOS使用通用CMake构建系统生成特定平台的构建文件,这意味着无论您使用什么操作系统工作流都非常相似:
从代码仓库克隆代码。
默认使用github链接FISCO BCOS
若出现网络问题导致长时间拉取代码失败,可使用gitee连接FISCO-BCOS
安装构建工具和依赖包(依赖于平台)。
运行<code>cmake</code>生成构建文件并编译。
![](https://img.laitimes.com/img/9ZDMuAjOiMmIsIjOiQnIsISPrdEZwZ1Rh5WNXp1bwNjW1ZUba9VZwlHdsATOfd3bkFGazxCMx8VesATMfhHLlN3XnxCMwEzX0xiRGZkRGZ0Xy9GbvNGLpZTY1EmMZVDUSFTU4VFRR9Fd4VGdsYTMfVmepNHLrJXYtJXZ0F2dvwVZnFWbp1zczV2YvJHctM3cv1Ce-cmbw5iMwUTYiRDM5U2M5MWO3YWZihDZ0kDMmVjM0UzNmZjMj9CXzEzLcdDMxIDMy8CXn9Gbi9CXzV2Zh1WavwVbvNmLvR3YxUjL3M3Lc9CX6MHc0RHaiojIsJye.png)
推荐Ubuntu 16.04以上版本,源码编译时需要先安装gcc等工具。
若无法下载,则可以先更新一下源
推荐使用Ubuntu 18.04以上版本。
编译完成后二进制文件位于<code>FISCO-BCOS/build/bin/fisco-bcos</code>。
注解
如果因为网络问题导致长时间无法下载依赖库,请尝试从 https://gitee.com/FISCO-BCOS/LargeFiles/tree/master/libs 下载,放在FISCO-BCOS/deps/src/
如果编译过程中长时间没有相应,一般是不能访问githubusercontent.com导致依赖无法下载,请使用代理或修改hosts使得机器能够访问githubusercontent.com
TESTS,默认off,单元测试编译开关。通过<code>cmake -DTESTS=on ..</code>打开单元测试开关。
DEMO,默认off,测试程序编译开关。通过<code>cmake -DDEMO=on ..</code>打开单元测试开关。
TOOL,默认off,工具程序编译开关。通过<code>cmake -DTOOL=on ..</code>打开工具开关,提供FISCO节点的rocksdb读取工具。
ARCH_NATIVE,默认off,编译时根据本地CPU指令优化以获得更好的性能,在ARM架构上编译可以使用此选项。GCC9以上版本编译暂未适配完成,可以通过打开此编译选项避过问题,完成编译。
BUILD_STATIC,默认off,静态编译开关,只支持Ubuntu。通过<code>cmake -DBUILD_STATIC=on ..</code>打开静态编译开关。
CMAKE_BUILD_TYPE,默认RelWithDebInfo,编译类型,如要编译Release版本,通过<code>cmake -DCMAKE_BUILD_TYPE=Release ..</code>设置
DEBUG,默认off,调试模式,编译后会打印将要提交的数据,性能大幅降低,仅用于开发查问题。
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/tutorial/compile.html?highlight=%E6%BA%90%E7%A0%81#fisco-bcos
问题
修改<code>/etc/hosts</code>文件,添加如下内容可加速依赖包的下载:
以上域名对应的ip可能会有变更,若在/etc/hosts中加了以上内容后,源码编译仍然很慢,请使用域名查询工具查询并更新这些域名对应的IP
若先前有一套编译完成的环境,可从原先环境的<code>deps/src</code>目录下拷贝已经下载好的依赖包到当前正在编译项目的<code>deps/src</code>目录下
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/faq/compile.html?highlight=%E6%BA%90%E7%A0%81#case1