-
Notifications
You must be signed in to change notification settings - Fork 20
Сборка и запуск
Тут рассказывается, как собрать DeskChan самому из исходных кодов. Перейдите сюда, чтобы просто скачать и попробовать DeskChan. Запускаемые файлы для всех платформ лежат в папке bin.
Скачиваем zip-архив с исходным кодом, изнутри терминала переходим туда.
При проблеме сборки внизу статьи есть раздел "Возможные ошибки"
Для сборки приложения в ОС Windows необходимо иметь установленный Java 8 JDK для Java 8 (скачать) или Java 9 JDK для Java 9 соответственно (скачать).
С помощью кнопки "Download ZIP" скачиваем архив с кодом. Открываем командную строку, переходим с помощью команды "cd %folder%", где %folder% - папка распакованных из архива файлов.
Компиляция и запуск без сборки исполняемых файлов:
gradlew.bat run
Компиляция и сборка исполняемых файлов:
gradlew.bat createExe
Компиляция и сборка полного дистирбутива с архивом:
gradlew.bat createExeDistZip
Готовые бинарники будут лежать в /build/distributions (для Windows - это файлы .bat и .exe внутри .zip архива) Приложение рекомендуется запускать через .exe-файл. Если во время работы возникают ошибки, запустите приложение через .bat-файл, чтобы увидеть консоль.
Для сборки приложения в ОС Linux необходимо иметь установленными Java-1.8 JDK с встроенной или отдельной JavaFX, launch4j для сборки бинарников и любой пакет system tray (например, libappindicator и libappindicator1 для Debian-систем).
Например, для Arch Linux
$ pacman -S jdk8-openjdk java-openjfx stalonetray libappindicator
$ yaourt -S launch4j
Можно также скачать проприетарный JDK с сайта Oracle.
Если у вас нет поддержки трея - создайте файл "/data/gui_javafx/config.properties", впишите там
use-tray=false
Компиляция и запуск без сборки исполняемых файлов:
$ ./gradlew run
ВНИМАНИЕ: обратите внимание на версию Gradle, используемую DeskChan. Использование Gradle других версий, в том числе выше 4.0, может привести к некорректной работе программы. Поэтому не используйте "gradle run", но команду выше, которая автоматически загрузит и установит необходимую версию Gradle.
Компиляция и сборка исполняемых файлов:
$ ./gradlew createExe
Компиляция и сборка полного дистирбутива с архивом:
$ ./gradlew createExeDistZip
После выполнения команды вы получите архив со всеми необходимыми для работы файлами в каталоге build/distributions. Содержимое архивов полностью самодостаточно (за исключением необходимости в установленной Java) и не требует никаких других файлов из этого репозитория.
Запускать jar-файл из каталога libs напрямую не рекомендуется, потому что скрипт запуска помимо прочего задаёт правильные значения CLASSPATH. Без этого приложение не сможет найти дополнительные библиотеки, которые ему нужны и не сможет корректно запуститься.
Приложение рекомендуется запускать через $ sh DeskChan
.
Программа работает так же и на Mac OS. Возможны подёргивания и другие неисправимые артефакты в работе gui, которые связаны с особенностями работы javafx на MacOS. Инструкции запуска идентичны инструкциям для пользователей OS Linux.
На данный момент в DeskChan отсутствует возможность указывать параметры запуска через консоль. Но это можно сделать, создав конфигурационный файл "/data/core/config.properties". Программа поддерживает следующие параметры:
quitDelay=2000 # Задержка перед закрытием программы
locale=en # Язык программы
terminal=false # Режим работы через консоль
start.run_first=0 # Запущена ли программа впервые
garbage-collection-delay=20000 # Частота вызова сборщика мусора, в мс. Поставьте -1, чтобы отключить
- Проверьте, чтобы ваша версия DeskChan собрана на соответствующем JDK (мы распространяем собранную на 8-м).
- Проверьте, что в пути папки, в которой вы собираете DeskChan, нет недопустимых символов, включая кириллицу.
- Иногда билд для распространения в архиве не собирается полностью. Например, не включается папка assets в полном составе. Понять это можно по ошибкам типа "No such file or directory", которые появляются сразу на старте программы. Попробуйте перед createExeDistZip провести build и снова собрать архив.
- Иногда появляются неизвестные ошибки типа "Cannot initialize class" или что-то такое. Попробуйте перезапустить программу, такое бывает только иногда.
- В master необязательно может лежать стабильная версия, может главный программист опять что-то начудил и сразу влил в общак. Зайдите в телеграм и надавайте ему по голове.
Подробный гайд по написанию плагина
Основное
- Сборка и запуск
- Как пользоваться
- Принципы взаимодействия плагинов
- События и команды
- Обработка речи
- Создание отдельных модулей
- Сценарии
- Информация о поддержке языков программирования
API
- Интерфейс взаимодействия с ядром
- API плагинов
- Элементы управления
- Остальные плагины
- Внешние плагины | DeskChan как сервер
Характер
А как...