最近參與了WPMind站長張欣發起的一個WP7開源項目,其中用到了Visual Studio Team Explorer進行原始程式碼控制。以下是使用Visual Studio Team Explorer管理Codeplex上原始碼的一些說明,感謝張欣提供的素材。
1. 設定
CodePlex支援Subversion、Visual Studio Team Explorer和Team Explorer Everywhere三種方式。請前往項目的原始碼選項頁面,點擊右側“Source Control Setup”小節中您所選用的方式來查看具體參數資訊。以下操作步驟以Visual Studio Team Explorer為例。
開啟Visual Studio中的Team Explorer(如果沒有,請自行安裝),選擇Team Explorer中的“Connect To Team Project”。如果您的Team Explorer還沒有配置過CodePlex上的項目,請添加Server,參數參考或者Codeplex上的提示:
Project Collection選擇TFS05,Project Name為wpmind。
在這裡需要注意的是,如果您的codeplex使用者名稱為zhangsan,那麼原始程式碼控制中你的使用者名稱為snd\zhangsan_cp,而密碼和你codeplex的密碼一致。
2. 原始碼擷取
當Team Explorer串連上wpmind的項目後,在Team Explorer中會看到如所示:
請雙擊”Source Control”開啟”Source Control Explorer”。然後在左側項目列表中選中wpmind這個項目,然後在右側列表上方“Local Path”地方點擊”Not mapped”來設定一個該項目在本地的映射目錄。然後右擊該項目選擇“Get Last Version”就可以擷取到所有最新的被簽入的代碼。
3. 代碼的簽出和修改
開啟步驟2中所獲得的solution檔案(WPMind Framework for WP7.sln),然後在Solution Explorer中任何一個檔案上面點擊右鍵選擇“Check Out for Edit…”就可以將該檔案簽出以供修改。通常,你首先需要簽出專案檔(WPMind.WP7.csproj)才能向項目中增添新的檔案。
4. Shelve你的代碼
Shelve的意思就是擱置,當你修改/添加了某些代碼後,請不要直接Check In到伺服器上面。應該讓團隊中其他成員進行代碼審核,當80%的成員都同意check in你的代碼的時候才能將代碼簽入伺服器。這樣才能保證伺服器上具有較高品質的代碼。修改完畢代碼,在Solution Explorer中右鍵點擊工程,選擇”Shelve Pending Changes…”.然後為你的這些代碼起一個”Shelve”的名字和添加一些注釋,最後點擊”Shelve”就可以將代碼提交到伺服器“擱置”起來。
5. Unshelve和代碼審核
當有人Shelve了代碼後,需要在論壇中相應版塊發帖要求大家進行代碼審核。審核代碼的時候,需要你開啟該工程,然後在VS2010的菜單中,依次“File”->”Source Control”->”Unshelve Pending Changes…”。然後在owner name中輸入該成員的ID(別忘了那個_cp)點擊Find就會列出他的所有擱置的代碼。
這時候有兩種審核的方式,對於少量更改,請點擊“Details”按鈕,則會列出該Shelve中所有的代碼:
選中某一個檔案,右鍵點擊然後“Compare”->”With Last Version…”就會把這個改動和伺服器上最終的代碼來進行對比。
或者你也可以在上一個shelve列表中選中該擱置,然後點擊”unshelve”,系統會把這個你本地相應的檔案簽出,然後把這些改動應用到你的本地。然後你就可以來編譯並測試它。
6. 放棄修改
有時候你想要放棄一些改動,或者查看完別人shelve的代碼後需要放棄這些代碼在你本地的改動。在Solution Explorer中右鍵點擊工程,然後選擇“Undo Pending changes”就可以將所有改動放棄。並將你本地的代碼恢複到系統中籤入的最終版本。
7. 簽入代碼
代碼被審核通過後決定簽入了,則在Solution Explorer中右鍵點擊工程然後選擇“Check In”,然後選中要簽入的檔案並加上注釋提交即可。