AERGO SHIP：用于開發(fā)智能合約的包管理器
用于構(gòu)建、測試和部署分布式應(yīng)用程序的客戶端框架和開發(fā)環(huán)境
構(gòu)建大型分布式應(yīng)用程序是很困難的，因為對其進行測試，使其實現(xiàn)端到端工作，并進行部署是一個非常耗時的過程。通過AERGO，我們計劃讓一切變得與眾不同。
AERGO是一個為在實現(xiàn)基于區(qū)塊鏈的系統(tǒng)和應(yīng)用程序時面臨眾多獨特挑戰(zhàn)的企業(yè)提供解決方案的平臺。為了提高開發(fā)、測試和部署智能合約的效率和易用性，我們創(chuàng)建了SHIP。SHIP是Lua智能合約包管理器。它將本地開發(fā)環(huán)境與Git和分布式分類賬連接起來，從而大大減少了構(gòu)建和管理智能合約所花費的時間。SHIP提供以下功能：
項目設(shè)置：在簡單的任務(wù)中完成開發(fā)準備。
從遠程存儲庫安裝軟件包：GitHub上的軟件包可以安裝在本地存儲庫中。
構(gòu)建：結(jié)合（預(yù)處理）項目內(nèi)部的資源來開發(fā)準備分發(fā)的產(chǎn)品。
單元測試：在上傳到網(wǎng)絡(luò)之前，您可以驗證新版本的功能是否符合要求。
部署到本地存儲庫：將已開發(fā)的項目安裝到本地存儲庫中，以供其他項目參考。
SHIP最基本的理念是簡潔；它輕巧而有效。目前版本的SHIP特意不包括廣泛的開發(fā)功能；但重要的是，SHIP是一個持續(xù)更新的項目。我們將從技術(shù)社區(qū)中獲取建議，并繼續(xù)添加被視為有價值的功能。
我們?yōu)槭裁匆獎?chuàng)建包管理器？
我們經(jīng)?；仡櫄v史，以便提出假設(shè)。本月早些時候，Phil發(fā)表了一篇文章，解釋了我們基于Linux和Red Hat所取得的歷史性成功的開源執(zhí)行方法。在開發(fā)分布式應(yīng)用程序時，我們采用相同的方式創(chuàng)建了一個包管理器。
2009年至2014年，許多技術(shù)競相出現(xiàn)，形成了我們今天所知的現(xiàn)代網(wǎng)絡(luò)的年代。
需要注意的是，在創(chuàng)建JavaScript之后，1995年到2010年之間沒有引入構(gòu)建或包管理工具。在開始使用JavaScript之后的15年里，在推進Web狀態(tài)方面幾乎沒有取得任何進展。然而，隨著2009年Node.js的發(fā)布，包管理器和捆綁包變得越來越普遍，從而可以創(chuàng)建新一代的動態(tài)網(wǎng)頁。Node.js的默認包管理器npm的創(chuàng)建實現(xiàn)了Web的快速發(fā)展。
2012年，Trello發(fā)布了一篇文章概述Trello Tech Stack。這篇文章介紹了許多技術(shù)，這些技術(shù)將使Web作為一個應(yīng)用程序而不僅僅是一個頁面工作。它很好地概述了2012年之前網(wǎng)絡(luò)的進展及其在前幾年的快速發(fā)展。這種快速發(fā)展確實是由npm的創(chuàng)建引起的，減少了開發(fā)網(wǎng)頁所花費的時間。
就像npm之于Web一樣，SHIP旨在成為開發(fā)基于區(qū)塊鏈的應(yīng)用程序和智能合約的關(guān)鍵點。SHIP將實現(xiàn)智能合約的開發(fā)、測試和部署無縫且高效。最終，SHIP將為AERGO提供吸引下一代dApp和企業(yè)區(qū)塊鏈開發(fā)人員所需的可用性，以創(chuàng)建一個蓬勃發(fā)展的開發(fā)者開源生態(tài)系統(tǒng)。
如何使用SHIP
要使用SHIP，您必須先下載并安裝以下程序：
Git
JDK 8+
Node.js
npm
構(gòu)建SHIP
SHIP目前尚未正式發(fā)布。如果您希望使用SHIP，必須先構(gòu)建它。SHIP使用下方的GitHub地址作為源存儲。
aergoio/ship
從GitHub獲取源代碼。（命令開頭的$顯示提示，如果系統(tǒng)root提示，則提示符為＃）。
$ git clone
現(xiàn)在運行構(gòu)建。第一次嘗試運行時，命令很長。
$ cd ship
$ ./build.sh clean deps npm assemble
成功完成后，您可以看到ship- $ VERSION.tar文件已在程序集/構(gòu)建/分發(fā)中創(chuàng)建。
解壓縮此文件以安裝SHIP。
接下來，使用ship命令在PATH路徑中包含bin目錄。您可將.bash_profile添加到最后一部分。它可能會根據(jù)您的shell而發(fā)生改變。
export PATH=$PATH:$SHIP_HOME/bin
SHOP_HOME指的是解壓縮ship - $ {VERSION}目錄。安裝現(xiàn)已完成。
建立項目
我們現(xiàn)在正在建立一個智能合約開發(fā)項目。在所需位置為項目創(chuàng)建目錄。
$ mkdir my-first-project
在本文中，我將此位置稱為$ {PROJECT_HOME}。
ship命令假定當前工作目錄即為項目目錄。讓我們將當前目錄移到項目中。
$ cd my-first-project
要將空目錄作為項目，您需要運行以下命令。
$ ship init
如果運行正常，則將在項目目錄中創(chuàng)建名為aergo.json的文件。aergo.json文件應(yīng)如下所示：
{
“name” : “bylee/my-first-project”,
“source” : “src/main/lua/main.lua”,
“target” : “app.lua”
}
更改項目設(shè)置
有關(guān)該項目的信息存儲在aergo.json中。必要時，您可以編輯此文件。我們來看看這個文件的屬性。
name - 項目名稱：以$ {github_account} / $ {project_name}格式導(dǎo)入或?qū)湃氪鎯鞎r使用此名稱。最初創(chuàng)建為$ {username} / $ {project_name}。如果您的用戶名和GitHub帳戶不同，則需要對其進行更改。
source – 將開始構(gòu)建的源文件的路徑視為相對于項目文件夾的路徑。
target - 保存有構(gòu)建結(jié)果的文件的路徑。編譯構(gòu)建的文件，生成二進制文件和ABI并將其部署到AERGO服務(wù)器。
dependencies - 引用的包的名稱。包是指存儲庫中安裝的項目的類型。
tests - 測試源的路徑。顧名思義，這是一種數(shù)組類型。
endpoint - AERGO服務(wù)器部署和運行以進行集成測試的主機名和端口信息。 $ {hostname}：設(shè)置為$ {port}。默認值為“l(fā)ocalhost：7845”。
由于當前狀態(tài)沒有變化，我們將繼續(xù)下一步。
編寫智能合約
現(xiàn)在，讓我們來編寫一段簡單的代碼。源是src / main / lua / main.lua。
function min(a, b)
if (a b) then
return a
else
return b
end
end
我寫了一個min函數(shù)，該函數(shù)選取了兩個數(shù)字并返回其中較小的數(shù)字。目前，AERGO支持的智能合約基于語言lua。讓我們來構(gòu)建當前的源代碼。
$ ship build
如果沒有問題，則創(chuàng)建app.lua文件。如果打開此文件，它與src / main / lua / main.lua完全相同，因為您可能只有一個文件要創(chuàng)建。如果繼續(xù)修改源并查看其更改方式，則可以看到該構(gòu)建如何組合文件。
此前，SHIP表示可以將多個文件合并為一個?，F(xiàn)在，讓我們重構(gòu)main.lua文件。您可以使用import命令從一個源引用另一個源。將min函數(shù)移到src / main / lua / utils.lua，將現(xiàn)有的main.lua替換為：
import “./utils.lua”
如果進行重新構(gòu)建，則可以看到app.lua文件與之前相同。
創(chuàng)建單元測試
讓我們?yōu)閯倓?chuàng)建的utils.lua中的min函數(shù)編寫一個單元測試。我們將在src / test / lua / test-utils.lua中編寫測試代碼。下一次如果有機會，我會更詳細地討論用于測試的API，這次僅顯示示例。
import “aergoio/athena-343”
local suite = TestSuite(‘test suite for utils.lua')
suite:add(TestCase(‘test min', function()
assertEquals(3, min(3, 4))
end))
suite:run()
在aergo.json中添加一個測試條目，告知SHIP這是一個用于測試的文件。
{
“name” : “bylee/my-first-project”,
“source” : “src/main/lua/main.lua”,
“target” : “app.lua”,
“tests”: [ “src/test/lua/test-utils.lua” ]
}
要運行測試，請運行以下命令：
$ ship test
ERROR : "Package aergoio/athena-343 not found: /Users/bylee/.aergo_modules/aergoio/athena-343/aergo.json"
When you run the test, you get an error because the aergoio / athena-343 that you use as a test framework is not installed. Now, let's install the package in github.
$ ship install aergoio/athena-343
實驗部分
增量構(gòu)建
SHIP具有強大的構(gòu)建能力。此功能可檢測項目中文件的更改，并對其進行自動構(gòu)建和測試。
運行該函數(shù)需要構(gòu)建命令的其他參數(shù)。
$ ship build –watch
如果運行沒有問題，則可以看到以下結(jié)果。這個例子是我的第一個項目。
如果您更改了源，則可以看到實時反映的構(gòu)建和測試。
WebUI
此外，我們還提供一個Web服務(wù)，允許瀏覽器訪問以下附加端口選項。
$ ship build --watch --port 8080
構(gòu)建結(jié)果
除了提供比終端所提供的更多細節(jié)之外，它還提供了額外的部署功能。此部署用于測試，因此它將轉(zhuǎn)到localhost上的端口7845。要使用此功能，服務(wù)器必須正在運行，并且必須在PATH中設(shè)置aergoluac命令。
單元測試結(jié)果
您還可以查看每個構(gòu)建的測試結(jié)果，并且構(gòu)建記錄還保存有過去的五個測試結(jié)果。
當您選擇Runner菜單時，會出現(xiàn)一個屏幕，您可以在其中實際運行已部署的功能。
結(jié)論
SHIP提供支持項目開發(fā)每個階段的功能，從設(shè)置到部署。它可以幫助開發(fā)人員從現(xiàn)有的編程方法中獲得結(jié)構(gòu)化編程，從而使開發(fā)智能合約的過程更加無縫和高效。雖然SHIP還沒有足夠的功能，并且開發(fā)的某些方面可能還不夠簡便，但我們計劃與dApp開發(fā)人員合作，以確定有價值的東西，并在將來通過更好的功能實現(xiàn)這些價值。我們正在等待您的反饋！
如果您還不知道，我們最近推出了AERGO預(yù)測試網(wǎng)，并發(fā)布了AERGO平臺的Alpha代碼庫。您可以隨意啟動本地測試網(wǎng)絡(luò)，貢獻代碼。
