Fireflyforeclipse使用規(guī)范.doc

中國光大銀行配置管理人力資源服務(wù)項(xiàng)目Firefly for eclipse使用規(guī)范 All rights reserved 版權(quán)所有，侵權(quán)必究文檔修訂記錄編號*變化狀態(tài)修訂說明日期變更人*變化狀態(tài)：A增加，M修改，D刪除目 錄1 前言32 Firefly Client的安裝33 Firefly Client參數(shù)設(shè)置33.1 Firefly Client參數(shù)33.2 Firefly for Eclipse插件參數(shù)33.3 客戶機(jī)操作系統(tǒng)時(shí)間調(diào)整34 wsad項(xiàng)目初始化35 關(guān)閉wsad46 Firefly for Eclipse插件的使用46.1 Birngover命令（更新本地工作區(qū)文件）46.2 6.2 add to source control增加新文件文件46.3 checkout和checkoutnow命令46.4 檢入文件46.5 文件的刪除、移動和重命名56.6 Rollback（回滾）命令56.6.1 Undelete命令56.6.2 History命令56.6.3 文件版本合并57 Firefly Client的使用57.1 組織工作區(qū)57.2 脫機(jī)工作模式67.3 文件狀態(tài)67.4 過濾文件77.5 其他命令87.6 Firefly WEB的使用88 Firefly常見問題處理81 前言本文描述了開發(fā)人員在開發(fā)工作中Firefly for eclipse集成的正確使用方法，以減少由于操作方法不當(dāng)對工作造成影響。2 Firefly Client的安裝在安裝Firefly Client for Windows軟件時(shí)，需要安裝MS .NET framework和VJ語言發(fā)布包，但是多數(shù)開發(fā)人員的操作系統(tǒng)中已經(jīng)有MS .NET framework，因此直接安裝VJ語言發(fā)布包和Firefly安裝包，但是有可能原來的MS .NET framework版本比較舊，可能會造成Firefly Client使用問題，如果出現(xiàn)MS .NET framework引起的問題，重新安裝MS .NET framework即可。在安裝Firefly for Eclipse插件后，打開wsad可能會看不到Firefly菜單，需要關(guān)閉wsad現(xiàn)有打開視圖，再重新打開就能夠看到Firefly菜單了。3 Firefly Client參數(shù)設(shè)置3.1 Firefly Client參數(shù)安裝Firefly Client之后需要在Firefly Client Setting中設(shè)置License Server主機(jī)地址（4）和端口號（缺省4761），以及界面語言（中/英文）。3.2 Firefly for Eclipse插件參數(shù)在wsad中打開config firefly界面，設(shè)置Firefly for Eclipse的參數(shù)，只填入License Server主機(jī)地址和端口號即可。其他選項(xiàng)和參數(shù)使用缺省值即可。3.3 客戶機(jī)操作系統(tǒng)時(shí)間調(diào)整開發(fā)人員的客戶機(jī)操作系統(tǒng)時(shí)間應(yīng)與Firefly服務(wù)器時(shí)間一致（偏差不能超過24小時(shí)），如果由于某種原因?qū)⒖蛻魴C(jī)操作系統(tǒng)時(shí)間進(jìn)行調(diào)整，以致與Firefly服務(wù)器時(shí)間不一致，則會出現(xiàn)Firefly client連接不到Firefly Server的問題。4 wsad項(xiàng)目初始化開發(fā)人員在工作前需要將源代碼從Firefly的存儲庫中下載到本地，然后在wsad中進(jìn)行開發(fā)。正確方法如下：u 在Firefly Client中初始化工作區(qū)。將所需的源文件bringover到本地工作區(qū)。u 打開wsad，選擇File-import，將bringover到本地工作區(qū)的項(xiàng)目導(dǎo)入wsad。u 選擇Firefly-bind project from Source ，源代碼后出現(xiàn)版本號，即可使用Firefly對代碼進(jìn)行版本管理工作。注意：u Firefly for Eclipse中的Open project from Source Control命令也可將Firefly存儲庫中的源文件下載到本地，但經(jīng)常會出現(xiàn)問題，不推薦使用這個(gè)功能。u 如果不希望使用Firefly管理項(xiàng)目版本，選擇Firefly-unbind project from Source。u 如果執(zhí)行bind project from Source后出現(xiàn)異常，執(zhí)行unbind命令，重新執(zhí)行初始化工作區(qū)、import、bind項(xiàng)目操作。5 關(guān)閉wsad在結(jié)束開發(fā)工作關(guān)閉wsad之前，應(yīng)使用wsad的“close project”命令關(guān)閉受控項(xiàng)目，然后再關(guān)閉wsad。如果不關(guān)閉project而直接關(guān)閉wsad，下次再打開wsad時(shí)，會出現(xiàn)wsad進(jìn)程沒有響應(yīng)的現(xiàn)象。注意：如果不小心沒有關(guān)閉工程直接關(guān)閉了wsad，再次啟動wsad沒有響應(yīng)，可以將FireFly受控的工程在資源管理器中，暫時(shí)重命名，打開wsad，關(guān)閉對應(yīng)的工程，關(guān)閉wsad，將剛才改名的工程恢復(fù)，打開wsad，打開工程即可。6 Firefly for Eclipse插件的使用6.1 Bringover命令（更新本地工作區(qū)文件）Bringover命令從Firefly存儲庫中下載最新版本的文件。但如果本地文件處于checkout狀態(tài)時(shí)，不更新最新版本。注意：不要將所有文件作checkout，否則bringover命令不起作用。需要修改文件時(shí)再checkout這個(gè)文件。6.2 add to source control增加新文件文件使用add to source control命令將新建的文件直接放入受控庫，不需再使用checkin命令。6.3 checkout和checkoutnow命令準(zhǔn)備對選定文件進(jìn)行編輯狀態(tài)，其中checkout可以查看您正在提交的所有任務(wù)，目前的狀態(tài)以及錯(cuò)誤信息，如果您不想查看這些信息，可直接點(diǎn)擊checkoutnow，這個(gè)操作將缺省檢出最新版本。6.4 checkin檢入文件文件修改后，使用checkin命令將文件提交到Firefly存儲庫。每個(gè)文件都能單獨(dú)checkin到Firefly存儲庫。但如果所修改的多個(gè)文件有相關(guān)性，可以將多個(gè)相關(guān)的文件一起checkin到存儲庫，這樣這一組文件作為一個(gè)變更集提交到Firefly 存儲庫保存，并且能夠在Firefly WEB中的分支歷史中查到6.5 文件的刪除、移動和重命名分別使用Firefly菜單中的remove、move和rename命令對文件進(jìn)行刪除、移動和重命名操作，使得所有的操作都是在Firefly控制下進(jìn)行。不要使用wsad中命令進(jìn)行這些操作。在firefly中，移動和重命名將不簡單的被看作刪除和新建的組合，從而避免了歷史版本的丟失。Firefly完整的保存了一個(gè)文件的歷史，即使這個(gè)文件被移動到其他目錄下（移動本身也會成為一個(gè)版本保留下來），6.6 Rollback（回滾）命令文件如果需要從某個(gè)歷史版本重新修改，使用Rollback命令。Rollback命令將建立一個(gè)新版本，這個(gè)新版本的內(nèi)容與我們想要到歷史版本內(nèi)容相同。即版本增加，但內(nèi)容不變。6.6.1 Undelete命令如果文件remove操作后，及刪除此文件后，可以使用undelete命令找回文件。Firefly對受控文件不作物理刪除，所有remove操作的文件都可以使用undelete命令找回。6.6.2 History命令能夠列出文件所有歷史版本，并可以選擇任意兩個(gè)版本進(jìn)行比較，選擇HIistory命令后，選中兩個(gè)版本，單擊右鍵，出現(xiàn)compare，即可對兩個(gè)版本進(jìn)行比較，F(xiàn)irefly會自動列出兩個(gè)版本不一樣的地方。注：如果執(zhí)行History命令列出的版本號出現(xiàn)重名，比如兩個(gè)1.3版本，這是eclipse顯示問題，實(shí)際上應(yīng)該顯示1.3.1和1.3.2。出現(xiàn)這種情況時(shí)，可以使用Firefly Client或Firefly Web上查看文件版本歷史。6.6.3 文件版本合并當(dāng)兩個(gè)開發(fā)人員同時(shí)checkout一個(gè)文件進(jìn)行修改，這時(shí)就處于并發(fā)開發(fā)狀態(tài)，第一個(gè)開發(fā)人員checkin后，第二個(gè)開發(fā)人員checkin時(shí)出現(xiàn)沖突，F(xiàn)irefly會自動打開沖突解決窗口，讓開發(fā)人員合并文件內(nèi)容。7 Firefly Client的使用7.1 組織工作區(qū)在工作區(qū)-組織工作區(qū)中刪除、卸載和加載工作區(qū)。對于不再使用的工作區(qū)，應(yīng)該在這里刪除，而不是在資源管理器中直接刪除工作區(qū)目錄。如果已經(jīng)在資源管理器中刪除了工作區(qū)的目錄，使用卸載命令可刪除在Firefly Client中的鏈接。7.2 脫機(jī)工作模式在工具選項(xiàng)當(dāng)前工作區(qū)設(shè)置中，選擇“脫機(jī)”復(fù)選框，F(xiàn)irefly進(jìn)入“脫機(jī)工作”模式。當(dāng)網(wǎng)絡(luò)出現(xiàn)故障，不能連接服務(wù)器時(shí)，可采用“脫機(jī)工作”模式。Firefly在離線狀態(tài)下仍然能夠允許開發(fā)人員進(jìn)行版本管理。當(dāng)網(wǎng)絡(luò)故障修復(fù)后，再采用“聯(lián)機(jī)工作”模式，重新連接服務(wù)器，并將脫機(jī)工作狀態(tài)下的所有文件歷史全部提交到Firefly存儲庫中。7.3 文件狀態(tài)當(dāng)firefly用戶（包括當(dāng)前用戶和其他用戶）對文件進(jìn)行操作時(shí)，文件的狀態(tài)會發(fā)生變化，firefly在文件列表欄中以不同的標(biāo)識代表不同的狀態(tài)，如圖所示。7.4 過濾文件一些中間過程產(chǎn)生的文件或者臨時(shí)文件，是不應(yīng)該作為配置項(xiàng)入庫的，比如.class文件和.tmp文件?？梢酝ㄟ^在Firefly client端設(shè)置來自動過濾，避免這種情況的發(fā)生，方法如下：（1） 進(jìn)入Firefly client，點(diǎn)擊菜單工具選項(xiàng)（2） 選擇“文件操作”選項(xiàng)卡，在“文件過濾器”中添加希望過濾掉不入庫的文件類型，同時(shí)要選擇“缺省使用文件過濾器”選項(xiàng)，點(diǎn)“確定”，完成過濾文件的設(shè)置。7.5 其他命令Firefly Client工具提供了更加豐富的命令管理文件版本。例如，找回丟失文件、列出非法修改文件、提供文件版本數(shù)、建立變更集等操作，具體使用方法請參考Firefly Users Guide。7.6 Firef