Перші кроки

Інструкції нижче стосуються як Scala 2 так, і та Scala 3.

Спробуйте Scala без інсталяції

Щоб швидко почати експериментувати зі Scala, відкрийте “Scastie” у вашому браузері. Scastie це онлайн “пісочниця”, де ви можете експериментувати з прикладами на Scala та подивитись як все працює, з доступом до всіх компіляторів Scala та доступних бібліотек.

Scastie підтримує як Scala 2 так, і Scala 3, але за замовчування використовується Scala 3. Якщо ж ви шукаєте приклади на Scala 2, натисніть тут.

Встановіть Scala на ваш комп’ютер

Інсталяція Scala означає встановлення різних command-line інструментів, таких як компілятор Scala та інструменти для збірки. Ми радимо використовувати інсталятор “Coursier”, який автоматично встановить всі необхідні залежності, але ви можете встановити окремо кожен інструмент.

За допомогою інсталятора Scala (рекомендовано)

Інсталятор 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 також встановлює корисні command-line інструменти:

Для більш детальної інформації про cs, прочитайте документацію coursier-cli.

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. Перевірте сумісність JDK для Scala/Java.
2. Встановіть sbt

Створити проєкт “Hello World” з sbt

Після встановлення sbt ви готові до створення проєкту на Scala, який ми розглянемо в подальших розділах.

Щоб створити проєкт, ви можете використати або термінал, або 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 uses this for its own files)
        - build.properties
    - build.sbt (sbt's build definition file)
    - src
        - main
            - scala (весь ваш код на Scala буде тут)
                - Main.scala (Точка входу в програму) <-- це все, що потрібно наразі

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

За допомогою IDE

Ви можете пропустити подальші кроки та перейти до Створення Scala проєкту з IntelliJ і sbt

Відкрити проєкт hello-world

Використаймо IDE, щоб відкрити проєкт. Найбільш популярними є IntelliJ та VSCode. Обидва з них мають багатий функціонал, але ви також можете використати багато інших редакторів.

За допомогою IntelliJ

1. Завантажте та встановіть IntelliJ Community Edition
2. Встановіть плагін Scala дотримуючись інструкції з встановлення плагінів в IntelliJ
3. Відкрийте файл build.sbt та оберіть Відкрити як проєкт (Open as a project)

За допомогою VSCode та metals

1. Завантажте VSCode
2. Встановіть розширення Metals з the Marketplace
3. Відкрийте директорію, що містить файл build.sbt (це має бути директорія hello-world якщо ви виконали попередні інструкції). Коли буде запропоновано, оберіть Імпортувати збірку (Import build).

Metals це “Сервер мови Scala” який забезпечує можливість написання коду на Scala в VS Code та інших редакторах на кшталт Atom, Sublime Text, and more, використовуючи Language Server Protocol.

Під капотом, Metals комунікує з інструментом збірки використовуючи Build Server Protocol (BSP). Більш детально про те, як працює Metals, можна подивитись на “Write Scala in VS Code, Vim, Emacs, Atom and Sublime Text with Metals”.

Внесення змін в початковий код

Перегляньте ці два файли у вашому IDE:

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

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

Запустити Hello World

Якщо вам зручно користуватися IDE, ви можете запустити код в Main.scala з вашого IDE.

В іншому випадку ви можете запустити програму через термінал, виконавши такі дії:

1. cd в hello-world.
2. Запустіть sbt. Це відкриє консоль sbt.
3. Наберіть ~run. Символ ~ опціональний і змушує sbt повторно запускатися після кожного збереження файлу, що забезпечує швидкий цикл редагування/запуск/налагодження. sbt також створить директорію target, яку ви можете проігнорувати.

Коли ви закінчите експериментувати з вашим проєктом, натисніть [Enter] щоб перервати команду run. Потім наберіть exit або затисніть [Ctrl+D] щоб вийти з sbt та повернутись до вашого командного рядка.

Наступні кроки

Після того, як ви закінчите наведені вище посібники, спробуйте пройти:

• Книга по Scala (версія по Scala 2 тут), яка містить коротких ознайомчих уроків з основних можливостей Scala.
• Тур по Scala for bite-sized introductions to Scala’s features.
• Навчальні ресурси, що містять інтерактивні онлайн путівники та курси.
• Наш список деяких популярних книжок по Scala.
• Посібник з міграції допомагає перевести ваш наявний проєкт зі Scala 2 на Scala 3.

Отримати допомогу

Існує безліч поштових розсилок та чатів в режимі реального часу, якщо ви захочете зв’язатися з іншими користувачами Scala. Перейдіть на сторінку нашої спільноти, щоб побачити перелік можливих способів та попросити про допомогу.