How to set up the compilation and installation environment

From OO Lab
Jump to: navigation, search

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.

Contents

前置作業

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

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;

Ogre 1.png Ogre 2.png

How to Setup Boost

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

Boost 1.png Boost 2.png

How to Setup xTitan

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

How to build xDiva

開啟 CMake GUI

選擇原始碼位置

Cmake 1.png

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

Cmake 2.png

點 configure, 會出現如下視窗

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

Cmake 3.png

完成後可點 generate

Cmake 4.png

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

Cmake 5.png

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 設為初始專案:

Xdiva project 1.png

How to build xDiva installer

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

Xdiva project 2.png

重要必讀

當你

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

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

Personal tools