4.5.1. 使用公共扩展组件

可以通过以下方式将发布在市场上的扩展组件添加到项目中。第一种和第二种方法假设你使用的是一个标准 CUBA 仓库。最后一种方法适用于开源扩展组件，不涉及任何远程仓库。

通过 Studio




-
编辑 Project properties 并在 App components 面板上单击 Custom components 旁边的加号按钮。

-
从 Marketplace 页面或扩展组件的文档中复制扩展组件的 Maven 坐标，并将其粘贴到坐标输入框中，例如：




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





-
单击对话框中的 OK。Studio 将尝试在当前项目选择的仓库中查找扩展组件的二进制文件。如果找到，对话框将关闭，扩展组件将显示在自定义组件列表中。

-
单击 OK 保存项目属性。



通过手动编辑




-
编辑 build.gradle 并在根 dependencies 元素中指定扩展组件的坐标：




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





-
在命令行中执行 gradlew idea 以在项目的开发环境中包含扩展组件。

-
编辑 core 和 web 模块的 web.xml 文件，并将扩展组件的标识符（等同于 Maven groupId）添加到 appComponents 上下文参数中以空格分隔的应用程序组件列表：




  1. <context-param>
        <param-name>appComponents</param-name>
        <param-value>com.haulmont.cuba com.haulmont.addon.cubajm</param-value>
    </context-param>







通过源码构建




-
将扩展组件的仓库克隆到本地目录，然后将项目导入 Studio。

-
执行 CUBA > Advanced > Install app component 主菜单命令将扩展组件安装到本地 Maven 仓库（默认为 ~/.m2 目录）。

-
在 Studio 中打开项目，然后在 Project > Properties 中选上 Use local Maven repository。

-
在 App components 面板上，单击 Custom components 旁边的加号按钮，然后在对话框底部的下拉列表中选择扩展组件。扩展组件的坐标将显示在顶部的字段中。

-
单击对话框中的 OK 并保存项目属性。