2012年10月22日星期一

Perforce 使用说明

Perforce 使用说明

 

一、    概念

    1.项目

与一个二进制可执行文件对应一组源代码,以及相关资源文件的集合。

    2. 解决方案

为了实现一个完整的开发任务,所必须的一组项目的集合。

    3. 工作区

工:一般情况下,工作区的名称应与用户名对应,每个用户应使用唯一的工作区。

    4. 版本库

depot,是服务器上的源代码版本数据库,添加到源代码管理的每个源代码文件的各个版本,都会保存在版本库中。

版本库一般由管理员创建,版本库可以按解决方案类型创建,同一类型的解决方案可以共用一个版本库。

对于分布式开发的情况,所有相关开发人员需将解决方案中的项目添加到与解决方案对应的版本库中。

    5. 工作区与版本库中文件夹路径的对应关系

工作区中的各个子文件夹,在版本库中对应地将显示为版本库的子文件夹。

在版本库中,虽然可从识别原代码文件来自哪个不同工作区,但不会以子文件夹的形式为工作区创建对应的文件夹。

一般情况下,工作区与版本库中的子文件夹,名称都与解决方案名称对应,这样可以使版本库中的文件按。

因此同一解决方案的项目文件,若存放在不同工作区中,只要将工作区添加到同一个版本库,这些项目文件将显示在同一个解决方案文件夹中。

 

二、    使用Perforce前的准备

    1. 创建版本库

在将工作区中的源代码添加到服务器前,应事先在服务器上创建版本库。

    2. 设定工作区

在磁盘上适当的位置,建立一个文件夹,作为工作区。

在创建需要添加到源代码管理的解决方案时,保存到这一文件夹中。

    3. 创建解决方案

在创建解决方案时,应将解决方案位置设置在工作区中(选择为解决方案创建文件夹)。

    4. 创建项目

创建项目时,应将项目位置设置在解决方案文件夹中(选择添加到解决方案)。

 

三、    P4V的基本操作

    1. 连接到Perforce服务器

若解决方案在现有的工作区中,可点击右侧Browse…按钮,并在弹出的对话框中选择所需的版本库(depot)和工作区。

若要为解决方案创建新的工作区,可点击右侧New…按钮,并在弹出的对话框中设置新建工作区的本地路径,以及该工作区与版本库中工作区的对应关系。具体规则见下节。

即使在不同的计算机上,也不能创建相同的工作区名称,因此在创建工作区时,在为的工作区命名时,宜对工作区的位置、用户和服务器信息进行适当标志:

标志工作区的位置(所在计算机),以便在其它计算机上可以创建临时工作区。

标志工作区的用户,以便其它用户可以在本机创建个人工作区。

标志服务器,以便户在一台计算上为不同服务器分别创建各自的工作区。

    2. 视图(View)——指定工作区的本地路径和版本库中路径的对应关系

工作区与版本库的对应关系称为视图,视图通过一对路径描述来定义:

前面是版本库路径(如://depot/…),后面是工作区的路径(如://Workspace/…),中间用空格隔开。

 

版本库路径描述格式说明:

格式:"//"+[版本库名]+"/...";

或:"//"+[版本库名]+"/"+[子文件夹路径]+"/..."。

 

工作区路径描述方法

格式:"//"+[工作区名]+"/..."

或:"//"+[工作区名]+[子文件夹路径]+"/...";

 

其中:[工作区名]可理解为创建或编辑对话框中"root"项所指定的工作区路径的别名,而[子文件夹路径]则与工作区中径下的子目录路径相对应。"/…"则相当于"/*.*"表示此路径下的所有文件。

    3. 重要说明

不管采用3.2和3.3中何种路径描述格式,都应确保版本库路径和工作区路径的对应关系。

若在版本库或工作区路径描述中使用子文件夹路径,应保证子文件夹路径事先存在。

    4. 版本库中源文件的添加和删除

将源文件添加到版本库:Mark for add…

从版本库中删除源文件:Mark for delete…

 

四、    在VisualStudio开发环境中使用Perforce源代码管理插件

    1. 设置源代码管理插件

在VisualStudio菜单中点选"工具->选项",将显示选项对话框,如下:

在选项对话框左侧面板选择"源代码管理",然后在右侧面板下拉框中选择"Perforce SCM"。

在选项对话框中选择"源代码管理->环境",可根据开发团队配置情况,在右侧显示的面板中可选择"独立开发人员"或"Visual Source Safe"等预定义环境设置选项配置,也可根据需要自定义选项。

在选项对话框中选择"源代码管理->插件设置",可设置用于登录Perforce服务器的用户ID。而点击"高级"按钮,将显示本机Perforce客户端P4V的选项对话。

注:一般情况下不需修改源代码管理插件的高级设置。

 

    2. 将VisualStudio解决方案添加到源代码管理中

在解决方案管理器中,右键点击解决方案,在弹出菜单中选择"将解决方案添加到源代码管理…",将弹出如下对话框:

输入适当的Server / User / Workspace信息后,点击OK按钮后即可启动将解决方案添加到源代码管理的操作。其中,Server / User / Workspace信息可向管理员咨询。

若软件显示如下对话框,提示文件编码格式为UTF-8,可直接点击确定执行下一步。

在软件显示如下对话框架时,在"Write a changlist description"下的文本框中输入对此次上传的描述,并在"Choose files to submit"下的列表框中确认需要更新的文件,最后点击"Submit"按钮,即完成了源代码文件的提交操作。

只有在完成过至少一次提交操作后,源代码文件的副本才会复制到版本库。

一般情况下,源代码管理会根据解决方案的内容,为用户自动选择需要提交的源代码文件,若非用户有特殊需要,不需对列表中的文件选择状态进行修改。

 

    3. 源代码管理菜单


TAG: