针对deps.edn项目的高效Uberjar构建工具

项目介绍

Uberjar builder是一款专为deps.edn项目设计的轻量级Uberjar创建工具。它采用了一种不占用磁盘空间且速度快的新方法，帮助您清晰了解您的依赖项，并仅打包运行时所需的内容。此外，该项目无需当前类路径或Clojure环境即可独立运行，且允许在代码中进行配置和嵌入。

项目技术分析

Uberjar builder的工作流程独特，首先启动一个仅依赖于uberdeps的JVM（不在应用类路径上），然后从deps.edn文件中解析依赖关系，但并不会加载应用程序或其依赖项，而是使用tools.deps.alpha作为运行时库进行分析。最后，直接创建最终的jar包，整个过程简洁而高效。

项目及技术应用场景

适用于任何基于Clojure并使用deps.edn管理依赖的项目。例如，当您需要创建一个干净、精简的生产环境jar包，或者希望避免将开发环境中不必要的依赖（如Datomic、nREPL等）打包进生产jar时，该工具是理想的选择。通过严格区分构建类路径和运行时类路径，Uberjar builder确保您只打包真正需要的东西。

项目特点

1. 快速: 不解压中间jar到磁盘，提高效率。
2. 明确: 打印出完整的依赖树，让您清楚地了解所打包的内容。
3. 独立: 不依赖当前类路径，不需要实时Clojure环境。
4. 可嵌入与配置: 结合配置选项并在代码中调用特定步骤以定制构建流程。
5. 细粒度控制: 通过别名和额外配置来精确控制打包的内容，如资源文件和目录。

快速入门

项目结构建议如下：

project
├ deps.edn
├ src
└ uberdeps
  ├ deps.edn
  └ package.sh

uberdeps目录中的package.sh脚本用于执行打包任务，而deps.edn文件定义了你的应用依赖。你还可以通过别名设置额外的路径和依赖，实现更灵活的配置。

无配置模式

如果你希望简化设置，可以直接在主deps.edn文件中添加uberdeps别名，尽管这会导致在打包过程中加载应用的类路径，但这通常不会产生影响。

执行生成的Uberjar

如果项目有主函数，你可以直接从生成的Uberjar中运行它，只需使用Java命令指定类路径和主命名空间。

总的来说，Uberjar builder提供了一个强大且高效的解决方案，用于创建基于Clojure的deps.edn项目的纯净、独立的部署包。无论是小型项目还是大型应用，都能从中受益。现在就尝试使用Uberjar builder，提升你的Clojure项目构建体验吧！