1. 程式人生 > >web3j的Gradle外掛

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)將包含每個源集的目錄(預設為maintest),其中包含智慧合約封裝器的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外掛使用基於每個源的命名約定(即compileJavacompileTestJava)向專案構建新增任務。

類似地,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外掛