Начало работы

Приведенные ниже инструкции охватывают как Scala 3, так и Scala 2.

Ресурсы для новичков

Установка Scala на компьютер

Установка Scala означает установку различных инструментов командной строки, таких как компилятор Scala и инструменты сборки. Мы рекомендуем использовать инструмент установки “Coursier”, который автоматически устанавливает все зависимости. Также возможно установить по отдельности каждый инструмент вручную.

Использование Scala Installer (рекомендованный путь)

Установщик Scala — это инструмент Coursier, основная команда которого называется cs. Он гарантирует, что в системе установлены JVM и стандартные инструменты Scala. Установите его в своей системе, следуя следующим инструкциям.

brew install coursier && coursier setup

curl -fL https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup

curl -fL https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs setup

$ scala -version
Scala code runner version: 1.4.3
Scala version (default): 3.5.1

Наряду с JVM cs setup также устанавливает полезные инструменты командной строки:

Дополнительная информация о cs доступна по ссылке.

cs setup по умолчанию устанавливает компилятор и исполняющую программу Scala 3 (команды scalac и scala соответственно). Независимо от того, собираетесь ли вы использовать Scala 2 или 3, обычно это не проблема, потому что в большинстве проектов используется инструмент сборки, который будет использовать правильную версию Scala независимо от того, какая версия установлена “глобально”. Тем не менее, вы всегда можете запустить конкретную версию Scala, используя

$ cs launch scala:2.13.15
$ cs launch scalac:2.13.15

Если предпочтительно, чтобы по умолчанию запускалась Scala 2, вы можете принудительно установить эту версию с помощью:

$ cs install scala:2.13.15 scalac:2.13.15

…или вручную

Для компиляции, запуска, тестирования и упаковки проекта Scala нужны только два инструмента: Java 8 или 11 и sbt. Чтобы установить их вручную:

1. если не установлена Java 8 или 11, загрузите Java из Oracle Java 8, Oracle Java 11, или AdoptOpenJDK 8/11. Подробную информацию о совместимости Scala/Java см. в разделе Совместимость с JDK.
2. установить sbt

Создание проекта “Hello World” с помощью sbt

В следующих разделах объясняется как создавать проект Scala после того, как установлен sbt.

Для создания проекта можно использовать командную строку или IDE. Мы рекомендуем командную строку, если вы с ней знакомы.

Использование командной строки

sbt — это инструмент сборки для Scala. sbt компилирует, запускает и тестирует Scala код (он также может публиковать библиотеки и выполнять множество других задач).

Чтобы создать новый проект Scala с помощью sbt:

1. cd в пустую папку.
2. Запустите команду sbt new scala/scala3.g8, чтобы создать проект на Scala 3, или sbt new scala/hello-world.g8 для создания проекта на Scala 2. Она извлекает шаблон проекта из GitHub. Эта команда также создает папку target, которую вы можете игнорировать.
3. При появлении запроса назовите приложение hello-world. Это создаст проект под названием “hello-world”.
4. Будет сгенерировано следующее:

- hello-world
    - project (sbt использует эту папку для собственных файлов)
        - build.properties
    - build.sbt (файл определения сборки sbt)
    - src
        - main
            - scala (здесь весь Scala code)
                - Main.scala (точка входа в программу) <-- это все, что сейчас нужно

Дополнительную документацию по sbt можно найти в Scala Book (см. здесь для версии Scala 2) и в официальной документации sbt.

С интегрированной средой разработки (IDE)

Вы можете пропустить оставшуюся часть страницы и сразу перейти к созданию проекта Scala с помощью IntelliJ и sbt.

Открыть проект hello-world

Давайте используем IDE, чтобы открыть проект. Самые популярные из них — IntelliJ и VSCode. Оба предлагают обширные возможности, но вы по-прежнему можете использовать множество других редакторов.

Использование IntelliJ

1. Загрузите и установите IntelliJ Community Edition
2. Установите Scala plugin, следуя инструкциям по установке плагинов IntelliJ
3. Откройте файл build.sbt, затем выберете Open as a project

Использование VSCode с metals

1. Загрузите VSCode
2. Установите расширение Metals из Marketplace
3. Затем откройте каталог, содержащий файл build.sbt (это должен быть каталог hello-world, если вы следовали предыдущим инструкциям). Когда будет предложено, выберите Import build.

Metals — это “языковой сервер Scala”, обеспечивающий поддержку написания кода Scala в VS Code и других редакторах, таких как Atom, Sublime Text и других, использующих Language Server Protocol.

Под капотом Metals взаимодействует со средством сборки с помощью Build Server Protocol (BSP). Подробнее о том, как работает Metals, см. “Написание Scala в VS Code, Vim, Emacs, Atom и Sublime Text с помощью Metals”.

Знакомство с исходным кодом

Просмотрите эти два файла в своей IDE:

• build.sbt
• src/main/scala/Main.scala

При запуске проекта на следующем шаге, конфигурация в build.sbt будет использована для запуска кода в src/main/scala/Main.scala.

Запуск Hello World

Код в Main.scala можно запускать из IDE, если удобно.

Но вы также можете запустить приложение из терминала, выполнив следующие действия:

1. cd в hello-world.
2. Запустить sbt. Эта команда открывает sbt-консоль.
3. В консоле введите ~run. ~ является необязательным, но заставляет sbt повторно запускаться при каждом сохранении файла, обеспечивая быстрый цикл редактирования/запуска/отладки. sbt также создаст директорию target, которую пока можно игнорировать.

После окончания экспериментирования с проектом, нажмите [Enter], чтобы прервать команду run. Затем введите exit или нажмите [Ctrl+D], чтобы выйти из sbt и вернуться в командную строку.

Следующие шаги

После того как пройдете приведенные выше обучающие материалы, подумайте о том, чтобы проверить:

• The Scala Book (см. версию для Scala 2 здесь), которая содержит набор коротких уроков, знакомящих с основными функциями Scala.
• The Tour of Scala для краткого ознакомления с функциями Scala.
• Обучающие ресурсы, которые включают в себя интерактивные онлайн-учебники и курсы.
• Наш список некоторых популярных книг по Scala.
• Руководство по миграции поможет перенести существующую кодовую базу Scala 2 на Scala 3.

Получение помощи

Существует множество рассылок и real-time чатов на случай, если вы хотите быстро связаться с другими пользователями Scala. Посетите страницу нашего сообщества, чтобы ознакомиться со списком этих ресурсов и узнать, куда можно обратиться за помощью.