Задача Label
Обновлен: Ноябрь 2007
Задача Label присоединяет метку к последней версии файлов в рабочей области.
Параметры
Параметр |
Описание |
|---|---|
Workspace |
Задает имя рабочей области. |
Name |
Задает имя метки. По умолчанию имя метки, созданной Team Foundation Build, такое же, как и значение свойства BuildNumber. Чтобы задать другое имя метки, в файле TFSBuild.proj необходимо переопределить свойство LabelName. |
Version |
Задает версию файла или папки. По умолчанию Team Foundation Build помечает все содержимое рабочей области, указанной в свойстве WorkspaceName. Чтобы задать другое значение versionspec, необходимо переопределить свойство LabelVersion. Этот параметр соответствует параметру versionspec команды tf.exe label. Дополнительные сведения см. в разделе Команда "label" (Управление версиями в Team Foundation). |
Files |
Задает помечаемые элементы. По умолчанию компонент Team Foundation Build заменяет версию элементов, которые уже существуют в его метке. Этот параметр соответствует значению replace параметра /child команды tf.exe label command. Чтобы не изменять элементы внутри существующей метки, в файле TFSBuild.proj свойству LabelFiles необходимо присвоить значение merge. |
Child |
По умолчанию компонент Team Foundation Build заменяет версию элементов, которые уже существуют в его метке. Чтобы оставить без изменений элементы внутри существующей метки, в файле TFSBuild.proj свойству LabelChild необходимо присвоить значение merge. Этот параметр соответствует параметру /child команды tf.exe label. |
Comments |
Задает примечание, используемое для метки в Team Foundation Build. Примечание по умолчанию, создаваемое Team Foundation Build, — «Метка создана Team Build». Чтобы задать другое примечание, в файле TFSBuild.proj необходимо переопределить свойство LabelComment. |
Recursive |
Указывает, помечаются ли файлы рекурсивно. Этот параметр соответствует параметру /recursive команды tf.exe label. В файле TFSBuild.proj свойству LabelRecursive необходимо присвоить значение false. В результате будут помечаться только элементы верхнего уровня. |
Заметки
Задача Label определена в библиотеке Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll. Файл Microsoft.TeamFoundation.Build.targets содержит экземпляр задачи Label, которую Team Foundation Build использует как реализацию по умолчанию для целевого объекта CoreLabel.
Файл Microsoft.TeamFoundation.Build.targets содержится в папке <корень>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild на компьютере Team Foundation Build.
Пример
В следующем примере показан экземпляр задания Label по умолчанию, определенный в файле Microsoft.TeamFoundation.Build.targets file.
<Label
Workspace="$(WorkspaceName)"
Name="$(LabelName)$(LabelScope)"
Version="$(LabelVersion)"
Files="$(LabelFiles)"
Child="$(LabelChild)"
Comments="$(LabelComment)"
Recursive="$(LabelRecursive)" />
См. также
Задачи
Основные понятия
Ссылки
Команда "label" (Управление версиями в Team Foundation)