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
更多的資訊
有關web3j的更多資訊,請參閱web3j主頁中文版。
======================================================================
分享一些以太坊、EOS、比特幣等區塊鏈相關的互動式線上程式設計實戰教程:
- java以太坊開發教程,主要是針對java和android程式設計師進行區塊鏈以太坊開發的web3j詳解。
- python以太坊,主要是針對python工程師使用web3.py進行區塊鏈以太坊開發的詳解。
- php以太坊,主要是介紹使用php進行智慧合約開發互動,進行賬號建立、交易、轉賬、代幣開發以及過濾器和交易等內容。
- 以太坊入門教程,主要介紹智慧合約與dapp應用開發,適合入門。
- 以太坊開發進階教程,主要是介紹使用node.js、mongodb、區塊鏈、ipfs實現去中心化電商DApp實戰,適合進階。
- C#以太坊,主要講解如何使用C#開發基於.Net的以太坊應用,包括賬戶管理、狀態與交易、智慧合約開發與互動、過濾器和交易等。
- EOS教程,本課程幫助你快速入門EOS區塊鏈去中心化應用的開發,內容涵蓋EOS工具鏈、賬戶與錢包、發行代幣、智慧合約開發與部署、使用程式碼與智慧合約互動等核心知識點,最後綜合運用各知識點完成一個便籤DApp的開發。
- java比特幣開發教程,本課程面向初學者,內容即涵蓋比特幣的核心概念,例如區塊鏈儲存、去中心化共識機制、金鑰與指令碼、交易與UTXO等,同時也詳細講解如何在Java程式碼中整合比特幣支援功能,例如建立地址、管理錢包、構造裸交易等,是Java工程師不可多得的比特幣開發學習課程。
- php比特幣開發教程,本課程面向初學者,內容即涵蓋比特幣的核心概念,例如區塊鏈儲存、去中心化共識機制、金鑰與指令碼、交易與UTXO等,同時也詳細講解如何在Php程式碼中整合比特幣支援功能,例如建立地址、管理錢包、構造裸交易等,是Php工程師不可多得的比特幣開發學習課程。
- tendermint區塊鏈開發詳解,本課程適合希望使用tendermint進行區塊鏈開發的工程師,課程內容即包括tendermint應用開發模型中的核心概念,例如ABCI介面、默克爾樹、多版本狀態庫等,也包括代幣發行等豐富的實操程式碼,是go語言工程師快速入門區塊鏈開發的最佳選擇。
匯智網原創翻譯,轉載請標明出處。這裡是原文web3j的Gradle外掛