SBT 一直以来都是 Scala 开发者不可言说的痛,最主要的原因就是官方文档维护质量较差,没有经过系统的、循序渐进式的整理,导致初学者入门门槛较高。虽然也有其它构建工具可以选择(例如 Mill), 但是在短时间内基本上不可能撼动 SBT 的地位,毕竟它是 Scala 名正言顺的亲儿子。当然还有另外一个原因可能导致其它构建工具永远没有机会,Scala 语言以其卓越的编译器著称,编译器支持的丰富特性需要和构建工具进行无缝对接,例如 Scala 的 Macro 需要和构建工具的增量编译密切配合,在和编译器对接方面,SBT 具有先天优势。既然别无选择,只能选择默默忍受。下面分享在SBT使用过程中的一些常用技巧。
设置 JVM 参数
有时候我们发现 SBT 编译速度异常缓慢,甚至直接报 OutOfMemory,这时我们就需要调整 JVM 堆大小。在 SBT 中,有三种方式可以设置 JVM 参数,下面分别介绍。
环境变量
设置 JAVA_OPTS 环境变量,例如在 Windows 命令行上执行:
set JAVA_OPTS="-Xmx1g -Xmx1g"
配置文件
在项目根目录下创建.jvmopts文件,内容如下:
-Xmx1g -Xmx1g
命令行参数
只有用于类Linux平台的sbt脚本支持命令行参数方式,用于Windows平台的sbt.bat无缘该方式,这种不统一的做法竟然没有任何文档说明,哎!用法如下,-J 后面的内容会被直接用作 JVM 参数:
sbt -J-Xmx1g
另外,我们也可以通过 -D 设置 JVM 的系统属性,值得欣喜的是,sbt.bat 脚本也是支持 -D 参数的:
sbt -Dprop=value
自动触发任务
在 SBT 任务名前加上 ~ ,则当有文件变化时则会自动触发该任务,例如我们在 Play 开发时,可以这样启动项目:
sbt ~run
当我们修改了某些文件时,SBT 会自动进行增量编译。
监测任务执行时间
当我们发现执行 sbt run 启动项目后,浏览器界面久久刷新不出来,这时我们就需要知道时间到底耗在哪儿了?执行如下命令则会打印各个任务的执行时间:
sbt -Dsbt.task.timings=true clean run
如果是Windows的话需要在参数两边加引号:
sbt "-Dsbt.task.timings=true" clean run
命令输出如下:
D:\IdeaProjects\play-community> sbt "-Dsbt.task.timings=true" clean run [info] Loading settings from gpg.sbt,idea.sbt ... [info] Loading global plugins from C:\Users\xiaomi\.sbt\1.0\plugins Total time: 1602 ms {file:/C:/Users/xiaomi/.sbt/1.0/plugins/}global-plugins/*:update : 755 ms {file:/C:/Users/xiaomi/.sbt/1.0/plugins/}global-plugins/compile:compileIncremental : 394 ms ...