Get, задание
Обновлен: Ноябрь 2007
Задание Get извлекает по заданным параметрам доступную только для чтения копию файлов и папок из рабочей области.
Параметры
Параметр |
Описание |
|---|---|
BuildUri |
Задает универсальный код ресурса (URI) для построения. |
Workspace |
Задает имя рабочей области. |
Version |
Задает файл versionspec. По умолчанию для параметра versionspec используется T, т.е. последняя версия. Установите свойство GetVersion в файле TFSBuild.proj для получения другой версии. Это поведение соответствует действию опции /version команды tf.exe get. Дополнительные сведения см. в разделе Команда "get". |
Filespec |
Задает элементы в рабочей области. По умолчанию Team Foundation Build получает все элементы из рабочей области, заданной в свойстве WorkspaceName. Чтобы указать определенные элементы Itemspec используется свойство GetFileSpec в файле TFSBuild.proj. Этот параметр соответствует параметру Itemspec команды tf.exe get. |
PopulateOutput |
По умолчанию Team Foundation Build не возвращает список элементов, которые были извлечены, заменены или удалены, а также не выдает предупреждений, сгенерированных заданием Get. Установите свойство GetPopulateOutput в файле TFSBuld.proj равным true, чтобы сделать доступными эти списки. Если вы установите параметр GetPopulateOutput равным true, вы получите следующее:
|
Preview |
Указывает, следует ли при вывести информацию о том, что произойдет при вызове операции Get, без фактического выполнения операции. Установите параметр PreviewGet в файле TFSBuild.proj равным true для предварительного просмотра действий, выполняемых операцией Get. Этот параметр соответствует параметру /preview команды tf.exe get. |
Recursive |
Указывает, следует ли извлекать файлы рекурсивно. Установите свойство RecursiveGet в фале TfsBuild.proj равным false, чтобы выполнить нерекурсивное извлечение в проекте Team Foundation Build. Этот параметр соответствует параметру /recursive команды tf.exe get. |
Force |
Задает, следует ли выполнять добавочное извлечение файлов. Чтобы выполнить добавочное извлечение в определении Team Foundation Build, установите свойство ForceGet в файле TfsBuild.proj равным false. Этот параметр соответствует параметру /force команды tf.exe get. |
Gets |
Выходной параметр. Указывает количество элементов, которые были извлечены заданием Get. |
Replaces |
Выходной параметр. Указывает количество элементов, которые были заменены заданием Get |
Deletes |
Выходной параметр. Указывает количество элементов, которые были удалены заданием Get |
Warnings |
Выходной параметр. Указывает список предупреждений, сгенерированных заданием Get |
Заметки
Задача Get определена в библиотеке Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll. Файл Microsoft.TeamFoundation.Build.targets содержит экземпляр задачи Get, которую Team Foundation Build использует как реализацию по умолчанию для целевого объекта CoreGet.
Файл Microsoft.TeamFoundation.Build.targets содержится в папке <корень>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild на компьютере Team Foundation Build.
Пример
В следующем примере показан экземпляр задачи Get по умолчанию, определенный в файле Microsoft.TeamFoundation.Build.targets file.
<Get
BuildUri="$(BuildURI)"
Workspace="$(WorkspaceName)"
Version="$(GetVersion)"
Filespec="$(GetFilespec)"
PopulateOutput="$(GetPopulateOutput)"
Preview="$(PreviewGet)"
Recursive="$(RecursiveGet)"
Force="$(ForceGet)">
<Output TaskParameter="Gets" ItemName="Gets" />
<Output TaskParameter="Replaces" ItemName="Replaces" />
<Output TaskParameter="Deletes" ItemName="Deletes" />
<Output TaskParameter="Warnings" ItemName="GetWarnings" />
</Get>