如何使用SBT修改默认构件内容并自定义其结构与类型

嘿，我帮你梳理下怎么搞定这个需求——把SBT默认生成的构件改成包含指定内容的ZIP格式。之前你修改映射没生效，大概率是没把构件类型和自定义映射正确关联起来，咱们一步步来：

核心思路 #

要实现这个需求，我们需要做三件事：

• 替换默认的JAR构件类型为ZIP
• 定义ZIP包内要包含的具体内容（你的两项指定内容）
• 确保这个自定义ZIP成为发布时的默认构件

具体实现步骤 #

在你的build.sbt里添加以下配置：

1. 定义自定义ZIP构件 #

首先我们要告诉SBT，我们要生成的是ZIP格式的构件，而不是默认的JAR：

// 替换成你的项目名称，构件ID、类型、扩展名都设为zip
val customZipArtifact = Artifact(name.value, "zip", "zip")

// 将这个自定义构件关联到默认的packageBin任务
artifact in (Compile, packageBin) := customZipArtifact

2. 指定ZIP包内的内容 #

接下来配置mappings，把你需要的两项内容添加进去。这里用示例展示，你替换成自己的文件/目录即可：

mappings in (Compile, packageBin) := Seq(
  // 示例1：把项目根目录下的README.md放到ZIP根目录
  (baseDirectory.value / "README.md") -> "README.md",
  // 示例2：把编译后的classes目录放到ZIP的lib子目录下
  (classDirectory.value) -> "lib/"
)

注意：mappings是一个Seq[(File, String)]，左边是本地文件/目录的路径，右边是它在ZIP里的相对路径。你可以根据自己的需求添加任意多的条目。

3. 确保构件会被发布 #

最后，确认我们的自定义ZIP会被包含在发布任务中：

// 启用packageBin任务的发布（默认是开启的，但明确设置更稳妥）
publishArtifact in (Compile, packageBin) := true

// 如果想禁用默认的JAR发布（可选，如果你不想同时发布JAR的话）
publishArtifact in (Compile, packageDoc) := false
publishArtifact in (Compile, packageSrc) := false

验证效果 #

配置完成后，你可以运行以下命令测试：

• sbt package：在target/scala-<你的Scala版本>/下会生成[你的项目名].zip，解压看看内容是否符合预期
• sbt publishLocal：把构件发布到本地Maven仓库，检查仓库里的构件是不是ZIP格式，内容是否正确

为啥之前修改映射没生效？ #

大概率是你只修改了mappings，但没替换默认的构件类型——SBT默认还是生成JAR包，即使你改了映射，最终输出的还是JAR，只是里面的内容变了，但类型不是你要的ZIP。现在我们通过artifact配置把构件类型改成了ZIP，再配合自定义的mappings，就能得到你想要的结果啦。

内容的提问来源于stack exchange，提问作者abiratsis