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
Next revision Both sides next revision
wiki:documentation:devguide:dependencies [2018/08/23 13:59]
marisa [Third party dependencies binaries for Microsot Visual C++ for Windows]
wiki:documentation:devguide:dependencies [2018/08/23 17:35]
marisa [TerraLib Developer's Guide - Third Party Dependencies]
Line 14: Line 14:
   * **Proj4** (Mandatory):​ Proj4 is available from [[http://​trac.osgeo.org/​proj]]. Make sure to have at least version 4.8.0 installed.   * **Proj4** (Mandatory):​ Proj4 is available from [[http://​trac.osgeo.org/​proj]]. Make sure to have at least version 4.8.0 installed.
  
-  * **Qt** (Optional): Make sure you have an installed Qt version 5.4.1 or later. Linux users may use any package manager to perform an easy installation. Mac OS X can use package managers such as [[http://​brew.sh|Homebrew]] or [[http://​www.macports.org|MacPorts]] in order to have an easy installation. If you prefer to install from source, download it from: [[http://​qt-project.org/​downloads]].+  * **Qt** (Optional): Make sure you have an installed Qt version 5.4.1 or 5.10.1 or later. Linux users may use any package manager to perform an easy installation. Mac OS X can use package managers such as [[http://​brew.sh|Homebrew]] or [[http://​www.macports.org|MacPorts]] in order to have an easy installation. If you prefer to install from source, download it from: [[http://​qt-project.org/​downloads]].
  
   * **QtPropertyBrowser** (Optional if Qt is not used): QtPropertyBrowser is a free and open source Qt component. We have been using a especial port of QtPropertyBrowser that you can find inside of our [[http://​www.dpi.inpe.br/​terralib5-devel/​3rdparty/​src/​ | third-party packages]] sources.\\ You can extract the qtpropertybrowser.tar.gz files using:   * **QtPropertyBrowser** (Optional if Qt is not used): QtPropertyBrowser is a free and open source Qt component. We have been using a especial port of QtPropertyBrowser that you can find inside of our [[http://​www.dpi.inpe.br/​terralib5-devel/​3rdparty/​src/​ | third-party packages]] sources.\\ You can extract the qtpropertybrowser.tar.gz files using:
Line 51: Line 51:
   ​   ​
   * **Google Test and Google Mock** (Optional): Google Test and Google Mock are available from https://​github.com/​google/​googletest. Any recent version may be used.   * **Google Test and Google Mock** (Optional): Google Test and Google Mock are available from https://​github.com/​google/​googletest. Any recent version may be used.
 +
 +  * **Python** (Optional): Python is available form https://​www.python.org/​downloads. Use 3.6.6 version.
  
 ===== Third party dependencies binaries for Microsoft Visual C++ for Windows ===== ===== Third party dependencies binaries for Microsoft Visual C++ for Windows =====
Line 87: Line 89:
  
 Copy one of the scripts (from your local codebase folder) to the same folder you have downloaded the 3rdparty package: Copy one of the scripts (from your local codebase folder) to the same folder you have downloaded the 3rdparty package:
-    * **[[https://​gitlab.dpi.inpe.br/​terralib/​terralib/​blob/​release-5.3/​install/​install-3rdparty-linux-ubuntu-14.04.sh|install-3rdparty-linux-ubuntu-14.04.sh]]** +    * **[[https://​gitlab.dpi.inpe.br/​terralib/​terralib/​blob/​release-5.4/​install/​install-3rdparty-linux-ubuntu-14.04.sh|install-3rdparty-linux-ubuntu-14.04.sh]]** 
-    * **[[https://​gitlab.dpi.inpe.br/​terralib/​terralib/​blob/​release-5.3/​install/​install-3rdparty-linux-ubuntu-16.04.sh|install-3rdparty-linux-ubuntu-16.04.sh]]**+    * **[[https://​gitlab.dpi.inpe.br/​terralib/​terralib/​blob/​release-5.4/​install/​install-3rdparty-linux-ubuntu-16.04.sh|install-3rdparty-linux-ubuntu-16.04.sh]]**
  
 Open the shell command line and call the script **install-3rdparty-linux-ubuntu-14.04.sh** (or the Ubuntu 16.04 one) setting the target to install all the stuffs from these third-party libraries and tools: Open the shell command line and call the script **install-3rdparty-linux-ubuntu-14.04.sh** (or the Ubuntu 16.04 one) setting the target to install all the stuffs from these third-party libraries and tools:
Line 132: Line 134:
  
 **Warning:​** Don't choose as target location a system folder such as //​**/​usr**//​ or //​**/​usr/​local**//​. Try some user specific folder. The best suggestion is to replace the folder named *user* by your user name. **Warning:​** Don't choose as target location a system folder such as //​**/​usr**//​ or //​**/​usr/​local**//​. Try some user specific folder. The best suggestion is to replace the folder named *user* by your user name.
 +
 +==== Microsoft Windows with Visual C++ 2017 ====
 +
 +The Microsoft Windows with Visual C++ 2017 shell script can be found in TerraLib source tree under //​**install**//​ folder.
 +
 +Follow the steps according with the branch you are working on:
 +
 +  * **develop** branch: Download the source code of all third-party libraries used by the development team:
 +    * [[http://​www.dpi.inpe.br/​terralib5-devel/​3rdparty/​src/​terralib-3rdparty-msvc17.zip|terralib-3rdparty-msvc17.zip]]
 +
 +  * **release-5.4** branch: Download the source code of all third-party libraries from the correct subdirectory named 5.4:
 +    * [[http://​www.dpi.inpe.br/​terralib5-devel/​3rdparty/​src|choose 5.4 dir]] and download terralib-3rdparty-msvc17.zip
 +  ​
 +  * Unpack it in a folder like  //​**C:/​my_win3rdparty**//​. The tree structure will be:
 +<code bash>
 +C:/​my_win3rdparty/​terralib-3rdparty-msvc17/​
 +C:/​my_win3rdparty/​build_all.bat
 +C:/​my_win3rdparty/​build_all_x64.bat
 +</​code> ​
 +
 +  * Open build_all_x64.bat and make sure TERRALIB_X64=1.
 +  * Open build_all.bat file and change the two variables to reflect your environment,​ if necessary:
 +<code bash>
 +:: Where to install the third-parties (this folder will be referenced by CMAKE when building terralib5)
 +set TERRALIB_DEPENDENCIES_DIR=C:​\terralib5-3rdparty-msvc-2017-win64
 +:: Where is the TerraLib5 codebase (git clone)
 +set TERRALIB5_CODEBASE_PATH=C:​\MyDevel\terralib5
 +</​code> ​
 +
 +  * Check if the other variables are reflecting your environment and change it when necessary
 +<code bash>
 +:: Where is cmake.exe
 +set "​CMAKE_FILEPATH=%PROGRAMFILES%\CMake\bin"​
 +:: Where is qmake.exe
 +set "​QMAKE_FILEPATH=C:​\Qt\Qt5.10.0\5.10.0\msvc2017_64\bin"​
 +:: Where is vcvars (visual studio 64 bits setting environment file (vcvars64.bat))
 +set "​VCVARS_FILEPATH=%PROGRAMFILES(x86)%\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build"​
 +:: Calling the script on TerraLib5 - is pointing to the batch file that will be called from here ( %TERRALIB5_CODEBASE_PATH%\install\install-3rdparty-msvc17.bat)
 +</​code> ​
 +
 +  * Make sure your Qt and CMake environment can be found in your PATH (it is not necessary)
 +
 +  * Disable the hibernation option on ''​Control Panel\Power Options''​
 +  ​
 +  * Run the //​**C:/​my_win3rdparty/​build_all_x64.bat**//​
 +
 +  * Check the dependencies generated at TERRALIB_DEPENDENCIES_DIR/​lib
 +
 +**Warning:​**If you need to re-run the build_all.bat,​ remove the //​**C:/​my_win3rdparty/​**//​ and unzip the //​**terralib-3rdparty-msvc17.zip**//​ file again because the script is not prepared to overwrite files generated under this folder and will crash.
 +
 +Now that you have prepared the working environment,​ please, read the [[:​wiki:​documentation:​devguide:​build|Build Instructions]] section.
 +
  
 ==== Microsoft Windows with Visual C++ 2013 ==== ==== Microsoft Windows with Visual C++ 2013 ====