在Liferay DXP Gradle中启用传递依赖

Question

我在Liferay DXP中为Google Analytics API编写了代码。我已经通过在build.gradle中编写来导入了以下jar

    compile group: 'commons-logging', name: 'commons-logging', version: '1.1.1'
    compile group: 'com.google.api-client', name: 'google-api-client', version: '1.22.0'
    compile group: 'com.google.api-client', name: 'google-api-client-appengine', version: '1.22.0'
    compile group: 'com.google.api-client', name: 'google-api-client-gson', version: '1.22.0'
    compile group: 'com.google.http-client', name: 'google-http-client-jackson2', version: '1.22.0'
    compile group: 'com.google.api-client', name: 'google-api-client-java6', version: '1.22.0'
    compile group: 'com.google.api-client', name: 'google-api-client-servlet', version: '1.22.0'
    compile group: 'com.google.apis', name: 'google-api-services-analytics', version: 'v3-rev132-1.22.0'
    compile group: 'com.google.http-client', name: 'google-http-client', version: '1.22.0'
    compile group: 'com.google.http-client', name: 'google-http-client-appengine', version: '1.22.0'
    compile group: 'com.google.http-client', name: 'google-http-client-gson', version: '1.22.0'
    compile group: 'com.google.http-client', name: 'google-http-client-jackson2', version: '1.22.0'
    compile group: 'com.google.http-client', name: 'google-http-client-jdo', version: '1.22.0'
    compile group: 'com.google.oauth-client', name: 'google-oauth-client', version: '1.22.0'
    compile group: 'com.google.oauth-client', name: 'google-oauth-client-appengine', version: '1.22.0'
    compile group: 'com.google.oauth-client', name: 'google-oauth-client-java6', version: '1.22.0'
    compile group: 'com.google.oauth-client', name: 'google-oauth-client-jetty', version: '1.22.0'
    compile group: 'com.google.oauth-client', name: 'google-oauth-client-servlet', version: '1.22.0'
    compile group: 'com.google.code.gson', name: 'gson', version: '2.1'
    compile group: 'org.apache.httpcomponents', name: 'httpcore', version: '4.0.1'
    compile group: 'com.fasterxml.jackson.core', name: 'jackson-core', version: '2.1.3'
    compile group: 'javax.jdo', name: 'jdo2-api', version: '2.3-eb'
    compile group: 'org.mortbay.jetty', name: 'jetty', version: '6.1.26'
    compile group: 'org.mortbay.jetty', name: 'jetty-util', version: '6.1.26'
    compile group: 'com.google.code.findbugs', name: 'jsr305', version: '1.3.9'
    compile group: 'javax.transaction', name: 'transaction-api', version: '1.1'

此外，我还使用以下代码将其包含在bnd.bnd文件中：

Include-Resource: @google-api-client-1.22.0.jar,@google-http-client-1.22.0.jar,@google-api-client-java6-1.22.0.jar,@google-http-client-jackson2-1.22.0.jar,@google-http-client-gson-1.22.0.jar,@google-oauth-client-1.22.0.jar,@google-oauth-client-java6-1.22.0.jar,@gson-2.1.jar,@google-api-services-analytics-v3-rev132-1.22.0.jar,@jackson-core-2.1.3.jar,@commons-logging-1.1.1.jar,@google-api-client-appengine-1.22.0.jar,@google-api-client-gson-1.22.0.jar,@google-api-client-servlet-1.22.0.jar,@google-api-services-analytics-v3-rev132-1.22.0.jar,@google-http-client-appengine-1.22.0.jar,@google-http-client-jackson2-1.22.0.jar,@google-http-client-jdo-1.22.0.jar,@google-oauth-client-appengine-1.22.0.jar,@google-oauth-client-jetty-1.22.0.jar,@google-oauth-client-servlet-1.22.0.jar,@gson-2.1.jar,@httpcore-4.0.1.jar,@jackson-core-2.1.3.jar,@jdo2-api-2.3-eb.jar,@jetty-6.1.26.jar,@jetty-util-6.1.26.jar,@jsr305-1.3.9.jar,@transaction-api-1.1.jar

该模块编译良好，我能够得到JAR。但是当我在服务器上部署这个jar时，我总是得到未解决的需求：import-package：error。

我知道问题出在传递依赖上。我在Liferay社区的某个地方读到我们在build.gradle中提到的东西在编译时可用，它不在编译时寻找传递依赖，但在运行时我们也需要传递依赖。

Gradle可以自行下载传递依赖项，而不是在build.Gradle文件中单独提到它们。

Answer 1

通过Include-Resource（或-includeresource）指定@some.jar，可以将JAR的所有内容复制到自己的JAR中。这是一个构建指令。

对于编译时，gradle可以识别和下载传递依赖项，但请注意，其中一些依赖项可能是可选的--在这种情况下，如果您想拥有所有这些依赖项，这是有问题的。另外：请注意，编译时依赖项并不一定意味着必须为运行时打包此依赖项。事实上，您使用IncludeResource进行的包装是由bnd完成的，而根本不是由gradle完成的。

您在这里指定的内容（包括您自己的jar中的30个jar）并不是最佳实践。如果它们是OSGi包，您应该将它们单独部署到OSGi运行时。如果它们不是OSGi bundle，您应该查找它们转换为OSGi bundle的地方。只有到那时，您才应该将剩下的非bundle包含在您自己的jar中，除非您找到了更好的选择（例如，您自己将它们变成bundles并向上游发送pullrequests）

为了演示：让我从IncludeResource指令中展开您的jar列表，您已经在一行中输入了这些jar：

• @google-api-client-1.22.0.jar
• @google-http-client-1.22.0.jar
• @google-api-client-java6-1.22.0.jar
• @google-http-client-jackson2-1.22.0.jar
• @google-http-client-gson-1.22.0.jar
• @google-oauth-client-1.22.0.jar
• @google-oauth-client-java6-1.22.0.jar
• @gson-2.1.jar
• @google-api-services-analytics-v3-rev132-1.22.0.jar
• @jackson-core-2.1.3.jar
• @commons-logging-1.1.1.jar
• @google-api-client-appengine-1.22.0.jar
• @google-api-client-gson-1.22.0.jar
• @google-api-client-servlet-1.22.0.jar
• @google-api-services-analytics-v3-rev132-1.22.0.jar
• @google-http-client-appengine-1.22.0.jar
• @google-http-client-jackson2-1.22.0.jar
• @google-http-client-jdo-1.22.0.jar
• @google-oauth-client-appengine-1.22.0.jar
• @google-oauth-client-jetty-1.22.0.jar
• @google-oauth-client-servlet-1.22.0.jar
• @gson-2.1.jar（哎呀，重复）
• @httpcore-4.0.1.jar
• @jackson-core-2.1.3.jar
• @jdo2-api-2.3-eb.jar
• @jetty6.1.26.jar
• @jetty-6.1.26.jar
• @jsr305-1.3.9.jar
• @transaction-api-1.1.jar

虽然我不鼓励在自己的jar中继续包含30个jar，但对于那些不是OSGi包的依赖项，还有另一种选择：如果需要包含任何必需的（非可选的）传递依赖项，我知道gradle的compileInclude指令将自动包含它们。

我最近录制了一段关于不同分级选项的视频，很快（经过适当的编辑）将被添加到Liferay大学的（免费）OSGi基础课程中--视频的初步编辑可能有助于理解当您在自己的jar中包含第三方代码时发生了什么--您可以在这里找到它。