如何通过 SBT 项目依赖项将 sbt-web 输出与 xsbt-web-plugin 一起使用?

How can sbt-web output be used with xsbt-web-plugin via a SBT project dependency?

我正在尝试在没有播放框架的情况下使用 sbt-web 插件,而是使用 xsbt-web-plugin 构建一个 webapp。

我已经让 sbt-web 插件在处理资产管道时正常工作,并让它创建有效的 webjar 输出(通过 packageBin)以及标准 "web/public/main" 输出(通过资产)。

另外,我一直在使用 xsbt-web-plugin 开发一个 webapp 并从 SBT 中为该 webapp 提供服务(通过 container:start)。 webapp 项目可以使用来自 mavenCentral 的 webjar 依赖项并毫无问题地引用这些资源。

我一直无法弄清楚的是如何让 xsbt-web-plugin 在 Web 应用程序中包含来自 sbt-web 管道的资产。看来我能做的最好的事情就是让它们进入 CLASSPATH。 (据我所知,这就是 play 所需要的,因为他们有一个 "Asset Controller" 可以在 CLASSPATH 之外提供这些资产,因此不需要它们作为静态资产提供给 Web 应用程序)。

我制作了一个 public GitHub 存储库 (https://github.com/MartinSnyder/serving-sbt-web-output) 来演示我正在尝试做的事情。

我的plugins.sbt是:

resolvers += Resolver.typesafeRepo("releases")

addSbtPlugin("com.typesafe.sbt" % "sbt-web" % "1.1.1")

addSbtPlugin("com.typesafe.sbt" % "sbt-less" % "1.0.6")

addSbtPlugin("com.earldouglas" % "xsbt-web-plugin" % "1.0.0")

我的build.sbt是:

name := "Example project serving sbt-web output from within SBT"

organization in ThisBuild := "com.martinsnyder"

version in ThisBuild := "0.0.1"

scalaVersion in ThisBuild := "2.11.6"

lazy val example_webjar =
  project
    .in(file("example_webjar"))
    .settings(libraryDependencies ++= Seq("org.webjars" % "requirejs" % "2.1.16"))
    .enablePlugins(SbtWeb)

lazy val example_webapp =
  project
    .in(file("example_webapp"))
    .dependsOn(example_webjar)
    .settings(libraryDependencies ++= Seq(
      "javax.servlet" % "servlet-api" % "2.5" % "provided",
      "org.eclipse.jetty" % "jetty-webapp" % "9.3.0.M2" % "container",
      "org.eclipse.jetty" % "jetty-plus"   % "9.3.0.M2" % "container",
      "commons-logging" % "commons-logging" % "1.2" % "container"
    ))
    .enablePlugins(SbtWeb)
    .settings(jetty(): _*)

webapp中的HTML文件是:

<html>
    <head>
        <title>Example</title>
        <link rel="stylesheet" type="text/css" href="css/main.css">
        <link rel="stylesheet" type="text/css" href="lib/example_webjar/css/main.css">
        <link rel="stylesheet" type="text/css" href="webjar/example_webjar/0.0.1/css/main.css">
        <script src="webjars/requirejs/2.1.16/require.js"></script>
    </head>
    <body>
        <div class="red">Red</div>
        <div class="green">Green</div>
    </body>
</html>

就目前情况而言,requirejs 已成功提供,因为它来自预构建的 webjar。这三个标签都是不同的,并且尝试引用 sbt-web 的资产输出失败。

我试图实现的最佳情况是将 sbt-web 插件输出 (target/web/public/main/) 包含在 xsbt-web-plugin webapp 输出 (target/webapp/)。我会满足于 xsbt-web-plugin 能够作为 webjar 访问项目依赖项。

如果您tell xsbt-web-plugin使用 sbt-web 的输出作为其 Web 应用程序资源目录,它应该可以帮助您完成大部分工作。

只需将 webappSrc in webapp <<= WebKeys.assets in Assets 作为设置添加到您的 example_webapp 项目:

lazy val example_webapp =
  project
    .in(file("example_webapp"))
    .dependsOn(example_webjar)
    .settings(libraryDependencies ++= Seq(
      "javax.servlet" % "servlet-api" % "2.5" % "provided",
      "org.eclipse.jetty" % "jetty-webapp" % "9.3.0.M2" % "container",
      "org.eclipse.jetty" % "jetty-plus"   % "9.3.0.M2" % "container",
      "commons-logging" % "commons-logging" % "1.2" % "container"
    ))
    .enablePlugins(SbtWeb)
    .settings(jetty(): _*)
    .settings(webappSrc in webapp <<= WebKeys.assets in Assets)

在解决 issue 之前,以下配置可能会有用:

// To sbt-web: Use 'src/main/webapp' for asset sources
sourceDirectory in Assets := baseDirectory.value / "src" / "main" / "webapp"

// To xsbt-web-plugin: Use sbt-web output instead of 'src/main/webapp'
webappSrc in webapp <<= WebKeys.assets in Assets

这将允许您将 src/main/webapp 用于您的资产和普通配置文件(例如 web.xml)。

另一种选择是使用 webappPostProcess,如 https://github.com/earldouglas/xsbt-web-plugin/issues/228 中所推荐。这将允许您保留现有的项目结构。

以下示例会将 sbt-web 生成的所有内容复制到 war 的 "assets" 目录中(并覆盖目标目录中的任何重复文件):

webappPostProcess := {
  import Path._

  val assets = (Compile / WebKeys.assets).value

  webapp =>
    val tocopy = (assets ** ("*" -- HiddenFileFilter)).get()
    val pairs = tocopy pair rebase(assets, webapp / "assets")
    IO.copy(pairs, true, true, false)
}