Santulator

? Сантулятор

Santulator поможет вам провести розыгрыш «Тайного Санты» просто и гибко. Вы можете ввести имена людей, участвующих в розыгрыше, и система случайным образом выберет, кто кому подарит подарки. Если вы хотите избежать жеребьевки, например, чтобы гарантировать, что люди не получат в розыгрыше своих собственных партнеров, вы можете добавить исключения. После проведения розыгрыша для каждого человека будет создан PDF-файл с указанием, для кого купить подарок. Если вы хотите избежать случайного просмотра всех результатов, вы можете добавить секретный пароль к сгенерированным PDF-файлам.

Как использовать Сантулятор

Сантулятор доступен бесплатно на странице загрузки сайта проекта. Вы можете найти полное руководство, объясняющее, как использовать систему, на странице справки.

Запуск разрабатываемой версии Santulator

Вам понадобится JDK 17. Для сборки выпусков Santulator используется версия OpenJDK 17 с Hotspot от Adoptium.

Установив JDK, вы можете клонировать этот репозиторий и запустить следующую команду, чтобы запустить Santulator:

 ./gradlew :gui:run

Как построить Сантулятор

Вы можете собрать всю систему с помощью следующей команды:

 ./gradlew clean build

Как запустить тест графического интерфейса

По умолчанию тест графического интерфейса выполняется как часть стандартной сборки Gradle в автономном режиме. Если вы хотите запустить тест графического интерфейса в автономном режиме, чтобы видеть, что происходит, используйте следующую команду:

 ./gradlew :gui:test --tests io.github.santulator.gui.main.GuiTest --rerun-tasks -PnoHeadless

Как собрать устанавливаемый пакет

В статье Устанавливаемые Java-приложения с помощью jpackage вы можете прочитать о том, как создаются устанавливаемые пакеты для Mac, Windows и Linux и как вы можете сделать это в своем собственном проекте. Эти автономные установщики позволяют пользователям устанавливать Santulator на свой компьютер без необходимости предварительно устанавливать Java.

Вы также можете найти полные пошаговые инструкции по созданию установочного пакета Santulator на сайте PACKAGING.md.

Открытый исходный код и Тайный Санта с Santulator

В блоге King Tech вы можете прочитать больше о проекте в разделе Open Source & Secret Santa with Santulator. В статье содержится информация о том, как CSS JavaFX используется для придания Сантулятору праздничной цветовой схемы.