Быстрый старт: различия между версиями

Материал из RunaWFE
Перейти к навигации Перейти к поиску
 
(не показано 14 промежуточных версий этого же участника)
Строка 10: Строка 10:


Оповещатель о заданиях - https://github.com/processtech/runawfe-free-notifier-java
Оповещатель о заданиях - https://github.com/processtech/runawfe-free-notifier-java
'''Важно!''' Начиная с актуального исходного кода используется JAVA 11  и для DS Eclipse 2022 (если использовать для сборки/разработки Eclipse)


=== Необходимое программное обеспечение для сборки проекта ===
=== Необходимое программное обеспечение для сборки проекта ===
Строка 19: Строка 21:
Git - распределённая система управления версиями, необходима при разработке проекта, над которым работает много разработчиков.
Git - распределённая система управления версиями, необходима при разработке проекта, над которым работает много разработчиков.


===== JDK =====
===== JDK 8/11 =====
 
JDK - Java Development Kit. RunaWFE совместима с версиями JAVA 8 и 11.
 
'''Для использования современного исходного кода НЕОБХОДИМА JAVA 11'''
 
https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html (для своей операционной системы)


https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html (для своей операционной системы)
'''Замечание:''' На java 17 b 21 не компилируетя. Надо установить именно java11. Для Windows - скачать, установить, поменять путь в переменных среды, Для линукс можно использовать export JAVA_HOME=/opt/java11, где java11 - каталог распакованной 1 java.  


JDK - Java Development Kit. RunaWFE совместима с версиями JAVA 8 и 11. При наличии других версий свяжитесь с нами, подскажем, что делать.
'''Замечание:''' Релизы 4.5.X и ниже используют JAVA 8 - https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html (для своей операционной системы)


===== Maven =====
===== Maven =====


Maven - фреймворк автоматической сборки проектов -  {{Downloads|maven|скачать maven}}.
Maven - фреймворк автоматической сборки проектов -  {{Downloads|maven|скачать maven}}.
'''Замечание''' Версия maven до 3.9.0 - https://releases.runawfe.ru/releases/d/apache-maven-3.6.3-bin.zip или https://releases.runawfe.ru/releases/d/apache-maven-3.8.6-bin.zip


===== Wildfly =====
===== Wildfly =====
'''Для использования с современным исходным кодом'''


Подготовленный сервер приложений Wildfly {{Downloads|Server|RunaWFE Free Server}}
Подготовленный сервер приложений Wildfly {{Downloads|Server|RunaWFE Free Server}}
'''Замечание:'''  Для релизов 4.5.X - подготовленный сервер приложений Wildfly {{Downloads|Server10|RunaWFE Free Server для релизов до 4.5.X}}


=== Подготовка к сборке ===
=== Подготовка к сборке ===

Текущая версия на 19:33, 9 октября 2023

Исходный код проекта

https://github.com/processtech

Основные составляющие проекта:

Сервер (среда исполнения) - https://github.com/processtech/runawfe-free-server

Редактор (дизайнер, DS, среда разработки) - https://github.com/processtech/runawfe-free-devstudio

Оповещатель о заданиях - https://github.com/processtech/runawfe-free-notifier-java

Важно! Начиная с актуального исходного кода используется JAVA 11 и для DS Eclipse 2022 (если использовать для сборки/разработки Eclipse)

Необходимое программное обеспечение для сборки проекта

Git

https://git-scm.com/downloads (для своей операционной системы).

Git - распределённая система управления версиями, необходима при разработке проекта, над которым работает много разработчиков.

JDK 8/11

JDK - Java Development Kit. RunaWFE совместима с версиями JAVA 8 и 11.

Для использования современного исходного кода НЕОБХОДИМА JAVA 11

https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html (для своей операционной системы)

Замечание: На java 17 b 21 не компилируетя. Надо установить именно java11. Для Windows - скачать, установить, поменять путь в переменных среды, Для линукс можно использовать export JAVA_HOME=/opt/java11, где java11 - каталог распакованной 1 java.

Замечание: Релизы 4.5.X и ниже используют JAVA 8 - https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html (для своей операционной системы)

Maven

Maven - фреймворк автоматической сборки проектов - скачать maven.

Замечание Версия maven до 3.9.0 - https://releases.runawfe.ru/releases/d/apache-maven-3.6.3-bin.zip или https://releases.runawfe.ru/releases/d/apache-maven-3.8.6-bin.zip

Wildfly

Для использования с современным исходным кодом

Подготовленный сервер приложений Wildfly RunaWFE Free Server

Замечание: Для релизов 4.5.X - подготовленный сервер приложений Wildfly RunaWFE Free Server для релизов до 4.5.X

Подготовка к сборке

  • Установите Git
  • Инсталлируйте JDK
  • Разархивируйте maven
  • Установите системные переменные JAVA_HOME и path.

Для Windows

Пуск - Системные перменные, создать

Добавьте в системную переменную path пути к jdk и mvn с указанием директории bin

  • Склонируйте проект

Откройте командную строку (cmd в Windows или установленную вместе с git)

Склонируйте код проекта в выбранную на Вашем компьютере директорию командой

git clone "путь к выбранной части проекта"

Ниже команды будут указаны подробно к каждой составляющей проекта.

Сборка составляющих проекта

Сервер
git clone https://github.com/processtech/runawfe-free-server
  • В склонированном runawfe-free-server для установки зависимостей:

- перейдите в директорию ../wfe-app/repository

- запустите

windows (можно запустить из командной строки или просто по клику на файл)

add_dependencies.bat

unix

add_dependencies.sh


  • Далее в директории ../wfe-app запустите команду для сборки проекта
mvn clean package

Начнётся сборка проекта сервера из исходного кода.

  • После сборки проекта в директории ../wfe-ear/target/ появится архив runawfe.ear, которым нужно будет заменить одноименный файл в предустановленном сервере приложений в директории ./wildfly/standalone/deployments/ (см. ниже Запуск сервера)

Подробнее Сервер. Руководство разработчика

Дизайнер процессов Developer Studio
git clone https://github.com/processtech/runawfe-free-devstudio

Перейдите в директорию ./plugins в склонированном на компьютере проекте и запустите

mvn clean package

В ./runawfe-professional-devstudio/plugins/ru.runa.gpd.maven/target/products/ появится собранный дизанер процессов, собранный для всех операционных систем как в запускаемом сразу виде, так и в виде zip-архивов.

Подробнее Среда разработки. Руководство разработчика

Оповещатель о заданиях
git clone https://github.com/processtech/runawfe-free-notifier-java

Для сборки нотификатора необходимо в директории сервера ./runawfe-professional-server/wfe-webservice-client/ запустить команду

mvn clean install

Сборку необходимо выполнять при включённом сервере.

Затем непосредственнно в директории ./runawfe-free-notifier-java/ выполнить

mvn clean compile assembly:single

Подробнее Оповещатель. Руководство разработчика

Запуск сервера

  • Разархивируйте RunaWFE Free Server и перейдите в раздел ../bin
  • Запустите standalone.bat (Windows) или standalone.sh (Unix)
  • Откройте web-браузер по адресу http://localhost:8080/wfe
  • Логин и пароль администратора системы по умолчанию (необходимо учитывать регистр символов):
    • логин: Administrator
    • пароль: wf

Демо процессы находятся в папке ./demo.