IvyPublication

此 publication 的完整 artifact 集合。

设置此属性将清除任何先前添加的 artifact，并从指定源创建 artifact。每个提供的源都按照 IvyPublication.artifact(java.lang.Object) 的方式解释。例如，要排除组件声明的依赖项，并改为使用自定义的 artifact 集合：

plugins {
    id 'java'
    id 'ivy-publish'
}

task sourceJar(type: Jar) {
  archiveClassifier = "source"
}

publishing {
  publications {
    ivy(IvyPublication) {
      from components.java
      artifacts = ["my-custom-jar.jar", sourceJar]
    }
  }
}

此 publication 的完整配置集合。

将要发布的模块描述符。

此 publication 的模块。

此 publication 的组织。

此 publication 的修订版本。

创建一个自定义的 IvyArtifact 以包含在 publication 中。artifact 方法可以接受各种输入：

以下示例演示了各种自定义 artifact 的添加。

plugins {
    id 'ivy-publish'
}

task sourceJar(type: Jar) {
  archiveClassifier = "source"
}

task genDocs {
  doLast {
    // Generate 'my-docs-file.htm'
  }
}

publishing {
  publications {
    ivy(IvyPublication) {
      artifact sourceJar // Publish the output of the sourceJar task
      artifact 'my-file-name.jar' // Publish a file created outside of the build
      artifact source: 'my-docs-file.htm', classifier: 'docs', extension: 'html', builtBy: genDocs // Publish a file generated by the 'genDocs' task
    }
  }
}

创建一个 IvyArtifact 以包含在 publication 中，该 artifact 由相关操作配置。第一个参数用于创建自定义 artifact 并将其添加到 publication，如 IvyPublication.artifact(java.lang.Object) 所示。然后使用提供的操作配置创建的 IvyArtifact。此方法还接受配置操作作为闭包参数，通过类型强制转换。

plugins {
    id 'ivy-publish'
}

task sourceJar(type: Jar) {
  archiveClassifier = "source"
}

task genDocs {
  doLast {
    // Generate 'my-docs-file.htm'
  }
}

publishing {
  publications {
    ivy(IvyPublication) {
      artifact(sourceJar) {
        // These values will be used instead of the values from the task. The task values will not be updated.
        classifier = "src"
        extension = "zip"
        conf = "runtime->default"
      }
      artifact("my-docs-file.htm") {
        type = "documentation"
        extension = "html"
        builtBy genDocs
      }
    }
  }
}

定义应包含在发布的 ivy 模块描述符文件中的一些 IvyConfiguration。以下示例演示如何添加一个“testCompile”配置，以及一个扩展它的“testRuntime”配置。

plugins {
    id 'java'
    id 'ivy-publish'
}

publishing {
  publications {
    ivy(IvyPublication) {
      configurations {
          testCompile {}
          testRuntime {
              extend "testCompile"
          }
      }
    }
  }
}

配置将要发布的描述符。

可以通过使用 IvyModuleDescriptorSpec.withXml(org.gradle.api.Action) 方法修改描述符 XML。

提供应发布的软件组件。

目前支持两种组件类型：“components.java”（由 JavaPlugin 添加）和“components.web”（由 WarPlugin 添加）。对于任何单独的 IvyPublication，只能以这种方式提供一个组件。以下示例演示如何将“java”组件发布到 ivy 仓库。

plugins {
    id 'java'
    id 'ivy-publish'
}

publishing {
  publications {
    ivy(IvyPublication) {
      from components.java
    }
  }
}

禁止所有 Ivy publication 的兼容性警告。当使用无法完全映射到 Ivy xml 的 Gradle 功能时，会发出警告。

禁止 Ivy publication 对指定 variant 的兼容性警告。当使用无法完全映射到 Ivy xml 的 Gradle 功能时，会发出警告。