ScalaFX is a UI DSL written within the Scala Language that sits on top of JavaFX. This means that every ScalaFX application is also a valid Scala application. By extension, it supports full interoperability with Java and can run anywhere the Java Virtual Machine (JVM) and JavaFX are supported.
If you have ScalaFX related questions please use ScalaFX Discussions, or ScalaFX Users Group, or ScalaFX on StackOverflow. Please report any problems using ScalaFX Issue Tracker.
ScalaFX binaries are published in the Maven Central repository: http://search.maven.org/#search|ga|1|scalafx
ScalaFX source code is using the SBT build system. For information on building with SBT see README-SBT.txt.
The official web site for ScalaFX is http://scalafx.org.
ScalaFX 12 is the current actively maintained version. ScalaFX 12 is intended to support Java 11 and newer. Staring with Java 11 JavaFX is no longer part of Java distribution. In addition to ScalaFX, JavaFX binaries needs to be explicitly added to a project. JavaFX binaries depend on operating system used. Add following to SBT configuration:
// Add dependency on ScalaFX library
libraryDependencies += "org.scalafx" %% "scalafx" % "15.0.1-R21"
// Determine OS version of JavaFX binaries
lazy val osName = System.getProperty("os.name") match {
case n if n.startsWith("Linux") => "linux"
case n if n.startsWith("Mac") => "mac"
case n if n.startsWith("Windows") => "win"
case _ => throw new Exception("Unknown platform!")
}
// Add dependency on JavaFX libraries, OS dependent
lazy val javaFXModules = Seq("base", "controls", "fxml", "graphics", "media", "swing", "web")
libraryDependencies ++= javaFXModules.map( m =>
"org.openjfx" % s"javafx-$m" % "15.0.1" classifier osName
)
If you're using Mill:
object yourProject extends ScalaModule {
// Determine OS version of JavaFX binaries
lazy val osName = System.getProperty("os.name") match {
case n if n.startsWith("Linux") => "linux"
case n if n.startsWith("Mac") => "mac"
case n if n.startsWith("Windows") => "win"
case _ => throw new Exception("Unknown platform!")
}
// Add dependency on JavaFX libraries, OS dependent
val javaFXModules = List("base", "controls", "fxml", "graphics", "media", "swing", "web")
.map(m => ivy"org.openjfx:javafx-$m:15.0.1;classifier=$osName")
def ivyDeps = {
Agg(
ivy"org.scalafx::scalafx:15.0.1-R21"
) ++ javaFXModules
}
}
ScalaFX version number has two part. The first part corresponds to the latest JavaFX version it was tested with. The second part is an incremental release number. For instance, version 15.0.1-R20
means that it was tested with JavaFX version 15
and that is the 20th release of ScalaFX.
with Java 10 use:
libraryDependencies += "org.scalafx" %% "scalafx" % "10.0.2-R15"
To use ScalaFX with SBT and Java 8 add following dependency (to use the latest scalafx you might need Java version at least 1.8.40):
libraryDependencies += "org.scalafx" %% "scalafx" % "8.0.192-R14"
With Java 7 use:
libraryDependencies += "org.scalafx" %% "scalafx" % "2.2.76-R11"
The ScalaFX Organization page on GitHub contains several sample
project that illustrate use of ScalaFX.
The simplest one, and recommended to start with, is scalafx-hello-world
.
Snapshot releases are also regularly published on Sonatype Snapshots. To use a snapshot build you may need to add "Sonatype OSS Snapshots" resolver to you SBT configuration:
resolvers += Opts.resolver.sonatypeSnapshots
If you just want to download a recent snapshot build you can also use Travis CI build site https://travis-ci.org/scalafx/scalafx
This software licensed under BSD Open Source.
The License text for this software can be found in LICENSE.txt in the root folder of the project.
The following software is needed to build ScalaFX:
It works with Windows, MacOS X and Linux ports.
The current project directory structure:
./notes
./project
./scalafx
./scalafx-demos
Where .
is a the root folder of the project.
The notes
folder contains release notes for past releases.
The scalafx
folder is the sub project for the ScalaFX Framework.
The scalafx-demos
is the sub project for the ScalaFX Framework Demonstrations (some are a bit out of date, help needed here :).
The project
folder is reserved for SBT build system setup.
The current development is for ScalaFX 12.
The development is done on the master
branch.
Releases are done on the stable
branch.
Releases are tagged with version number.
Pull requests are only accepted off a brunch created from the master
branch.
When working on a pull request, create a separate branch for each feature or bug fix.
This way the main development branch is not blocked by a pull request and pull requests are easier to merge individually.
The ScalaFX 8 and 2.2 development is no longer active.
For those who need it, the code is on branches: SFX-8
and SFX-2
.
Past releases are on SFX-8-stable
and SFX-2-stable
branches.
ScalaFX was originally created by Stephen Chin, Java Champion, Oracle JavaOne program chair; and Sven Reimers, a member of the Netbeans Dream Team.
The most up to date list of contributors to the project can be found on the Contributors page.
We request all the team members to follow the Typelevel Code of Conduct in our mailinglist, issue discussion, Gitter room or any of ScalaFX meetups.
For more info on Contribute, check our Contributing page.