DotNET項目編譯指南

精品文檔精心整理精品文檔可編輯的精品文檔DotNET項目編譯指南目錄：1、DotNET項目編譯指南2、培訓資料編寫指南文件編碼文件密級最新發(fā)布日期當前版本DotNET項目編譯指南。本文檔中任何部分未經XX軟件股份有限公司書面授權，不得將材料泄露給第三方，不得以任何手段、任何形式進行復制與傳播變更履歷版本日期變更位置變更理由/變更內容變更人備注1.0新建1.1根據(jù)研發(fā)項目管理流程問題巡檢檢查出的問題進行更新：增加變更履歷一、名詞解釋編譯管理軟件：公司內部開發(fā)的、用于編譯管理系統(tǒng)?？梢詫Σ煌瑱嘞薜挠脩籼峁┎煌椖康木幾g服務。Helper工具：公司內部開發(fā)的編譯輔助工具?？尚薷拿總€程序集的版本信息等。二、編譯分類編譯主要有兩種編譯選項：Debug：用于調試。保存了狀態(tài)信息，方便調試。開發(fā)人員一般使用此設置。Release：用于生成最終的發(fā)布代碼。給測試和實施人員發(fā)布程序時使用此設置。三、編譯選項編譯選擇需重點關注如下幾項，其它選項使用默認設置即可。應用程序項（圖1）圖1編譯選項－－應用程序程序集名稱（N）：生成的EXE或DLL文件名稱。默認命名空間（L）：程序級的命名空間，其它應用調用時使用。輸出類型（U）：Windows應用程序、控制臺應用程序、類庫。程序集信息（I）：包含了標題、說明、公司、產品、、商標、程序集版本、文件版本、GUID等信息（如圖2）。圖2程序集合信息圖標（C）：應用程序圖標。生成（圖3）：條件編譯符號（Y）：如果程序中需要條件編譯則再次設置。如下編譯指令#ifNET20privateList<Driver>m_inUsePool;privateQueue<Driver>m_idlePool;#else privateArrayListm_inUsePool; privateQueuem_idlePool;#endif如果在編譯符號編輯框輸入NET20，則實際編譯時使用如下定義privateList<Driver>m_inUsePool;privateQueue<Driver>m_idlePool;否則使用另一種定義。將警告視為錯誤：無表示處理警告；特定警告表示對指定的警告視為錯誤，不能通過編譯；所有則表示編譯時不允許有警告，否則編譯不通過。輸出路徑（O）：程序集生成的路徑，可以是相對路徑（默認bin\Debug\）也可以是絕對路徑。XML文檔文件（X）：選中該復選框生成時將同時生成程序的XML說明文檔，該文檔可以通過其它工具生成html格式的技術文檔。圖3編譯選項－－生成生成事件：使用默認設置調試：使用默認設置資源：使用默認設置設置：使用默認設置應用路徑：使用默認設置簽名：為程序集簽名（A）：選中該復選框后，可以選擇強名稱密鑰文件（如圖4）。如果強名稱密鑰文件不存在時可以新建（如圖5）。圖4編譯選項－－簽名圖5編譯選項－－簽名－－創(chuàng)建強名稱密鑰代碼分析：使用默認設置OCX使用：注冊OCX：在開始/運行窗口輸入“regsvr32+OCX路徑”注冊OCX控件。如regsvr32E:\DEV\CI_GOV_YKT\04源代碼\05表格打印組件\JQPrintXControl.ocx將OCX添加到開發(fā)環(huán)境中：啟動MicrosoftVisualStudio2005開發(fā)環(huán)境，從菜單欄選擇工具/選擇工具箱項（如圖6），在選擇工具箱項窗口切換標簽頁到COM組件，在COM組件列表找到已注冊的OCX控件并選中，點擊確定即可（如圖7）。如果列表中不存在可通過“瀏覽”按鈕從文件中選擇。圖6選擇工具箱項圖7添加COM組件四、手動編譯添加引用在編譯前應確保該項目說引用的程序集引用都已添加。添加引用的方式為，展開項目找到引用節(jié)點，右鍵單擊引用并選擇“添加引用”菜單（如圖8）。打開添加引用窗口（如圖9），選擇要引用的文件包括自帶的程序集、COM組件、項目和自定義程序集等。如果選擇了項目，則編譯該項目前系統(tǒng)會先編譯其所依賴的其它項目。圖8添加引用圖9添加引用窗口生成生成當個項目：選擇要編譯的項目，單擊右鍵選擇“生成”或“重新生成”菜單圖10生成單個項目生成整個解決方案：在開發(fā)界面菜單中選擇生成/生成解決方案菜單即可。圖10生成解決方案注意事項如果OCX重新注冊，則需要先對清理再生成，或者選擇重新編譯菜單。五、自動編譯原理自動編譯就是將編譯過程做成批處理文件，通過執(zhí)行批處理文件便可完成更個編譯過程。編譯過程需要解決如下幾個問題。版本自動生成（生成規(guī)則見附錄A）：每個程序集（EXE或DLL）文件都可以有自己的版本，版本信息存放在每個項目中的AssemblyInfo.cs文件中，因此編譯時只需要修改AssemblyInfo.cs文件中相應的信息即生成所需的版本。我們是通過公司內部的helper小程序實現(xiàn)。OCX控件自動注冊：可使用regsvr32實現(xiàn)。參數(shù)“-s”表示注冊OCX控件，參數(shù)“-u–s”表示取消注冊。編譯：利用自帶的devenv工具可以實現(xiàn)用命令的方式編譯。錯誤處理：當發(fā)生編譯錯誤時應將錯誤信息寫入日志文件。步驟1、設置環(huán)境變量PATH=C:\ProgramFiles(x86)\MicrosoftVisualStudio8\Common7\IDE;C:\ProgramFiles(x86)\WinRAR;C:\ProgramFiles(x86)\Borland\StarTeamCross-PlatformClient2008;D:\Projects\ci_gov_ykt1.0\build;%PATH%;2、設置目標文件夾路徑setDestDir=D:\Projects\ci_gov_ykt_client1.0\out\3、獲取源文件到文件編譯目錄（如果文件編譯目錄中已存在源文件則應先刪除）stcmdco-p"用戶名:密碼@10.2.9.250:49201/CI_GOV_YKT/CI_GOV_YKT/04源代碼/02客戶端/"-o-is-fp"D:\Projects\ci_gov_ykt_client1.0\source\"4、獲取OCX文件stcmdco-p"sun:zhangxuewen@10.2.9.250:49201/CI_GOV_YKT/CI_GOV_YKT/04源代碼/05表格打印組件/"-o-is-fp"D:\Projects\ci_gov_ykt_client1.0\source\ocx"5、注冊OCX控件regsvr32-u-sD:\Projects\ci_gov_ykt_client1.0\source\ocx\JQGrid.ocxregsvr32-sD:\Projects\ci_gov_ykt_client1.0\source\ocx\JQGrid.ocxregsvr32-u-sD:\Projects\ci_gov_ykt_client1.0\source\ocx\JQPrintXControl.ocxregsvr32-sD:\Projects\ci_gov_ykt_client1.0\source\ocx\JQPrintXControl.ocxregsvr32-u-sD:\Projects\ci_gov_ykt_client1.0\source\ocx\JQImportXControl.ocxregsvr32-sD:\Projects\ci_gov_ykt_client1.0\source\ocx\JQImportXControl.ocx6、設置年、月、日、時、分變量，這些變量的值有外部程序helper提供helperget-yifnoterrorlevel0gotodirerrorsetYear=%errorlevel%7、設置生成目標文件夾名稱。（文件夾名稱格式：yyyy-mm-dd-hh.mm）setDestDir=%DestDir%%year%-%month%-%day%-%hour%.%minute%\8、創(chuàng)建Release路徑setReleaseDir=%DestDir%release\9、創(chuàng)建日志路徑setLogDir=%DestDir%log\10、修改程序集版本號（如果一個項目有多個程序集是需分別改寫）。改寫版本號的功能有外部程序helper提供ifexistD:\Projects\ci_gov_ykt_client1.0\source\Jiuqi\YKT\mkdirD:\Projects\ci_gov_ykt_client1.0\source\Jiuqi\YKT\helperwriteverD:\Projects\ci_gov_ykt_client1.0\source\Jiuqi\YKT\AssemblyInfo.cs11、編譯devenvD:\Projects\ci_gov_ykt_client1.0\source\JIuqi\YKT\JQYKT.sln/rebuild"Release">%LogDir%build.log12、錯誤處理ifnotexistD:\Projects\ci_gov_ykt_client1.0\source\Jiuqi\YKT\bin\Release\JQYKT.exegotobuilderrorcopyD:\Projects\ci_gov_ykt_client1.0\source\Jiuqi\YKT\bin\Release\*.*%ReleaseDir%gotoover:direrrorecho創(chuàng)建目標文件夾失敗:builderrorecho編譯失敗，應該與研發(fā)負責人聯(lián)系，解決編譯錯誤的問題:over使用方法編譯過程測試人員使用編譯管理軟件向編譯服務器發(fā)送編譯請求。如圖編譯過程中的①。編譯服務器從StarTeam服務獲取要編譯的文件。如圖編譯過程中的②、③。編譯服務修改源文件版本信息，并生成程序集和日志文件。如圖編譯過程中的④從編譯服務獲得可執(zhí)行文件。附錄：A版本號生成規(guī)則如果整個程序有大的調整，有了很大的改觀就升級大版本號，如可以從1.0變成2.0如果是按階段發(fā)布版本，就可以改小數(shù)位第一位，如：1.1、1.2、1.3……如果是階段內每天有改動，可以在后面加上年份和日期，年份從今年開始遞加如：1.0.00807，如果是明年的1月21日則是：1.0.10121最后一位表示當天的改動次數(shù)，如第一次改動版本號是：1.0.00807.1，第二次改動是：1.0.00807.2每個動態(tài)庫或exe文件都應有獨立的版本信息。附錄BVista上注冊OCX的方法一、UAC說明UAC(UserAccountControl:用戶帳戶控制)是微軟為提高系統(tǒng)安全而在WindowsVista中引入的新技術，它要求所有用戶在標準賬號模式下運行程序和任務，阻止未認證的程序安裝，并阻止標準用戶進行不當?shù)南到y(tǒng)設置改變?？梢苑乐箰阂廛浖@取特權，就算用戶是以管理員帳戶登錄也可以起到保護作用。二、手動方法：1、啟動vista后，在‘開始’→‘運行’框中輸入“msconfig”命令，點擊‘確定’。（也可以通過‘開始’→‘管理工具’→‘系統(tǒng)配置’來打開系統(tǒng)配置對話框）2、在彈出的‘系統(tǒng)配置’對話框中，切換到‘工具’頁簽，拖動滾動條，找到并選擇‘禁用UAC’選項，點擊‘啟動’按鈕禁用UAC功能。3、點擊‘確定’，重啟計算機。4、計算機重新啟動后，安裝并注冊OCX控件。5、所需OCX控件下載完畢后，重新打開‘系統(tǒng)配置’對話框，選擇‘啟用UAC’選項，點擊‘啟動’啟動UAC功能。（此一步非常重要，一定要啟動UAC功能，以保證vista操作系統(tǒng)的安全性）6、重啟電腦。三、自動方法1、右鍵單擊‘禁用UAC并重啟電腦.bat’程序，選擇‘以管理員身份運行’，按照提示完成后，等待電腦重啟完畢，安裝并注冊OCX控件。2、運行‘啟用UAC并重啟電腦.bat’程序，進行UAC功能的開啟和電腦的重啟工作。四、禁用UAC并重啟電腦bat文件內容@echoWindowsRegistryEditorVersion5.00>>UAC.reg@echo.>>UAC.reg@echo[HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Policies\System]>>UAC.reg@echo"EnableLUA"=dword:00000000>>UAC.reg@ping127.0.0.1-n2>>null@regeditUAC.reg@delUAC.reg@delnull@echo是否重新啟動電腦?@echo.@echo如果"是"請輸入"y"并回車(推薦)，"否"請輸入"n"并回車。@echo.@set/pv=請輸入你的選擇。[YorN]@if%v%==ygotocongqi@if%v%==ngototuichu:congqi@echo.@echo正在重啟電腦...@ping127.0.0.1-n3>>null@delnull@shutdown-r@exit:tuichu@echo.@echoUAC功能已禁用，但是在重啟電腦前不會生效!@echo.@pause五、啟用UAC并重啟電腦bat文件內容@echoWindowsRegistryEditorVersion5.00>>UAC.reg@echo.>>UAC.reg@echo[HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Policies\System]>>UAC.reg@echo"EnableLUA"=dword:00000001>>UAC.reg@ping127.0.0.1-n2>>null@regeditUAC.reg@delUAC.reg@delnull@echo是否重新啟動電腦?@echo.@echo如果"是"請輸入"y"并回車(推薦)，"否"請輸入"n"并回車。@echo.@set/pv=請輸入你的選擇。[YorN]@if%v%==ygotocongqi@if%v%==ngototuichu:congqi@echo.@echo正在重啟電腦...@ping127.0.0.1-n3>>null@delnull@shutdown-r@exit:tuichu@echo.@echoUAC功能已禁用，但是在重啟電腦前不會生效!@echo.@pause精品文檔精心整理精品文檔可編輯的精品文檔文件編碼文件密級最新發(fā)布日期當前版本XX軟件股份有限公司培訓資料編寫指南變更履歷版本日期變更位置變更理由/變更內容變更人備注1.0新建2.0根據(jù)20XX年新模板進行調整。

目錄1 培訓資料編寫原則 32 培訓內容分冊指南 33 生效 4

培訓資料編寫原則編寫培訓資料前，必須首先明確要培訓的對象，分析被培訓對象的工作職責、關心的功能，有針對性設計培訓教材的內容。培訓教材的編寫應有詳有略，對于重點功能、或用戶難以理解的功能應詳細描述，對于常規(guī)功能或屬于常設性功能（如日志管理、用戶管理等）的操作應簡略帶過，但不管詳略，都應截取必要的操作界面以便讓被培訓者有感性認識。培訓內容的組織應圍繞實際的工作流程來展開，結合實際的工作流程在介紹相關功能點的操作，而不是按照功能分類單純描述每個功能的操作，否則被培訓者難以形成整體的認識。培訓內容的編排應按照“先概述、后明細”，先總體上介紹，再按層次逐次展開，讓被培訓者既能從整體上了解，也能快速切入某個具體的關鍵功能。對每個功能的介紹