scala - sbt test:doc找不到任何要链接的成员

Question

我正在尝试运行sbt test:doc，并且看到许多类似以下的警告：


[警告] /Users/tleese/code/my/stuff/src/test/scala/com/my/stuff/common/tests/util/NumberExtractorsSpecs.scala:9：找不到任何链接到“ com.my的成员.stuff.common.util.IntExtractor”。


问题似乎是从测试源到主要源的Scaladoc引用无法正确链接。知道我做错了什么或需要配置吗？

以下是我的Build.scala的相关部分：

val docScalacOptions = Seq("-groups", "-implicits", "-external-urls:[urls]")

scalacOptions in (Compile, doc) ++= docScalacOptions
scalacOptions in (Test, doc) ++= docScalacOptions
autoAPIMappings := true

Answer 1

不确定这是否是令人满意的解决方案，但是...

Scaladoc当前期望成对的jar和URL可以使外部链接起作用。您可以使用exportJars强制sbt使用JAR链接内部依赖项。比较值

$ show test:fullClasspath

设置 exportJars之前和之后。接下来，获取正在使用的JAR的名称，并将其链接到将要上传到的URL。

scalaVersion := "2.11.0"

autoAPIMappings := true

exportJars := true

scalacOptions in (Test, doc) ++= Opts.doc.externalAPI((
  file(s"${(packageBin in Compile).value}") -> url("http://example.com/")) :: Nil)

现在，我看到 test:doc一个Scaladoc，它具有从我的 foo.IntExtractor链接到 http://example.com/index.html#foo.IntExtractor的链接。