scala - 在 SBT 中覆盖自动 API 映射

Question

我有几个依赖于 Cats 的库.假设新的 Cats 0.4.0 版本有错误 apiURL在其 POM 中的值。我不希望我的 API 文档被破坏，所以我提供了 URL 映射 apiMappings :

  ..
  autoAPIMappings := false,
  apiMappings ++= (fullClasspath in Compile).value.flatMap(
    entry => entry.get(moduleID.key).map(entry -> _)
  ).collectFirst {
    case (entry, module)
      if module.organization == "org.typelevel" &&
        module.name.startsWith("cats-") =>
          entry.data
  }.map(_ -> url("https://typelevel.org/cats/api/")).toMap,
  apiURL := Some(url("https://travisbrown.github.io/iteratee/api/")),
  ...

这适用于我的 API 文档中 Cats 类型的链接，但这意味着我丢失了标准库和其他依赖项中类型的链接。如果我改变 autoAPIMappings至 true ，不过，我的自定义映射不见了。

这对我来说没有任何意义——似乎当然明确定义的映射不应该被从依赖 POM 中自动提取的映射覆盖。

我可以用 autoAPIMappings但是针对特定的依赖项覆盖它？

Answer 1

这可能是因为 apiMappings为 doc 重新定义任务，并在设置时附加映射 autoAPImappings := true ，从而覆盖在全局范围中定义的你的。

这应该有效:

apiMappings in doc := ...