Microsoft Visual SourceSafe 任务用户手册

作者

• Craig Cottingham
• Andrew Everitt
• Balazs Fejes 2
• Glenn_Twiggs@bmc.com
• Martin Poeschl (mpoeschl@marmot.at)
• Phillip Wells
• Jon Skeet (jon.skeet@peramon.com)
• Nigel Magnay (nigel.magnay@parsec.co.uk)
• Gary S. Weaver
• Jesse Stockall

目录

• 简介
• 任务

简介

这些任务为 Microsoft Visual SourceSafe SCM 提供接口。 org.apache.tools.ant.taskdefs.optional.vss 包包含一个简单的框架来支持 VSS 功能，以及一些封装常用 VSS 命令的 Apache Ant 任务。 虽然可以在桌面使用这些命令，但它们主要用于自动化构建系统。

如果在运行这些命令时出现 CreateProcess error=2 错误，则表示未找到 ss.exe。 检查是否可以从命令行运行它 - 您可能需要更改路径或设置 ssdir 属性。

任务

任务描述

VssGet

描述

执行 GET 命令到 Microsoft Visual SourceSafe 的任务。

如果从版本、日期和标签中指定了两个或多个属性，则将按版本、日期、标签的顺序使用其中一个。

参数

请注意，只能指定版本、日期或标签中的一个

示例

使用用户名 me 和密码 mypassword 对 VSS 项目 $/source/myproject 执行 get 操作。 这将递归获取标记为 Release1 的文件，并将它们写入本地目录 C:\mysrc\myproject。 本地文件将可写。

<vssget localPath="C:\mysrc\myproject"
        recursive="true"
        label="Release1"
        login="me,mypassword"
        vsspath="$/source/aProject"
        writable="true"/>

VssLabel

描述

执行 LABEL 命令到 Microsoft Visual SourceSafe 的任务。

将标签分配给指定版本或文件的当前版本或项目。

参数

示例

使用用户名 me 和密码 mypassword，用标签 Release1 标记 VSS 项目 $/source/aProject 的当前版本。

<vsslabel vsspath="$/source/aProject"
          login="me,mypassword"
          label="Release1"/>

用标签 1.03.004 标记 VSS 文件 $/source/aProject/myfile.txt 的版本 4。 如果此版本已存在标签，则操作（以及构建）将失败。

<vsslabel vsspath="$/source/aProject/myfile.txt"
          version="4"
          label="1.03.004"/>

VssHistory

描述

参数

指定时间范围

有不同的方法可以指定要评估的时间范围

• 两个日期之间的更改：同时指定 fromDate 和 toDate
• 日期之前的更改：指定 toDate
• 日期之后的更改：指定 fromDate
• 日期前 X 天的更改：指定 toDate 和（负数！）numDays
• 日期后 X 天的更改：指定 fromDate 和 numDays

示例

显示 Release1 和 Release2 之间的全部更改。

<vsshistory vsspath="$/myProject" recursive="true"
            fromLabel="Release1"
            toLabel="Release2"/>

显示 2001 年 1 月 1 日至 2001 年 3 月 31 日之间的全部更改（在德国，日期必须根据您的区域设置指定）。

<vsshistory vsspath="$/myProject" recursive="true"
            fromDate="01.01.2001"
            toDate="31.03.2001"/>

显示过去两周内的全部更改。

<tstamp>
  <format property="to.tstamp" pattern="M-d-yy;h:mma"/>
</tstamp>

<vsshistory vsspath="$/myProject" recursive="true"
            numDays="-14"
            dateFormat="M-d-yy;h:mma"
            toDate="${to.tstamp}"/>

VssCheckin

描述

执行 CHECKIN 命令到 Microsoft Visual SourceSafe 的任务。

参数

示例

使用本地目录 D:\build 签入项目 $/test 中名为 test* 的文件。

<vsscheckin vsspath="$/test/test*"
            localpath="D:\build\"
            comment="Modified by automatic build"/>

VssCheckout

描述

执行 CHECKOUT 命令到 Microsoft Visual SourceSafe 的任务。

如果从 version、date 和 label 中指定了两个或多个属性，则将按 version、date、label 的顺序使用其中一个。

参数

示例

将项目 $/test 递归签出到目录 D:\build。

<vsscheckout vsspath="$/test"
             localpath="D:\build"
             recursive="true"
             login="me,mypass"/>

VssAdd

描述

参数

示例

将名为 build.00012.zip 的文件添加到项目当前工作目录（参见 vsscp）。

<vssadd localpath="D:\build\build.00012.zip"
        comment="Added by automatic build"/>

VssCp

描述

执行 CP（更改项目）命令到 Microsoft Visual SourceSafe 的任务。

此任务通常在 VssAdd 之前使用，以设置目标项目

参数

示例

将当前 VSS 项目设置为 $/Projects/ant。

<vsscp vsspath="$/Projects/ant"/>

VssCreate

描述

执行 CREATE 命令到 Microsoft Visual SourceSafe 的任务。

在 VSS 中创建新项目。

参数

示例

创建 VSS 项目 $/existingProject/newProject。

<vsscreate vsspath="$/existingProject/newProject"/>