錯誤資料庫
錯誤資料庫
此頁面提供一些書籤,讓您可以使用 Bugzilla Apache 錯誤資料庫。
此連結 issues.apache.org 會連線到 Apache 錯誤資料庫系統的完整清單。
是否已回報?
如果目前的夜間建置無法解決您的問題,則可能是其他人已回報此問題。是時候查看錯誤資料庫了。此系統易於使用,而且可以讓您搜尋 目前已開啟 和已解決的錯誤,以查看您的問題是否已回報。如果您的問題已回報,您可以查看是否有任何開發人員留言,建議解決方法或錯誤原因等。或者您可能有資訊要補充(請參閱下方關於建立和修改錯誤報告的資訊),這種情況下,請直接繼續補充資訊。如果您沒有任何其他資訊,您可能只想針對此錯誤投票,並將自己新增到 CC
清單中,以追蹤此錯誤的進度。
提交錯誤報告
在您決定 Apache Ant 中是否有未報告的錯誤之前,請先閱讀我們關於 問題 的文件。
此時您有幾個選擇。您可以發送電子郵件至 user
郵件清單,以了解其他人是否遇到您的問題,並找出他們可能如何解決問題。在經過一些討論後,如果您覺得是時候建立錯誤報告,這是一個錯誤資料庫中的簡單操作。請盡量提供盡可能多的資訊,以協助開發人員解決錯誤。請在建立錯誤時嘗試為各種輸入輸入正確的值,例如您正在執行哪個版本的 Ant,以及在哪些平台上執行等。建立錯誤後,您也可以將附件新增至錯誤報告。
您應該在錯誤報告中包含哪些資訊?最容易修復的錯誤是最容易重現的錯誤,因此如果您能產生一個顯示問題的小型測試案例,將會非常有幫助。在這種情況下,您會附加建置檔案和任何其他必要檔案,以重現問題,這些檔案可能打包在一個檔案庫中。如果您無法產生測試案例,您應該嘗試從您的建置檔案中包含一個程式碼片段,以及來自 Ant 的詳細或偵錯輸出的相關區段。請嘗試包含標頭資訊,其中 Ant 說明版本、作業系統和 VM 資訊等。由於偵錯輸出可能會非常龐大,因此最好移除任何不相關的輸出。一旦錯誤輸入錯誤資料庫,您將透過電子郵件收到有關錯誤進度的通知。如果您收到要求提供進一步資訊的電子郵件,請嘗試回覆,因為這將有助於解決您的錯誤。
若要建立錯誤報告,請按一下這個 連結。
要求增強功能
有時,你可能會發現 Ant 無法執行你需要的動作。這並非錯誤,因為 Ant 按照預期的方式運作。或許是某項任務需要一些尚未想到的附加功能,或是一個全新的任務。在這些情況下,你會想要提出增強要求。增強要求會使用上述的 Apache 錯誤資料庫進行管理。這些只不過是另一種類型的錯誤報告。如果你查看錯誤資料庫,你會看到錯誤的嚴重性設定之一為「增強」。只要填寫錯誤報告,將錯誤的嚴重性設定為「增強」,並在說明中說明你希望如何增強 Ant。再次提醒,你應該先檢查是否有任何現有的增強要求符合你的需求。如果有,只要對這些要求投下你的贊成票即可。
修復錯誤
如果你不滿意只提交錯誤報告,你可以嘗試找出問題的原因並自行提供修復程式。執行的最佳方式是使用 Subversion 中的最新程式碼。或者,你可以使用 原始程式碼散佈 中提供的原始程式碼。如果你打算在此層級解決問題,你可能想要先在 dev
郵件清單中討論一些細節。一旦你修復了問題,你可以將修復程式作為修補程式提交到 dev
郵件清單,或如上所述輸入錯誤資料庫,並將修補程式附加到錯誤報告。使用錯誤資料庫的優點是可以追蹤你的修補程式的進度。
如果你有修補程式要提交,並將其傳送至 dev
郵件清單,請在你的訊息主旨加上「[修補程式]」前綴(這在錯誤資料庫的主旨列中也是個好主意)。請包含任何相關的錯誤編號。修補程式檔案應使用 diff
或 svn diff
命令的 -u
選項建立。例如
diff -u Javac.java.orig Javac.java > javac.diffs
或者,如果你有來自 Subversion 的原始程式碼
svn diff Javac.java > javac.diffs
注意:你應該為你的修補程式檔案取有意義的名稱。這讓需要套用許多不同修補程式檔案的開發人員更輕鬆。