文件

§從原始碼建置 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 以使用程式碼的資訊。

下一步:儲存庫


在此文件找到錯誤?此頁面的原始程式碼可以在 這裡 找到。在閱讀 文件指南 後,請隨時提交拉取請求。有問題或建議要分享?前往 我們的社群論壇 與社群展開對話。