研發(fā)規(guī)范-版本管理規(guī)范

XX公司密級(jí)密級(jí)內(nèi)部資料XX公司文檔名稱(chēng)文檔編號(hào)起草時(shí)間版本管理規(guī)范2022-6姓名2022-6姓名部門(mén)文檔信息發(fā)布版本起草人簽發(fā)人文檔修改記錄序號(hào)修改時(shí)間修改人主要修改存檔版本123456789XX公司版本管理規(guī)范1目的 42合用范圍 43版本管理規(guī)范 43.1版本管理工具 43.2版本庫(kù)目錄結(jié)構(gòu) 43.3版本命名規(guī)范 5 3.4版本提交規(guī)范 5XX公司1目的標(biāo)識(shí)、控制和追蹤軟件開(kāi)辟和實(shí)施過(guò)程中產(chǎn)生的各種軟件產(chǎn)品版本。合用于研發(fā)中心相關(guān)項(xiàng)目和產(chǎn)品所有軟件文檔和源代碼版本的管理。采用Subversion(SVN)進(jìn)行版本管理。下所示：第一層目錄為wasu_XXXX(XXXX為項(xiàng)目或者產(chǎn)品名稱(chēng)縮寫(xiě))，每一個(gè)項(xiàng)目或者產(chǎn)品的下層目錄結(jié)構(gòu)(第trunk主開(kāi)辟目錄release_tags發(fā)布版本存檔目錄(不允許修改)這三個(gè)目錄每一個(gè)目錄下層目錄結(jié)構(gòu)(第三層目錄)統(tǒng)一如下：doc存放開(kāi)辟過(guò)程中的文檔發(fā)、測(cè)試、文檔、制作安裝程序、打包等)結(jié)束后，代碼處于凍結(jié)狀態(tài)(人為規(guī)定)。此時(shí)應(yīng)該此時(shí)，如果發(fā)現(xiàn)了上一個(gè)已發(fā)行版本(ReleasedVersion)有一些bug，或者一些很急迫的功能要求，而正在開(kāi)辟的版本(DevelopingVersion)無(wú)法滿(mǎn)足時(shí)間要求，這時(shí)候就需要在上一個(gè)版本上進(jìn)行修改了。應(yīng)該基于發(fā)行版對(duì)應(yīng)的tag，做相應(yīng)的分支(branch)進(jìn)行開(kāi)辟。1.1.0開(kāi)辟完畢，代碼凍結(jié)此時(shí)的目錄結(jié)構(gòu)為此時(shí)的目錄結(jié)構(gòu)為XX公司步操作，要根據(jù)具體情況)名稱(chēng)新產(chǎn)品立項(xiàng)時(shí)，為產(chǎn)品賦予版本庫(kù)中的產(chǎn)品名稱(chēng)；當(dāng)已有產(chǎn)品升級(jí)時(shí)，則沿用前一版本產(chǎn)品版本庫(kù)中的產(chǎn)品名稱(chēng)暫定為wasu_XXXX(XXXX為產(chǎn)品中文名稱(chēng)首字母組成或者產(chǎn)品英文名稱(chēng))，作為版本庫(kù)該產(chǎn)品的首層目錄名。版本號(hào)版本號(hào)用來(lái)標(biāo)識(shí)發(fā)布產(chǎn)品，版本號(hào)格式為：<主版本號(hào)>.<副版本號(hào)>主版本號(hào)：立項(xiàng)時(shí)設(shè)置副版本號(hào)：立項(xiàng)時(shí)設(shè)置本標(biāo)識(shí)當(dāng)產(chǎn)品因?yàn)獒槍?duì)不同項(xiàng)目浮現(xiàn)分支而又不需要合并到主版本或者與主版本功能有沖突的或者基于建立目錄，后續(xù)針對(duì)分支的修改都在該分支內(nèi)完成；如果分支作為老版本bugfix而又修復(fù)完成版本號(hào)+1>的目錄作為版本發(fā)布目錄，內(nèi)容從分支目錄下copy。先更新，再提交SVN更新的原則是要隨時(shí)更新，隨時(shí)提交。當(dāng)完成為了一個(gè)小功能，能夠通過(guò)編譯并且自己測(cè)試之后，謹(jǐn)慎地提交。自己更改的是同一個(gè)文件，那末update時(shí)會(huì)自動(dòng)進(jìn)行合并，如果修改的是同一行，那末合并時(shí)會(huì)產(chǎn)生沖突，這種情況就需要同之前的開(kāi)辟人員聯(lián)系，兩個(gè)人一起商議解決沖突，解決沖突之后，需要兩人一起測(cè)試保證解決沖突之后，程序不會(huì)影響其他功能。XX公司在更新時(shí)注意所更新文件的列表，如果提交過(guò)程中產(chǎn)生了更新，則也是需要重新編譯并且完成自己的一些必要測(cè)試，再進(jìn)行提交。這樣既能了解別人修改了哪些文件，同時(shí)也能避免SVN并錯(cuò)誤導(dǎo)致代碼有錯(cuò)。多提交以每完成一個(gè)UI界面的修改或者設(shè)計(jì)，就提交一次。在開(kāi)辟功能模塊的時(shí)候，可以每完成一個(gè)bug，也就提交一次。我們提倡多提交，也就能多為代碼添加之保險(xiǎn)。不要提交不能通過(guò)編譯的代碼代碼在提交之前，首先要確認(rèn)自己能夠在本地編譯。如果在代碼中使用了第三方類(lèi)庫(kù)，要考慮到項(xiàng)目組成員中有些成員可能沒(méi)有安裝相應(yīng)的第三方類(lèi)庫(kù)。項(xiàng)目經(jīng)理在準(zhǔn)備項(xiàng)目工作區(qū)域行每次提交必須書(shū)寫(xiě)明晰的標(biāo)注在一個(gè)項(xiàng)目組中使用SVN，如果提交空的標(biāo)注或者不切當(dāng)?shù)臉?biāo)注將會(huì)讓項(xiàng)目組中其他的成員感到很無(wú)奈，項(xiàng)目經(jīng)理無(wú)法很清晰的掌握工作進(jìn)度，無(wú)法清晰的把握此次提交的概要信息。在發(fā)現(xiàn)錯(cuò)誤后也無(wú)法準(zhǔn)確的定位引起錯(cuò)誤的文件。所以，在提交工作時(shí)，要填寫(xiě)明晰的標(biāo)注，能夠概要的描述所提交文件的信息，讓項(xiàng)目組其他成員在看到標(biāo)注后不用詳細(xì)看代碼就能了解提交時(shí)注意不要提交本地自動(dòng)生成的文件文件.obj,.class等等。如果項(xiàng)目中沒(méi)有進(jìn)行這方面的配置來(lái)強(qiáng)行禁止提交這樣的文件，請(qǐng)自覺(jué)不要提交自己不明白的代碼代碼在提交入SVN之后，你的代碼將被項(xiàng)目成員所分享。如果提交了你不明白的代碼，你三方代碼之前，確保你對(duì)這個(gè)代碼有