Perforce 的使用及觀念


我們架設完了 Perforce 的伺服器,接下來要處理真正在用的部分「客戶端」。大家可能會想:伺服器可以和客戶端共存嗎?答案是可以的!因此若是只有自己一個人製作專案也是可以使用。接下來也是以伺服器自己當客戶端來做介紹,大家請繼續看下去!

(Photo by Annie Spratt on Unsplash)

一、下載 Perforce 客戶端

第一步 進入到 Perforce 下載頁面,尋找 Helix Visual Client (P4V)



第二步 點擊後往下拉,和 Perofrce Server 下載時相同(有看上一篇應該會知道 XD)。FAMILY 選擇 Windows、 PLATFORM 選擇 Windows (x64),選項請依自己的系統選擇!



第三步 點擊跳出視窗的 Download,就會開始下載囉!

二、安裝

第一步 開啟 p4vinst64.exe,再開啟的時候可能會出現這個警告,主要是寫 Microsoft Visual C++ Redistributable 版本太高不相容可能會出現問題。這邊我是直接點確定繼續安裝。



第二步 直接 Next!



第三步 選擇要安裝的工具,這邊建議選擇 Helix Visual Client (P4V)、Merge and Diff Tool (P4Merge)、Adminstration Tool 。Command-Line Client (P4) 由於我是伺服器 + 客戶端一體,所以就不安裝了,在伺服器時已安裝過。至於 Merge and Diff Tool 之後拿來比對檔案哪裡有修改過很方便! Adminstration Tool 則是用來創 streamDepot 用!



* 備註:這邊有多出現粗體的英文敘述 (The DVCS feature 那段) 是因為我是使用伺服器自己兼客戶端,會喪失一些功能。

第四步 按下 Install 吧!



第五步 安裝成功。點 Close 關閉

三、連線到伺服器

第一步 開啟 P4V



第二步

Server (伺服器) 自己連:基本上系統應該會幫你設定好,直接按 OK 就可以進入了!



其他人連:Server 的部分填入伺服器的 IP (不知道怎麼查?請點這裡) 及 Port、User 部分填入代表自己的名稱



第三步 (其他人連才需要) 點擊 New



第四步 (其他人連才需要) 填入 User name、Full name、Email,Password 可不填。填完後請點 Save。



第五步 點擊 OK 即可進入 Perforce 了!



第六步 進入後會詢問是否要自動更新 P4V,建議是選 Yes



第七步 詢問是否要自動更新後,會跳出要不要傳送匿名資料,這部分就看個人喜好了

四、新增 WorkSpace

A. 建立專案者

第一步 進入 Perforce 後,點擊位於左側的 Depot 下的 (no workspace selected)



第二步 向下尋找 New Workspace...



第三步 在 Workspace name 填入「使用者名稱_專案名稱」方便辨識是哪一個使用者。Workspace root 則是資料儲存的位置,若是照預設路徑則會隨著 Workspace name 變更。弄好後點擊 OK。



第四步 隨便丟一個檔案進去後,按 Next。(等下會刪除這個檔案) 



第五步 將 Mainline name 改為專案名稱後,點 Next。



第六步 敘述為複製檔案到 Perforce Server ,請按下 Start 吧!



第七步 成功,按 Finish!



這邊我們就完成新增 Workspace 的動作了。第一步 ~ 第三步是新增自己的 Workspace 而第四步 ~ 第七步這邊是新增連上這個 Perforce Server 會共同存在的 Depot,主要是讓團隊可以直接從這個 Depot 抓資料下來到自己的 Workspace。

B. 團隊其他人 (第一、二步和建立專案的人相同)


第一步 進入 Perforce 後,點擊位於左側的 Depot 下的 (no workspace selected)



第二步 向下尋找 New Workspace...



第三步 Workspace name 也是填入「使用者名稱_專案名稱」。點擊 Workspace root 旁的 Browse... 選擇儲存空間。都弄好後,點擊 Stream 旁的 Browse...



第四步 選擇專案,按下 OK



第五步 點擊 OK,就完成了!

五、新增、刪除檔案

第一步 點 no workspace selected



第二步 切換至要製作的專案

A. 刪除檔案

第一步 在要刪除的檔案點擊右鍵,尋找 Mark for Delete。



第二步 點擊 OK。



到這邊就完成刪除檔案的準備了!我們再來新增檔案看看吧!

B. 新增檔案 (這邊用比較傳統的方法,若有連結遊戲引擎則不用這樣)

第一步 點擊左側 Workspace 分頁



第二步 在路徑上點擊右鍵 → Show In → Show in Explorer



第三步 點進專案資料夾裡面



第四步 新增文字文件



第五步 回到 Perforce 點擊 Refresh



第六步 右鍵剛剛新增的檔案 → Mark for Add...



第七步 點擊 OK

六、將更改的東西送出去 (Submit)

A. 送出變更

第一步 將右邊頁面切換為 Pending



第二步 會看到此次提交會變動甚麼檔案



第三步 選擇要送出的 Change List



第四步 點擊 Submit



第五步 在 Write a changelist description 輸入此次變動的敘述,輸入完後按 Submit。就完成了


B. 查看變更紀錄

第一步 點擊 View → History



第二步 由於剛剛新增完檔案,需點擊左側路徑處。



第三步 結果如下



或是回到 Depot → 選擇專案也可以看到一樣的紀錄

七、觀念

若是一個團隊在使用 Perforce ,每次開啟時,最好都有先按 Refresh 再按 Get Lastest 的習慣。新增檔案最好也以「一個功能」來 Submit (提交) 並打好敘述,好讓其他人知道新增或修改了什麼。若有任何問題歡迎大家在下面一起討論!

延伸閱讀

留言