2.1. Установка CUBA Studio

Окружение

  • Убедитесь в том, что на компьютере установлен Java SE Development Kit (JDK) 8, выполнив в консоли команду

    java -version

    В ответ должно быть выведено сообщение с номером версии Java, например 1.8.0_152.

  • Если вы используете OpenJDK на Linux, установите OpenJFX, например:

    sudo apt-get install openjfx

  • Если для соединения с интернетом используется прокси-сервер, в JVM, исполняющие Studio и Gradle, необходимо передавать специальные системные свойства Java. Они описаны в документе http://docs.oracle.com/javase/8/docs/technotes/guides/net/proxies.html (см. свойства для протоколов HTTP и HTTPS).

    Рекомендуется установить нужные свойства в переменной окружения JAVA_OPTS. Скрипт запуска Studio передает JAVA_OPTS в java.exe.

Новая установка Studio

  1. Загрузите подходящий инсталлятор или ZIP архив со страницы https://www.cuba-platform.ru/download.

  2. Запустите инсталлятор или распакуйте ZIP архив в локальный каталог, например, c:\work\studio.

  3. Запустите установленное приложение или откройте командную строку, перейдите в подкаталог bin и запустите studio.bat или studio в зависимости от вашей операционной системы.

  4. В окне CUBA Studio Server введите следующие параметры:

    • Server port − порт, на котором будет запущен сервер CUBA Studio (по умолчанию 8111).

    • Remote connection - по умолчанию Studio принимает соединения только с локального компьютера. Установите данный флажок, если вам нужна возможность подключения к этому экземпляру Studio с удаленного хоста.

    • Silent startup - если выбрано, сервер Studio запускается в трее и открывает UI в браузере автоматически. Данная опция доступна только в Windows.

    studio server window

  5. Запустите сервер Studio, нажав кнопку Start.

    Когда запустится веб-сервер, в поле URL отобразится адрес, по которому доступен интерфейс Studio. Нажав →, можно открыть веб-браузер, нажав Copy − скопировать адрес в буфер обмена.

  6. Запустите веб-браузер и перейдите по указанному адресу. В веб-интерфейсе Studio перейдите на вкладку Settings и введите следующие параметры:

    • Java home − JDK, который будет использоваться для сборки и запуска проектов. Если вы установили переменную окружения JAVA_HOME как описано в начале данной главы, ее значение будет подставлено в данное поле. В противном случае Studio попытается самостоятельно найти каталог установки Java.

    • Gradle home - путь к Gradle. Оставьте поле пустым, в этом случае при первом запуске будет автоматически загружен нужный дистрибутив Gradle.

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

    • IDE port − порт, на котором принимает подключения плагин IDE (по умолчанию 48561).

    • Offline - включить возможность работы без интернет-соединения при условии, что все необходимые библиотеки были предварительно загружены из репозитория.

    • Check for updates - проверять наличие новых версий при старте.

    • Send anonymous statistics and crash reports - разрешить Studio отправлять статистику ошибок разработчикам.

    • Help language - язык встроенной справки.

    • Logging level - уровень логирования: TRACE, DEBUG, INFO, WARN, ERROR или FATAL. По умолчанию INFO.

    studio server settings

  7. Нажмите Apply and proceed to projects.

  8. Нажмите Create new для создания нового проекта, или Import для добавления имеющегося проекта в список Recent.

  9. Сразу после открытия проекта Studio загружает исходный код компонентов платформы, на которых основан проект, и сохраняет его в локальном каталоге. Перед сборкой приложения рекомендуется дождаться окончания загрузки и убедиться в том, что индикатор фоновых задач в левом нижнем углу экрана Studio погас.

Обновление CUBA Studio

Если вы обновляете Studio на новую bug-fix версию (например с 6.5.0 на 6.5.1), устанавливайте ее в существующий каталог, например на Windows это будет C:\Program Files (x86)\CUBA Studio 6.5. При установке новой minor или major версии, используйте отдельный каталог, например CUBA Studio 6.6.

Если Studio установлена из инсталлятора Windows EXE или из ZIP-архива, она поддерживает автообновление на новые bug-fix релизы. Файлы обновлений сохраняются в каталоге ~/.haulmont/studio/update. В случае каких-либо проблем с новой версией вы можете просто удалить файлы обновления и Studio вернется к версии, установленной ранее вручную.

Автообновление не работает для minor и major релизов, и если Studio была установлена из macOS DMG. В этом случае загрузите и запустите новый инсталлятор вручную.