文件

§設定您偏好的 IDE

使用 Play 很容易。您甚至不需要複雜的 IDE，因為 Play 會自動編譯並更新您對原始檔所做的修改，因此您可以輕鬆地使用簡單的文字編輯器來工作。

但是，使用現代的 Java 或 Scala IDE 提供了很酷的生產力功能，例如自動完成、即時編譯、輔助重構和除錯。

§Eclipse

§設定 sbt-eclipse

與 Eclipse 整合需要 sbt-eclipse。請務必在您的 project/plugins.sbt 檔中始終使用 最新可用版本，或按照 sbt-eclipse 文件進行全球安裝。

addSbtPlugin("com.github.sbt" % "sbt-eclipse" % "6.2.0")

您必須在執行 eclipse 指令前 編譯 您的專案。您可以在執行 eclipse 指令時透過在 build.sbt 中加入下列設定來強制編譯

// Compile the project before generating Eclipse files, so
// that generated .scala or .class files for views and routes are present

EclipseKeys.preTasks := Seq(Compile / compile, Test / compile)

如果您在專案中有 Scala 原始碼，您需要安裝 Scala IDE。

如果您不想安裝 Scala IDE，而且您的專案中只有 Java 原始碼，那麼您可以設定下列 build.sbt（假設您沒有 Scala 原始碼）

// Java project. Don't expect Scala IDE
EclipseKeys.projectFlavor := EclipseProjectFlavor.Java

// Use .class files instead of generated .scala files for views and routes
EclipseKeys.createSrc := EclipseCreateSrc.ValueSet(EclipseCreateSrc.ManagedClasses, EclipseCreateSrc.ManagedResources)

§產生組態

在設定好 sbt-eclipse 之後，若要將 Play 應用程式轉換成可運作的 Eclipse 專案，請使用 eclipse 指令

[my-first-app] $ eclipse

如果您想取得可用的原始碼 jar（這將花費較長的時間，而且可能有部分原始碼遺失）

[my-first-app] $ eclipse with-source=true

注意：如果您使用具有聚合的子專案，則需要在 build.sbt 中適當地設定 skipParents

ThisBuild / EclipseKeys.skipParents := false

或從 sbt shell 輸入

[my-first-app] $ eclipse skip-parents=false

然後您需要使用 檔案/匯入/一般/現有專案… 功能表（先編譯您的專案）將應用程式匯入您的工作空間。

若要偵錯，請使用 sbt -jvm-debug 9999 run 啟動您的應用程式，並在 Eclipse 中按一下專案右鍵，然後選擇 偵錯為、偵錯組態。在 偵錯組態 對話方塊中，按一下 遠端 Java 應用程式 右鍵，然後選擇 新增。將 埠 變更為 9999，然後按一下 套用。從現在開始，您可以按一下 偵錯 以連線至正在執行的應用程式。停止偵錯階段不會停止伺服器。

提示：您可以使用 ~run 執行您的應用程式，以在檔案變更時啟用直接編譯。這樣一來，當您在 view 中建立新的範本時，會自動偵測 Scala 範本檔案，並在檔案變更時自動編譯。如果您使用一般的 run，則每次都必須在瀏覽器中按一下 重新整理。

如果您對應用程式進行任何重要的變更，例如變更類別路徑，請再次使用 eclipse 以重新產生組態檔案。

提示：當您在團隊中工作時，請勿提交 Eclipse 組態檔案。若要讓這件事變得更簡單，請將下列行加入您的 .gitignore 檔案

/.classpath
/.project
/.settings

產生的設定檔包含絕對參考至您的架構安裝。這些是特定於您自己的安裝。當您在團隊中工作時，每個開發人員必須將其 Eclipse 設定檔設為私人。

§IntelliJ IDEA

Intellij IDEA 讓您可以快速建立 Play 應用程式，而無須使用命令提示字元。您不需要在 IDE 外部設定任何內容，sbt 建置工具會負責下載適當的函式庫、解決相依性和建置專案。

在您開始在 IntelliJ IDEA 中建立 Play 應用程式之前，請確定已在 IntelliJ IDEA 中安裝並啟用最新的 Scala 外掛程式。即使您不使用 Scala 開發，它仍有助於範本引擎、解決相依性，以及一般設定專案。

建立 Play 應用程式

  1. 開啟新增專案精靈，在Scala區段下選取sbt，然後按一下下一步。
  2. 輸入您的專案資訊，然後按一下完成。

您也可以匯入現有的 Play 專案。

匯入 Play 專案

  1. 開啟專案精靈，選取匯入專案。
  2. 在開啟的視窗中，選取您要匯入的專案，然後按一下確定。
  3. 在精靈的下一頁中，選取從外部模型匯入專案選項，選取sbt 專案，然後按一下下一步。
  4. 在精靈的下一頁中，選取其他匯入選項，然後按一下完成。

提示：您可以下載並匯入我們的其中一個 入門專案 或其中一個 範例專案。

檢查專案結構，確定已下載所有必要的相依性。您可以使用程式碼協助、導覽和即時程式碼分析功能。

你可以執行已建立的應用程式，並在預設瀏覽器中檢視結果 https://127.0.0.1:9000。要執行 Play 應用程式

  1. 建立新的執行組態 – 從主選單中，選擇執行 -> 編輯組態
  2. 按一下 + 來新增新的組態
  3. 從組態清單中，選擇「sbt 任務」
  4. 在「任務」輸入方塊中，只要輸入「執行」
  5. 套用變更並選取確定。
  6. 現在你可以從主執行選單中選擇「執行」並執行你的應用程式

你可以使用預設執行/偵錯組態設定，輕鬆地為 Play 應用程式啟動偵錯器工作階段。

如需更詳細的資訊，請參閱以下網址的 Play Framework 2.x 教學課程

https://www.jetbrains.com/idea/help/getting-started-with-play-2-x.html

§從錯誤頁面瀏覽至原始程式碼

使用 play.editor 組態選項，你可以設定 Play 來新增超連結至錯誤頁面。這將連結至 Play 在執行開發模式時所引發的執行時期例外狀況。

你可以使用 IntelliJ 的「遠端檔案」REST API 搭配內建於 63342 埠上的 IntelliJ 網路伺服器，輕鬆地從錯誤頁面直接瀏覽至 IntelliJ 中的原始程式碼。

在 application.conf 中啟用以下列行以提供超連結

play.editor="https://127.0.0.1:63342/api/file/?file=%s&line=%s"

你也可以從 build.sbt 設定 play.editor

javaOptions += "-Dplay.editor=https://127.0.0.1:63342/api/file/?file=%s&line=%s"

或設定 PLAY_EDITOR 環境變數

PLAY_EDITOR="https://127.0.0.1:63342/api/file/?file=%s&line=%s"

§NetBeans

§產生組態

Play 目前沒有原生 NetBeans 專案產生支援，但有一個 NetBeans 的 Scala 外掛程式，可以協助處理 Scala 語言和 sbt

https://github.com/dcaoyuan/nbscala

還有一個 sbt 外掛程式可以建立 NetBeans 專案定義

https://github.com/dcaoyuan/nbsbt

§所有 Scala 外掛程式（如果需要）

  1. Eclipse Scala IDE：http://scala-ide.org/
  2. NetBeans Scala 外掛程式：https://github.com/dcaoyuan/nbscala
  3. IntelliJ IDEA Scala 外掛程式：https://blog.jetbrains.com/scala/
  4. ENSIME - Emacs 的 Scala IDE 模式：https://github.com/ensime/ensime-emacs

下一步：Hello World 教學

在此文件中發現錯誤？此頁面的原始程式碼可在 此處 找到。閱讀 文件指南 後，請隨時提交拉取請求。有問題或建議要分享？請前往 我們的社群論壇 與社群展開討論。