TerraLib and TerraView Wiki Page

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
wiki:terralib50_build [2015/05/29 17:51]
marisa [1. Build instructions on Linux with g++ (GNU gcc)]
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_qhelp
   $ make terralib_qtranslations   $ make terralib_qtranslations
Line 66: Line 62:
 -------------------------- --------------------------
  
-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 2013, obtained from +b) We will assume that the suitable ​third party libraries, obtained from 
-   ​http://​www.dpi.inpe.br/​terralib5-devel/​terralib5-3rdparty-msvc-2013-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-2013-win64.zip +
-   +
 are located at: are located at:
        
-   ​C:​\terralib\terralib5-3rdparty-msvc-2013-win32 
-   or 
    ​C:​\terralib\terralib5-3rdparty-msvc-2013-win64    ​C:​\terralib\terralib5-3rdparty-msvc-2013-win64
 +            (or C:​\terralib\terralib5-3rdparty-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++ 2013 (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):​
Line 98: Line 90:
   * Qt CMake => look for the Qt dir containing ''​Qt5Config.cmake''​   * Qt CMake => look for the Qt dir containing ''​Qt5Config.cmake''​
  
-Example for win64: Press ''​AddEntry''​ button and inform the name ''​CMAKE_PREFIX_PATH'',​ type ''​PATH''​ and set its value as:    +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:/​terralib5-3rdparty-msvc-2013-win64;​C:/​Qt/​Qt5.4.1/​5.4/​msvc2013_64/​lib/​cmake/​Qt5+   ​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-2013-win32;​C:/​Qt/​Qt5.3.0/​5.3/​msvc2010_opengl/​lib/​cmake/​Qt5 ​- not maintained. +   ​CMAKE_PREFIX_PATH => C:/​terralib/​terralib5-3rdparty-msvc-2013-win32;​C:/​Qt/​Qt5.3.0/​5.3/​msvc2010_opengl/​lib/​cmake/​Qt5
- +
-Note that for 32 bits it is necessary to include the path for Microsoft SDK  => look for the dir containing include/​glu.h)  ​+
  
 h) Then press "''​Configure''"​ and choose: h) Then press "''​Configure''"​ and choose:
Line 114: 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-win64''​ or ''​C:​\terralib\build-win32''​. ​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"​ the following: j) To be able to debug, add to your environment variable "​PATH"​ the following:
Line 121: Line 117:
 k) To run and debug TerraView application,​ set terraview module as StartUp Project at Microsoft Visual C++ 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 specified by TERRALIB_DATA_DIR :   +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 ​    ​or ​  ​C:​\terralib\build-win64\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:
Line 162: 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