java类库web3j的Gradle插件
web3j Gradle插件是从Solidity智能合约生成web3j Java封装的构建工具。它通过添加可以独立运行的特定任务,顺利地与项目的构建生命周期集成。
插件配置
在开始之前,如果计算机中尚未安装Solidity编译器,则需要安装它。
使用buildscript约定
要使用旧的Gradle buildscript约定安装web3j插件,应该将以下内容添加到构建文件的第一行(目前只有Gradle支持发行版本,而不是SNAPSHOT):
buildscript { repositories { mavenCentral() } dependencies { classpath 'org.web3j:web3j-gradle-plugin:0.1.6' } } apply plugin: 'web3j'
使用插件DSL
或者,如果你使用的是更现代的插件DSL,请将以下行添加到你的构建文件中:
plugins { id 'org.web3j' version '0.1.6' }
然后运行包含Solidity智能合约的项目:
./gradlew build
应用插件后,生成代码的基本目录(默认为$buildDir/generated/source/web3j)将包含每个源集的目录(默认为main和test),其中包含智能合约封装器的Java类。
代码生成
web3j DSL允许配置生成的代码,例如:
web3j { generatedPackageName = 'com.mycompany.{0}' generatedFilesBaseDir = "$buildDir/custom/destination" excludedContracts = ['Ownable'] useNativeJavaTypes = false }
DSL接受的属性如下表所示:
generatedPackageName被评估为接受大括号({0})之间的单个参数的消息格式字符串,允许使用合约名称格式化生成的值。为方便起见,当应用于Java包名称时,它将转换为小写。
例如,在一个具有组com.mycompany的项目将generatedPackageName设置为${group}.{0},那名为MyToken.sol的Solidity智能合约将被在com.mycompany.mytoken包中生成。
此外,默认值包含${group}属性,该属性对应于项目中的组(例如com.mycompany)。如果项目未定义组属性,则生成的包名称将为org.web3j.{0}。
请注意,消息格式参数不是Gradle属性,不应以$开头。
来源设置
默认情况下,$projectDir/src/main/solidity中的所有.sol文件都将由插件处理。要指定和添加不同的来源,请使用sourceSets DSL:
sourceSets { main { solidity { srcDir { "my/custom/path/to/solidity" } } } }
检查Solidity Plugin文档以配置智能合约源代码目录。
生成的智能合约封装器Java代码的输出目录将自动添加到你的构建中。
插件任务
Java插件使用基于每个源的命名约定(即compileJava,compileTestJava)向项目构建添加任务。
类似地,Solidity插件将为项目主源添加generateContractWrappers任务,并为每个剩余的源(例如test)添加generate[SourceSet]ContractWrappers。
要获取所有已添加任务的列表和说明,请运行以下命令:
./gradlew tasks --all