EOS开发调试环境搭建（全部流程）
本贴适用于：Linux-ubuntu16.04版本和mac-osx 10.12+版本
一、最新代码编译构建
1、从github上克隆代码仓库到本地
[plain] view plain copy
- git clone https://github.com/EOS-Mainnet/eos
2、更新代码仓库子模块，使用递归参数
[plain] view plain copy
- git submodule update --init --recursive
3、git tag命令查看版本标签,下拉找到mainnet-1.0.4,以后再升级新的版本，在代码本地仓库目录下git pull，再git tag，就能找到最新版本。
4、git checkout 命令检出mainnet-1.0.4版本代码
git checkout mainnet-1.0.4
注意：我的系统里因为原来已经有本地代码仓库，版本是mainnet-1.0.3，而且代码有修改，所以当我git checkout的时候提示先提交修改过的代码或把修改过的文件stash，然后再git chekcout。因为我提交不了代码，所以只能选择：get stash，然后再git checkout。这样就可以成功检出最新版本代码：mainnet-1.0.4。可以使用git branch命令检查一下检查代码是否成功。
正当我写这篇贴的时候，BM团队为解决mainnet-1.0.4版本有节点停止出块的问题，紧急升级到了mainnet-1.0.5版本，收到消息，我git pull，拉取最新仓库，git tag，果然mainnet-1.0.5已经存在了，所以我又进行了git checkout mainnet-1.0.5的操作，接下来就在1.0.5的版本上搞事情吧，永远保持最新！
5、执行自动化构建脚本。
./eosio_build.sh如果是首次编译构建代码，过程中可能会遇到一些坑：
比如：boost库下载失败或安装失败，mongodb以及mongodb驱动下载失败，可以从我的百度网盘下载：
mongo-c-driver-1.9.3
链接:https://pan.baidu.com/s/1bMMIhqGPHSIEZjIQqFVuhg 密码:h4a1
mongodb 3.6.3
链接:https://pan.baidu.com/s/1KfPMv8qWRU8EMMLl-reAAg 密码:38q0
请阅读脚本：eos/scripts/eosio_build_ubuntu.sh 或 eosio_build_darwin.sh，视你的操作系统而定，把下载的文件放到合适的位置，把如下图所示的下载过程注释掉，再进行编译。
还有如果你安装的是ubuntu的虚拟机，自动化编译过程可能会因为主机物理内存小于7G，而报错编译失败，这个问题可以通过修改eos/scripts/eosio_build_ubuntu.sh脚本中的第27-31行，注释掉这5行，如下图：
初次构建由于要下载安装一堆的依赖库，时间会很长，大概2-3个小时，耐心等待吧！
如果以前已经多次编译成功，依赖库就不会被重新下载安装，应该会很顺利。
6、为了后续操作方便，可以安装一下，省的每次启动nodeos或敲cleos命令行都要切换目录
[plain] view plain copy
- sudo make install
7、config.ini文件内容如下,可以参考。
genesis-json = ./genesis.json
block-log-dir = blocks
readonly = 0
send-whole-blocks = true
enable-stale-production = true
http-server-address = 127.0.0.1:8888
p2p-listen-endpoint = 0.0.0.0:9876
p2p-server-address = localhost:9876
allowed-connection = any
#p2p-peer-address = 192.168.31.220:9876
#p2p-peer-address = localhost:9877
required-participation = 33
#Private key: 5JZ5Wwb8uQbi3A7DmMsD2zevcKCYw1pxmitij1x4xCjU8gv7ucj
#Public key: EOS6a5pr4DS4CksCQSHqTdKMPbAdCyrE4b7QExDwTuCxH1vbkYMqG
# key for eosio
producer-name = eosio
private-key = ["EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV","5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3"]
# actinve key for bp.a
producer-name = p1
private-key = ["EOS6a5pr4DS4CksCQSHqTdKMPbAdCyrE4b7QExDwTuCxH1vbkYMqG","5JZ5Wwb8uQbi3A7DmMsD2zevcKCYw1pxmitij1x4xCjU8gv7ucj"]
# actinve key for bp.b
producer-name = p2
private-key = ["EOS5NiFNF4bG7T49S6f7qVXMAt4RN2WM211s77UZrwD4cz2Xu6gw9","5JKkei9CFtawsvnHt728DUQaahcjHm5nqJsNgZzna9XZKq8eA5c"]
# actinve key for bp.c
producer-name = p3
private-key = ["EOS59rjXxZLjRnUEdErjtCEN8fihQnMmdsWYSz7jaeruPEoSeyCHz","5JBDtjPbUeV2Hte6ZuFE5ny9RtuUujWEKG1u2yYPw2jmkCR7A4Y"]
# actinve key for bp.d
producer-name = p4
private-key = ["EOS5psRxWMGyQS4HPNY8fa4PDhgP53vD4AZ6w24Z9HUCTxXKEH7Ey","5JQPYAtWxdzGsJkBpHyWBV18N2rzFtMjcBwxvfndS3KXe4oQu3L"]
plugin = eosio::producer_plugin
plugin = eosio::chain_api_plugin
#plugin = eosio::account_history_api_plugin
plugin = eosio::wallet_plugin
plugin = eosio::wallet_api_plugin
plugin = eosio::http_plugin
plugin = eosio::net_plugin
plugin = eosio::net_api_plugin
8、genesis.json文件内容，可参考。
{
"initial_timestamp": "2018-06-08T08:08:08.888",
"initial_key": "EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
"initial_configuration": {
"max_block_net_usage": 1048576,
"target_block_net_usage_pct": 1000,
"max_transaction_net_usage": 524288,
"base_per_transaction_net_usage": 12,
"net_usage_leeway": 500,
"context_free_discount_net_usage_num": 20,
"context_free_discount_net_usage_den": 100,
"max_block_cpu_usage": 200000,
"target_block_cpu_usage_pct": 1000,
"max_transaction_cpu_usage": 150000,
"min_transaction_cpu_usage": 100,
"max_transaction_lifetime": 3600,
"deferred_trx_expiration_window": 600,
"max_transaction_delay": 3888000,
"max_inline_action_size": 4096,
"max_inline_action_depth": 4,
"max_authority_depth": 6
}
}
9、config.ini和genesis.json文件放置路径
[plain] view plain copy
- linux-ubuntu: ~/.local/share/eosio/nodeos/config/
- mac-osx: ~/Library/Application\ Support/eosio/nodeos/data/confi
10、启动nodeos前注意：清理旧的数据
二、使用vscode 开发工具对代码进行单步调试，查看堆栈调用
1、在mac-osx系统和ubuntu中都可以使用vscode对c++代码进行开发编辑和调试，vscode工具下载安装略过，请百度。
2、这里只说单步调试和查看堆栈调用，所以需要打开eosio_build.sh脚本，把第51行CMAKE_BUILD_TYPE=Release修改成CMAKE_BUILD_TYPE=Debug，执行./eosio_build.sh
./eosio_build.sh3、编译完成后，打开vscode，打开文件夹，选择eos代码主目录，选择打开
4、配置任务，如图所示菜单路径：任务->配置任务
5、使用模板创建tasks.json文件
6、MSBuild执行生成目标
7、mscode会在eos工程目录下创建一个tasks.json文件，并打开，如下所示
8、按下图修改tasks.json文件
{
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [{
"label": "eosio_build",
"type": "shell",
"command": "cd build && make nodeos -j4",
"group": {
"kind": "build",
"isDefault": true
},
"problemMatcher": []
}]
}9、菜单：调试->添加配置...
10、vscode会在eos工程目录下创建launch.json文件，如下图
11、按照下图修改launch.json文件
{
// 使用 IntelliSense 了解相关属性。
// 悬停以查看现有属性的描述。
// 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "(lldb) Launch",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceFolder}/build/programs/nodeos/nodeos",
//"args": ["get","info"],
"stopAtEntry": false,
"cwd": "${workspaceFolder}/build",
"environment": [],
"externalConsole": true,
"MIMode": "lldb"
}
]
}12、菜单：任务->运行任务
13、输入或选择eosio_build
14、如下图所示，vscode会执行一次代码编译，以后修改代码后，可以直接在这里执行编译。
15、编译完成后可以在programs/nodeos/main.cpp的main函数里下个断点，如下图所示
16、菜单：调试->启动调试或F5，片刻后系统会启动一个新的终端控制台，显示nodes的运行，因为我们设置了断点，所以程序会停在断点处，终端显示的nodeos程序也会暂停在下面的状态。
17、nodeos程序停在断点处，如下图所示
18、按F5继续运行到下个断点，因为下个断点还没设置，所以nodeos程序开始不间断执行，如下图所示
18、按照下图所示打开plugins->chain_plugin->chain_plugin.cpp,在get_info函数中(598)行下个断点
19、打开一个新的终端控制台程序，输入cleos get info命令，如下图所示
20、控制台输入：cleos get info命令后回车，屏幕会自动跳到vscode代码编辑窗口，断点调试指示器游标会停在598断点处，如下图所示
21、打开左边栏的debug面板，如下图
22、左边栏可以看到：变量、监视、调用堆栈、断点4个标签分栏。变量一栏可以查看当前调试文件下的全局和局部变量，监视一栏可以查看添加到监视器里的变量的变化情况，调用堆栈一栏可以看到，从程序开始运行到断点处的所有命名空间、类、函数的调用关系，断点一栏显示所有已打的断点，可以操作使断点有效或无效，或删除断点。
23、下图显示如何把一个变量添加到监视器
24、调试过程
25、get info 命令调试结束
26、停止调试
