Installing and running SBT on Windows 10

Jun 14, 2018 · 3 min read

As I mentioned in yesterday’s post, I’m working on a workshop for Scala days (Join us if you can! ) that includes setting up an Akka cluster on a set of three Raspberry Pis. The workshop organizers have very kindly shared a pre-built image with me.

Up until now I’ve been working with the image on Windows 10 via Windows Subsystem for Linux, but I need to connect to the project in Eclipse to make updates, and it’s just not easy transferring files back and forth between the two systems.

Instead, I ’ m using Eclipse for Windows and the Windows version of the Scala Simple Build Tool (SBT). Here’s what I had to do to make that happen, in a few minutes with 2 easy steps:

• Download and install the .msi from the SBT download page
• ADD sbt\bin to the PATH.

Two handy tips for this:

For easy and error-free copying of the path, go to the sbt\bin directory, right click and choose “copy address as text”:

Then to easily add the environment variable, open the windows menu then type environment, and pick the first option:

That takes you directly to the advanced system properties dialog:

Then just pick Environment Variables, and paste the copied path in to your PATH.

One more tip: If you need to use a common.credentials file with a provided SBT script, it usually goes in

If that doesn’t work, run the script and it will tell you where it expects to find credentials via error messages.

Now you should be able to run SBT from the command line.

Optionally, to get the project working in Eclipse, add this line to your project/plugins.sbt (substitute the current version of sbteclipse from the GitHub site, mine was 5.2.4) :

Then from the project’s bae folder type

This will run for a while the first time, and generate .project and .classpath files that eclipse will use to import the project.

In Eclipse, choose File>Import>General> Existing Projects into Workspace, and choose the project’s base folder, then Next.

Руководство по использованию sbt

Этим постом, я попробую начать серию переводов официальной документации, об инструменте, который при текущем росте языка Scala становится все более востребованным, но о котором тем не менее очень мало информации на русском языке.
Речь пойдет о sbt — системе сборки проектов для языка Scala (хотя, важно упомянуть, что Java проекты (и вообще любые другие) им так же могут собираться).
Статья является началом перевода документации с сайта проекта scala-sbt.org и так как это мой первый опыт перевода — буду рад любым замечаниям и правкам.
Так же, из-за того, что пока перевод оформлен в виде статьи, я буду пропускать моменты, которые смотрелись бы не совсем корректно, в контексте отдельной части руководства.

Предисловие

sbt, используя небольшое число концепций, предлагает гибкие решения сборки проектов.
Это руководство расскажет о некоторых моментах, которые необходимы для создания и поддержки решений по сборке с помощью sbt.
Данное руководство, очень рекомендовано к прочтению. Но, если вам некогда читать все, то самую важную информацию вы можете прочитать в разделах “Параметры .sbt сборки”, “Области сборок”, “Дополнительные параметры сборок”. Но, мы не обещаем, что эта хорошая идея поможет вам пропустить все страницы данного руководства.
Лучше всего читать этот документ последовательно, опираясь на пройденный ранее материал.
Спасибо, что используете sbt! Желаем вам получить от этого максимум удовольствия!

1. Установка sbt

Для создания sbt проекта вам нужно сделать следующие шаги:

• Установить sbt и создать скрипт запуска
• Создать простой проект “Hello world”
• Создать директорию проекта с исходными файлами внутри
• Описать параметры сборки
• Прочитать как запустить sbt
• Продолжить чтение руководства о параметрах sbt сборки

В конечном счете, установка сводиться к запуску JAR файла и shell скрипта. Но, мы опишем несколько путей для разных платформ, которые могут сделать установку менее утомительной.
Если у вас появились проблемы с запуском sbt, смотрите раздел “Примечания к установке”.

1.a. Установка под Mac

С помощью Macports
$ port install sbt
Homebrew
$ brew install sbt

1.b. Установка под Windows

Просто скачайте инсталятор msi и запустите его.

1.c. Установка под Linux

Официально поддерживаемые дистрибутивы:
RPM пакет
DEB пакет

В дальнейшем я расскажу о том, как можно скачать и настроить sbt вручную. А пока что, самое интересное.

2. Hello, World

Создаем директорию проекта с исходным кодом

Одним из корректных вариантов sbt проекта, может быть директория, содержащая один файл с исходным кодом. Попробуйте создать директорию hello с файлом hw.scala, со следующим содержимым:

Теперь, в самой директории запустите sbt и наберите команду run в интерактивной консоле. В Linux или OS X это выглядить примерно так:

При создании проекта, sbt работает в соответствии со следующими правилами:

• Исходник лежит в корневой директории
• Исходники лежат в директории src/main/scala или src/main/java
• Тесты лежат в src/test/scala или src/test/java
• Файлы ресурсов в src/main/resources или src/test/resources
• Файлы jar в директории lib

По умолчанию, sbt соберет проект той версией scala, с помощью которой sbt был запущен сам.
Кроме запуска консоли, проект можно сразу запустить на выполнение командой sbt run.

Параметры сборки

Большинство проектов, все же нуждаются в более сложной настройке процесса сборки. В sbt основные параметры сборки хранятся в файле build.sbt в корневой директории проекта.
Например, если для нашего проекта hello создать файл настроек, то выглядеть бы он мог примерно так:

Обратите внимание на пустые строки. Это не просто так, они на самом деле требуются чтобы отделять строки в файле конфигурации и без них sbt выдаст ошибку. Подробнее мы вернемся к этому файлу в последующих разделах.

Установка версии sbt

Вы можете принудительно установить версию sbt если пропишете в файле hello/project/build.properties указав там следующую строчку:
sbt.version=0.13.5
Теперь, будет использоваться версия sbt 0.13.5. Хранить версию sbt следует именно в файле project/build.properties для избежания возможных колизий.

В качестве заключения

Для эксперимента, я решил ограничиться только этими самыми первыми разделами, и если реакция будет более-менее положительной, надеюсь продолжить переводить и остальные.

Парсер Хабра

Вас тоже достает, когда автор переносит топик в черновик?

суббота, 2 августа 2014 г.

Руководство по использованию sbt

Этим постом, я попробую начать серию переводов официальной документации, об инструменте, который при текущем росте языка Scala становится все более востребованным, но о котором тем не менее очень мало информации на русском языке.

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

Статья является началом перевода документации с сайта проекта scala-sbt.org и так как это мой первый опыт перевода — буду рад любым замечаниям и правкам.

Так же, из-за того, что пока перевод оформлен в виде статьи, я буду пропускать моменты, которые смотрелись бы не совсем корректно, в контексте отдельной части руководства.

Предисловие

sbt, используя небольшое число концепций, предлагает гибкие решения сборки проектов.

Это руководство расскажет о некоторых моментах, которые необходимы для создания и поддержки решений по сборке с помощью sbt.

Данное руководство, очень рекомендовано к прочтению. Но, если вам некогда читать все, то самую важную информацию вы можете прочитать в разделах “Параметры .sbt сборки”, “Области сборок”, “Дополнительные параметры сборок”. Но, мы не обещаем, что эта хорошая идея поможет вам пропустить все страницы данного руководства.

Лучше всего читать этот документ последовательно, опираясь на пройденный ранее материал.

Спасибо, что используете sbt! Желаем вам получить от этого максимум удовольствия!

1. Установка sbt

Для создания sbt проекта вам нужно сделать следующие шаги:

• Установить sbt и создать скрипт запуска
• Создать простой проект “Hello world”
• Создать директорию проекта с исходными файлами внутри
• Описать параметры сборки
• Прочитать как запустить sbt
• Продолжить чтение руководства о параметрах sbt сборки

В конечном счете, установка сводиться к запуску JAR файла и shell скрипта. Но, мы опишем несколько путей для разных платформ, которые могут сделать установку менее утомительной.

Если у вас появились проблемы с запуском sbt, смотрите раздел “Примечания к установке”.

1.a. Установка под Mac

С помощью Macports

$ port install sbt

$ brew install sbt

1.b. Установка под Windows

Просто скачайте инсталятор msi и запустите его.

1.c. Установка под Linux

Официально поддерживаемые дистрибутивы:

В дальнейшем я расскажу о том, как можно скачать и настроить sbt вручную. А пока что, самое интересное.

2. Hello, World

Создаем директорию проекта с исходным кодом

Одним из корректных вариантов sbt проекта, может быть директория, содержащая один файл с исходным кодом. Попробуйте создать директорию hello с файлом hw.scala, со следующим содержимым:

Теперь, в самой директории запустите sbt и наберите команду run в интерактивной консоле. В Linux или OS X это выглядить примерно так:

При создании проекта, sbt работает в соответствии со следующими правилами:

• Исходник лежит в корневой директории
• Исходники лежат в директории src/main/scala или src/main/java
• Тесты лежат в src/test/scala или src/test/java
• Файлы ресурсов в src/main/resources или src/test/resources
• Файлы jar в директории lib

По умолчанию, sbt соберет проект той версией scala, с помощью которой sbt был запущен сам.

Кроме запуска консоли, проект можно сразу запустить на выполнение командой sbt run.

Параметры сборки

Большинство проектов, все же нуждаются в более сложной настройке процесса сборки. В sbt основные параметры сборки хранятся в файле build.sbt в корневой директории проекта.

Например, если для нашего проекта hello создать файл настроек, то выглядеть бы он мог примерно так:

Обратите внимание на пустые строки. Это не просто так, они на самом деле требуются чтобы отделять строки в файле конфигурации и без них sbt выдаст ошибку. Подробнее мы вернемся к этому файлу в последующих разделах.

Установка версии sbt

Вы можете принудительно установить версию sbt если пропишете в файле hello/project/build.properties указав там следующую строчку:

Теперь, будет использоваться версия sbt 0.13.5. Хранить версию sbt следует именно в файле project/build.properties для избежания возможных колизий.

В качестве заключения

Для эксперимента, я решил ограничиться только этими самыми первыми разделами, и если реакция будет более-менее положительной, надеюсь продолжить переводить и остальные.

Введение в sbt

Этим постом, я попробую начать серию переводов официальной документации, об инструменте, который при текущем росте языка Scala становится все более востребованным, но о котором тем не менее очень мало информации на русском языке.
Речь пойдет о sbt — системе сборки проектов для языка Scala (хотя, важно упомянуть, что Java проекты (и вообще любые другие) им так же могут собираться).
Статья является началом перевода документации с сайта проекта scala-sbt.org и так как это мой первый опыт перевода — буду рад любым замечаниям и правкам.
Так же, из-за того, что пока перевод оформлен в виде статьи, я буду пропускать моменты, которые смотрелись бы не совсем корректно, в контексте отдельной части руководства.

Предисловие

sbt, используя небольшое число концепций, предлагает гибкие решения сборки проектов.
Это руководство расскажет о некоторых моментах, которые необходимы для создания и поддержки решений по сборке с помощью sbt.
Данное руководство, очень рекомендовано к прочтению. Но, если вам некогда читать все, то самую важную информацию вы можете прочитать в разделах “Параметры .sbt сборки”, “Области сборок”, “Дополнительные параметры сборок”. Но, мы не обещаем, что эта хорошая идея поможет вам пропустить все страницы данного руководства.
Лучше всего читать этот документ последовательно, опираясь на пройденный ранее материал.
Спасибо, что используете sbt! Желаем вам получить от этого максимум удовольствия!

1. Установка sbt

Для создания sbt проекта вам нужно сделать следующие шаги:

• Установить sbt и создать скрипт запуска
• Создать простой проект “Hello world”
• Создать директорию проекта с исходными файлами внутри
• Описать параметры сборки
• Прочитать как запустить sbt
• Продолжить чтение руководства о параметрах sbt сборки

В конечном счете, установка сводиться к запуску JAR файла и shell скрипта. Но, мы опишем несколько путей для разных платформ, которые могут сделать установку менее утомительной.
Если у вас появились проблемы с запуском sbt, смотрите раздел “Примечания к установке”.

1.a. Установка под Mac

С помощью Macports
$ port install sbt
Homebrew
$ brew install sbt

1.b. Установка под Windows

Просто скачайте инсталятор msi и запустите его.

1.c. Установка под Linux

Официально поддерживаемые дистрибутивы:
RPM пакет
DEB пакет

В дальнейшем я расскажу о том, как можно скачать и настроить sbt вручную. А пока что, самое интересное.

2. Hello, World

Создаем директорию проекта с исходным кодом

Одним из корректных вариантов sbt проекта, может быть директория, содержащая один файл с исходным кодом. Попробуйте создать директорию hello с файлом hw.scala, со следующим содержимым:

Теперь, в самой директории запустите sbt и наберите команду run в интерактивной консоле. В Linux или OS X это выглядить примерно так:

При создании проекта, sbt работает в соответствии со следующими правилами:

• Исходник лежит в корневой директории
• Исходники лежат в директории src/main/scala или src/main/java
• Тесты лежат в src/test/scala или src/test/java
• Файлы ресурсов в src/main/resources или src/test/resources
• Файлы jar в директории lib

По умолчанию, sbt соберет проект той версией scala, с помощью которой sbt был запущен сам.
Кроме запуска консоли, проект можно сразу запустить на выполнение командой sbt run.

Параметры сборки

Большинство проектов, все же нуждаются в более сложной настройке процесса сборки. В sbt основные параметры сборки хранятся в файле build.sbt в корневой директории проекта.
Например, если для нашего проекта hello создать файл настроек, то выглядеть бы он мог примерно так:

Обратите внимание на пустые строки. Это не просто так, они на самом деле требуются чтобы отделять строки в файле конфигурации и без них sbt выдаст ошибку. Подробнее мы вернемся к этому файлу в последующих разделах.

Установка версии sbt

Вы можете принудительно скачать и установить нужную версию sbt если пропишете в файле hello/project/build.properties следующую строчку:
sbt.version=0.13.5
Теперь, при запуске будет использоваться версия sbt 0.13.5. Если ее нет, то скрип скачает и установит ее в системе.
Хранить версию sbt следует именно в файле project/build.properties для избежания возможных колизий.

В качестве заключения

Для эксперимента, я решил ограничиться только этими самыми первыми разделами, и если реакция будет более-менее положительной, надеюсь продолжить переводить и остальные.