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 功能，以及一些 Apache Ant 任務，用於封裝常用的 VSS 指令。雖然可以在桌面上使用這些指令，但它們主要用於自動化建置系統。

如果您在執行這些指令時收到 CreateProcess error=2，表示找不到 ss.exe。請查看您是否可以從命令列執行它，您可能需要變更您的路徑，或設定 ssdir 屬性。

任務

任務說明

VssGet

說明

執行 GET 指令至 Microsoft Visual SourceSafe 的任務。

如果您從版本、日期和標籤指定兩個或更多屬性，只會使用一個，順序為版本、日期、標籤。

參數

請注意，只能指定 version、date 或 label 其中一個

範例

使用使用者名稱 me 和密碼 mypassword，對 VSS 專案 $/source/myproject 執行取得。這會遞迴取得標籤為 Release1 的檔案，並將其寫入本機目錄 C:\mysrc\myproject。本機檔案將可寫入。

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

VssLabel

說明

執行標籤命令至 Microsoft Visual SourceSafe 的工作。

將標籤指定給檔案或專案的指定版本或目前版本。

參數

範例

使用使用者名稱 me 和密碼 mypassword，將 VSS 專案 $/source/aProject 的目前版本標記為標記 Release1。

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

將 VSS 檔案 $/source/aProject/myfile.txt 的版本 4 標記為標記 1.03.004。如果此版本已具有標記，則作業（和建置）將會失敗。

<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 Source Safe 的工作。

在 VSS 中建立新的專案。

參數

範例

建立 VSS 專案 $/existingProject/newProject。

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