TeamCity Kotlin DSL/jetbrains.buildServer.configs.kotlin.buildSteps/FxCopStep

FxCopStep

fun BuildSteps.fxCop(init: FxCopStep.() -> Unit): FxCopStep

An FxCop build step is intended for inspecting .NET assemblies and reporting possible design, localization, performance, and security improvements.

Example. Runs FxCop for the specified assembly files and reports inspections results to the TeamCity server. The location of the FxCop installation on the agent is determined automatically.

buildType {
    // Other Build Type settings ...
    steps {
        // Other Build Steps ...
        fxCop {
          fxCopInstallation = auto {
            version = FxCopStep.FxCopVersion.v16_0
          }
          inspectionSource = assemblies {
            files = "build/*.dll"
          }
        }
Content copied to clipboard
    }
}

*/

Constructors

FxCopStep

fun FxCopStep(init: FxCopStep.() -> Unit)

FxCopStep

fun FxCopStep()

Types

FxCopInstallation

sealed class FxCopInstallation : CompoundParam<FxCopStep.FxCopInstallation>

FxCopVersion

enum FxCopVersion : Enum<FxCopStep.FxCopVersion>

InspectionSource

sealed class InspectionSource : CompoundParam<FxCopStep.InspectionSource>

Functions

assemblies

fun assemblies(init: FxCopStep.InspectionSource.Assemblies.() -> Unit = {}): FxCopStep.InspectionSource.Assemblies

auto

fun auto(init: FxCopStep.FxCopInstallation.Auto.() -> Unit = {}): FxCopStep.FxCopInstallation.Auto

Select to use the FxCop installation on an agent.

booleanParameter

fun booleanParameter( customName: String? = null, trueValue: String? = "true", falseValue: String? = "false"): SingleDelegateProvider<Boolean>

clear

fun clear()

clearConditions

fun clearConditions()

Deletes all configured build step conditions

compoundParameter

fun <T : CompoundParam<T>> compoundParameter(customName: String? = null): CompoundDelegateProvider<T>

conditions

fun conditions(init: BuildStepConditions.() -> Unit = {})

Configures build step conditions

copyParamsTo

fun <T : Parametrized> copyParamsTo(target: T): T

Copies parameters of this object to the specified target

create

open fun create(): BuildStep

Creates an instance of this build step via reflection using a no argument constructor, used during copying. Throws an error if this class doesn't have a default constructor. Subclasses can override it to create an instance without using a default constructor.

doubleParameter

fun doubleParameter(customName: String? = null): SingleDelegateProvider<Double>

enumParameter

fun <E : Enum<E>> enumParameter(customName: String? = null, mapping: Map<E, String?>? = null): SingleDelegateProvider<E>

findRawParam

fun findRawParam(paramName: String): Parameter?

hasParam

fun hasParam(paramName: String): Boolean

intParameter

fun intParameter(customName: String? = null): SingleDelegateProvider<Int>

manual

fun manual(init: FxCopStep.FxCopInstallation.Manual.() -> Unit = {}): FxCopStep.FxCopInstallation.Manual

Select to use a custom installation of FxCop (not the autodetected one), or if you do not have FxCop installed on the build agent (for example, you can place the FxCop tool in your source control, and check it out with the build sources).

param

fun param(name: String, value: String)

Adds parameter with specified name and value

project

fun project(init: FxCopStep.InspectionSource.Project.() -> Unit = {}): FxCopStep.InspectionSource.Project

removeRawParam

fun removeRawParam(paramName: String)

stringParameter

fun stringParameter(customName: String? = null): SingleDelegateProvider<String>

toString

open override fun toString(): String

validate

open override fun validate(consumer: ErrorConsumer)

Validates this object and reports found errors to the provided consumer

Properties

additionalOptions

var additionalOptions: String?

Additional options for calling FxCopCmd executable. All entered options will be added to the beginning of the command line parameters.

conditions

var conditions: BuildStepConditions

Optional collection of build step execution conditions

enabled

var enabled: Boolean = true

Specifies whether the step is enabled, true by default

executionMode

var executionMode: BuildStep.ExecutionMode

Build step execution mode

failOnAnalysisError

var failOnAnalysisError: Boolean?

Fails build on analysis errors from FxCop such as: ANALYSIS_ERROR, ASSEMBLY_LOAD_ERROR, ASSEMBLY_REFERENCES_ERROR, PROJECT_LOAD_ERROR, RULE_LIBRARY_LOAD_ERROR, UNKNOWN_ERROR, OUTPUT_ERROR

fxCopInstallation

var fxCopInstallation: FxCopStep.FxCopInstallation?

When a build agent is started, it detects automatically whether FxCop is installed. If FxCop is detected, TeamCity defines the %system.FxCopRoot% agent system property. You can also use a custom installation of FxCop or the use FxCop checked in your version control.

var id: String? = null

Optional id of the step. Usually the id is not required, however if a build configuration inherits from a template and wants to override a build step defined there, then both steps should have the same id.

ignoreGeneratedCode

var ignoreGeneratedCode: Boolean?

Sets /ignoregeneratedcode for FxCopCmd (note: it's supported since FxCop 1.36). Speeds up inspection.

inspectionSource

var inspectionSource: FxCopStep.InspectionSource?

name

var name: String

Build step name

params

val params: List<Parameter>

reportXSLTFile

var reportXSLTFile: String?

The path to the XSLT transformation file relative to the Build Checkout Directory or absolute on the agent machine. You can use the path to the detected FxCop on the target machine (i.e. %system.FxCopRoot%/Xml/FxCopReport.xsl). When the Report XSLT file option is set, the build runner will apply an XSLT transform to FxCop XML output and display the resulting HTML in a new FxCop tab on the build results page.

searchInDirs

var searchInDirs: String?

Search the assemblies referenced by targets in the specified directories separated by spaces. Sets /d: options for FxCopCmd

searchInGAC

var searchInGAC: Boolean?

Search the assemblies referenced by targets in Global Assembly Cache.

type

var type: String

Build step type

FxCopStep

See also

Constructors

Types

Functions

Properties