使用标签获取文件快照
使用标签可以获取文件快照,以便您可以在以后的日期回头参考该快照。 通过使用标签,您可以查看、生成大量文件,甚至可以将这些文件回滚到应用标签时所处的状态。
所需权限
若要应用标签,您必须将**“标签”权限设置为“允许”。 若要查找、列出或查看标签,您必须将“读取”权限设置为“允许”。 若要修改或删除标签,您必须是标签的所有者或者将“管理标签”权限设置为“允许”**。
本文内容
使用标签
应用标签
重命名标签
列出、查找、查看、编辑和移除标签
将文件的带标签版本下载到工作区
使用“标签”窗口处理标签
将文件回滚到带标签版本
从命令行处理标签
使用标签
在许多软件项目中,当代码已达到合理的质量和稳定级别时,团队会生成并发布产品的新版本。 团队需要标记每个文件的当前版本,这样即便文件继续更改,团队也仍然可以在其项目中获取和生成每个文件的新版本。
从理论上来说,可以手动记录每个文件的每个变更集 ID;但很显然这种过程是不切实际的。 Team Foundation 版本控制使这一工作变得很简单:只需向包含这些文件的文件夹、分支或团队项目应用标签即可。 您可以按照喜欢的任何命名约定为标签指定名称。 标签名称的一些示例包括:“Sprint 5”、“M1”、“Beta2”和“Release Candidate 0”。
应用了标签后,即可用于限定操作,如生成、分支、合并、比较及获取文件和文件夹的特定版本等。
有时,在应用标签后,您会决定需要对其进行更改。 通过使用 Team Foundation 版本控制,可以将标签应用于其他文件、从某些文件中移除标签、甚至可以修改将标签应用到特定文件的哪一版本。
提示
与创建分支相比,应用标签具有许多相同的优点,但是通常成本更低且复杂性更小。
应用标签
应用标签
在**“源代码管理资源管理器”中,右击要应用标签的集合、团队项目、分支、文件夹或文件,然后单击“应用标签”**。
此时将显示**“新建标签”**对话框。
在**“名称”**框中键入标签的名称。
(可选)在**“注释”**框中键入注释。
在**“版本”列表中,默认情况下“最新版本”**处于选中状态。 此选项是最常用的一个选项,但如果需要标签针对特定的版本,则可以选择以下其他选项之一:
如果单击**“变更集”,则可以在“变更集”框中指定变更集的编号。 或者,单击省略号(“…”)打开“查找变更集”**对话框。 有关更多信息,请参见查找有关变更集的信息。
如果单击**“日期”,则可以在“日期”**框中指定一个日期,或者从下拉菜单中的日历中选择一个日期。
如果单击**“标签”,则可以指定新标签所基于的现有标签。 在“标签”框中键入标签名称,或单击省略号(“…”)打开“查找标签”**对话框。 有关更多信息,请参见查找、编辑和移除标签。
如果单击**“工作区版本”**,则会为工作区中的版本创建标签。
如果对设置感到满意,请执行以下步骤之一:
若要应用标签,请单击**“创建”**。
若要应用标签,然后在应用后进行修改,请单击**“创建和编辑”。 这会应用标签,并且随后会显示“标签”窗口。 有关如何使用“标签”**窗口编辑标签的更多信息,请参见使用“标签”窗口处理标签。
提示
当应用使用了已存在的名称的标签时,系统会警告您,并询问您是否继续。 如果单击“确定”继续,则未包含在该标签所应用于的路径中的所有项都不再具有该标签。
重命名标签
当不能修改现有标签的名称时,可以轻松地将新标签应用于另一标签所应用到的那些文件和版本。
基于现有标签应用标签
在源代码管理资源管理器中,右击项目集合节点(根节点),然后单击**“应用标签”**。
此时将显示**“新建标签”**对话框。
在**“名称”**框中键入标签的名称。
(可选)在**“注释”**框中键入注释。
在**“版本”列表中选择“标签”**。
此时将显示**“标签”**框。
执行以下步骤之一:
键入现有标签的名称。
如果您不太确定现有标签的名称,请单击**“标签”**框旁带有省略号 (…) 的浏览按钮。
将出现**“查找标签”**对话框。
使用**“查找标签”**对话框中的选项可对标签列表进行筛选,并查找要应用新标签的现有标签。 (有关更多信息,请参见查找、编辑和移除标签)。
单击**“创建”**。
(可选)创建新标签后,可以移除旧标签。 有关更多信息,请参见查找、编辑和移除标签。
列出、查找、查看、编辑和移除标签
可以使用两种方法列出和查找标签:**“查找标签”对话框和“历史记录”窗口中的“标签”**选项卡。 找到所需的标签后,即可查看、编辑、移除该标签或处理应用该标签的文件。
使用“查找标签”对话框查找和处理标签
在源代码管理资源管理器中,在**“文件”菜单上,依次指向“源代码管理”和“标签”,然后单击“查找标签”**。
将出现**“查找标签”**对话框。
(可选)通过执行以下一个或多个步骤,缩小搜索范围:
在**“名称”**文本框中输入标签的名称。
在**“项目”**列表中,选择包含要查找的标签的团队项目。
在**“所有者”**文本框中,键入标签所有者的姓名或别名。
单击**“查找”**。
此时**“结果”**列表会显示符合所输入的搜索条件的标签。
(可选)执行以下步骤之一:
若要查看或编辑某个标签,请选择该标签,然后单击**“编辑”**。
此时将显示**“标签”**窗口。 有关更多信息,请参见使用“标签”窗口处理标签。
若要删除某个标签,请选择该标签,然后单击**“删除”**。
单击**“关闭”**。
有时您可能不太确定标签的名称,但知道标签已应用于处于版本控制下的特定项。 下面的过程解释如何在此情况中查找然后处理标签。
列出并处理应用于特定项的标签
在**“源代码管理资源管理器”中,右击要查找的标签所应用于的项,然后单击“查看历史记录”**。
此时将显示**“历史记录”**窗口。
单击**“标签”**选项卡以显示应用于此项的标签列表。
(可选)执行以下步骤之一:
若要查看或编辑某个标签,请右击该标签,然后选择**“编辑标签”**。
此时将显示“标签”窗口。 有关如何使用此窗口的信息,请参见使用“标签”窗口处理标签。
若要删除某个标签,请右击该标签,然后选择**“删除标签”**。
右击标签,然后选择其他操作,如**“获取此版本”和“比较”**等。
有关如何使用“历史记录”窗口中的“标签”选项卡的更多信息,请参见查看历史数据。
将文件的带标签版本下载到工作区
对一组文件创建标签类似于获取这些文件在某一时间点的情况的快照。 在获取此快照的数周或数月后,您可能需要按照这些文件在该快照中存在的情况进行查看或处理。 下面的过程解释如何将一组文件的带标签版本下载到工作区。
将文件的带标签版本下载到工作区
在**“源代码管理资源管理器”中,右击包含要下载项的项目集合、团队项目、分支或文件夹,然后单击“获取特定版本”**。
将出现**“获取”**对话框。
在**“类型”列表中选择“标签”,然后在“标签”框中键入标签名称,或单击省略号(“…”)打开“查找标签”**对话框。 有关如何使用此对话框的更多信息,请参见查找、编辑和移除标签。
查看**“获取”**对话框中的其他选项,并根据需要选择任意选项。
单击**“获取”**。
使用“标签”窗口处理标签
通过上述任一过程打开“标签”窗口后,即可开始处理标签。 在窗口顶部是一个显示注释的框,可以根据需要进行编辑。
可以使用“标签”窗口执行以下任务:
向标签中添加项
从标签中移除项
更改文件的版本
对项执行其他操作
向标签中添加项
在**“标签”窗口中单击“添加项”**。
将出现**“选择项版本”**对话框。
在**“选择项版本”**对话框中,浏览至要添加的项,然后选择该项。
提示
可以按住 Ctrl 或 Shift 键,然后选择多个项。
(可选)如果需要标签针对特定的版本,则可以从**“版本”**列表中选择以下选项之一:
如果单击**“最新版本”**,则标签会应用于处于版本控制下的最新版本。
如果单击**“变更集”,则可以在“变更集”框中指定变更集的编号。 或者,单击省略号(“…”)打开“查找变更集”**对话框。 有关更多信息,请参见查找有关变更集的信息。
如果单击**“日期”,则可以在“日期”**框中指定一个日期,或者从下拉菜单中的日历中选择一个日期。
如果单击**“标签”,则可以指定新标签所基于的现有标签。 在“标签”框中键入标签名称,或单击省略号(“…”)打开“查找标签”**对话框。 有关更多信息,请参见查找、编辑和移除标签。
如果单击**“工作区版本”**,则会为工作区中的版本创建标签。
单击**“确定”**。
单击**“文件”菜单,然后单击“保存”**。
从标签中移除项
在**“标签”**窗口中,找到要从此标签中移除的集合、团队项目、分支、文件夹或文件。
右击该项并选择**“从标签中移除”**。
该标签即会从该项中移除。 如果该项是项目集合、团队项目、分支或文件夹,则也将从其包含的所有项中移除该标签。
单击**“文件”菜单,然后单击“保存”**。
更改文件的版本
在**“标签”**窗口中找到要修改的文件。
右击该文件并选择**“更改项版本”**。
将出现**“选择项版本”**对话框。
执行以下步骤之一:
单击**“最新版本”**将标签应用于处于版本控制下的最新版本。
单击**“变更集”,然后在“变更集”框中指定变更集的编号。 或者,单击省略号(“…”)打开“查找变更集”**对话框。 有关更多信息,请参见查找有关变更集的信息。
单击**“日期”,然后在“日期”**框中指定一个日期,或者从下拉菜单中的日历中选择一个日期。
单击**“标签”,然后指定新标签所基于的现有标签。 在“标签”框中键入标签名称,或单击省略号(“…”)打开“查找标签”**对话框。 有关更多信息,请参见查找、编辑和移除标签。
单击**“工作区版本”**,会为工作区中的版本创建标签。
单击**“文件”菜单,然后单击“保存”**。
对带标签项执行其他操作
当在“标签”窗口中右击某个项时,还可以选择以下命令之一:
查看(仅限文件)
查看历史记录
比较(仅限文件)
批注(仅限文件)
获取此版本
将文件回滚到带标签版本
使用 tf rollback 命令可以将一组文件还原到它们在用标签标记的版本中的状态。 有关更多信息,请参见 回滚命令(Team Foundation 版本控制)。
从命令行处理标签
本节提供从命令行处理标签的一些典型方法。
从命令行列出标签
从命令行列出标签
单击**“开始”,单击“所有程序”,指向“Microsoft Visual Studio 2010”,指向“Visual Studio 工具”,然后单击“Visual Studio 命令提示(2010)”**。
键入 cd 路径,其中路径 是包含适用工作区的目录。
键入 tf labels。
从命令行应用和编辑标签
从命令行应用标签的效果不同于使用 Visual Studio ALM 应用标签(如本主题前面部分所述)的效果。 使用 Visual Studio ALM 应用已存在的标签时,该操作会先从所有文件版本中移除该标签,然后再应用该标签。
然而,从命令行执行的标签操作是累加性操作。 例如,假设将标签 mylabel 应用于 $/DinnerNow/Features/FeatureTeamA。 如果以后将标签 mylabel 应用于 $/DinnerNow/Features/FeatureTeamB,则 mylabel 将应用于这两个文件夹。
从命令行应用标签
单击**“开始”,单击“所有程序”,指向“Microsoft Visual Studio 2010”,指向“Visual Studio 工具”,然后单击“Visual Studio 命令提示(2010)”**。
键入 cd 路径,其中路径 是要用应用标签的文件夹的路径。
键入 tf label mylabel . /recursive。
系统将 mylabel 标签应用于路径 文件夹以及该文件夹包含的所有文件和文件夹的工作区版本。
从命令行移除标签
从命令行移除标签
单击**“开始”,单击“所有程序”,指向“Microsoft Visual Studio 2010”,指向“Visual Studio 工具”,然后单击“Visual Studio 命令提示(2010)”**。
键入 cd 路径,其中路径 是包含适用工作区的目录。
键入 tf label /delete标签名称,其中标签名称 是要删除的标签的名称。
请参见
参考
Label 命令(Team Foundation 版本控制)