How to set up the compilation and installation environment

Previous Article: How to download xDIVA source code from version control server

Please read Diva/xdiva/diva_document/ReadMe_Build_Diva_Windows.docx in the source tree, it describes latest information.

前置作業

下述作業只需要做一次即可.

How to Setup CMake

1. 從 CMake 下載安裝檔並安裝

How to Setup Qt

1. 從 Qt 下載編好的版本 (目前使用 VC 2010)
2. 執行下載好的安裝檔
3. 新增系統變數:
   1. 在我的電腦上按右鍵選內容
   2. 進階系統設定
   3. 環境變數
   4. 新增變數 QTDIR, 其值為 Qt 的安裝路徑
   5. 修改 Path 變數, 新增 %QTDIR%\bin;

How to Setup OGRE

1. 從 OGRE 下載編好的版本 (目前使用 VC 2010, OGRE 1.8.x)
2. 執行下載好的安裝檔
3. 新增系統變數:
   1. 新增變數 OGRE_HOME, 其值為 OGRE 的安裝路徑
   2. 修改 Path 變數, 新增 %OGRE_HOME%\bin\debug;%OGRE_HOME%\bin\release;

How to Setup Boost

1. 從 BoostPro 下載編好的版本
2. 執行下載好的安裝檔
3. 新增系統變數:
   1. 新增變數 BOOST_ROOT, 其值為 Boost 的安裝路徑
   2. 修改 Path 變數, 新增 %BOOST_ROOT%\lib;

How to Setup xTitan

1. 已包在原始碼內, 不必設定

How to build xDiva

開啟 CMake GUI

選擇原始碼位置

選擇建置位置 (可以是任何位置, 但避免和原始碼位置一樣, 本例是使用 Diva/build)

點 configure, 會出現如下視窗

選 Visual Studio 10 (日後如有需要可直接生成其他 Visual Studio 版本)

完成後可點 generate

然後方案檔會出現在剛剛指定的建置資料夾內

How to Debug xDiva

1. 從 OGRE 複製 media 資料夾到建置資料夾 (即前例的 Diva/build, 含有 xDiva.sln 的資料夾)
2. 複製原始碼的 xdiva/Diva/media 到建置資料夾 (覆蓋所有檔案)
3. 從 %OGRE_HOME%/bin/release 和 %OGRE_HOME%/bin/debug 複製 OGRE 的 plugins 到建置資料夾
4. 複製原始碼的 xdiva/Diva/WorkingDirectoryFiles 到建置資料夾

如果你使用 Visual Studio, 記得先把 xDiva 設為初始專案:

How to build xDiva installer

1. 安裝 NSIS
2. 建置 PACKAGE 專案:

重要必讀

當你

1. 從專案新增或移除原始碼(*.cpp, *.h, *.ui ... etc.)
2. 從標頭檔新增或移除 Q_OBJECT 巨集

請務必再執行一次 CMake 的 configure 及 generate, 讓它刷新新的建置規則.