1703877947
区块链项目开发指南 [:1703875359]
1703877948
区块链项目开发指南 6.2.2 solcjs API
1703877949
1703877950
solcjs提供了compiler方法，用于编译solidity代码。根据源代码是否有import（引用），该方法可以用于两种不同方法：如果源代码没有import，则需要两个实参，即第一个实参是字符串作solidity源代码，第二个实参是Boolean，表示是否最优化字节码。如果源字符串包含多个合约，则将编译全部。示例如下：
1703877951
1703877952
1703877953
1703877954
1703877955
如果源代码包含对其他合约的引用（imports），则第一个实参就是一个对象，它的键是文件名，值是文件内容。所以无论何时编译器看到一个import语句，它不会在文件系统中寻找文件，而是通过与文件名匹配的键在对象中寻找文件内容。示例如下：
1703877956
1703877957
1703877958
1703877959
1703877960
如果想在编译时从文件系统读取被引用的文件或者在编译时解析文件内容，则compiler方法支持第三个实参，即取文件名并返回文件内容的方法。示例如下：
1703877961
1703877962
1703877963
1703877964
1703877965
1.使用不同的编译器版本
1703877966
1703877967
为了使用不同的solidity版本编译合约，需要用useVersion方法去引用一个不同的编译器。useVersion用一个字符串，该字符串表示存储了编译器的JavaScript文件名，并在/node_modules/solc/bin目录中寻找该文件。
1703877968
1703877969
solcjs还提供另一种方式loadRemoteVersion，它用的编译器文件名与solc-bin文件库（https://github.com/etherum/solc-bin）中的solc-bin/bin目录下的文件名进行匹配，并下载和使用。
1703877970
1703877971
最后，solcjs还提供了另一个setupMethods方法，它与useVersion类似，但是可以从任意目录加载编译器。
1703877972
1703877973
下面用一个示例来演示这三个方法的用法：
1703877974
1703877975
1703877976
1703877977
1703877978
为了运行上述代码，首先需要从solc-bin repository下载v0.4.7.commit.822622cf.js文件，并将其保存在node_modules/solc/bin目录中。然后需要下载编译器文件版本0.4.8，将其保存在文件系统中某处，并把setupMethods调用中的路径指向那个目录。
1703877979
1703877980
2.接入库
1703877981
1703877982
如果solidity源代码引用库，生成的字节码将包含被引用库真实地址的占位符。这些必须在部署合约之前，通过一个称为接入（linking）的程序更新。
1703877983
1703877984
solcjs提供了把库地址接入生成的字节码的linkByteCode方法。示例如下：
1703877985
1703877986
1703877987
1703877988
1703877989
3.更新ABI
1703877990
1703877991
合约ABI提供多种信息，这些信息不包括合约的实现。两种不同版本的编译器生成的ABI可能不匹配，因为较高版本比较低版本支持更多的solidity功能，所以ABI中有一些额外信息。例如，回退函数是在Solidity 0.4.0版本时引入的，所以使用0.4.0以下版本编译器生成的ABI没有回退函数的信息，但这些智能合约的行为就像它们有回退函数一样，只不过是空的函数体和应付修改器。所以应当更新ABI，以便让依赖于较新Solidity版本ABI的应用有关于合约的更佳信息。
1703877992
1703877993
solcjs提供了用于更新的API。示例如下：
1703877994
1703877995
1703877996