P4V 入门教程

P4V 入门

P4V（Perforce可视化客户端）是Perforce跨平台图形化用户界面。你可以在Windows,Mac, UNIX 和 Linux 各种平台上使用 P4V，且各种平台都有相同的界面。

使用Perforce来管理文件时，你通常会使用P4V之类的应用程序连接到Perforce版本控制 服务器。通过 P4V 签入签出文件，并执行其它各种版本控制任务。

基本概念

些Perforce术语的定义如下：

• workspace：对Perforce所管理的文件进行工作时，所用到的本地工作站的文件夹或目录。
• Perforce应用程序：P4V(或别的Perforce应用程序)，在你的工作站上运行，从Perforce 版本控制服务发出请求并把这些请求的结果（文件，状态信息等）发给你。
• 服务：Perforce 版本控制服务响应来自Perforce 应用程序的请求，维护 depot 文件，跟踪工作区的状态。
• Depot: 由 Perforce 服务管理的文件仓库。它包含所有已提交文件的各个版本信息。 Perforce服务可以同时管理多个depot，但该指南的示例只列举了一个depot。

连接到Perforce

第一次启动P4V时， 连接设置向导（Mac：连接设置助手）会引导你完成整个配置连接过程，其中需要你指定服务器、 用户 ID 和工作区。

也可以手动启动向导/助手：Connection → Set Up Connection...

当然，你也可以在如下的这个对话框中配置连接：

完善下列各项：

• Server：托管共享版本控制服务的机器的名称。你还必须指定 TCP/IP 和 PORT
  • 如果你用 SSL连接到Perforce，则用 ssl:host:port
• User：你的Perforce 用户名
• Password：如果需要的话，输入Perforce用户密码
• Workspace：你的工作区

点击Browse…以显示既存用户和工作区（在点击Browse…之前，必须先指定服务器和端口）

如果你指定的服务器设置不正确，P4V显示以下的信息:
点OK连接，P4V显示如下的主画面：

设置你的工作区

Perforce系统管理员可以为你做这些，但建议你掌握一些配置工作区的重要方面，特别是：

1. 配置工作区根目录
2. 配置工作区视图。

为了定义工作区，选择Connection→New Workspace....在对话框中输入工作区名。

为了编辑当前工作区式样，选择Connection→Edit Current Workspace...

• Workspace Root：指定Perforce在你工 作站上存储 depot 文件副本 的位置。指定一个有意义的名字，并保证它不是你的计算机的根目录！

• WorkspaceMapping：使你能筛选你要访问的depot文件。 把该视图设置成只看你需要看的。

右键点击所要的文件和文件夹，选择Exclude Tree把它们包含进工作区映射中或从工作区映射中排除，

管理你的文件

一般的，你利用Perforce管理文件时，执行下列步骤的任务。

1. 从depot中读取文件。
2. 签出你需要编辑的文件。
3. 编辑文件。
4. 签入你的变更。

以下章节提供这些及其他共通文件管理任务的详细说明。

从depot读取文件

从depot拷贝文件到工作区：

1. 在左侧面板，点击Depot标签。

2. 光标移到想要读取的文件夹或文件。

3. 右击文件或文件夹。

   • 想要取得最新版本的话，选择Get Latest Revision。

   • 想要取得某个旧版本的话，选择Get Revision...并指定你想要的版本号。

在左侧面板，注意文件显示绿点： 表示它们已存在于工作区中。在你编辑文件之前，你必须先把它签出。

从depot签出文件

在工作区中签出文件：

1. 在左侧面板的depot标签中，把光标移到想要请签出的文件。
2. 右击该文件并选择Check Out。

在左侧面板，注意文件显示红色打钩标志，表示它已被签出

注意：当你签出文件时，Perforce把它加到一个changelist中，该changelist是一系列关联文件的列表。

你可以用changelists来归类相互关联的文件，例如：所有包含实现产品新功能所需的变更的文件。

要查看changelist，选择View→ Pending Changelists或点击工具栏。

在你的工作区中编辑文件

要编辑签出了的文件，双击该文件（或右击该文件后选择Open With，再选择应用程序）后，P4V会启动相应的编辑应用程序，编辑该文件后保存。

要选择一个打开文件的应用程序，点击File→Open With→Choose Application。

你可以在Preferences对话框的File Editors子页中配置编辑器。

添加新文件到depot

要添加文件到 depot，你需要进行以下两个操作：

• 首先，你把该文件标记为以添加为目的， 把该文件放在一个changelist中

• 然后，你提交该changelist，把该文件拷贝到depot中。

添加文件到depot ：

1. 在左侧面板，点击Workspace标签。
2. 把光标移到想要请添加的文件。
   • 如果该文件不在depot的话，它的图标就没有标记 。
   • 如果你在Workspace子标签页中没有看到该本地文件，选择Search→FilterWorkspace→Show Local Workspace Files。
3. 右击该文件并选择Mark for Add. 该文件图标显示一个红色加号 ，表示它以追加目的打开。
4. 提交包含以追加目的打开的文件的 changelist 。
   • 右击该文件后选择Submit… 显示 工作中Changelist表单，列出该changelist中的文件。

比较文件内容以查看变更

为了查看你做了哪些变更，你可以把你所编辑的文件与你签出的版本比较。

为了做比较，在左侧面板中右击签出了的文件并选择Diff Against Have Revision。

P4V启动比较工具，显示 这两个文件的差分。

例如（随便找了两个）：

通过恢复废弃变更

如果你决定废弃变更的话：

1. 在左侧面板中右击该文件并选择Revert ，P4V显示警告对话框。
2. 点击OK

把变更签入depot

为了把变更了的文件签入depot，执行以下步骤：

1. 显示作业中 changelist: 点击工具栏中的[外链图片转存中…(img-71kFi25C-1603520637808)]图标。P4V 显示如下图所示的作业中 changelist一览。要显示该changelist中的文件的话，展开它。

2. 双击你文件所在的changelist。P4V显示如下图所示的详细信息。

3. 输入注释说明你所做的变更，然后点击Submit.

显示文件的版本历史

要查看文件或文件夹所做的变更，右击该文件或文件夹后选择File History或Folder History

在右侧面板上显示所选文件或文件夹的历史。

例如，下图显示一个文件夹的历史，列出了所有影响该文件夹内文件的已提交了的changelist

图形化报表工具

P4V包含几种有用的图形化报表工具：

• Revision Graph：以图形的形式显示所选文件的演变过程，包括该文件的所有分支操作。
• Time-lapse View：显示所选文本文件的内容从一个版本到另一个版本是如何变化的。你可以很容易地浏览版本范围以定位你所感兴趣的段落以查看该段落是何时创建又是如何变化的。 • 文件夹比较工具：使你可以查看文件夹的内容是如何变化的。

用 Revision Graph的方式查看文件版本演变

为了显示一个文件的版本演变过程，在左侧面板中右击该文件并选择RevisionGraph.P4V 弹出工具，显示如下的版本演变图。

该版本演变图显示该文件是何时创建的又是如何被分支的，并使你可以查看提交到depot的 每个版本的细节，利用导航图可以在版本演变图上浏览。

利用 Time-lapse View浏览文件版本

为了浏览一个文本文件所发生的变化，在左侧面板中右击该文件并选择Time-lapse View。 P4V 启动工具，显示如下画面。

利用Time-lapse View，你可以移动滑块浏览所有的版本，留意何时做了变更、谁做了变更。

用文件夹比较工具显示文件夹历史

文件夹比较工具使你可以查看文件夹的内容是如何变化的：哪些文件被增删改了。

要查看一 个文件夹所发生的变化：

1. 右击左侧面板的Depot或Workspace子标签页中的文件夹，选择Folder History. 在右侧面板中，P4V列出跟该文件夹有关的changelist，例如：

2. 要查看文件夹的两个版本之间所发生的变更，可以把一个版本拖放到另一个版本上。

   P4V 显示如下图所示的变化。该例子显示在所选的版本之间，一个文件被编辑并被签入。文件用颜色高亮显示以表示增删改。展开文件夹并定位到所感兴趣的变更。要移到下一个或前一个变更，点击左箭头或右箭头。

查看 Streams

Perforce streams是“智能化的分支”，是一个管理类似于代码行之类相关文件的集成化方法。

如果你的团队使用 streams 的话，你将在Depot面板中看到Streams depots。

重要且有用的功能

在P4V 提供的众多功能中，下列功能特别有用：

• 工具提示：想要了解界面上各个控件的更多信息，把光标移到该控件上，P4V 即弹出对话 框说明该控件的更多信息。
• 拖放: P4V包含许多共通操作的拖放快捷方式。
• 文件视图：P4V允许你利用缩略图预览图形文件。
• 分离窗口：为了在单独窗口中显示式样，你可以分离窗口。 以下章节提供更详细的信息。

工具提示

P4V 为画面上的众多控件提供工具提示。

例如，为显示一个文件的状态，把光标移到左侧面板中的该文件上，P4V显示工具提示。

拖放

P4V 为共通任务提供拖放快捷方式。拖放能简化大批量文件的操作。

例如，要把一个文件夹中的所有文件签出，只要把该文件夹拖放到一个changelist即可。

要比较两个文件，只要把其中一个拖放到另一个。

如果想了解更多关于拖放快捷方式的话，你可以参照《P4V在线帮助》。

文件视图

如果你用Perforce管理图形文件， P4V的缩略图视图能使你预览这些文件。

要显示缩略图， 点击右侧面板的文件子标签页，然后从标题栏中选择所需的缩略图尺寸。

分离窗口

要保持一个子页为打开状态，你可以把它分离出去。

设置[Preferences]

要 配 置 P4V, 编 辑 它 的 首 选 项 (Mac: P4V → Preferences, Windows:Edit →Preferences)。

在File Editor子页，你可以设置文件类型与应用程序联系起来，以覆盖系统设置。

在Diff和 Merge子页，你可以根据自己的喜好，绑定除P4V系统默认工具以外的外部应用程序。

从命令行启动PV 组件

如果你是 Perforce 命令行客户端用户，偶尔利用 P4V 的某些功能，例如查看版本演变图或 Stream图，你可以利用P4VC（一个包含在P4V中的命令行工具）来从命令行启动具体的P4V组件，而不必打开整个P4V实例。

如果想了解更多信息的话，你可以在命令行输入p4vc help命令。

后继工作

Perforce管理员通过选择Tools → Administration能执行管理操作。