Archive:Development/Software Engineering Framework (zh TW)

此網頁的目的是總結 KDE 專案在軟體工程方面所使用的工具和步驟；換言之，所有程式設計相關的工作。這包括 bug 修正、審查、測試、文件、需求等等。

KDE 目前使用的工具列出了其使用範圍、已知的替代品，和優缺點。

開發工具

Subversion 1.4 是 KDE 目前使用的原始碼控制管理系統，伺服器位於法蘭克福。另一個唯讀鏡像位於anonsvn.kde.org。

已有考慮移植到一個分散式原始碼控制管理工具，如 GIT。關於這件事的討論詳見 kde-scm-interest郵件列表。很可能是 git 和其他工具一起使用，諸如repo。

CMake 是 KDE 目前使用的構建工具。他是由 kitware inc 開發的自由軟體，可用於 KDE 的多平台支援。

該工具被用於 KDE4 系列的建構系統，目前還沒有替換的計劃。CMake 2.6.2 版就是建構 KDE 4.2 必需的。

LXR 作出 KDE 中使用的類別和方法的索引。他可以找到如何使用類別的範例，並且在重構或更新 API 時，可以找到程式裡所有使用的類別。

審查

通常 KDE 並不對單個補丁（patch）提供正規審查策略。有些補丁在提交到 SVN 之前就在相關的郵件列表審查過了。這個項目是特別針對一個大補丁或是新開發者的補丁。

作為官方政策 kdereview 用於審查進入 KDE trunk 前的新應用程式和 kdelibs 的新類別。該系統的缺點是並非所有審查報告，他們都審查新的內容。它可能是審查使用的檢查清單，例如：

• 所有新加類別都有提供文件 [x]
• 正確合理使用私有類別和 d-pointers [x]
• 通過所有 Krazy 檢查 [ ]
• 沒有明顯的安全問題 [ ]
• 設計良好、易維護 [ ]
• 等等...

這些議題在這裡有所討論，但尚未精煉成 techbase 頁面。

許多專案使用提交過濾器來發送所有提交給相關郵件列表。

KDE 沒有正式的設計審查流程。一些設計審查就是 kdereview 流程的一部分。將來也許要把它正規化或鼓勵有一些設計文件。

文件

techbase.kde.org 是個 MediaWiki 網站 ，用於收集技術任務如教學、時間表和專案資訊。

KDE API 文件是每日生成並放在 http://api.kde.org 。它也可以使用 IDE 來生成相同的本地文件。

可以從 KDE 原始碼建立 man pages 和qthelp 文件。

使用者文件是從模塊 doc/ 目錄產生的，在 http://docs.kde.org 上也有。

meinproc 是一個 KDE 工具（Stephen Kulow 所寫，它使用 libxslt 轉變 docbook 成（bzip壓縮）html。在執行 kio_help 時打開 bzip 壓縮過的 html 並在 khelpcenter 中顯示給使用者。

http://userbase.kde.org 的目的是作為網絡上使用者文件的主要來源。之後可能會打包內容，供離線使用。

測試和品質

KDE 目前使用 Bugzilla 3.0 管理 bug 追踪。Work was recently merged on a transition to Bugzilla 3.0 from Bugzilla 2.16. There is still cleanup work going on but most features of the previous Bugzilla installation already work.

Bugzilla can be difficult to use and daunting to newbies.

歡迎加入更多檢查到 Krazy。詳見 http://websvn.kde.org/trunk/quality/ 。

There is interest in more build testing for KDE especially on non-linux platforms. Improvements include some standard ctest scripts that can be used to build and submit a dashboard result for kdelibs to CDash. This would be run on a cronjob for simplicity.

Builds are planned for the following platforms:

• Windows
• MacOS
• FreeBSD 6 (gcc)
• FreeBSD 7 (gcc)
• Solaris (S10, S11) on SPARC and amd64

It may be possible run run these tests automatically possibly on EBN or on Dirks dashboard.

可以有一些統計指標，譬如千行錯誤率、缺陷修正率等。

可在未來提供教學幫助開發人員最佳化他們的程式碼。

發布

目前使用 techbase 討論功能計劃，但也許還有更好的替代品。

佈景主題和翻譯

可以用 http://kde-look.org 貢獻美工作品（artwork）。

可能有必要建立如何創造 KDE 美工的教學。