Apache Ant Pvcs 任务用户手册

注意：在使用此任务之前，运行 Ant 的用户必须能够访问 PVCS 的命令（get 和 pcli），并且必须能够访问存储库。请注意，指定存储库的方式取决于平台，因此请使用属性来指定存储库的位置。

作者

版本 1.1—2001/06/27

修复了 UNC 路径名和路径中使用 () 的问题，并引入了 updateonly 参数。

版本 1.0—2001/01/31

初始版本。

目录

简介

pvcs 任务允许 Ant 用户从 PVCS（Polytron 版本控制系统）存储库中提取最新版本的源代码。它目前由 MicroFocus 拥有。

此版本已在 Windows 和 Solaris 下针对 PVCS 版本 6.5 和 6.6 进行测试。

Pvcs 任务

描述

pvcs 任务被设置为指向 PVCS 存储库，并可选地指向该存储库中的一个项目，并且可以从该规范中获取存储库中包含的文件的最新版本。

参数

属性 描述 必需
repository 存储库的位置（请参阅您的 PVCS 手册）。 是
pvcsproject 要从中提取文件的 PVCS 存储库中的项目。 否；默认为根项目，/
label 仅提取标记为此标签的文件。 否
promotiongroup 仅提取此升级组中的文件。同时使用 label 和 promotiongroup 标签将导致提取升级组中具有该标签的文件。 否
config 非默认 .cfg 文件的路径。可以给出相对于项目的基目录的绝对路径或相对路径。 否
force 如果设置为 yes，则覆盖所有存在且可写的文件。默认 no 导致忽略可写的文件。这将阻止 PVCS 命令 get 停止询问问题！ 否；默认为 no
workspace 通过指定 workspace，文件将被提取到该位置。PVCS 工作区是工作文件位置的名称，本身不是位置本身。您可以使用 PVCS GUI 客户端定义工作区的位置。 否；默认为当前用户的默认工作区
pvcsbin 在某些系统上，PVCS 可执行文件 pcli 和 get 在 PATH 中找不到。在这种情况下，此属性应设置为包含前面提到的可执行文件的 PVCS 安装的 bin 目录。如果未指定此属性，则该标签期望使用 PATH 环境变量找到可执行文件。 否
ignorereturncode 如果设置为 true，则忽略执行 PVCS 命令的返回值。 否
updateonly 如果设置为 true，则仅在文件比现有本地文件更新时才获取文件。 否
filenameformat 以适合 java.text.MessageFormat 的格式显示文件夹名称的格式。存档扩展名不是 -arc 的存储库应设置此项。 否；默认为 {0}-arc({1})
linestart 用于解析 pcli 命令的输出。解析器已经知道 / 和 \\，此属性在通过驱动器字母映射在 Windows 平台上访问存储库的情况下很有用。 否；默认为 "P:
revision 检索指定的修订版。 否
userid 使用指定的用户名。 否

作为嵌套元素指定的参数

pvcsproject 元素

该任务支持一个嵌套的 <pvcsproject> 元素，它表示要从中提取文件的 PVCS 存储库中的一个项目。通过在 <pvcs> 任务下嵌套多个 <pvcsproject> 元素，可以指定多个项目。

参数
属性 描述 必需
name PVCS 项目的名称 是

示例

以下设置提取 pvcs 存储库中文件的最新版本。

<!-- =================================================================== -->
<!-- Get the latest version                                              -->
<!-- =================================================================== -->
<target name="getlatest">
  <pvcs repository="/mnt/pvcs" pvcsproject="/myprj"/>
</target>

现在运行：ant getlatest

这将导致以下输出出现

  getlatest:
  [pvcs] PVCS Version Manager (VMGUI) v6.6.10 (Build 870) for Windows NT/80x86
  [pvcs] Copyright 1985-2000 MERANT. All rights reserved.
  [pvcs] PVCS Version Manager (get) v6.6.10 (Build 870) for Windows NT/80x86
  [pvcs] Copyright 1985-2000 MERANT. All rights reserved.
  [pvcs] c:\myws\myprj\main.java <- C:\mypvcs\archives\myprj\main.java-arc
  [pvcs] rev 1.1
  [pvcs] c:\myws\myprj\apache\tool.java <- C:\mypvcs\archives\myprj\apache\tools.java-arc
  [pvcs] rev 1.5

  BUILD SUCCESSFUL

  Total time: 19 seconds

下一个示例使用嵌套的 <pvcsproject> 元素从 pvcs 存储库中的两个项目提取文件的最新版本。

<!-- ===================================================================-->
<!-- Get latest from myprj and myprj2                                   -->
<!-- ===================================================================-->
<target name="getlatest2">
  <pvcs repository="/mnt/pvcs">
    <pvcsproject name="/myprj"/>
    <pvcsproject name="/myprj2"/>
  </pvcs>
</target>

现在运行：ant getlatest2

这将导致以下输出出现

  getlatest2:
  [pvcs] PVCS Version Manager (VMGUI) v6.6.10 (Build 870) for Windows NT/80x86
  [pvcs] Copyright 1985-2000 MERANT.  All rights reserved.
  [pvcs] PVCS Version Manager (get) v6.6.10 (Build 870) for Windows NT/80x86
  [pvcs] Copyright 1985-2000 MERANT.  All rights reserved.
  [pvcs] c:\myws\myprj\main.java <- C:\mypvcs\archives\myprj\main.java-arc
  [pvcs] rev 1.1
  [pvcs] c:\myws\myprj\apache\tool.java <- C:\mypvcs\archives\myprj\apache\tool.java-arc
  [pvcs] rev 1.5
  [pvcs] c:\myws\myprj2\apache\tool2.java <- C:\mypvcs\archives\myprj2\apache\tool2.java-arc
  [pvcs] rev 1.2

  BUILD SUCCESSFUL

  Total time: 22 seconds