SBT 常用开发技巧

2019-03-12 16:02:31 浏览数 (1)

SBT 一直以来都是 Scala 开发者不可言说的痛,最主要的原因就是官方文档维护质量较差,没有经过系统的、循序渐进式的整理,导致初学者入门门槛较高。虽然也有其它构建工具可以选择(例如 Mill), 但是在短时间内基本上不可能撼动 SBT 的地位,毕竟它是 Scala 名正言顺的亲儿子。当然还有另外一个原因可能导致其它构建工具永远没有机会,Scala 语言以其卓越的编译器著称,编译器支持的丰富特性需要和构建工具进行无缝对接,例如 Scala 的 Macro 需要和构建工具的增量编译密切配合,在和编译器对接方面,SBT 具有先天优势。既然别无选择,只能选择默默忍受。下面分享在SBT使用过程中的一些常用技巧。

设置 JVM 参数

有时候我们发现 SBT 编译速度异常缓慢,甚至直接报 OutOfMemory,这时我们就需要调整 JVM 堆大小。在 SBT 中,有三种方式可以设置 JVM 参数,下面分别介绍。

环境变量

设置 JAVA_OPTS 环境变量,例如在 Windows 命令行上执行:

代码语言:javascript复制
set JAVA_OPTS="-Xmx1g -Xmx1g"

配置文件

在项目根目录下创建.jvmopts文件,内容如下:

代码语言:javascript复制
-Xmx1g 
-Xmx1g

命令行参数

只有用于类Linux平台的sbt脚本支持命令行参数方式,用于Windows平台的sbt.bat无缘该方式,这种不统一的做法竟然没有任何文档说明,哎!用法如下,-J 后面的内容会被直接用作 JVM 参数:

代码语言:javascript复制
sbt -J-Xmx1g

另外,我们也可以通过 -D 设置 JVM 的系统属性,值得欣喜的是,sbt.bat 脚本也是支持 -D 参数的:

代码语言:javascript复制
sbt -Dprop=value

自动触发任务

在 SBT 任务名前加上 ~ ,则当有文件变化时则会自动触发该任务,例如我们在 Play 开发时,可以这样启动项目:

代码语言:javascript复制
sbt ~run

当我们修改了某些文件时,SBT 会自动进行增量编译。

监测任务执行时间

当我们发现执行 sbt run 启动项目后,浏览器界面久久刷新不出来,这时我们就需要知道时间到底耗在哪儿了?执行如下命令则会打印各个任务的执行时间:

代码语言:javascript复制
sbt -Dsbt.task.timings=true clean run

如果是Windows的话需要在参数两边加引号:

代码语言:javascript复制
sbt "-Dsbt.task.timings=true" clean run

命令输出如下:

代码语言:javascript复制
D:IdeaProjectsplay-community> sbt "-Dsbt.task.timings=true" clean run
[info] Loading settings from gpg.sbt,idea.sbt ...
[info] Loading global plugins from C:Usersxiaomi.sbt1.0plugins
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
...

0 人点赞