§從原始碼建置 Play
如果您想使用 Play 的一些未發布變更,或者您想親自為 Play 的開發做出貢獻,您需要從原始碼編譯 Play。您需要一個 Git 客户端 來獲取原始碼。
§先決條件
要建置 Play,您需要安裝 sbt。
§取得原始碼
從 shell 中,首先簽出 Play 原始碼
$ git clone [email protected]:playframework/playframework.git
簽出您想要的 branch,main
是目前的開發 branch,而主要版本的穩定 branch 則以 .x
命名,例如 2.8.x
。
現在執行 sbt
$ sbt
要建置並發布 Play,請執行 publishLocal
> publishLocal
這將為預設的 Scala 版本建置並發布 Play。如果您想為所有版本的 Scala 發布,您可以交叉建置
> +publishLocal
或為特定 Scala 版本發布
> ++ 2.13.13 publishLocal
§建置文件
文件位於 playframework/documentation
中,為 Markdown 檔案。要查看 HTML,請執行以下操作
$ cd playframework/documentation
$ sbt run
您現在可以在 https://127.0.0.1:9000/@documentation 瀏覽文件。
有關開發 Play 文件的更多詳細資訊,請參閱 文件指南。
§執行測試
您可以使用 test
任務從 sbt 控制台執行單元和整合測試
> test
與發布一樣,您可以在指令前加上 +
以針對所有支援的 Scala 版本執行測試。
Play PR 驗證執行比單元和整合測試多一點的測試,包括腳本測試、測試文件程式碼範例,以及測試 Play 範本。PR 驗證執行的腳本可以在 framework/scripts
目錄中找到,你可以執行這些腳本中的每一個來執行與 PR 驗證執行的相同的測試。
§在專案中使用
當你在本地端發布 Play 時,它會將快照版本發布到你的本地儲存庫。要使用這個版本,你需要更新你的建置設定檔來使用這個版本。
導覽到你的現有 Play 專案,並在 project/plugins.sbt
中進行下列編輯
// Change the sbt plugin to use the local Play build (3.0.0-SNAPSHOT)
addSbtPlugin("org.playframework" % "sbt-plugin" % "3.0.0-SNAPSHOT")
完成此步驟後,你可以啟動主控台並正常與你的專案互動
$ cd <projectdir>
$ sbt
§在 Eclipse 中使用程式碼
你可以在 Stackoverflow 找到一些關於如何設定 Eclipse 以使用程式碼的資訊。
下一步:儲存庫
在此文件找到錯誤?此頁面的原始程式碼可以在 這裡 找到。在閱讀 文件指南 後,請隨時提交拉取請求。有問題或建議要分享?前往 我們的社群論壇 與社群展開對話。