全面理解EOS——1.源码编译及运行

随着EOSIO软件越来越成熟，后来的开发者也越来越幸福。EOS相关源码的编译和运行变得异常简单。而且官方提供了开发者文档EOSIO Developer Portal
，能够帮助更好的理解和使用。不过文档全面而细节不足，也缺少一些问题情况的处理。知易行难，上手试试吧。

环境说明

本文测试过的编译环境：
Ubuntu 16.04 LTS
Ubuntu 16.04.4 LTS
macOS High Sierra（具体版本再补充）

源码下载

本文撰写时，最新的release为v1.0.6

（1）下载代码

git clone https://github.com/EOSIO/eos --recursive

如果忘记使用“–recursive”，可在克隆下的eos目录中执行

git submodule update --init --recursive

（2）切换到v1.0.6

git checkout v1.0.6

编译

在eos目录中，执行eosio_build.sh。
如果有好的科学上网工具请提前配置好，执行下面的命令后，会检查系统环境，下载所依赖的软件工具。如有问题可看后面的问题汇总与处理。

cd eos
./eosio_build.sh

比较顺利的话，会看到如下的提示：
这里写图片描述
使用Ubuntu比较顺利，就是下载和编译耗时，基本没有啥问题。

启动节点

如果仅想搭建本地的单节点测试网，进入eos的build目录，执行sudo make install。像我这样自己同步主网、测试网，外加自己单节点测试的，暂时先不执行install了，避免混乱，而是在build各个目录里面执行。
这里先说明单节点测试情况

cd build/programs/nodeos
./nodeos -e -p eosio --plugin eosio::chain_api_plugin --plugin eosio::history_api_plugin

看到如下信息说明已经开始生产块了
这里写图片描述

查看网络信息

既然已经开始生产块了，那另起一个shell终端，执行cleos查看当前网络信息

cd build/programs/cleos
./cleos get info

看到如下网络信息：

{
  "server_version": "79651199",
  "chain_id": "cf057bbfb72640471fd910bcb67639c22df9f92470936cddc1ade0e2f2e7dc4f",
  "head_block_num": 20,
  "last_irreversible_block_num": 19,
  "last_irreversible_block_id": "000000138960dec18c0daf35042fc8a180e884241cd5827335206a441992fa86",
  "head_block_id": "00000014ef94b3c0b066454bec196c8c4f1ac4115c8c9cd43294fc0e2ea596cd",
  "head_block_time": "2018-06-22T23:57:02.000",
  "head_block_producer": "eosio",
  "virtual_block_cpu_limit": 203830,
  "virtual_block_net_limit": 1068689,
  "block_cpu_limit": 199900,
  "block_net_limit": 1048576
}

好了，可以开始你的各种测试了，测试命令参考官网cleos reference
生成的块和配置信息默认在如下目录：
Mac OS: ~/Library/Application Support/eosio/nodeos/
Linux: ~/.local/share/eosio/nodeos/

简单理解下单节点网络

借用官网图：
这里写图片描述
eos的build目录里生成的可执行程序很多，常用到的：

nodeos ：通过配置不同插件，启动节点，同步EOS网络数据或者自己生成块，也可作为API节点供调用
keosd：管理钱包，钱包中包含EOS公私钥对信息
cleos：命令行交互接口，连接钱包与EOS网络，执行查看网络信息，推送交易信息，部署智能合约等
eosiocpp：编译智能合约，生成wasm文件及abi文件

各种问题

在阿里云服务器的Ubuntu上编译最顺利，几乎没有遇到任何问题；Mac OS上问题多些。编译时会下载需要的文件，如果中断，按照提示删除未完成的目录重新编译即可。其他问题列举如下：

1.内存空间不足
遇到Your system must have 7 or more Gigabytes of physical memory installed
执行eosio_build.sh时，会检查系统内存至少7G，修改script下对应系统的脚本即可。scripts/eosio_build_ubuntu.sh的diff如下：

-       if [ "${MEM_MEG}" -lt 7000 ]; then
+       if [ "${MEM_MEG}" -lt 3000 ]; then
                printf "\\tYour system must have 7 or more Gigabytes of physical memory installed.\\n"
                printf "\\tExiting now.\\n"
                exit 1

下面是Mac OS上的问题
2.无法找到已安装的llvm路径

CMake Error at libraries/wasm-jit/Source/Runtime/CMakeLists.txt:26 (find_package):
  Could not find a package configuration file provided by "LLVM" (requested
  version 4.0) with any of the following names:

参考https://github.com/EOSIO/eos/issues/43
根据提示找到llvm 4.0的路径，可利用tab在此路径下查找
ll /usr/local/Cellar/llvm/4.
然后通过export到环境变量中
export LLVM_DIR=/usr/local/Cellar/llvm/4.0.0_1/lib/cmake

3.Failed to find Gettext libintl

CMake Error at /Applications/CMake.app/Contents/share/cmake-3.11/Modules/FindPackageHandleStandardArgs.cmake:137 (message):
  Failed to find Gettext libintl (missing: Intl_INCLUDE_DIR)
Call Stack (most recent call first):
  /Applications/CMake.app/Contents/share/cmake-3.11/Modules/FindPackageHandleStandardArgs.cmake:378 (_FPHSA_FAILURE_MESSAGE)
  /Applications/CMake.app/Contents/share/cmake-3.11/Modules/FindIntl.cmake:47 (FIND_PACKAGE_HANDLE_STANDARD_ARGS)
  programs/cleos/CMakeLists.txt:29 (find_package)

参考https://github.com/EOSIO/eos/issues/2174
执行brew link gettext –force

顺便补充万一测试个hello world的智能合约，发现编译有问题
4.无法找到依赖的头文件及库

hello.cpp:1:10: fatal error: 'eosiolib/eosio.hpp' file not found
#include <eosiolib/eosio.hpp>
         ^~~~~~~~~~~~~~~~~~~~
1 error generated.

简单的是在eos源码下编译后的build目录中，执行sudo make install后即可。

后续再写如何连接EOS主网，JungleTestnet测试网络及如何配置节点等信息，比如genesis.json，block数据等等。

转载请注明出处：http://blog.csdn.net/w7849516230，欢迎关注微信公众号“编程阳光”
扫码关注