搜索
查看: 4029|回复: 1

[教程] 萌新如何用sbt插件打包一个不需要scala环境的scala程序

[复制链接]
发表于 2023-8-3 00:35:46 | 显示全部楼层 |阅读模式
本文是我学习scala3过程中的笔记,同时也尽量给scala基础薄弱的读者较好的阅读体验,因此可能会比较啰嗦。

intro

scala是一个多范式的编程语言,提供面向对象编程(OOP)和函数式编程(FP)两种编程范式。scala是一门静态类型的语言,同时具有优秀的类型推断,这使其编写体验又有些类似于动态类型的语言(如Pyhton)。

scala运行在jvm之上,但有具有一些jvm不具备的特性,因此如要运行scala程序,需要系统同时安装jvm和scala。

但同时具备两种运行环境的电脑不多,至少scala环境在大部分电脑中都不存在。那么,很自然的产生了这样的需求:打包scala环境,使整个程序仅需要jvm环境(或者说安装jre),甚至不需要特殊的环境即可运行。代价仅仅是打包的大小有少许增加。

步骤

系统环境

要打包不需要scala环境的scala程序,需要先进行以下的环境准备工作:
+ 配置jdk环境
+ 配置scala环境(要求具备sbt)
配置环境的步骤不是本文的重点,因此不赘述。

项目配置

在准备好环境之后,就是检查你要打包的项目,其中除了你的代码,最重要的是 build.sbt。这个文件可能长这样:

  1. val scala3Version = "3.3.0"

  2. lazy val root = project
  3.   .in(file("."))
  4.   .settings(
  5.     name := "example",
  6.     version := "0.1.0-SNAPSHOT",

  7.     scalaVersion := scala3Version,

  8.     libraryDependencies += "org.scalameta" %% "munit" % "0.7.29" % Test,
  9.   )
复制代码



打包成jar

在检查好环境和项目配置后,就需要准备打包需要的工具了。要打包成jar,我们需要的工具是:sbt-assembly

要使用这个工具,需要在 `[你的项目根目录]/project/` 里面,添加一个 assembly.sbt,内容如下:

  1. addSbtPlugin("com.eed3si9n" % "sbt-assembly" % "1.1.0")
复制代码


之后,在 build.sbt 里, `.settings()` 内,添加一行:

  1.     assembly / mainClass := Some("Package.Main")
复制代码

其中, `"Package.Main"` 中的 `Package` 为你的包路径, `Main` 为你的主类。

在完成以上工作后,再在你的项目根目录运行如下命令:

  1. sbt assembly
复制代码


scala1.png
打包过程参考,下略。


若配置无误,则可以顺利打包一份不需要scala环境的scala程序,程序将打包成jar包的形式,可以直接使用 `java -jar` 运行。当然,首次运行时会下载一些必要的文件,会需要一定的时间和较稳定的网络连接。

打包成程序包

更进一步的,我们可以打包成不需要提前安装scala环境的程序包。这里用到的工具为:sbt-native-packager

类似于sbt-assembly,我们首先需要在 `[你的项目根目录]/project/` 里面,添加一个 native-packager.sbt,内容如下:


  1. addSbtPlugin("com.github.sbt" % "sbt-native-packager" % "1.9.16")
复制代码



这里的1.9.16可以手动换成更新的版本。

然后在 build.sbt 里, `.settings()` 外,添加一行启用该插件:


  1. enablePlugins(JavaAppPackaging)
复制代码


随后可以在`.settings()` 内,添加:

  1. maintainer := "YourName"
  2. Compile / mainClass := Some("Package.Main")
复制代码


若配置无误,就可以运行以下命令生成依赖,依赖文件会放在`[你的项目根目录]/target/universal/stage/`里。

  1. sbt stage
复制代码

然后就可以打包成多种类型的包了,其中包括但不限于:ZIP, TAR, EXE, MSI, DEB, RPM。打包好的文件会放在`[你的项目根目录]/target/[打包类型]/`里。关于打包的类型和其他配置细节,可以参考这个页面

以下列举几个打包指令:

tzx包:`sbt universal:packageXzTarball`

exe(需要安装WIX):`sbt windows:packageBin`

创建不依赖java环境的包

截止目前,我们打包的程序虽然不需要scala环境,但仍需要jre(java环境)。接下来,我们开始尝试打内置jre,不需要提前在系统中安装jre的包。(注:由于我的电脑有完整java环境,因此本部分内容笔者不保证完全可用)

在这里的打包工具仍是sbt-native-packager。

首先,我们需要保证我们的jre版本为jre11或更高。然后,我们需要在 build.sbt 里, `.settings()` 外,添加如下内容:

  1. enablePlugins(JlinkPlugin)
  2. jlinkIgnoreMissingDependency := JlinkIgnore.only(
  3.   "scala.quoted" -> "scala",
  4.   "scala.quoted.runtime" -> "scala"
  5. )
复制代码


然后就可以打unversal类型,不依赖jre的包了:

  1. sbt universal:packageBin
复制代码


性能对比

分别用sbt默认方式和以上介绍的方式打包同一份跑分程序代码,并运行3次。

这是sbt打包:
scala2.png

这是sbt-assembly打包:
scala3.png

这是sbt-native-packager打包的不带jre的包:
scala4.png

这是sbt-native-packager打包的带jre的包:
scala5.png

从运行结果可以看出,跑分的差别不大,甚至比笔电拔掉电源适配器产生的影响更小,因此可以认为打包方式对运行性能没有影响。

只是……体积的变化就比较容易感知了。(这里为了方便比较大小,复制到同一个文件夹内,不代表均打包到同一处)
image.png


小结

不同的打包方式各有利弊,在性能差不多的情况下,直接用sbt打包的文件体积最小,但环境要求最高;而自带java环境的包具有最好的跨平台能力,但包体较大。因此要打成什么样的包,应该根据需求决定。

参考文章

https://www.baeldung.com/scala/package-app

回复

使用道具 举报

发表于 2023-8-3 11:41:23 | 显示全部楼层
谢谢楼主的分享。支持一下。
回复

使用道具 举报

联系我们(Contact)|手机版|萝卜头IT论坛 ( 苏ICP备15050961号-1 )

GMT+8, 2024-11-21 19:34 , Processed in 0.110553 second(s), 23 queries , Gzip On.

Powered by Discuz! X3.5

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表