scala - 如何在一个库中支持多个 Scala 版本

Question

我有一个相当正常的 Scala project目前正在使用 Maven 构建。我想同时支持 Scala 2.9.x 和即将推出的 2.10，它不是二进制或源代码兼容的。如有必要，我愿意接受转换为 SBT，但我遇到了一些挑战。

我对这个项目的要求是:

单一源树(无分支)。我相信尝试为每个 Scala 版本支持多个并发的“主”分支将是错过分支之间错误修复的最快方法。

版本特定的源目录。由于 Scala 版本不兼容源代码，因此我需要能够为特定版本的源代码指定一个辅助源代码目录。

版本特定的源 jars。最终用户应该能够为他们用于 IDE 集成的 Scala 版本下载正确的源 jar，以及正确的版本特定源。

集成部署。我目前使用 Maven 发布插件将新版本部署到 Sonatype OSS 存储库，并希望有一个类似简单的发布工作流程。

最终用户 Maven 支持。我的最终用户通常是 Maven 用户，因此准确反射(reflect)依赖关系的功能 POM 至关重要。

阴影 jar 支持。我需要能够生成一个 JAR，其中包含我的依赖项的子集，并从已发布的 POM 中删除阴影依赖项。

我尝试过的事情:

Maven 配置文件。我创建了一组 Maven 配置文件来控制用于构建的 Scala 版本，使用 Maven build-helper 插件来选择特定于版本的源树。在发布之前，这一直运行良好；

使用分类器来限定版本效果不佳，因为源 jar 还需要自定义分类器('source-2.9.2' 等)，并且大多数 IDE 工具不知道如何定位它们。

我尝试使用 Maven 属性将 SBT 样式的 _${scala.version} 后缀添加到 Artifact 名称，但 Maven 不喜欢 Artifact 名称中的属性。

SBT。一旦你可以理解它，这就会很好地工作(尽管有大量文档，但这是一项不小的任务)。缺点是似乎没有与 Maven shade 插件等效的插件。我看过:

亵渎者。该插件未针对 SBT 0.12.x 进行更新，并且不会从源代码构建，因为它依赖于另一个更改了 groupId 的 SBT 插件，并且在旧名称下没有 0.12.x 版本。我还没有弄清楚如何指示 SBT 忽略/替换插件依赖项。

一 jar 。这使用自定义类加载从嵌入式 jar 中运行 Main 类，这不是预期的结果；我希望我的项目的类文件与我的着色依赖项中的(可能重命名的)类文件一起放在 jar 中。

SBT 组装插件。这可以在一定程度上起作用，但 POM 文件似乎包含我试图隐藏的依赖项，这对我的最终用户没有帮助。

我接受可能没有解决方案可以满足我对 Scala 的要求，和/或我可能需要编写自己的 Maven 或 Scala 插件来实现目标。但如果可以，我想找到一个现有的解决方案。

更新

我即将接受@Jon-Ander 的优秀 answer ，但对我来说还是有一个比较突出的，就是统一的发布流程。我的当前状态 build.sbt is on GitHub . (我将在稍后的答案中复制它以供后代使用)。

sbt-release 插件不支持多版本构建(即 + release 的行为不像人们喜欢的那样)，这是有道理的，因为发布标记的过程并不真正需要跨版本发生。但我希望该过程的两个部分是多版本的:测试和发布。

我希望发生的事情类似于两阶段的 maven-release-plugin 过程。第一阶段将执行更新 Git 和运行测试的管理工作，在这种情况下，这意味着运行 + test以便所有版本都经过测试、标记、更新到快照，然后将结果推送到上游。

第二阶段将检查标记版本和 + publish ，这将重新运行测试并将标记的版本推送到 Sonatype 存储库。

我怀疑我可以写 releaseProcess执行这些中的每一个的值，但我不确定我是否可以支持多个 releaseProcess我的 build.sbt 中的值.它可能可以与一些额外的范围一起使用，但是 SBT 的那部分对我来说仍然很奇怪。

我目前所做的是更改了 releaseProcess不发表。然后我必须手动 check out 标记版本并运行 + publish事实上，这与我想要的很接近，但确实有所妥协，特别是因为测试仅在发布过程中的当前 scala 版本上运行。我可以接受一个不像 maven 插件那样两阶段的过程，但确实实现了多版本测试和发布。

任何可以让我完成最后一英里的其他反馈将不胜感激。

Answer 1

在单个源代码树中的 sbt 中的大部分内容都得到了很好的支持

通常不需要特定于版本的源目录。 Scala 程序往往是源代码兼容的——事实上经常这样
crossbuilding ( http://www.scala-sbt.org/release/docs/Detailed-Topics/Cross-Build ) 在 sbt 中有一流的支持。

如果您确实需要特定于版本的代码，则可以添加额外的源文件夹。
把它放在你的 build.sbt 文件中，除了常规的“src/main/scala”之外，当你交叉构建时，会添加“src/main/scala-[scalaVersion]”作为每个版本的源目录。
(还有一个插件可用于在版本之间生成垫片，但我还没有尝试过 - https://github.com/sbt/sbt-scalashim)

unmanagedSourceDirectories in Compile <+= (sourceDirectory in Compile, scalaVersion){ (s,v) => s / ("scala-"+v) }

版本特定的源 jars - 请参阅交叉构建，开箱即用

集成部署- https://github.com/sbt/sbt-release (也有很棒的 git 集成)

Maven 最终用户 - http://www.scala-sbt.org/release/docs/Detailed-Topics/Publishing.html

阴影 - 我用过这个 https://github.com/sbt/sbt-assembly这已经很好地满足了我的需求。
你的程序集插件问题可以通过重写生成的pom来解决。
这是一个撕掉 joda-time 的例子。

pomPostProcess := {
    import xml.transform._
    new RuleTransformer(new RewriteRule{
        override def transform(node:xml.Node) = {
            if((node \ "groupId").text == "joda-time") xml.NodeSeq.Empty else node
        }
    })
}

完整的 build.sbt 以供引用

scalaVersion := "2.9.2"

crossScalaVersions := Seq("2.9.2", "2.10.0-RC5")

unmanagedSourceDirectories in Compile <+= (sourceDirectory in Compile, scalaVersion){ (s,v) => s / ("scala-"+v) }

libraryDependencies += "joda-time" % "joda-time" % "1.6.2"

libraryDependencies += "org.mindrot" % "jbcrypt" % "0.3m"

pomPostProcess := {
    import xml.transform._
    new RuleTransformer(new RewriteRule{
        override def transform(node:xml.Node) = {
            if((node \ "groupId").text == "joda-time") xml.NodeSeq.Empty else node
        }
    })
}