使用公共扩展组件 - CUBA 框架开发者手册

4.5.1. 使用公共扩展组件

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

通过 Studio

如果你使用 CUBA Studio 11+ 以上版本，需要使用 CUBA Add-Ons 窗口管理扩展，参考 Studio 文档。

如果使用的之前版本的 CUBA Studio，按照下面的步骤：

编辑 Project properties 并在 App components 面板上单击 Custom components 旁边的加号按钮。
从 Marketplace 页面或扩展组件的文档中复制扩展组件的 Maven 坐标，并将其粘贴到坐标输入框中，例如：
```
com.haulmont.addon.cubajm:cuba-jm-global:0.3.1
```
单击对话框中的 OK。Studio 将尝试在当前项目选择的仓库中查找扩展组件的二进制文件。如果找到，对话框将关闭，扩展组件将显示在自定义组件列表中。
单击 OK 保存项目属性。

通过手动编辑

编辑 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")
}

在命令行中执行 gradlew idea 以在项目的开发环境中包含扩展组件。
编辑 core 和 web 模块的 web.xml 文件，并将扩展组件的标识符（等同于 Maven groupId）添加到 appComponents 上下文参数中以空格分隔的应用程序组件列表：
```
<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 并保存项目属性。