1. 索引

索引 

這是在 sbt 建置定義中可能會找到的常見方法、類型和值的索引。如需命令名稱,請參閱執行。如需可用的外掛程式,請參閱外掛程式列表

值和類型 

相依性管理 

  • ModuleID 是相依性定義的類型。請參閱函式庫管理
  • Artifact 代表要建置和發佈的單一成品 (例如 jar 或 pom)。請參閱函式庫管理成品
  • Resolver 可以解析和擷取相依性。許多類型的解析器也可以發佈相依性。儲存庫是一個密切相關的概念,通常是指相依性的實際位置。但是,sbt 在此術語上不是很一致,儲存庫和解析器偶爾會交替使用。
  • ModuleConfiguration 定義要用於一組相依性的特定解析器。
  • Configuration 是一個有用的 Ivy 建構,用於群組相依性。請參閱 ivy-configurations。它也用於設定作用域
  • CompileTestRuntimeProvidedOptional 是預先定義的組態

設定和任務 

  • Setting 描述如何在建置中初始化特定設定。它可以使用其他設定的值或正在初始化的設定的先前值。
  • SettingsDefinition 是 build.sbt 中運算式的實際類型。這允許一次定義單一的Setting 或一系列設定 (SettingList)。在.scala 建置定義中的類型總是只使用簡單的Setting
  • Initialize 描述如何使用其他設定初始化設定,但尚未繫結至特定設定。結合初始化方法和要初始化的設定,它會產生完整的Setting
  • TaskKeySettingKeyInputKey 是代表任務或設定的索引鍵。這些不是實際的任務,而是用於參考它們的索引鍵。它們可以設定作用域來產生 ScopedTaskScopedSettingScopedInput。這些構成提供 Settings 方法的基本類型。
  • InputTask 會解析和 Tab 自動完成使用者輸入,產生要執行的任務。
  • Task 是任務的類型。任務是按需執行的動作。這與設定相反,設定會在專案初始化時執行一次。

建置結構 

方法 

設定和任務 

如需詳細資訊,請參閱入門指南

  • :=+=++= 這些會建構Setting,這是設定系統中的基本類型。
  • value 這會在定義新設定或任務時使用另一個設定或任務的值。此方法很特別 (它是一個巨集),除了在上述設定定義方法 (:=、…) 之一的引數中或在獨立的建構方法 Def.setting 和 Def.task 中以外,無法使用。如需詳細資訊,請參閱任務圖
  • in 指定正在參考的設定的作用域或部分作用域。請參閱作用域

檔案和 IO 

如需完整文件,請參閱RichFilePathFinder路徑

  • / 在單一 File 上呼叫時,這是 new File(x,y)。對於 Seq[File],這會套用至序列的每個成員。
  • *** 是用於選取符合篩選器的 File 或 Seq[File] 的子項 (*) 或後代 (**) 的方法。
  • |||&&&--- 是用於結合篩選器的方法,這些篩選器通常用於選取檔案。請參閱NameFilterFileFilter。請注意,這些名稱的方法也存在於其他類型,例如集合 (如 Seq) 和 Parser (請參閱解析輸入)。
  • pair 用於建構從 File 到另一個 File 或到 String 的對應。請參閱映射檔案
  • get 強制將 PathFinder (按名稱呼叫的資料結構) 轉換為嚴格的 Seq[File] 表示法。這是 Scala 中的常見名稱,由 Option 等類型使用。

相依性管理 

如需完整文件,請參閱函式庫管理

  • % 這用於建立 ModuleID
  • %% 這與 % 類似,只是它識別已交叉建置的相依性。
  • from 用於指定相依性的後備 URL
  • classifier 用於指定相依性的分類器。
  • at 用於定義 Maven 樣式的解析器。
  • intransitive相依性組態標示為不可傳遞的。
  • hide組態標示為內部,且不會包含在發佈的中繼資料中。

解析 

這些方法用於從較小的 Parser 建構出 Parser。它們與標準函式庫的解析器組合器名稱非常相似。請參閱解析輸入以取得完整的文件。這些方法用於輸入任務命令

  • ~~><~ 序列方法。
  • ??? 用於使 Parser 成為可選的方法。? 是後綴。
  • id 用於將字元或字串文字轉換為 Parser。它通常用於觸發隱式轉換為 Parser。
  • ||| 選擇方法。這些是 Scala 中常見的方法名稱。
  • ^^^ 當 Parser 匹配時產生一個常數值。
  • +* 後綴重複方法。這些是 Scala 中常見的方法名稱。
  • mapflatMap 轉換 Parser 的結果。這些是 Scala 中常見的方法名稱。
  • filter 限制 Parser 匹配的輸入。這是 Scala 中常見的方法名稱。
  • - 前綴否定。僅在原始解析器不匹配輸入時才匹配輸入。
  • examplestoken Tab 鍵自動完成
  • !!! 提供當原始解析器不匹配輸入時要使用的錯誤訊息。