| API 文档 | DistributionContainer |
|---|
一个 DistributionContainer 管理一组 Distribution 对象。
| 方法 | 描述 |
create(name) | 创建一个给定名称的新项，并将其添加到此容器。 |
create(name, configureClosure) | 创建一个给定名称的新项，并将其添加到此容器，然后使用给定的闭包对其进行配置。 |
create(name, configureAction) | 创建一个给定名称的新项，并将其添加到此容器，然后使用给定的动作对其进行配置。 |
getByName(name) | 按名称查找对象，如果不存在此类对象则失败。 |
getByName(name, configureClosure) | 按名称查找对象，如果不存在此类对象则失败。在对象从此方法返回之前，会针对该对象执行给定的配置闭包。对象作为其委托传递给闭包。 |
getByName(name, configureAction) | 按名称查找对象，如果不存在此类对象则失败。在对象从此方法返回之前，会针对该对象执行给定的配置动作。 |
maybeCreate(name) | 查找具有给定名称的项，如果不存在则创建并将其添加到此容器。 |
named(name) | 按名称查找对象，如果不存在此类对象则失败。 |
named(name, type) | 按名称和类型查找对象，如果不存在此类对象则失败。 |
named(name, type, configurationAction) | 按名称和类型查找对象，如果不存在此类对象则失败。在对象从提供者返回之前，会针对该对象执行给定的配置动作。 |
named(name, configurationAction) | 按名称查找对象，如果不存在此类对象则失败。在对象从提供者返回之前，会针对该对象执行给定的配置动作。 |
named(nameFilter) | 孵化中 返回一个包含名称匹配所提供过滤器的对象的集合。返回的集合是动态的（live），因此当匹配的对象添加到此集合时，它们在过滤后的集合中也可见。 |
register(name) | 定义一个新对象，该对象将在需要时创建。当使用查询方法（例如 |
register(name, configurationAction) | 定义一个新对象，该对象将在需要时创建和配置。当使用查询方法（例如 |
创建一个给定名称的新项，并将其添加到此容器，然后使用给定的闭包对其进行配置。
此操作是急切的（eager），元素在返回之前被实例化（realized）。
创建一个给定名称的新项，并将其添加到此容器，然后使用给定的动作对其进行配置。
此操作是急切的（eager），元素在返回之前被实例化（realized）。
按名称查找对象，如果不存在此类对象则失败。在对象从此方法返回之前，会针对该对象执行给定的配置闭包。对象作为其委托传递给闭包。
此操作是急切的（eager），将导致返回的元素被实例化。
按名称查找对象，如果不存在此类对象则失败。在对象从此方法返回之前，会针对该对象执行给定的配置动作。
此操作是急切的（eager），将导致返回的元素被实例化。
NamedDomainObjectProvider<S>named(String name, Class<S>
NamedDomainObjectProvider<S>Class<S>按名称和类型查找对象，如果不存在此类对象则失败。
此方法是惰性的（lazy），并且不会导致返回的元素被实例化。
NamedDomainObjectProvider<S>named(String name, Class<S>Action<? super S>
NamedDomainObjectProvider<S>Class<S>Action<? super S>按名称和类型查找对象，如果不存在此类对象则失败。在对象从提供者返回之前，会针对该对象执行给定的配置动作。
此方法是惰性的（lazy），并且不会导致返回的元素被实例化。
NamedDomainObjectProvider<T>named(String name, Action<? super T>
NamedDomainObjectProvider<T>Action<? super T>按名称查找对象，如果不存在此类对象则失败。在对象从提供者返回之前，会针对该对象执行给定的配置动作。
此方法是惰性的（lazy），并且不会导致返回的元素被实例化。
NamedDomainObjectCollection<T>named(Spec<String>
NamedDomainObjectCollection<T>Spec<String>注意：此方法处于孵化中阶段，并且在将来的 Gradle 版本中可能会更改。
返回一个包含名称匹配所提供过滤器的对象的集合。返回的集合是动态的（live），因此当匹配的对象添加到此集合时，它们在过滤后的集合中也可见。
此方法是一个中间操作。它不改变集合中元素的实例化/未实例化状态。
NamedDomainObjectProvider<T>register(String name)
NamedDomainObjectProvider<T>定义一个新对象，该对象将在需要时创建。当使用查询方法（例如 NamedDomainObjectCollection.getByName(java.lang.String)）定位对象时，或当对此方法的返回值调用 Provider.get() 时，对象被认为是“必需的”。
通常使用此方法比使用 NamedDomainObjectContainer.create(java.lang.String) 更高效，因为该方法会急切地创建对象，无论当前构建是否需要该对象。另一方面，此方法会将创建推迟到需要时。
此操作是惰性的（lazy），返回的元素未被实例化。返回一个 NamedDomainObjectProvider，允许继续将其与其他惰性 API 一起使用。
NamedDomainObjectProvider<T>register(String name, Action<? super T>
NamedDomainObjectProvider<T>Action<? super T>定义一个新对象，该对象将在需要时创建和配置。当使用查询方法（例如 NamedDomainObjectCollection.getByName(java.lang.String)）定位对象时，或当对此方法的返回值调用 Provider.get() 时，对象被认为是“必需的”。
通常使用此方法比使用 NamedDomainObjectContainer.create(java.lang.String, org.gradle.api.Action) 或 NamedDomainObjectContainer.create(java.lang.String) 更高效，因为那些方法会急切地创建和配置对象，无论当前构建是否需要该对象。另一方面，此方法会将创建和配置推迟到需要时。
此操作是惰性的（lazy），返回的元素未被实例化。返回一个 NamedDomainObjectProvider，允许继续将其与其他惰性 API 一起使用。