编译合约文件

太过爱你忘了你带给我的痛 2022-06-01 07:43 117阅读 0赞

# 编译合约文件 #

## 合约的位置 ##

所有的合约文件都位于你项目中的 contracts/ 目录下。合约文件是用[Solidity][]这个语言来编写的，所有包含合约的文件都有一个.sol的扩展名。相关联的Solidity的库也会有一个.sol的文件扩展名。

一个通过truffle init创建的项目都会有一个单一的Migrations.sol文件会在部署过程中有所帮助。如果你使用的是Truffle Box, 这里会有多样的文件。

使用truffle init 创建项目后的合约目录文件图示：  
![这里写图片描述][SouthEast]  
使用truffle box创建项目后的合约目录文件图示：  
![这里写图片描述][SouthEast 1]

## 编译合约的命令 ##

编译命令：`truffle compile`

官方文档中说要在truffle项目的根目录执行这个命令，但是本人在测试过程中发现不可行。需要进入truffle项目的合约目录进行编译。  
测试示例：  
在turffle项目根目录进行编译：  
![这里写图片描述][SouthEast 2]

在truffle项目的合约目录进行编译:  
![这里写图片描述][SouthEast 3]

第一次执行该命令，所有的合约文件将会被编译。在之后的运行过程中，truffle只会编译那些在上一次编译完成后发生改变的的合约文件。如果你想重写这些行为，使用–all选项来运行上述的命令。命令：`truffle compile --all`  
示例：  
![这里写图片描述][SouthEast 4]

## BUILD ARTIFACTS ##

编译器的工件将在build/contracts/这个目录中被替代，相对于项目的根目录。如果这个目录不存在，将会被创建。

这些工件是truffle内部工作的一部分，它们在成功的部署你的应用中扮演着很重要的角色。你不能编辑这些文件，因为它们会在合约编译和部署时被重写。

## 依赖 ##

你可使用Solidity里的[import][]命令来声明合约的依赖。Truffle将会在正确的命令下编译这些合约，并确保所有的依赖都发送给编译器。依赖关系可以通过两种方式来指定。

### 通过文件名称导入依赖 ###

从一个单独的文件中导入合约，在你的Solidity源码文件中增加下面的代码：

import "./AnotherContract.sol";

这将使所有的合约都在AnotherContract.sol之内。在这里，AnotherContract.sol是相对于当前书面合约的路径的。

注意：Solidity 也允许导入其它的语法，更多的关于导入的语法可以参考这个链接：[http://solidity.readthedocs.io/en/latest/layout-of-source-files.html\#importing-other-source-files][import]

### 从外部包导入合约文件 ###

Truffle 是支持通过EthPM和NPM安装的依赖包，从一个依赖项目导入合约，通过以下的语法：

import "somepackage/SomeContract.sol";

这时，somepackage表示一个EthPM和NPM安装的包,SomeContract.sol表示这个包提供的Solidity提供的源文件。  
Truffle 将会先寻找通过EthPM安装的包，然后再寻找通过NPM安装的包，因此，在命名冲突的情况下，通过EthPM安装的包将被使用。

关于如何使用Truffle的包管理特性，可以查看[EthPM][] 和 [NPM][] 的文档。

参考链接：[http://truffleframework.com/docs/getting\_started/compile][http_truffleframework.com_docs_getting_started_compile]

[Solidity]: https://solidity.readthedocs.io/en/develop/
[SouthEast]: /images/20220601/bdb4f19d289b413a92f3a5e97ea69b81.png
[SouthEast 1]: /images/20220601/b68f2db6f51c47748f3afaadb8f000ee.png
[SouthEast 2]: /images/20220601/6fb358998a314ab38a38a4944e5362c1.png
[SouthEast 3]: /images/20220601/09e8e6e238514329bcfa9ef3b04ca113.png
[SouthEast 4]: /images/20220601/33bb7094caef4e12b76927184338dada.png
[import]: http://solidity.readthedocs.io/en/latest/layout-of-source-files.html#importing-other-source-files
[EthPM]: http://truffleframework.com/docs/getting_started/packages-ethpm
[NPM]: http://truffleframework.com/docs/getting_started/packages-npm
[http_truffleframework.com_docs_getting_started_compile]: http://truffleframework.com/docs/getting_started/compile