创建静态库

API文档: CreateStaticLibrary

从目标文件组装静态库。

属性

Property 描述
actions

此任务将按执行顺序执行的 Action 对象序列。

ant

此任务的 AntBuilder。您可以在构建文件中使用它来执行 ant 任务。

convention
已弃用

此任务的 Convention 对象。 Plugin 可以使用约定对象为该任务贡献属性和方法。

dependsOn

此任务的依赖项。

description

此任务的描述。

destroyables

这个任务的破坏物。

didWork

检查任务是否真的做了任何工作。即使一个Task执行了,它也可能确定它无事可做。例如,编译任务可能确定自上次任务运行以来源文件没有改变。

enabled

返回此任务是否启用。

extensions

扩展的容器。

finalizedBy

返回完成此任务的任务。

group

此任务所属的任务组。任务组在报告和用户界面中用于在向用户呈现任务列表时将相关任务分组在一起。

inputs

此任务的输入。

localState

此任务的本地状态。

logger

此任务的记录器。您可以在构建文件中使用它来编写日志消息。

logging

LoggingManager 可用于接收日志记录并控制此任务的标准输出/错误捕获。默认情况下,System.out 在 QUIET 日志级别重定向到 Gradle 日志系统,而 System.err 在 ERROR 日志级别重定向。

mustRunAfter

返回此任务必须在其后运行的任务。

name

此任务的名称。该名称在其 Project 中唯一标识任务。

outputFile

输出二进制文件所在的文件。

outputs

此任务的输出。

path

任务的路径,它是任务的完全限定名称。任务的路径是其Project的路径加上任务的名称,由:分隔。

project

该任务所属的Project

shouldRunAfter

返回此任务应在其后运行的任务。

source

要传递给归档器的源对象文件。

state

此任务的执行状态。这提供了有关此任务执行的信息,例如它是否已执行、被跳过、是否失败等。

staticLibArgs

Additional 传递给归档器的参数。

targetPlatform

链接的平台。

taskDependencies

返回一个 TaskDependency,其中包含此任务所依赖的所有任务。

temporaryDir

返回此任务可用于写入临时文件的目录。每个任务实例都有一个单独的临时目录。无法保证此目录的内容将在任务执行之后保留。

timeout

该任务的超时时间。

toolChain

用于链接的工具链。

方法

方法 描述
dependsOn(paths)

将给定的依赖项添加到此任务。有关可用作任务依赖项的对象类型的说明,请参见 这里

doFirst(action)

将给定的闭包添加到此任务的操作列表的开头。闭包在执行时将此任务作为参数传递。

doFirst(actionName, action)

将给定的 Action 添加到此任务的操作列表的开头。

doFirst(action)

将给定的 Action 添加到此任务的操作列表的开头。

doLast(action)

将给定的闭包添加到此任务的操作列表的末尾。闭包在执行时将此任务作为参数传递。

doLast(actionName, action)

将给定的 Action 添加到此任务的操作列表的末尾。

doLast(action)

将给定的 Action 添加到此任务的操作列表的末尾。

doNotTrackState(reasonNotToTrackState)

不要跟踪任务的状态。

finalizedBy(paths)

为此任务添加给定的终结器任务。

hasProperty(propertyName)

确定此任务是否具有给定的属性。有关可用于任务的属性的详细信息,请参阅 这里

mustRunAfter(paths)

指定此任务必须在所有提供的任务之后运行。

onlyIf(onlyIfClosure)

仅当给定的闭包返回 true 时才执行任务。闭包将在任务执行时评估,而不是在配置期间评估。闭包将传递一个参数,这个任务。如果闭包返回 false,任务将被跳过。

onlyIf(onlyIfReason, onlyIfSpec)
孵化中的

仅当满足给定规范时才执行任务。规范将在任务执行时评估,而不是在配置期间评估。如果不满足 Spec,任务将被跳过。

onlyIf(onlyIfSpec)

仅当满足给定规范时才执行任务。规范将在任务执行时评估,而不是在配置期间评估。如果不满足 Spec,任务将被跳过。

property(propertyName)

返回此任务的给定属性的值。此方法定位属性如下:

setProperty(name, value)

设置此任务的属性。此方法在以下位置搜索具有给定名称的属性,并在找到该属性的第一个位置设置该属性。

shouldRunAfter(paths)

指定此任务应在所有提供的任务之后运行。

source(source)

添加一组要链接的目标文件。

usesService(service)

注册此任务使用的 BuildService,以便 BuildServiceRegistration.getMaxParallelUsages() 可以得到尊重。

脚本块

没有脚本块

属性详情

List<Action<? super Task>> actions

此任务将按执行顺序执行的 Action 对象序列。

AntBuilder ant(只读)

此任务的 AntBuilder。您可以在构建文件中使用它来执行 ant 任务。

Convention convention(只读)

注意:此属性为 弃用,将在 Gradle 的下一个主要版本中删除。

此任务的 Convention 对象。 Plugin 可以使用约定对象为该任务贡献属性和方法。

Set<Object> dependsOn

此任务的依赖项。

String description

此任务的描述。

TaskDestroyables destroyables(只读)

这个任务的破坏物。

boolean didWork

检查任务是否真的做了任何工作。即使一个Task执行了,它也可能确定它无事可做。例如,编译任务可能确定自上次任务运行以来源文件没有改变。

boolean enabled

返回此任务是否启用。

ExtensionContainer extensions(只读)

扩展的容器。

TaskDependency finalizedBy

返回完成此任务的任务。

String group

此任务所属的任务组。任务组在报告和用户界面中用于在向用户呈现任务列表时将相关任务分组在一起。

TaskInputs inputs(只读)

此任务的输入。

TaskLocalState localState(只读)

此任务的本地状态。

Logger logger(只读)

此任务的记录器。您可以在构建文件中使用它来编写日志消息。

LoggingManager logging(只读)

LoggingManager 可用于接收日志记录并控制此任务的标准输出/错误捕获。默认情况下,System.out 在 QUIET 日志级别重定向到 Gradle 日志系统,而 System.err 在 ERROR 日志级别重定向。

TaskDependency mustRunAfter

返回此任务必须在其后运行的任务。

String name(只读)

此任务的名称。该名称在其 Project 中唯一标识任务。

RegularFileProperty outputFile

输出二进制文件所在的文件。

TaskOutputs outputs(只读)

此任务的输出。

String path(只读)

任务的路径,它是任务的完全限定名称。任务的路径是其Project的路径加上任务的名称,由:分隔。

Project project(只读)

该任务所属的Project

启用配置缓存时,不支持从任务操作调用此方法。

TaskDependency shouldRunAfter

返回此任务应在其后运行的任务。

FileCollection source(只读)

要传递给归档器的源对象文件。

TaskState state(只读)

此任务的执行状态。这提供了有关此任务执行的信息,例如它是否已执行、被跳过、是否失败等。

ListProperty<String> staticLibArgs

Additional 传递给归档器的参数。

Property<NativePlatform> targetPlatform

链接的平台。

TaskDependency taskDependencies(只读)

返回一个 TaskDependency,其中包含此任务所依赖的所有任务。

启用配置缓存时,不支持从任务操作调用此方法。

File temporaryDir(只读)

返回此任务可用于写入临时文件的目录。每个任务实例都有一个单独的临时目录。无法保证此目录的内容将在任务执行之后保留。

Property<Duration> timeout

该任务的超时时间。

LoggingManager captureStandardOutput​(LogLevel level)

如果任务运行时间超过指定的时间量,则执行此任务的线程将被中断。为了使任务能够正常使用此功能,它需要对中断做出反应并且必须清理它打开的所有资源。

默认情况下,任务永远不会超时。

用于链接的工具链。

方法细节

Task dependsOnObject... 路径)

将给定的依赖项添加到此任务。有关可用作任务依赖项的对象类型的说明,请参见 这里

Task doFirstClosure 动作)

将给定的闭包添加到此任务的操作列表的开头。闭包在执行时将此任务作为参数传递。

Task doFirst (String actionName, Action<? super Task> action)

将给定的 Action 添加到此任务的操作列表的开头。

Task doFirstAction<? super Task> 动作)

将给定的 Action 添加到此任务的操作列表的开头。

Task doLastClosure 动作)

将给定的闭包添加到此任务的操作列表的末尾。闭包在执行时将此任务作为参数传递。

Task doLast (String actionName, Action<? super Task> action)

将给定的 Action 添加到此任务的操作列表的末尾。

Task doLastAction<? super Task> 动作)

将给定的 Action 添加到此任务的操作列表的末尾。

void doNotTrackState (String reasonNotToTrackState)

不要跟踪任务的状态。

指示 Gradle 将任务视为未跟踪。

Task finalizedBy (Object... 路径)

为此任务添加给定的终结器任务。

interface Extension {
    val description: Property<String>
}

// register "extension" with type Extension
extension {
    // Current: Using the set() method call
    description.set("Hello Property")
    // Experimental: lazy property assignment enabled
    description = "Hello Property"
}

有关可用于指定终结器任务的对象类型的描述,请参见 这里

boolean hasProperty (String 属性名)

确定此任务是否具有给定的属性。有关可用于任务的属性的详细信息,请参阅 这里

Task mustRunAfter (Object... 路径)

指定此任务必须在所有提供的任务之后运行。

Configuration defaultDependencies​(Action<? super DependencySet> action)

对于每个提供的任务,此操作添加一个任务“排序”,并且不指定任务之间的“依赖性”。因此,仍然可以在不先执行示例中的“taskX”的情况下执行“taskY”。

有关可用于指定排序关系的对象类型的说明,请参见 这里

void onlyIf (Closure onlyIfClosure)

仅当给定的闭包返回 true 时才执行任务。闭包将在任务执行时评估,而不是在配置期间评估。闭包将传递一个参数,这个任务。如果闭包返回 false,任务将被跳过。

您可以添加多个这样的谓词。如果任何谓词返回 false,则跳过该任务。

典型用法:myTask.onlyIf { isProductionEnvironment() }

void onlyIf (String onlyIfReason, Spec<? super Task> onlyIfSpec)

注意:此方法是 孵化,可能会在 Gradle 的未来版本中更改。

仅当满足给定规范时才执行任务。规范将在任务执行时评估,而不是在配置期间评估。如果不满足 Spec,任务将被跳过。

您可以添加多个这样的谓词。如果任何谓词返回 false,则跳过该任务。

典型用法(来自 Java):

@Incubating
public abstract static class PlatformDependencyModifiers.EnforcedPlatformDependencyModifier
extends java.lang.Object
implements DependencyModifier

void onlyIf (Spec<? super Task> onlyIfSpec)

仅当满足给定规范时才执行任务。规范将在任务执行时评估,而不是在配置期间评估。如果不满足 Spec,任务将被跳过。

您可以添加多个这样的谓词。如果任何谓词返回 false,则跳过该任务。

典型用法(来自 Java):

public JacocoReport()

Object property (String 属性名)

返回此任务的给定属性的值。此方法定位属性如下:

  1. 如果此任务对象具有给定名称的属性,则返回该属性的值。
  2. 如果此任务具有给定名称的扩展名,则返回该扩展名。
  3. 如果此任务的约定对象具有给定名称的属性,则返回该属性的值。
  4. 如果此任务有一个具有给定名称的额外属性,则返回该属性的值。
  5. 如果没有找到,抛出 MissingPropertyException

void setPropertyString 名称,Object 值)

设置此任务的属性。此方法在以下位置搜索具有给定名称的属性,并在找到该属性的第一个位置设置该属性。

  1. 任务对象本身。例如,enabled 项目属性。
  2. 任务的约定对象。
  3. 任务的额外属性。

如果未找到该属性,则会抛出 MissingPropertyException

TaskDependency shouldRunAfter (Object... 路径)

指定此任务应在所有提供的任务之后运行。

public static <T> java.util.Set<T> toSet​(java.lang.Iterable<? extends T> things)

对于每个提供的任务,此操作添加一个任务“排序”,并且不指定任务之间的“依赖性”。因此,仍然可以在不先执行示例中的“taskX”的情况下执行“taskY”。

有关可用于指定排序关系的对象类型的说明,请参见 这里

void sourceObject 来源)

添加一组要链接的目标文件。

提供的源对象根据 Project.files(java.lang.Object[]) 进行评估。

void usesServiceProvider<? extends BuildService<?>> 服务)

注册此任务使用的 BuildService,以便 BuildServiceRegistration.getMaxParallelUsages() 可以得到尊重。