Package org.gradle

Klasse StartParameter

java.lang.Object
org.gradle.StartParameter
Alle implementierten Schnittstellen:
Serializable, LoggingConfiguration, ParallelismConfiguration
public class StartParameter extends Object implements LoggingConfiguration, ParallelismConfiguration, Serializable

StartParameter defines the configuration used by a Gradle instance to execute a build. The properties of StartParameter generally correspond to the command-line options of Gradle.

You can obtain an instance of a StartParameter by either creating a new one, or duplicating an existing one using newInstance() or newBuild().

Siehe auch:

  • Felddetails

    • GRADLE_USER_HOME_PROPERTY_KEY

      public static final String GRADLE_USER_HOME_PROPERTY_KEY
      Siehe auch:

    • DEFAULT_GRADLE_USER_HOME

      public static final File DEFAULT_GRADLE_USER_HOME
      The default user home directory.

    • gradleHomeDir

      protected File gradleHomeDir

  • Konstruktordetails

    • StartParameter

      public StartParameter()
      Creates a StartParameter with default values. This is roughly equivalent to running Gradle on the command-line with no arguments.

    • StartParameter

      protected StartParameter(org.gradle.initialization.BuildLayoutParameters layoutParameters)
      Creates a StartParameter initialized from the given BuildLayoutParameters.
      Seit:
      7.0

  • Methodendetails

    • getLogLevel

      public LogLevel getLogLevel()
      Returns the minimum logging level to use. All log messages with a lower log level are ignored. Defaults to LogLevel.LIFECYCLE.
      Angegeben von:
      getLogLevel in Schnittstelle LoggingConfiguration

    • setLogLevel

      public void setLogLevel(LogLevel logLevel)
      Specifies the minimum logging level to use. All log messages with a lower log level are ignored.
      Angegeben von:
      setLogLevel in Schnittstelle LoggingConfiguration

    • getShowStacktrace

      public ShowStacktrace getShowStacktrace()
      Returns the detail that should be included in stacktraces. Defaults to ShowStacktrace.INTERNAL_EXCEPTIONS.
      Angegeben von:
      getShowStacktrace in Schnittstelle LoggingConfiguration

    • setShowStacktrace

      public void setShowStacktrace(ShowStacktrace showStacktrace)
      Sets the detail that should be included in stacktraces.
      Angegeben von:
      setShowStacktrace in Schnittstelle LoggingConfiguration

    • getConsoleOutput

      public ConsoleOutput getConsoleOutput()
      Returns the style of logging output that should be written to the console. Defaults to ConsoleOutput.Auto
      Angegeben von:
      getConsoleOutput in Schnittstelle LoggingConfiguration

    • setConsoleOutput

      public void setConsoleOutput(ConsoleOutput consoleOutput)
      Specifies the style of logging output that should be written to the console.
      Angegeben von:
      setConsoleOutput in Schnittstelle LoggingConfiguration

    • getWarningMode

      public WarningMode getWarningMode()
      Specifies which type of warnings should be written to the console.
      Angegeben von:
      getWarningMode in Schnittstelle LoggingConfiguration

    • setWarningMode

      public void setWarningMode(WarningMode warningMode)
      Specifies which type of warnings should be written to the console.
      Angegeben von:
      setWarningMode in Schnittstelle LoggingConfiguration

    • setProjectCacheDir

      public void setProjectCacheDir(@Nullable File projectCacheDir)
      Sets the project's cache location. Set to null to use the default location.

    • getProjectCacheDir

      @Nullable public File getProjectCacheDir()
      Returns the project's cache dir.

      Note that this directory is managed by Gradle, and it assumes full ownership of its contents. Plugins and build logic should not store or modify any files or directories within this cache directory.

      Gibt zurück:
      project's cache dir, or null if the default location is to be used.

    • newInstance

      public StartParameter newInstance()
      Duplicates this StartParameter instance.
      Gibt zurück:
      the new parameters.

    • prepareNewInstance

      protected StartParameter prepareNewInstance(StartParameter p)

    • newBuild

      public StartParameter newBuild()

      Creates the parameters for a new build, using these parameters as a template. Copies the environmental properties from this parameter (eg Gradle user home dir, etc), but does not copy the build specific properties (eg task names).

      Gibt zurück:
      The new parameters.

    • prepareNewBuild

      protected StartParameter prepareNewBuild(StartParameter p)

    • equals

      public boolean equals(Object obj)
      Setzt außer Kraft:
      equals in Klasse Object

    • hashCode

      public int hashCode()
      Setzt außer Kraft:
      hashCode in Klasse Object

    • getBuildFile

      @Deprecated @Nullable public File getBuildFile()
      Veraltet.
      Setting custom build file to select the default project has been deprecated. This method will be removed in Gradle 9.0.
      Returns the build file to use to select the default project. Returns null when the build file is not used to select the default project.
      Gibt zurück:
      The build file. May be null.

    • setBuildFile

      @Deprecated public void setBuildFile(@Nullable File buildFile)
      Veraltet.
      Setting custom build file to select the default project has been deprecated. Please use setProjectDir(File) to specify the directory of the default project instead. This method will be removed in Gradle 9.0.
      Sets the build file to use to select the default project. Use null to disable selecting the default project using the build file.
      Parameter:
      buildFile - The build file. May be null.

    • getTaskNames

      public List<String> getTaskNames()
      Returns the names of the tasks to execute in this build. When empty, the default tasks for the project will be executed. If TaskExecutionRequests are set for this build then names from these task parameters are returned.
      Gibt zurück:
      the names of the tasks to execute in this build. Never returns null.

    • setTaskNames

      public void setTaskNames(@Nullable Iterable<String> taskNames)

      Sets the tasks to execute in this build. Set to an empty list, or null, to execute the default tasks for the project. The tasks are executed in the order provided, subject to dependency between the tasks.

      Parameter:
      taskNames - the names of the tasks to execute in this build.

    • getTaskRequests

      public List<TaskExecutionRequest> getTaskRequests()
      Returns the tasks to execute in this build. When empty, the default tasks for the project will be executed.
      Gibt zurück:
      the tasks to execute in this build. Never returns null.

    • setTaskRequests

      public void setTaskRequests(Iterable<? extends TaskExecutionRequest> taskParameters)

      Sets the task parameters to execute in this build. Set to an empty list, to execute the default tasks for the project. The tasks are executed in the order provided, subject to dependency between the tasks.

      Parameter:
      taskParameters - the tasks to execute in this build.

    • getExcludedTaskNames

      public Set<String> getExcludedTaskNames()
      Returns the names of the tasks to be excluded from this build. When empty, no tasks are excluded from the build.
      Gibt zurück:
      The names of the excluded tasks. Returns an empty set if there are no such tasks.

    • setExcludedTaskNames

      public void setExcludedTaskNames(Iterable<String> excludedTaskNames)
      Sets the tasks to exclude from this build.
      Parameter:
      excludedTaskNames - The task names.

    • getCurrentDir

      public File getCurrentDir()
      Returns the directory to use to select the default project, and to search for the settings file.
      Gibt zurück:
      The current directory. Never returns null.

    • setCurrentDir

      public void setCurrentDir(@Nullable File currentDir)
      Sets the directory to use to select the default project, and to search for the settings file. Set to null to use the default current directory.
      Parameter:
      currentDir - The directory. Set to null to use the default.

    • getProjectProperties

      public Map<String,String> getProjectProperties()
      Key-value map of project properties. These are derived from the command-line arguments (-P) and do not reflect the final project properties available. Changing these properties may be too late to impact the build configuration.
      Gibt zurück:
      map of properties

    • setProjectProperties

      public void setProjectProperties(Map<String,String> projectProperties)
      Sets the project properties. This completely replaces the map of project properties. Changing these properties may be too late to impact the build configuration.
      Parameter:
      projectProperties - new map of properties

    • getSystemPropertiesArgs

      public Map<String,String> getSystemPropertiesArgs()
      Key-value map of system properties. These are derived from the command-line arguments (-D) and do not reflect the final system properties available. Changing these properties may be too late to impact the build configuration.
      Gibt zurück:
      map of properties

    • setSystemPropertiesArgs

      public void setSystemPropertiesArgs(Map<String,String> systemPropertiesArgs)
      Sets the system properties. This completely replaces the map of system properties. Changing these properties may be too late to impact the build configuration.
      Parameter:
      systemPropertiesArgs - new map of properties

    • getGradleUserHomeDir

      public File getGradleUserHomeDir()
      Returns the directory to use as the user home directory.
      Gibt zurück:
      The home directory.

    • setGradleUserHomeDir

      public void setGradleUserHomeDir(@Nullable File gradleUserHomeDir)
      Sets the directory to use as the user home directory. Set to null to use the default directory.
      Parameter:
      gradleUserHomeDir - The home directory. May be null.

    • isBuildProjectDependencies

      public boolean isBuildProjectDependencies()
      Returns true if project dependencies are to be built, false if they should not be. The default is true.

    • setBuildProjectDependencies

      public StartParameter setBuildProjectDependencies(boolean build)
      Specifies whether project dependencies should be built. Defaults to true.
      Gibt zurück:
      this

    • isDryRun

      public boolean isDryRun()
      Is the build running as a dry-run? Dry-run means task actions do not execute for the root build.
      Gibt zurück:
      true if the build is running as a dry-run

    • setDryRun

      public void setDryRun(boolean dryRun)
      Enables or disables dry-run.
      Parameter:
      dryRun - true if the build should run as a dry-run

    • setSettingsFile

      @Deprecated public void setSettingsFile(@Nullable File settingsFile)
      Veraltet.
      Setting custom settings file for the build has been deprecated. Please use setProjectDir(File) to specify the directory of the default project instead. This method will be removed in Gradle 9.0.
      Sets the settings file to use for the build. Use null to use the default settings file.
      Parameter:
      settingsFile - The settings file to use. May be null.

    • getSettingsFile

      @Deprecated @Nullable public File getSettingsFile()
      Veraltet.
      Setting custom build file to select the default project has been deprecated. This method will be removed in Gradle 9.0.
      Returns the explicit settings file to use for the build, or null. Will return null if the default settings file is to be used.
      Gibt zurück:
      The settings file. May be null.

    • addInitScript

      public void addInitScript(File initScriptFile)
      Adds the given file to the list of init scripts that are run before the build starts. This list is in addition to the default init scripts.
      Parameter:
      initScriptFile - The init scripts.

    • setInitScripts

      public void setInitScripts(List<File> initScripts)
      Sets the list of init scripts to be run before the build starts. This list is in addition to the default init scripts.
      Parameter:
      initScripts - The init scripts.

    • getInitScripts

      public List<File> getInitScripts()
      Returns all explicitly added init scripts that will be run before the build starts. This list does not contain the user init script located in ${user.home}/.gradle/init.gradle, even though that init script will also be run.
      Gibt zurück:
      list of all explicitly added init scripts.

    • getAllInitScripts

      public List<File> getAllInitScripts()
      Returns all init scripts, including explicit init scripts and implicit init scripts.
      Gibt zurück:
      All init scripts, including explicit init scripts and implicit init scripts.

    • setProjectDir

      public void setProjectDir(@Nullable File projectDir)
      Sets the project directory to use to select the default project. Use null to use the default criteria for selecting the default project.
      Parameter:
      projectDir - The project directory. May be null.

    • getProjectDir

      @Nullable public File getProjectDir()
      Returns the project dir to use to select the default project. Returns null when the build file is not used to select the default project
      Gibt zurück:
      The project dir. May be null.

    • setProfile

      public void setProfile(boolean profile)
      Specifies if a profile report should be generated.
      Parameter:
      profile - true if a profile report should be generated

    • isProfile

      public boolean isProfile()
      Returns true if a profile report will be generated.

    • isContinueOnFailure

      public boolean isContinueOnFailure()
      Specifies whether the build should continue on task failure. The default is false.

    • setContinueOnFailure

      public void setContinueOnFailure(boolean continueOnFailure)
      Specifies whether the build should continue on task failure. The default is false.

    • isOffline

      public boolean isOffline()
      Specifies whether the build should be performed offline (ie without network access).

    • setOffline

      public void setOffline(boolean offline)
      Specifies whether the build should be performed offline (ie without network access).

    • isRefreshDependencies

      public boolean isRefreshDependencies()
      Specifies whether the dependencies should be refreshed..

    • setRefreshDependencies

      public void setRefreshDependencies(boolean refreshDependencies)
      Specifies whether the dependencies should be refreshed..

    • isRerunTasks

      public boolean isRerunTasks()
      Specifies whether the cached task results should be ignored and each task should be forced to be executed.

    • setRerunTasks

      public void setRerunTasks(boolean rerunTasks)
      Specifies whether the cached task results should be ignored and each task should be forced to be executed.

    • isParallelProjectExecutionEnabled

      public boolean isParallelProjectExecutionEnabled()
      Returns true if parallel project execution is enabled.
      Angegeben von:
      isParallelProjectExecutionEnabled in Schnittstelle ParallelismConfiguration
      Siehe auch:

    • setParallelProjectExecutionEnabled

      public void setParallelProjectExecutionEnabled(boolean parallelProjectExecution)
      Enables/disables parallel project execution.
      Angegeben von:
      setParallelProjectExecutionEnabled in Schnittstelle ParallelismConfiguration
      Siehe auch:

    • isBuildCacheEnabled

      public boolean isBuildCacheEnabled()
      Returns true if the build cache is enabled.
      Seit:
      3.5

    • setBuildCacheEnabled

      public void setBuildCacheEnabled(boolean buildCacheEnabled)
      Enables/disables the build cache.
      Seit:
      3.5

    • isBuildCacheDebugLogging

      public boolean isBuildCacheDebugLogging()
      Whether build cache debug logging is enabled.
      Seit:
      4.6

    • setBuildCacheDebugLogging

      public void setBuildCacheDebugLogging(boolean buildCacheDebugLogging)
      Whether build cache debug logging is enabled.
      Seit:
      4.6

    • getMaxWorkerCount

      public int getMaxWorkerCount()
      Returns the maximum number of concurrent workers used for underlying build operations. Workers can be threads, processes or whatever Gradle considers a "worker". Some examples:
      • A thread running a task
      • A test process
      • A language compiler in a forked process
      Defaults to the number of processors available to the Java virtual machine.
      Angegeben von:
      getMaxWorkerCount in Schnittstelle ParallelismConfiguration
      Gibt zurück:
      maximum number of concurrent workers, always >= 1.
      Siehe auch:

    • setMaxWorkerCount

      public void setMaxWorkerCount(int maxWorkerCount)
      Specifies the maximum number of concurrent workers used for underlying build operations.
      Angegeben von:
      setMaxWorkerCount in Schnittstelle ParallelismConfiguration
      Siehe auch:

    • isConfigureOnDemand

      @Incubating public boolean isConfigureOnDemand()
      If the configure-on-demand mode is active

    • toString

      public String toString()
      Setzt außer Kraft:
      toString in Klasse Object

    • setConfigureOnDemand

      @Incubating public void setConfigureOnDemand(boolean configureOnDemand)

    • isContinuous

      public boolean isContinuous()

    • setContinuous

      public void setContinuous(boolean enabled)

    • includeBuild

      public void includeBuild(File includedBuild)

    • setIncludedBuilds

      public void setIncludedBuilds(List<File> includedBuilds)

    • getIncludedBuilds

      public List<File> getIncludedBuilds()

    • isBuildScan

      public boolean isBuildScan()
      Returns true if build scan should be created.
      Seit:
      3.4

    • setBuildScan

      public void setBuildScan(boolean buildScan)
      Specifies whether a build scan should be created.
      Seit:
      3.4

    • isNoBuildScan

      public boolean isNoBuildScan()
      Returns true when build scan creation is explicitly disabled.
      Seit:
      3.4

    • setNoBuildScan

      public void setNoBuildScan(boolean noBuildScan)
      Specifies whether build scan creation is explicitly disabled.
      Seit:
      3.4

    • setWriteDependencyLocks

      public void setWriteDependencyLocks(boolean writeDependencyLocks)
      Specifies whether dependency resolution needs to be persisted for locking
      Seit:
      4.8

    • isWriteDependencyLocks

      public boolean isWriteDependencyLocks()
      Returns true when dependency resolution is to be persisted for locking
      Seit:
      4.8

    • setLockedDependenciesToUpdate

      public void setLockedDependenciesToUpdate(List<String> lockedDependenciesToUpdate)
      Indicates that specified dependencies are to be allowed to update their version. Implicitly activates dependency locking persistence.
      Parameter:
      lockedDependenciesToUpdate - the modules to update
      Seit:
      4.8
      Siehe auch:

    • getWriteDependencyVerifications

      public List<String> getWriteDependencyVerifications()
      Indicates if a dependency verification metadata file should be written at the end of this build. If the list is not empty, then it means we need to generate or update the dependency verification file with the checksums specified in the list.
      Seit:
      6.1

    • setWriteDependencyVerifications

      public void setWriteDependencyVerifications(List<String> checksums)
      Tells if a dependency verification metadata file should be written at the end of this build.
      Parameter:
      checksums - the list of checksums to generate
      Seit:
      6.1

    • getLockedDependenciesToUpdate

      public List<String> getLockedDependenciesToUpdate()
      Returns the list of modules that are to be allowed to update their version compared to the lockfile.
      Gibt zurück:
      a list of modules allowed to have a version update
      Seit:
      4.8

    • setDependencyVerificationMode

      public void setDependencyVerificationMode(DependencyVerificationMode verificationMode)
      Sets the dependency verification mode. There are three different modes:
      • strict, the default, verification is enabled as soon as a dependency verification file is present.
      • lenient, in this mode, failure to verify a checksum, missing checksums or signatures will be logged but will not fail the build. This mode should only be used when updating dependencies as it is inherently unsafe.
      • off, this mode disables all verifications
      Parameter:
      verificationMode - the verification mode to use
      Seit:
      6.2

    • getDependencyVerificationMode

      public DependencyVerificationMode getDependencyVerificationMode()
      Returns the dependency verification mode.
      Seit:
      6.2

    • setRefreshKeys

      public void setRefreshKeys(boolean refresh)
      Sets the key refresh flag.
      Parameter:
      refresh - If set to true, missing keys will be checked again. By default missing keys are cached for 24 hours.
      Seit:
      6.2

    • isRefreshKeys

      public boolean isRefreshKeys()
      If true, Gradle will try to download missing keys again.
      Seit:
      6.2

    • isExportKeys

      public boolean isExportKeys()
      If true, after writing the dependency verification file, a public keyring file will be generated with all keys seen during generation of the file. This file can then be used as a source for public keys instead of reaching out public key servers.
      Gibt zurück:
      true if keys should be exported
      Seit:
      6.2

    • setExportKeys

      public void setExportKeys(boolean exportKeys)
      If true, after writing the dependency verification file, a public keyring file will be generated with all keys seen during generation of the file. This file can then be used as a source for public keys instead of reaching out public key servers.
      Parameter:
      exportKeys - set to true if keys should be exported
      Seit:
      6.2

    • getWelcomeMessageConfiguration

      @Incubating public WelcomeMessageConfiguration getWelcomeMessageConfiguration()
      Returns when to display a welcome message on the command line.
      Gibt zurück:
      The welcome message configuration.
      Seit:
      7.5
      Siehe auch:

    • setWelcomeMessageConfiguration

      @Incubating public void setWelcomeMessageConfiguration(WelcomeMessageConfiguration welcomeMessageConfiguration)
      Updates when to display a welcome message on the command line.
      Parameter:
      welcomeMessageConfiguration - The welcome message configuration.
      Seit:
      7.5
      Siehe auch:

    • isConfigurationCacheRequested

      @Incubating @Deprecated public boolean isConfigurationCacheRequested()
      Veraltet.
      Use Configuration Cache build feature instead.
      Returns true if configuration caching has been requested. Note that the configuration cache may not necessarily be used even when requested, for example it may be disabled due to the presence of configuration cache problems. It is also currently not used during an IDE import/sync.
      Seit:
      7.6