[P4V]Perforce(P4V)使用教程
Perforce(P4V)使用教程
1.前言
Perforce SCM System是一款构建于可伸缩客户/服务器结构之上的软件配置管理工具。仅仅应用TCP/IP，开发人员就能够通过多种Perforce客户端（几种平台的GUI、WEB、或命令行）访问Perforce服务器。Perforce能够被快速和容易地部署，即使对大型或分布式的站点，也只要求最小限度的管理。Perforce可以使用在50多个操作系统中，它包括版本控制、工作空间管理、变更处理和一个强大的分支模型。这里介绍的P4V是perforce的一种可以跨平台使用的客户端。
2.操作区
操作区中的内容主要由如下的几种工作区组成。
1.Pending changelists 工作区 ：这里显示当前用户正在修改的文件和其他开发者正在修改的文件。当然，你只需要关心你自己的project即可。当你执行：Mark for Add,check out等操作时，这些信息就会显示在changlist列表中显示，并由不同的图标显示其状态。如果你修改完成后，执行submit就可提交更新文件；但也可以执行revert放弃所作的修改。
1.Submitted changelists 工作区 ：显示了近期所有项目组成员对项目所做的操作。从中可以获得如：changlist号、修改时间、修改文件的内容、修改原因及修改人等信息。
3. Workspace工作区 ：在该工作区中可显示所有连接在服务器上的客户端工作空间。 在此工作区内可以执行创建、编辑修改、删除用户工作空间等操作。（前提是有执行的权限。）
4. History工作区 ：查看指定文件的变更历史信息。
3.文件修改
1.1.每次要修改文件的时候，需要先check out 到本地，然后进行修改。 此时被Check Out出来的文件左上方有个红色钩标志，表明该文件已经成功的被您Check Out出来了。如果是文件的右上方有个蓝色钩标志，说明该文件已经被别人Check Out出来了。由于Perforce支持并行操作，所以您仍可以将别人已经Check Out的文件再次Check Out到您本机进行修改。
1.2.双击打开已经Check Out出来的文件，对其进行修改。 修改完毕后，右键点击该文件，选择Submit，写下变更列表的描述。
1.3.点击Submit，文件提交到服务器，增加了一个新版本。 在这里需要提醒大家的是，如果将某个文件Check Out出来后，并没有做任何修改，这时请不要做Submit操作，而是点击右键选择Revert If Unchanged，这样提交后就不会增加该文件的版本数了，否则服务器将会为一个没有做任何修改的文件增加一个版本。
建议在每次修改后思考：为什么要做这些修改？如果所作的修改是没有意义的，那么，建议不要将这个文件提交（submit），而是Revert你所做的修改。
4.合并文件
合并操作主要用来解决并行开发过程中变更产生的冲突。 （Check out --> Get latest --> Resove --> Accept Merge）
例如，当有多人需要对同一个文件同时执行Check Out操作时，在Submit该文件时，Perforce可能会报错。现举例如下：有A、B两人需要同时对CallKeep.cpp文件执行Check Out操作。 此时可以看到文件CallKeep.cpp的左上角和右上角分别有钩，这说明该文件正在被至少两个人执行Check Out操作。由于Perforce支持并行操作，所以A和B在执行Check Out时不会发生冲突，但Submit该文件时就可能报错了。第一个执行Submit操作的人不会出现问题，例如A可以正常提交，但如果B修改的内容和A修改的相冲突，则B执行Submit时报错，并且会提示服务器上已经有最新的版本了（即A刚刚提交的版本） 。这时，选中该文件，右键点击，选择Resolve操作。 Perforce提供了三种自动解决方案，分别是“Accept Merged”、“Accept Yours”和“Accept Theirs”。当然，你也可以查看和别人冲突的地方在哪里，进行手动解决冲突。点击Run Merge Tool，显示界面从左到右。
区域1：显示的是A提交版本中的内容，即目前服务器上的最新版本。
区域2：显示的是A和B同时Check out文件CallKeep.cpp时，当时服务器上最新版本内容，也就是A、
B修改的基础版本。
区域3：显示的是B自己修改的文件内容。
区域4：显示了三个版本所有冲突的地方，B可以在此基础上对文件做修改，给出解决方案。
选择红线框中的按钮来决定所保留的代码。解决完冲突后再Submit即可。
5.查询文件历史版本
1.1. 如果想要查询某个文件的任何一个历史版本，右键点击这个文件，选择Get Revision。 如果不能Get下來，需要勾選Force Operation。
1.2. 写下需要查看的历史版本号，然后点击Get Revision。此时Perforce为您取出任何一个你想要的历史版本。
6.比较两个文件的区别
比较操作主要是用来查看某个文件到底做了哪些修改：从中你可以看出添加了什么，删除了什么等等。
1.1. 比较两个不同文件或一个文件不同版本之间的区别。右键点击需要比较的文件，选择Diff Against命令。
7.同步服务器上文件
如果您在服务器上找到自己所需要的文件，并希望把这些文件同步到本机，这时就需要首先选择好工作区Workspace，然后右键点击需要下载的文件夹，选中Get Lastest Revision命令，就可以完成。
8.對比服務器與本地文件的差異
選擇需要對比的目錄，選擇Reconcile Offline Work...
9. P4常用命令
| 命令 | 解释 |
| p4 diff -se … | 查看当前目录下的编辑文件 |
| p4 filelog file | 查看file的日志 |
| p4 changes -m 5 file | 查看file最近5条日志 |
| p4 diff file#1 | file与其库中版本#1 |
| p4 reconcile … | 离线工作之后，p4 reconcile可查看文件增删改状态，p4 changelist可再次查看 |
| p4 have file | 查看最新版本 |
| p4 reopen -c id file | 指定文件重新加入指定change list, 此命名前先使用p4 change生成CL号 |
| p4 opened | 查看change list中已打开未上传的文件 |
| p4 changes -m1 …#have | 查看本地库当前CL号 |
| p4 sync -f …@CL | 强制覆盖还本地文件 |
| p4 revert -c default //… | Revert every file open in the default changelist to its pre-opened state. |
| p4 revert -n ... | #恢复所有打开却没提交的文件 |
| p4 shelve -c CL | CL上传到shelve |
| p4 shelve -d -c CL | 上传前需删除shelve |
| p4 unshelve -s CL | unshelve到当前client |
| p4 shelve -f -c CL | 有新文件加入已shelved的CL后，需要用-f重新提交 |
| p4 describe -s CL | 查看对应CL提交log |
| p4 submit -d "some description" file | 提交(check in)已经编辑好的文件 |
| p4 cstat ... | 查看当前worspace的所有的CL，已下载的和未下载的 |
1)p4 opened 2)p4 change 3)p4 submit -c CL 4)p4 opened | 如果 edit 了多个文件，eg: a,b,c,d. 但是只需要上传其中的部分文件， eg: a,b. 1）显示 a b c d 四个文件被编辑 2）通过p4 change，得到一个change list (eg:116119), 并自动生成打开一个 vim 文件，编辑文件，把不需要的文件 c d 从vim里去掉，添加description, 保存并退出。 3）CL为刚才得到的change list， 比如 116119， 我需要输入命令p4 submit -c 116119， 就会把需要上传的 a b 上传 4）此时会发现， 只有c d 还在， a b 已经被上传 |
| 斜体部分为变量 | |
| file ： file name | |
| CL : change number |