4.5.1. Использование публичных аддонов

Аддоны, доступные на маркетплейсе CUBA, можно добавить к приложению одним из способов, описанных ниже. Первый и второй способы подразумевают, что в приложении настроен доступ к одному из стандартных репозиториев CUBA. Третий подход применим к аддонам с открытым исходным кодом и не требует подключения к какому-либо удалённому репозиторию.

Подключение из Studio

Если вы используете CUBA Studio 11+, управляйте аддонами в окне CUBA Add-Ons, как это описано в документации по Studio.

Для предыдущих версий CUBA Studio выполните следующие действия:

  1. Откройте экран Project properties и на панели App components нажмите на кнопку со знаком плюс рядом с Custom components.

  2. Скопируйте координаты аддона из маркетплейса или документации к аддону и вставьте их в поле координат компонента, например:

    com.haulmont.addon.cubajm:cuba-jm-global:0.3.1

  3. Нажмите OK в диалоговом окне. Studio попытается найти бинарные артефакты аддона в репозитории, используемом в проекте в настоящий момент. Если они найдены, диалоговое окно закроется, и аддон появится в списке собственных компонентов.

  4. Сохраните изменения в свойствах проекта нажатием OK.

Добавление вручную

  1. Откройте файл build.gradle на редактирование и добавьте координаты аддона в секцию dependencies:

    dependencies {
    appComponent("com.haulmont.cuba:cuba-global:$cubaVersion")
    // your add-ons go here
    appComponent("com.haulmont.addon.cubajm:cuba-jm-global:0.3.1")
}

  2. Выполните команду gradlew idea из командной строки, чтобы добавить аддон к окружению проекта.

  3. Добавьте в файлы web.xml модулей core и web идентификатор аддона (он совпадает с Maven groupId) в параметр контекста appComponents к списку компонентов приложения, разделённому пробелами:

    <context-param>
    <param-name>appComponents</param-name>
    <param-value>com.haulmont.cuba com.haulmont.addon.cubajm</param-value>
</context-param>
Сборка из исходников

  1. Склонируйте репозиторий аддона в локальный каталог и откройте проект аддона в Studio.

  2. Выполните команду CUBA > Advanced > Install app component в главном меню Studio, чтобы установить аддон в локальный репозиторий Maven (по умолчанию это каталог ~/.m2).

  3. Откройте основной проект в Studio и добавьте локальный репозиторий Maven к списку используемых репозиториев в экране настроек проекта Project properties.

  4. Добавьте аддон в проект используя диалог CUBA Add-ons в Studio. Подробнее см. Установка аддона по координатам в секции Управление аддонами Руководства пользователя CUBA Studio.

  5. Нажмите OK в диалоге и сохраните изменения.

Если в проекте используется несколько аддонов, имеющих модуль web-toolkit, то в проекте также должен быть модуль web-toolkit. Если его нет, то в приложение загружается только один набор виджетсетов из одного аддона. Таким образом, модуль web-toolkit необходим для интеграции всех виджетсетов из используемых аддонов.