使用Mingw环境可以比较快的编译出bitcoin-cli,bitcoind,bitcoin-qt这三个执行文件,但是对于C++开发人员不方便学习代码,进行调试,所以本人网上找了一些资料实践了一把,记录如下:
环境:win7 64位系统,vs2013, bitcoin-0.9.4源码
下载、编译比特币源码的依赖库。
比特币源码的依赖库包含OpenSSL、Berkeley DB、Boost、miniupnpc、QT等第三方依赖库
1、下载perl安装 (windows 环境VS编译需要)
https://www.activestate.com/activeperl/downloads
默认:C:\Perl,运行“CMD”命令,使用cd命令指向perl安装目录的eg文件,执行“perl example.pl”若显示“Hello from ActivePerl!”,则说明Perl安装成功!
安装OpenSSL下载:http://www.openssl.org/source/openssl-1.0.1g.tar.gz
打开VS2013的命令行窗口,进入到openssl-1.0.1g目录下,依次输入以下命令进行编译:
perl Configure VC-WIN32
ms\do_ms nmake -f ms\ntdll.mak
编译完成后,在各个工程中添加OpenSSL的目录,头文件路径是:C:\deps\openssl-1.0.1g\include\openssl(本机安装依赖库都在c:\deps下),lib路径是:C:\deps\openssl-1.0.1g\out32dll,lib库名称是:libeay32.lib、ssleay32.lib。
2、安装Boost,下载地址: http://sourceforge.net/projects/boost/files/boost/1.57.0/
在VS2013的命令行窗口中编译boost_1_57_0,输入以下命令:
bootstrap
.\b2
编译完成后,在各个工程中添加Boost的目录,头文件路径是:C:\deps\boost_1_57_0\stage\lib,lib路径是:C:\deps\boost_1_57_0\stage\lib。
下载地址 http://download.oracle.com/berkeley-db/db-4.8.30.NC.tar.gz
使用vs2013打开db-4.8.30.NC\buildwindows目录下的Berkeley DB.sln,生成解决方案。
编译完成后,在各个工程中添加Berkeley DB的相关目录,头文件路径是:\db-4.8.30.NC\build_windows,lib路径是:\db-4.8.30.NC\build_windows\Win32\Debug,lib库是libdb48d.lib,DLL库是libdb48d.dll,bitcoin的程序运行时需要libdb48d.dll,复制到bitcoin的程序相同目录中。
4、库QT
这是bitcoin-qt、bitcoin-qt-test 建立工程所需要的,不需要的可以跳过
下载地址:http://download.qt.io/archive/qt/5.3/5.3.2/
下载文件:qt-opensource-windows-x86-msvc2013-5.3.2.exe
下载完成后安装即可。因为本人用的是vs2013 32位的编译器,所以要对应下载x86-msvc2013对应的版本,如果你的版本不同则要下载相应的Qt库,否则编译bitcon-qt工程时会报错。
5、QT的VC插件
这是bitcoin-qt、bitcoin-qt-test需要的,不在意的可以跳过。
下载地址:http://download.qt-project.org/official_releases/vsaddin/qt-vs-addin-1.2.3-opensource.exe。
下载后安装,在VS2013中菜单多了”Qt5“,在”Qt Options“中添加QT版本、路径(Qt库的安装路径)
6、库Protobuf
这也是bitcoin-qt、bitcoin-qt-test需要的
下载地址 :https://github.com/google/protobuf/releases/download/v2.6.1/protobuf-2.6.1.tar.gz
用vs2013打开 C:\deps\protobuf-2.6.1\vsprojects下的protobuf.sln,生成解决方案。
Protobuf库是用来把paymentrequest.proto文件生成对应的.h、.cc文件的。
编译完成后,在QT相关的bitcoin-qt、bitcoin-qt-test工程中添加Protobuf的相关目录,头文件路径是:\protobuf-2.6.1\src,lib路径是:\protobuf-2.6.1\vsprojects\Debug,lib库是libprotobuf.lib、libprotoc.lib。
分析比特币的源码,总结成3个程序、2个测试程序,3个程序对应着BTC钱包中的3个程序。分别是:
在VC中的工程结构如图:
为保持BTC的文件目录结构,Bitcoin.sln、bitcoin-cli.vcxproj、bitcoind.vcxproj在src目录下,bitcoin-qt.vcxproj位于src\qt目录中,bitcoin-qt-test.vcxproj位于src\qt\test目录中,test_bitcoin.vcxproj位于src\test目录中。
说明:
现在开始给各个工程添加相关的代码文件。
因为src目录下的文件在所有工程中都用到,所以先在bitcoin-cli工程新建文件夹(在资源管理器中新建筛选器),添加各个工程公用的文件夹(Common),再复制到其他工程中。目录结构如下:
注意几点:
在bitcoin-cli工程中添加bitcoin-cli.cpp以及资源文件bitcoin-cli-res.rc。工程结构如下:
在bitcoind工程中添加bitcoind.cpp以及资源文件bitcoind-res.rc。工程结构如下:
在test_bitcoin工程中添加src\test目录下的代码文件,data中包含了src\test\data目录下的文件。工程结构如下:
在bitcoin-qt中添加src\qt中的目录、文件。不包含test目录下的文件。工程结构如下:
forms下包含src\qt\forms下的文件,locale下包含src\qt\locale下的文件,res中包含src\qt\res下的目录、文件,Resource Files中包含bitcoin.qrc。proto下的.h、.cc文件是用工具Protobuf生成的,后面介绍。
在bitcoin-qt-test工程中添加src\qt\test目录下的文件。添加bitcoin-qt的代码文件。工程结构如下:
设置工程属性,除了设置前面介绍的依赖库的相关路径、lib库外,还有些特殊设置,这里特别介绍。
1、bitcoin-cli、bitcoind、test_bitcoin工程的字符集从UNICODE改为多字符集。
2、所有工程设置leveldb相关的头文件路径,包含3个,分别是:
3、工程添加预处理器定义:
预处理定义分所有工程都需要定义、单个工程需要定义的,在下面会指明。
先说所有工程都需要知名的预处理器定义:
4、所有工程添加链接lib库:Shlwapi.lib。
编译、运行过程中发生错误,逐条修改,数量很多,但改动很小。
1、工程Bitcoin-cli、Bitcoind
(1)文件main.cpp编译release版时,报错”Bitcoin cannot be compiled without assertions.”。把这句代码注释掉,增加#include
(2)在文件net.h中添加#define __func__ __FUNCTION__,__func__是GCC的,__FUNCTION__是VC的。
(3)文件addrman.h中的类CAddrMan中的IMPLEMENT_SERIALIZE因为括号不对,编译报错,不用IMPLEMENT_SERIALIZE宏,把宏IMPLEMENT_SERIALIZE定义的3个函数函数GetSerializeSize、Serialize、Unserialize中的‘{statements} ’替换为IMPLEMENT_SERIALIZE中的参数。就是说把serialize.h中的IMPLEMENT_SERIALIZE对应的函数代码替换到addrman.h中CAddrMan的IMPLEMENT_SERIALIZE出现的地方。
因为变量nVersion在函数参数中有定义,且局部变量中也有定义,重复定义,注释掉局部变量中的nVersion。
(4)把文件core.h中类CTxOutCompressor的IMPLEMENT_SERIALIZE宏展开,用实际代码替换,不用IMPLEMENT_SERIALIZE宏,用宏的参数替换宏定义中的{statements}字段。同上
(5)把文件serialize.h中ReadCompactSize函数中的0x100000000LLu改为(unsigned __int64)0×100000000。VC不支持LLu类型的数据。
(6)文件serialize.h中,类CDataStream的构造函数中: CDataStream(const std::vector& vchIn, int nTypeIn, int nVersionIn) : vch((char*)&vchIn.begin()[0], (char*)&vchIn.end()[0]),运行时报错,注释掉”[0]“。VC不允许数组大小为0。
(7)文件script.h中的CScriptCompressor中的Serialize函数、Unserialize函数中的数组越界了,且需要处理大小为0的数组,共4处。在bitcoin-0.9.4中未发现,可能已修正
Serialize函数中:
if(compr.size() > 0)
s << CFlatData(&compr[0], &compr[compr.size()-1]);
if(script.size() > 0)
s << CFlatData(&script[0], &script[script.size()-1]);
Unserialize函数:
if(vch.size() > 0)
s >> REF(CFlatData(&vch[0], &vch[vch.size()-1]));
if(script.size() > 0)
s >> REF(CFlatData(&script[0], &script[script.size()-1]));
(8)文件script.h中类CScript中:
#ifndef _MSC_VER
CScript(const unsigned char* pbegin, const unsigned char* pend) : std::vector(pbegin, pend) { }
#endif
注释掉_MSC_VER的宏定义。
因为文件\qt\walletmodel.cpp中的WalletModel::prepareTransaction函数中的代码:
const unsigned char* scriptStr = (const unsigned char*)out.script().data();
CScript scriptPubKey(scriptStr, scriptStr+out.script().size());
编译错误,scriptStr的类型转换失败。
(9)在文件key.cpp中,添加函数:
int CompareBigEndianEx(const unsigned char *c1, size_t c1len) {
while (c1len > 0) {
if (*c1)
return 1;
c1++;
c1len--;
}
return 0;
}
注释掉const unsigned char vchZero[0] = {};
函数CKey::Check、CKey::CheckSignatureElement中的CompareBigEndian(vch, len, vchZero, 0)改为CompareBigEndianEx(vch, 32)。
GCC允许数组大小为0,但VC不允许。
在bitcoin-0.9.4中未发现,可能已修正
(10)文件addrman.cpp中的CAddrMan::Select_函数中的代码:
double nCorTried = sqrt(nTried) * (100.0 - nUnkBias);
double nCorNew = sqrt(nNew) * nUnkBias;
改为:
double nCorTried = sqrt((double)nTried) * (100.0 - nUnkBias);
double nCorNew = sqrt((double)nNew) * nUnkBias;
在sqrt函数的参数加入(double)强制类型转换,VC支持3个sqrt函数,参数类型不同,这里增加强制类型转换。
(11)文件init.cpp中的AppInit2函数中的Setvbuf的最后一个参数0改为INT_MAX。
setvbuf(stdout, NULL, _IOLBF, INT_MAX /*0*/);
VC不允许最后一个参数为0。
(12)把文件db.h中类CDB的部分代码注释掉,分别是:
Free地址时报错,我跟踪过,在数据库的pdb->get函数中确实调用了malloc函数申请内存,按理说free此地址没问题,但报错,这个问题暂时解决不了,后续解决。
我暂时没有进行此步操作,待观察
(13)文件db.cpp中,类CDBEnv的CloseDb函数,delete pdb;时报错,解决不了,暂时注释掉,可能会产生数据库操作错误。
同步区块半小时后不在同步,这个问题可以跟与数据库的这2个修改相关,尚未确定。
我暂时没有进行此步操作,待观察
(14)BTC源码中有2个bloom文件,分别是bloom.cpp、\leveldb\util\bloom.cc,编译时生成的bloom.obj冲突,把其中1个文件改名即可,把bloom.cc改名为bloomdb.cc。
(15)BTC源码中有2个hash文件,分别是hash.cpp、\leveldb\util\hash.cc,编译时生成的hash.obj冲突,把其中1个文件改名即可,把hash.cc改名为hashdb.cc。
(16)把文件\leveldb\util\env_win.cc中的CreateDirInner函数中的GetFileAttributes改为GetFileAttributesA,CreateDirectory改为CreateDirectoryA,强制使用ASCI函数。
(17)注释掉\leveldb\db\dbbench.cc、\leveldb\db\leveldbmain.cc中的main函数,冲突了。
(18)在文件netbase.cpp、\leveldb\db\dbiter.cc中添加语句:”typedef signed int ssize_t;”,VC中没有定义ssize_t数据类型。
(19)注释掉文件\leveldb\db\c.cc中的#include
(20)函数min()、max()在windef.h、stl中有不同的定义,需要把std::numericlimits::max()改为(std::numericlimits::max)(),否则编译时max()参数报错。
需要改的地方包括:
文件wallet.h中类CWallet的LoadMinVersion函数中的参数std::max加上小括号。
文件net.h中的类CNode的AskFor函数中的std::max加上小括号。
2、工程bitcoin-qt、bitcoin-qt-test
(1)在CMD中,运行\protobuf-2.5.0\vsprojects\Release目录下的protoc.exe,生成paymentrequest.proto文件对应的头文件、源文件,命令格式为:
protoc --proto_path=e:/bitcoin/qt --cpp_out=e:/bitcoin/qt e:/bitcoin/qt/paymentrequest.proto
把生成的.h、.cc文件添加到bitcoin-qt、bitcoin-qt-test工程中。
(2)对\qt\locale下的所有文件执行lrelease操作,在资源管理器中,在locale下的文件上点击右键,执行lrelease操作,生成文字的多国语言版本。
(3)在文件\qt\winshutdownmonitor.h中语句“#include
#define WIN32_LEAN_AND_MEAN
#include
(4)修改bitcoin-qt、bitcoin-qt-test工程中的某些cpp文件的编译方式,把Custom Build Tool改为C/C++ compiler。需要修改的文件为:rpcconsole.cpp、intro.cpp、overviewpage.cpp、bitcoin.cpp。vs2013操作:选中文件右键属性->常规->项管理->c/c++编译器。
(5)注释掉文件\qt\test\test_main.cpp的第一行代码:#include “bitcoin-config.h”。我已经提交github修改此BUG,已通过,5月22日之后的代码没有这个问题,github上的修改BUG地址:https://github.com/bitcoin/bitcoin/pull/4212。有兴趣可以查看。
(6) 因为链接时报qInitResources_bitcoin无法识别的错误,所以屏蔽了bitcoin.cpp 中main函数下Q_INIT_RESOURCE(bitcoin);这句,错误原因还不清楚,后续再看
3、工程test_bitcoin
在src目录中的Makefile.include文件完成此操作,转换代码如下:
%.json.h: %.json
@$(MKDIR_P) $(@D)
@echo "namespace json_tests{" > $@
@echo "static unsigned const char $(*F)[] = {" >> $@
@$(HEXDUMP) -v -e '8/1 "0x%02x, "' -e '"\n"' $< | $(SED) -e 's/0x ,//g' >> $@
@echo "};};" >> $@
@echo "Generated $@"
%.raw.h: %.raw
@$(MKDIR_P) $(@D)
@echo "namespace alert_tests{" > $@
@echo "static unsigned const char $(*F)[] = {" >> $@
@$(HEXDUMP) -v -e '8/1 "0x%02x, "' -e '"\n"' $< | $(SED) -e 's/0x ,//g' >> $@
@echo "};};" >> $@
@echo "Generated $@"
使用vs2013编译相应的工程就可以得到对应的执行文件,然后就可以使用断点调试功能开始你的比特币代码学习之路了。