Perforce教程

1、Perforce使用指南_forP4V第一章   前言    Perforce SCM System是一款構(gòu)建于可伸縮客戶/服務器結(jié)構(gòu)之上的軟件配置管理工具。僅僅應用TCP/IP，開發(fā)人員就能夠通過多種Perforce客戶端（幾種平臺的GUI、WEB、或命令行）訪問Perforce服務器。Perforce能夠被快速和容易地部署，即使對大型或分布式的站點，也只要求最小限度的管理。Perforce可以使用在50多個操作系統(tǒng)中，它包括版本控制、工作空間管理、變更處理和一個強大的分支模型。這里介紹的P4V是perforce的一種可以

2、跨平臺使用的客戶端。1.1. Perforce結(jié)構(gòu)1.2.專業(yè)術(shù)語定義第二章 Perforce使用介紹2.1客戶端配置2.1.1. 服務器連接1.是首次在您的機器上使用P4V，那開始會出現(xiàn)如下的創(chuàng)建工作空間窗口。選擇“Create a new clientworkspace”，在你的本地機器上創(chuàng)建你的第一個工作空間。2.在菜單欄上，選擇“Connection”下拉菜單中的“open Connection”選項。 3.彈出如下配置窗口，按如下配置填寫正確的服務器名、端口、用戶名、密碼及工作空間設置。4.在這里需要強調(diào)的是，登錄時請務必填寫Workspace的內(nèi)容，否則Perforce的

3、一些操作無法正常執(zhí)行。如果還沒有創(chuàng)建Workspace，請點擊New，界面如下：5.在此填入您在自己機器上所新建的工作區(qū)名稱，并在如下圖所示窗口中設置本地目錄等信息：如下： 注意將“Option”的“modtime”選項選中。1.填寫完成后，提交確認（OK）, 開始連接相應的服務器。 2.1.2 客戶端上配置1. 設置：下次打開P4時，自動定位到上次退出時的路徑。2. 設置：Submit時，不選擇未修改的文件，只提交修改過的文件。但對于未修改的文件還是要手動Revert。（此功能還可以通過在pending changelist框中全選提交文件，右擊，選擇

4、菜單“Revert If Unchanged”完成。）3.  設置：當打算CHECK OUT已被別人CHECK OUT的文件時，會給出提示。（但如果是對目錄CHECK OUT，則不會提示）2.1.3 客戶端主要工作區(qū)上圖所示的是Perforce的主界面，大部分的操作都是在該界面下完成的。該界面分為三個區(qū)域：區(qū)域1：顯示Deport以及Workspace中的內(nèi)容，稱為目錄區(qū)。區(qū)域2：列出文件的一些操作屬性，稱為操作區(qū)。區(qū)域3：給出所執(zhí)行操作的提示信息，稱為信息區(qū)。2.1.3.1 目錄區(qū)目錄區(qū)由Depot目錄區(qū)和Workspace目錄區(qū)組成。1.Depot目錄區(qū)顯示了服務器上可

5、見目錄結(jié)構(gòu)（用戶權(quán)限設置不同，可見目錄也不同），這也與Workspace View映射文件路徑有關系，可以指定顯示文件路徑。在這里，可以執(zhí)行的操作包括： check out, submit,Get Latest Revision, Revert Files等操作。2 Workspace目錄區(qū)顯示了與服務器上文件有映射關系的，本地工作空間的目錄結(jié)構(gòu)，這與Workspace View也有關系。操作同上。 2.1.3.1 操作區(qū)操作區(qū)中的內(nèi)容主要由如下的幾種工作區(qū)組成。1. Pending changelists 工作區(qū)這里顯示當前用戶正在修改的文件和其他開發(fā)者正在修改的文件。當然，你只需

6、要關心你自己的project即可。當你執(zhí)行：Mark for Add,check out等操作時，這些信息就會顯示在changlist列表中顯示，并由不同的圖標顯示其狀態(tài)。如果你修改完成后，執(zhí)行submit就可提交更新文件；但也可以執(zhí)行revert放棄所作的修改。2. Submitted changelists 工作區(qū)顯示了近期所有項目組成員對項目所做的操作。從中可以獲得如：changlist號、修改時間、修改文件的內(nèi)容、修改原因及修改人等信息。3. Workspace工作區(qū)在該工作區(qū)中可顯示所有連接在服務器上的客戶端工作空間。在此工作區(qū)內(nèi)可以執(zhí)行創(chuàng)建、編輯修改、刪除用戶工作空間等操

7、作。（前提是有執(zhí)行的權(quán)限。）4. History工作區(qū)查看指定文件的變更歷史信息。5. Labels工作區(qū)查看目前所有的label號。在此工作區(qū)中可完成label的創(chuàng)建，內(nèi)容的修改等。（前提是有執(zhí)行此操作的權(quán)限。）6. Branchs工作區(qū)查看目前所有的Branch號。在此工作區(qū)中完成Branch的創(chuàng)建，修改、刪除等。（前提是有執(zhí)行此操作的權(quán)限。）除了以上說明的幾種工作區(qū)，還有Files、Users、Jobs、Details以及Fild files等工作區(qū)。包括上述的六種在內(nèi)，這幾個工作區(qū)窗口可以通過界面上，如下圖所示的選項卡相互切換：2.1.3.3. 

8、信息區(qū)由一個窗口（Pane windows）組成。Pane windows這是一個非常有用的窗口，稱之為消息窗口區(qū)，最底下的那個窗口就是。你的任何操作的信息都會出現(xiàn)在這里，包括success, warning, error等信息。特別是執(zhí)行某個操作失敗后，這里的信息是至關重要的。一般情況下，都可以根據(jù)這里的信息來處理一些意外情況或者是不規(guī)范操作。2.2.  Perforce的日常操作2.2.1. 添加（Add）文件夾及文件1. 在Workspace中選定要添加的文件夾/文件上右擊，選擇“Mark for Add”,添加文件。將添加文件行為顯示在pendi

9、ng changelists工作區(qū)中。在工作區(qū)上增加好文件夾和文件后，圖標上有個紅色的加號標志  ，表明此時增加的文件夾和文件還僅僅存在客戶端的工作區(qū)中，還沒有提交到服務器上的倉庫中。所以，右鍵點擊需要提交的文件夾或文件，選擇Submit，提交完畢后，文件此時才真正提交到服務器上的倉庫中。2. 提交（Submit）添加文件/文件夾在Submit的過程中，需要寫下該變更的描述，這點很重要！描述信息的詳細，將大大的方便對文件的查詢和跟蹤。且在描述的開頭用英文說明此次操作行為的類型。如用Add表示添加；Modify表示修改；Build表示編譯等等。點擊Submit后，即

10、可看到文件前面的紅色加號已經(jīng)去掉了，并且在Reversion欄中已經(jīng)顯示出該文件的版本號。此時，文件的右下角有個綠色的標識，表示該文件當前顯示的是最新版本。2.2.2. 文件修改如果需要對文件進行修改，首先將需要修改的文件Check Out出來到本機，才可以進行修改。1. 右鍵點擊需要修改的文件，選擇Check Out命令。此時被Check Out出來的文件左上方有個紅色鉤標志，表明該文件已經(jīng)成功的被您Check Out出來了。如果是文件的右上方有個藍色鉤標志，說明該文件已經(jīng)被別人Check Out出來了。由于Perforce支持并行操作，所以您仍可以將別人已經(jīng)Check

11、Out的文件再次Check Out到您本機進行修改。2. 雙擊打開已經(jīng)Check Out出來的文件，對其進行修改。修改完畢后，右鍵點擊該文件，選擇Submit，寫下變更列表的描述。3. 點擊Submit，文件提交到服務器，增加了一個新版本。在這里需要提醒大家的是，如果將某個文件Check Out出來后，并沒有做任何修改，這時請不要做Submit操作，而是點擊右鍵選擇Revert If Unchanged，這樣提交后就不會增加該文件的版本數(shù)了，否則服務器將會為一個沒有做任何修改的文件增加一個版本。建議在每次修改后思考：為什么要做這些修改？如果所作的修改是沒有意義的，那么，建議

12、不要將這個文件提交（submit），而是Revert你所做的修改。2.2.2.1. 合并文件合并操作主要用來解決并行開發(fā)過程中變更產(chǎn)生的沖突。例如，當有多人需要對同一個文件同時執(zhí)行Check Out操作時，在Submit該文件時，Perforce可能會報錯。現(xiàn)舉例如下：有A、B兩人需要同時對CallKeep.cpp文件執(zhí)行Check Out操作。此時可以看到文件CallKeep.cpp的左上角和右上角分別有鉤，這說明該文件正在被至少兩個人執(zhí)行Check Out操作。由于Perforce支持并行操作，所以A和B在執(zhí)行Check Out時不會發(fā)生沖突，但Submit該文件時就可能報錯了。

13、第一個執(zhí)行Submit操作的人不會出現(xiàn)問題，例如A可以正常提交，但如果B修改的內(nèi)容和A修改的相沖突，則B執(zhí)行Submit時報錯，并且會提示服務器上已經(jīng)有最新的版本了（即A剛剛提交的版本）此時B獲得最新版本后再提交，仍報錯。且在文件上打個問號，說明服務器不知道該怎么辦，因為B需要提交的版本內(nèi)容和A的相沖突，需要B給予解決。這時，選中該文件，右鍵點擊，選擇Resolve操作。Perforce提供了三種自動解決方案，分別是“Accept Merged”、“Accept Yours”和“Accept Theirs”。當然，你也可以查看和別人沖突的地方在哪里，進行手動解決沖突。點擊Run Merge T

14、ool，顯示如下圖所示界面。區(qū)域1：顯示的是A提交版本中的內(nèi)容，即目前服務器上的最新版本。區(qū)域2：顯示的是A和B同時Check out文件CallKeep.cpp時，當時服務器上最新版本內(nèi)容，也就是A、B修改的基礎版本。區(qū)域3：顯示的是B自己修改的文件內(nèi)容。區(qū)域4：顯示了三個版本所有沖突的地方，B可以在此基礎上對文件做修改，給出解決方案。選擇紅線框中的按鈕來決定所保留的代碼。解決完沖突后再Submit即可。2.2.3. 查詢文件歷史版本1. 如果想要查詢某個文件的任何一個歷史版本，右鍵點擊這個文件，選擇Get Revision。2. 寫下需要查看的歷史版本號，然后

15、點擊Get Revision。此時Perforce為您取出任何一個你想要的歷史版本。2.2.4. 比較兩個文件的區(qū)別比較操作主要是用來查看某個文件到底做了哪些修改：從中你可以看出添加了什么，刪除了什么等等。1. 比較兩個不同文件或一個文件不同版本之間的區(qū)別。右鍵點擊需要比較的文件，選擇DiffFiles命令。2. 按照下圖所示，設置需要比較的文件名稱或文件的版本等。3. 點擊Diff就可以看到如下圖所示的所有不同處，包括增加、刪減或修改的操作。在這里需要注意的是：Perforce暫時不支持多個文件的比較。同時，如果在進行兩個文件比較時，文件的大小超過2M

16、B，Perforce也會報錯，出現(xiàn)以下所示界面：請大家在操作過程中注意！2.2.5. 同步服務器上文件如果您在服務器上找到自己所需要的文件，并希望把這些文件同步到本機，這時就需要首先選擇好工作區(qū)Workspace，然后右鍵點擊需要下載的文件夾，選中Get Lastest Revision命令，就可以完成文件夾的同步操作了。2.2.6. 獲取Label標識版本文件提取出標記特定label下的文件。1. 在工具欄上找到  的標識，在右上方的Labels工作區(qū)中找到所需的label號。2. 獲取指定label下特定文件。 右鍵選中指定lab

17、el,在菜單中選擇“Get Revision.”。3. 在彈出的如下對話框中，選擇需要簽出的文件。4. 點擊“Add”按鈕，選擇添加標記該label的文件。第三章 注意事項1. 合并的Base File文件中一行的字數(shù)不可以超過6000個字符。否則會報錯。2. 在進行兩個文件比較的時候，文件大小不要超過2MB，否則會保存錯。3. 關于check outcheck out告訴服務器要修改指定文件，而實際上是把本地文件的屬性從只讀變?yōu)榭蓪懀?需要注意的是千萬不要手動去改文件信息，服務器并不會知道手工修改，這樣只會帶來不必要的麻煩，這些信息會顯示在pending changelists的defualt這個接點下面。4. 關于文件刪除凡在Perforce上的任何刪除操作，都由配置管理員統(tǒng)一操作完成。如有刪除文件的需要，將需要刪除的文件的Perforce上路徑發(fā)給配置管理員來完成。5. 關于文件類型(file type)在簽入文件前，首先要查看所簽入文件的類型是否包含在已設定文件類型中（可在/depot/Misc/Types/typemap.txt文件中作查找），否則為包含的文件類型是不能成功加入perforce