Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
wiki:terralib50_build [2015/04/16 16:42] marisa [2. Building with CMake GUI on Windows using MSVC2010] |
wiki:terralib50_build [2015/09/08 14:58] (current) marisa |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== TerraLib 5.0 and TerraView 5.0 - General guide for Building and Install ====== | ====== TerraLib 5.0 and TerraView 5.0 - General guide for Building and Install ====== | ||
| - | Useful links: | ||
| - | |||
| - | * [[wiki:terralib5_build#CMake_Command_Line_Notes| Using Cmake Command line]] | ||
| - | |||
| ===== Building Terralib ===== | ===== Building Terralib ===== | ||
| Line 51: | Line 47: | ||
| 1.5 Building: | 1.5 Building: | ||
| - | $ make -j 4 | + | $ make (or make -j 4) |
| + | $ make terralib_qhelp | ||
| + | $ make terralib_qtranslations | ||
| + | | ||
| 1.6 Installing: | 1.6 Installing: | ||
| $ make install | $ make install | ||
| + | 1.7 Uninstalling: | ||
| - | ==== 2. Building with CMake GUI on Windows using MSVC2010 ==== | + | $ make uninstall |
| + | |||
| + | ==== 2. Building with CMake GUI on Windows using MSVC2013 ==== | ||
| -------------------------- | -------------------------- | ||
| - | a) We will assume that the TerraLib source tree (git clone) is located at: | + | a) We will assume that the TerraLib source tree ([[http://www.dpi.inpe.br/terralib5/wiki/doku.php?id=wiki:terralib50_download|git clone]]) is located at: |
| C:\terralib\codebase | C:\terralib\codebase | ||
| - | b) We will assume that the third party libraries for Visual Studio 2010, obtained from | + | b) We will assume that the suitable third party libraries, obtained from |
| - | http://www.dpi.inpe.br/terralib5-devel/terralib5-3rdparty-msvc-2010-win32.zip | + | http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib5.x.x-3rdparty-msvc-2013-win64.zip |
| - | or | + | (or terralib5.x.x-3rdparty-msvc-2013-win32.zip) where 5.x.x is the terralib release |
| - | http://www.dpi.inpe.br/terralib5-devel/terralib5-3rdparty-msvc-2010-win64.zip | + | |
| - | + | ||
| are located at: | are located at: | ||
| - | C:\terralib\terralib5-3rdparty-msvc-2010-win32 | + | C:\terralib\terralib5-3rdparty-msvc-2013-win64 |
| - | or | + | (or C:\terralib\terralib5-3rdparty-msvc-2013-win32) |
| - | C:\terralib\terralib5-3rdparty-msvc-2010-win64 | + | |
| - | + | ||
| - | Note: If you are using MSVC 2013, the suffix of the 3rdparty is "-msvc-2013-win32". | + | |
| c) Create a folder out of the TerraLib source tree to build the binaries, for example: | c) Create a folder out of the TerraLib source tree to build the binaries, for example: | ||
| - | C:\terralib\build-win32 | ||
| - | or | ||
| C:\terralib\build-win64 | C:\terralib\build-win64 | ||
| + | (or C:\terralib\build-win32) | ||
| - | d) Open CMake-GUI in order to generate a build project for Microsoft Visual C++ 2010 (32-bit or 64-bit). | + | d) Open CMake-GUI in order to generate a build project for Microsoft Visual C++ 2013 (64-bit or 32-bit). |
| f) Then assure that the following variables are set to the locations defined above: | f) Then assure that the following variables are set to the locations defined above: | ||
| Where is the source code => C:\terralib\codebase\build\cmake | Where is the source code => C:\terralib\codebase\build\cmake | ||
| - | Where to build the binaries => C:\terralib\build-win32 | + | Where to build the binaries => C:\terralib\build-win64 |
| or | or | ||
| - | C:\terralib\build-win64 | + | C:\terralib\build-win32 |
| g) Then add an entry called CMAKE_PREFIX_PATH with the libraries location (separated by semicolons): | g) Then add an entry called CMAKE_PREFIX_PATH with the libraries location (separated by semicolons): | ||
| - | * Microsoft SDK => C:/Program Files (x86)/Microsoft SDKs/Windows/v7.0A | + | * TerraLib 5 Third party => C:/terralib/terralib5-3rdparty-msvc-2013-win64 |
| - | * TerraLib 5 Third party => C:/terralib/terralib5-3rdparty-msvc-2010-win32 | + | * Qt CMake => look for the Qt dir containing ''Qt5Config.cmake'' |
| - | * Qt CMake => C:/Qt/Qt5.3.0/5.3/msvc2010_opengl/lib/cmake/Qt5 | + | |
| + | Example for win64: Press ''AddEntry'' button and inform the name ''CMAKE_PREFIX_PATH'', type ''PATH'' and set its value as (do not press the bottom "..." to add the two paths, because the second will overwrite the first): | ||
| + | CMAKE_PREFIX_PATH => C:/terralib/terralib5-3rdparty-msvc-2013-win64;C:/Qt/Qt5.4.1/5.4/msvc2013_64/lib/cmake/Qt5 | ||
| + | |||
| Example for win32: Press ''AddEntry'' button and inform the name ''CMAKE_PREFIX_PATH'', type ''PATH'' and set its value as: | Example for win32: Press ''AddEntry'' button and inform the name ''CMAKE_PREFIX_PATH'', type ''PATH'' and set its value as: | ||
| - | CMAKE_PREFIX_PATH => C:/Program Files (x86)/Microsoft SDKs/Windows/v7.0A;C:/terralib/terralib5-3rdparty-msvc-2010-win32;C:/Qt/Qt5.3.0/5.3/msvc2010_opengl/lib/cmake/Qt5 | + | CMAKE_PREFIX_PATH => C:/terralib/terralib5-3rdparty-msvc-2013-win32;C:/Qt/Qt5.3.0/5.3/msvc2010_opengl/lib/cmake/Qt5 |
| - | + | ||
| - | Example for win64: Press ''AddEntry'' button and inform the name ''CMAKE_PREFIX_PATH'', type ''PATH'' and set its value as: | + | |
| - | CMAKE_PREFIX_PATH => C:/terralib/terralib5-3rdparty-msvc-2010-win64;C:/qt5-win64/lib/cmake/Qt5 | + | |
| h) Then press "''Configure''" and choose: | h) Then press "''Configure''" and choose: | ||
| - | * "''Visual Studio 10''" (win32) or "''Visual Studio 10 x64''" (win64) and | + | * "''Visual Studio 12 x64''" (win64) or "''Visual Studio 12''" (win32) and |
| - | * if no problem occurs press "''Generate''". | + | * if no problem occurs press "''Generate''". Otherwise update your environment variable "PATH" with the right location of Qt and third party (see item "j"). |
| Note: Some projects may be disabled through the following variables(in this case press again "Configure" and "Generate"): | Note: Some projects may be disabled through the following variables(in this case press again "Configure" and "Generate"): | ||
| Line 110: | Line 104: | ||
| TERRALIB_BUILD_UNITTEST_ENABLED => OFF | TERRALIB_BUILD_UNITTEST_ENABLED => OFF | ||
| - | i) Open the generated ''terralib.sln'' solution at the folder ''C:\terralib\build-win32'' or ''C:\terralib\build-win64''. Then build the "''ALL_BUILD''" project to build all terralib projects, including terraview application. To build the help associated with TerraView application, it is necessary to build "''terralib_qhelp''" and "''terralib_qtranslations''". | + | i) Open the generated ''terralib.sln'' solution at the folder ''C:\terralib\build-win64'' (or ''C:\terralib\build-win32''). and build the following projects: |
| + | * ''ALL_BUILD'' to build all terralib projects, including terraview application; | ||
| + | * ''terralib_qhelp'' to build the help associated with TerraView application and optionally | ||
| + | * ''terralib_qtranslations'' to generate the translations file | ||
| + | * ''terralib_doxygen'' to generate doxygen documentation. | ||
| + | |||
| - | j) To be able to debug, add to your environment variable "PATH" one of the following locations: | + | j) To be able to debug, add to your environment variable "PATH" the following: |
| - | For 32 bits: C:\terralib\terralib5-3rdparty-msvc-2010-win32\lib;C:\Qt\Qt5.3.0\5.3\msvc2010_opengl\bin or | + | For 64 bits: C:\terralib5-3rdparty-msvc-2013-win64\lib;C:\Qt\Qt5.4.1\5.4\msvc2013_64\bin |
| - | For 64 bits: C:\terralib\terralib5-3rdparty-msvc-2010-win64\lib;C:\qt5-win64\bin | + | |
| - | k) To run and debug TerraView application, set terraview module as StartUp Project at Microsoft Visual C++ 2010 or 2013. | + | k) To run and debug TerraView application, set terraview module as StartUp Project at Microsoft Visual C++ 2013. |
| - | l) To run and debug an terralib_example_* and/or terralib_unitest_* make set it as ''StartUp'' Project and make sure the data ([[@../download/download.php?FileName=data.zip|data.zip]]) used are located at the default directory: | + | l) To run and debug an terralib_example_* and/or terralib_unitest_* set it as ''StartUp'' Project and make sure the data ([[http://www.dpi.inpe.br/terralib5/data.zip| data.zip]]) used are located at the default directory specified by TERRALIB_DATA_DIR : |
| - | TERRALIB_DATA_DIR C:\terralib\build-win32\data | + | TERRALIB_DATA_DIR C:\terralib\build-win32\data or C:\terralib\build-win64\data |
| m) Make sure the default directory used to save the reports generated by the unittests exist, otherwise no report will be saved: | m) Make sure the default directory used to save the reports generated by the unittests exist, otherwise no report will be saved: | ||
| - | TERRALIB_REPORT_DIR C:\terralib\build-win32\report | + | TERRALIB_REPORT_DIR C:\terralib\build-win32\report or C:\terralib\build-win64\report |
| ==== 3) Building with CMake GUI on MacOs and Linux ==== | ==== 3) Building with CMake GUI on MacOs and Linux ==== | ||
| Line 129: | Line 128: | ||
| /home/user/terralib5 | /home/user/terralib5 | ||
| - | b) We wil assume that the build tree where will be generated the binaries is located at: | + | b) We will assume that the build tree where will be generated the binaries is located at: |
| /home/user/build_terralib5 | /home/user/build_terralib5 | ||
| Line 159: | Line 158: | ||
| i) TerraLib/TerraView can be compiled calling make for the Makefile Generator, Eclipse (for Linux) or XCode (for MacOS). | i) TerraLib/TerraView can be compiled calling make for the Makefile Generator, Eclipse (for Linux) or XCode (for MacOS). | ||
| - | j) To run and debug terralib_example_* and/or terralib_unittest_* make it the current project and make sure the data ([[@../download/download.php?FileName=data.zip|data.zip]]) used are located at the build directory: | + | j) To run and debug terralib_example_* and/or terralib_unittest_* make it the current project and make sure the data ([[http://www.dpi.inpe.br/terralib5/data.zip| data.zip]]) used are located at the build directory: |
| TERRALIB_DATA_DIR /home/user/build_terralib5/data | TERRALIB_DATA_DIR /home/user/build_terralib5/data | ||