Perforce使用指南_forP4V
第一章???前言
????Perforce SCM System是一款構建于可伸縮客戶/服務器結構之上的軟件配置管理工具。僅僅應用
TCP/IP，開發人員就能夠通過多種Perforce客戶端（幾種平臺的GUI、WEB、或命令行）訪問
Perforce服務器。Perforce能夠被快速和容易地部署，即使對大型或分布式的站點，也只要求最小限
度的管理。Perforce可以使用在50多個操作系統中，它包括版本控制、工作空間管理、變更處理和
一個強大的分支模型。這里介紹的P4V是perforce的一種可以跨平臺使用的客戶端。
1.1. Perforce結構
1.2.專業術語定義
第二章 Perforce使用介紹
2.1客戶端配置
2.1.1. 服務器連接
1.是首次在您的機器上使用P4V，那開始會出現如下的創建工作空間窗口。選擇“Create a new client
workspace”，在你的本地機器上創建你的第一個工作空間。
2.在菜單欄上，選擇“Connection”下拉菜單中的“open Connection”選項。
?
3.彈出如下配置窗口，按如下配置填寫正確的服務器名、端口、用戶名、密碼及工作空間設置。
4.在這里需要強調的是，登錄時請務必填寫Workspace的內容，否則Perforce的一些操作無法正常執行。如果還沒有創建Workspace，請點擊New，界面如下：
5.在此填入您在自己機器上所新建的工作區名稱，并在如下圖所示窗口中設置本地目錄等信息：
如下：
?
注意將“Option”的“modtime”選項選中。
1.填寫完成后，提交確認（OK）, 開始連接相應的服務器。
?
2.1.2 客戶端上配置
1.?設置①：下次打開P4時，自動定位到上次退出時的路徑。
2.?設置②：Submit時，不選擇未修改的文件，只提交修改過的文件。但對于未修改的文件
還是要手動Revert。
（此功能還可以通過在pending changelist框中全選提交文件，右擊，選擇菜單“Revert If Unchanged”
完成。）
3.??設置③：當打算CHECK OUT已被別人CHECK OUT的文件時，會給出提示。
（但如果是對目錄CHECK OUT，則不會提示）
2.1.3 客戶端主要工作區
上圖所示的是Perforce的主界面，大部分的操作都是在該界面下完成的。該界面分為三個區域：
區域1：顯示Deport以及Workspace中的內容，稱為目錄區。
區域2：列出文件的一些操作屬性，稱為操作區。
區域3：給出所執行操作的提示信息，稱為信息區。
2.1.3.1 目錄區
目錄區由Depot目錄區和Workspace目錄區組成。
1.Depot目錄區
顯示了服務器上可見目錄結構（用戶權限設置不同，可見目錄也不同），這也與Workspace View映
射文件路徑有關系，可以指定顯示文件路徑。在這里，可以執行的操作包括： check out, submit,
Get Latest Revision, Revert Files等操作。
2 Workspace目錄區
顯示了與服務器上文件有映射關系的，本地工作空間的目錄結構，這與Workspace View也有關系。
操作同上。
?2.1.3.1 操作區
操作區中的內容主要由如下的幾種工作區組成。
1. Pending changelists 工作區
這里顯示當前用戶正在修改的文件和其他開發者正在修改的文件。
當然，你只需要關心你自己的project即可。當你執行：Mark for Add,check out等操作時，這些信息
就會顯示在changlist列表中顯示，并由不同的圖標顯示其狀態。如果你修改完成后，執行submit就
可提交更新文件；但也可以執行revert放棄所作的修改。
2. Submitted changelists 工作區
顯示了近期所有項目組成員對項目所做的操作。
從中可以獲得如：changlist號、修改時間、修改文件的內容、修改原因及修改人等信息。
3.?Workspace工作區
在該工作區中可顯示所有連接在服務器上的客戶端工作空間。
在此工作區內可以執行創建、編輯修改、刪除用戶工作空間等操作。（前提是有執行的權限。）
4.?History工作區
查看指定文件的變更歷史信息。
5.?Labels工作區
查看目前所有的label號。
在此工作區中可完成label的創建，內容的修改等。（前提是有執行此操作的權限。）
6.?Branchs工作區
查看目前所有的Branch號。
在此工作區中完成Branch的創建，修改、刪除等。（前提是有執行此操作的權限。）
除了以上說明的幾種工作區，還有Files、Users、Jobs、Details以及Fild files等工作區。包括上述的
六種在內，這幾個工作區窗口可以通過界面上，如下圖所示的選項卡相互切換：
2.1.3.3.?信息區
由一個窗口（Pane windows）組成。
Pane windows
這是一個非常有用的窗口，稱之為消息窗口區，最底下的那個窗口就是。你的任何操作的信息都會
出現在這里，包括success, warning, error等信息。特別是執行某個操作失敗后，這里的信息是至關
重要的。一般情況下，都可以根據這里的信息來處理一些意外情況或者是不規范操作。
2.2.??Perforce的日常操作
2.2.1.?添加（Add）文件夾及文件
1.?在Workspace中選定要添加的文件夾/文件上右擊，選擇“Mark for Add”,添加文件。
將添加文件行為顯示在pending changelists工作區中。在工作區上增加好文件夾和文件后，圖標上有
個紅色的加號標志??，表明此時增加的文件夾和文件還僅僅存在客戶端的工作區中，還沒有提交到服
務器上的倉庫中。所以，右鍵點擊需要提交的文件夾或文件，選擇Submit，提交完畢后，文件此時
才真正提交到服務器上的倉庫中。
2.?提交（Submit）添加文件/文件夾
在Submit的過程中，需要寫下該變更的描述，這點很重要！描述信息的詳細，將大大的方便對文件
的查詢和跟蹤。且在描述的開頭用英文說明此次操作行為的類型。如用Add表示添加；Modify表示
修改；Build表示編譯等等。
點擊Submit后，即可看到文件前面的紅色加號已經去掉了，并且在Reversion欄中已經顯示出該文件
的版本號。此時，文件的右下角有個綠色的標識，表示該文件當前顯示的是最新版本。
2.2.2.?文件修改
如果需要對文件進行修改，首先將需要修改的文件Check Out出來到本機，才可以進行修改。
1.?右鍵點擊需要修改的文件，選擇Check Out命令。
此時被Check Out出來的文件左上方有個紅色鉤標志，表明該文件已經成功的被您Check Out出來了
。如果是文件的右上方有個藍色鉤標志，說明該文件已經被別人Check Out出來了。由于Perforce支
持并行操作，所以您仍可以將別人已經Check Out的文件再次Check Out到您本機進行修改。
2.?雙擊打開已經Check Out出來的文件，對其進行修改。
修改完畢后，右鍵點擊該文件，選擇Submit，寫下變更列表的描述。
3.?點擊Submit，文件提交到服務器，增加了一個新版本。
在這里需要提醒大家的是，如果將某個文件Check Out出來后，并沒有做任何修改，這時請不要做
Submit操作，而是點擊右鍵選擇Revert If Unchanged，這樣提交后就不會增加該文件的版本數了，
否則服務器將會為一個沒有做任何修改的文件增加一個版本。
建議在每次修改后思考：為什么要做這些修改？如果所作的修改是沒有意義的，那么，建議不要將
這個文件提交（submit），而是Revert你所做的修改。
2.2.2.1.?合并文件
合并操作主要用來解決并行開發過程中變更產生的沖突。
例如，當有多人需要對同一個文件同時執行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剛剛提交的版本）
此時B獲得最新版本后再提交，仍報錯。
且在文件上打個問號，說明服務器不知道該怎么辦，因為B需要提交的版本內容和A的相沖突，需要
B給予解決。
這時，選中該文件，右鍵點擊，選擇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即可。
2.2.3.?查詢文件歷史版本
1.?如果想要查詢某個文件的任何一個歷史版本，右鍵點擊這個文件，選擇Get Revision。
2.?寫下需要查看的歷史版本號，然后點擊Get Revision。
此時Perforce為您取出任何一個你想要的歷史版本。
2.2.4.?比較兩個文件的區別
比較操作主要是用來查看某個文件到底做了哪些修改：從中你可以看出添加了什么，刪除了什么等
等。
1.?比較兩個不同文件或一個文件不同版本之間的區別。右鍵點擊需要比較的文件，選擇Diff
Files命令。
2.?按照下圖所示，設置需要比較的文件名稱或文件的版本等。
3.?點擊Diff就可以看到如下圖所示的所有不同處，包括增加、刪減或修改的操作。
在這里需要注意的是：Perforce暫時不支持多個文件的比較。同時，如果在進行兩個文件比較時，
文件的大小超過2MB，Perforce也會報錯，出現以下所示界面：
請大家在操作過程中注意！
2.2.5.?同步服務器上文件
如果您在服務器上找到自己所需要的文件，并希望把這些文件同步到本機，這時就需要首先選擇好
工作區Workspace，然后右鍵點擊需要下載的文件夾，選中Get Lastest Revision命令，就可以完成
文件夾的同步操作了。
2.2.6.?獲取Label標識版本文件
提取出標記特定label下的文件。
1.?在工具欄上找到??的標識，在右上方的Labels工作區中找到所需的label號。
2.?獲取指定label下特定文件。 右鍵選中指定label,在菜單中選擇“Get Revision...”。
3.?在彈出的如下對話框中，選擇需要簽出的文件。
4.?點擊“Add”按鈕，選擇添加標記該label的文件。
第三章?注意事項
1.?合并的Base File文件中一行的字數不可以超過6000個字符。否則會報錯。
2.?在進行兩個文件比較的時候，文件大小不要超過2MB，否則會保存錯。
3.?關于check out
check out告訴服務器要修改指定文件，而實際上是把本地文件的屬性從只讀變為可寫， 需要注意
的是千萬不要手動去改文件信息，服務器并不會知道手工修改，這樣只會帶來不必要的麻煩，這些
信息會顯示在pending changelists的defualt這個接點下面。
4.?關于文件刪除
凡在Perforce上的任何刪除操作，都由配置管理員統一操作完成。如有刪除文件的需要，將需要刪
除的文件的Perforce上路徑發給配置管理員來完成。
5.?關于文件類型(file type)
在簽入文件前，首先要查看所簽入文件的類型是否包含在已設定文件類型中（可
在//depot/Misc/Types/typemap.txt文件中作查找），否則為包含的文件類型是不能成功加入perforce配
置庫的。
第四章?服務端相關安裝與配置
2.1.?安裝步驟
1.?點擊安裝程序，出現如下界面，選擇“User Installation”后，next繼續安裝。
2.?出現如下界面，選擇需要安裝的組件。選擇全選。
3.?配置連接服務器端口等信息。
除Username為用戶本人名以外，其他配置信息如圖。
4.?最后檢查確認所填安裝配置信息（包括安裝路徑、安裝組件、服務器端口號、用戶名等等
）后，點擊“Install”開始安裝。
5.?在“開始”菜單程序中選擇Perforce——〉P4V，進入P4V客戶端程序界面。
總結
以上是生活随笔為你收集整理的Perforce使用指南_forP4V的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： IDEA 方法自动添加注释
- 下一篇： 搭建一个属于自己的语音对话机器人