Extension Details

Scala provides syntax highlighting and autocompletion for the Scala language
using the Metals language server.

This extension requires Coursier to be installed and on the system path:
https://get-coursier.io/

Language Support

Supported Features:

• Syntax highlighting
• Go-to definition
• Hover documentation
• JDK selection
• Metals commands: "import build", "connect to build server", "switch build
  server", "restart build server", "disconnect from build server", "cascade
  compile", "clean compile", "cancel compilation", "reset workspace", and "list
  build targets"

Configuration

Java Home

By default, the JAVA_HOME configured on the system path is used to install and
run Metals for all projects.

When the Java Home setting is set to a local JDK
folder, that path will be used in place of JAVA_HOME and Metals will be
re-installed and restarted with it instead.

Command Palette Reference

Metals: Import build

Imports the latest changes from the build. For example, this command pulls in
the latest library dependencies. Run this command if the project feels
unresponsive or if the build has been re-configured.

Reference

Metals: Update

Updates the Metals tool installed with this extension to the latest version.

Metals: Restart

Stops and restarts the Metals application.

Metals: Doctor

Opens the Metals doctor diagnostics page in the default web browser.

Metals: Switch build server

Provides a prompt to switch the underlying build server.

Reference

Metals: Connect to build server

Creates a new connection to the build server. Useful when documentation of go-to
feels unresponsive.

Reference

Metals: Cancel compilation

Cancels any ongoing compilations.

Reference

Metals: Cascade compile

Compiles the open files and any files dependent on open files.

Reference

Metals: Clean compile

Recompiles all build targets in the workspace.

Reference

Metals: Reset notifications

Resets any dismissed notifications so that choices can be made again.

Reference

Metals: Restart build server

Stops and restart the current running build server.

Reference

Metals: Disconnect from old build server

Cancels the existing build server connection.

Reference

Metals: Reset workspace

Cleans the Metals cache and restarts the build server. If a project is not
responding to hover or go-to and the "Metals: Import Build" command didn't help,
this command can fully reset Metals for this project.

Reference

Metals: List build targets

Lists Metals build targets in the workspace using a notification.

Reference

Version 0.3.0

• moves java.home setting to the global extension configuration
• updates tree-sitter-scala to 0.23.2
• adds with and throw keyword highlights
• adds Metals: Restart command