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

Аддоны, доступные на маркетплейсе CUBA, можно добавить к приложению одним из способов, описанных ниже. Первый и второй способы подразумевают, что в приложении настроен доступ к одному из стандартных репозиториев 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. Выполните команду Run > Install app component в главном меню Studio, чтобы установить аддон в локальный репозиторий Maven (по умолчанию это каталог ~/.m2).

  3. Откройте основной проект в Studio и поставьте флажок Use local Maven repository на вкладке Advanced экрана Project properties.

  4. На панели App components нажмите на кнопку со знаком плюс рядом с Custom components и выберите установленный аддон в выпадающем списке внизу диалога. Координаты аддона появятся в верхнем поле.

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