This is an old revision of the document!
Table of Contents
TerraLib and TerraView - Working Environment
Tools
The basic tools you have to install in your environment to work with TerraLib and TerraView are:
| Software | Version | Website |
|---|---|---|
| Git | Latest | http://git-scm.com/ |
| CMake | 3.11 | http://www.cmake.org/cmake |
| Qt | 5.12.3 | https://download.qt.io/archive/qt/5.12/5.12.3//1) |
The following tools are optional, and their use is described below:
| Software | Website | Function |
|---|---|---|
| TortoiseGIT | http://code.google.com/p/tortoisegit | General User Interface that makes it easier to use GIT on Windows |
| Git-Cola | http://git-cola.github.io/downloads.html | General User Interface that makes it easier to use GIT on Unix platforms |
| Doxygen | http://sourceforge.net/projects/doxygen/ | used to generate the documentation |
Installing and configuring GIT
Install the latest Git version from: GIT
Follow the default settings, except at:
- Select Components: click Windows Explorer Integration, Git Bash, Git GUI.
- Adjusting you PATH environment: Click third option (Run Git and included Unix Tools …)
- Configuring the line ending conversions: click the first option (Checkout Windows-style, commit Unix-style line endings)
Dependencies
The TerraLib library is splitted into several modules providing different functionality, therefore, each have a particular set of dependencies. Microsoft Visual Studio 2017 C++ users can download and unpack the suitable third-party libraries compiled for building 64-bit version of TerraLib with Qt 5.12.3 support or previous.
Copy the right one from the links below or access all of them at http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/
| MSVC C++ | QT | TerraView Tags | 3rdparty Zip |
|---|---|---|---|
| 2017 | Qt5.12.3 | 5.5.2 | terralib-5.5.2-3rdparty-msvc-2017-win64 |
| 2017 | Qt5.12.3 | 5.5.1 | terralib-5.5.1-3rdparty-msvc-2017-win64 |
| 2017 | Qt5.12.3 | 5.5.0 | terralib-5.5.0-3rdparty-msvc-2017-win64 |
| 2017 | Qt5.10.1 | 5.4.3, 5.4.2 | terralib-5.4.3-and-5.4.2-3rdparty-msvc-2017-win64 |
| 2017 | Qt5.10.1 | 5.4.1 | terralib-5.4.1-3rdparty-msvc-2017-win64 |
| 2017 | Qt5.10.1 | 5.4.0 | terralib-5.4.0-3rdparty-msvc-2017-win64 |
| 2013 | Qt5.4.1 | 5.3.x | terralib-5.3.3and5.3.2and5.3.1and5.3.0-3rdparty-msvc-2013-win64 |
| 2013 | Qt5.4.1 | 5.2.4 | terralib-5.2.4-3rdparty-msvc-2013-win64 |
Alternatively, software developers can be working on specific branches improving functionalities, adjusting 3rdparty or fixing any kind of small bugs. In this case, to take the right third party used by an specific branch go to one of the links bellow:
| Branch | 3rdparty Zip | Comments |
|---|---|---|
| DEVELOP | http://www.dpi.inpe.br/terralib5-devel/3rdparty/bin | Pick the 3rdparty here |
| release-5.Y | http://www.dpi.inpe.br/terralib5-devel/3rdparty/bin/ | Go to the branch directory '5.Y' to pick up the right 3rdparty(Y=1,2,3…,n) |
The third party dependencies must be uncompressed in a local directory, for example C:\TL5\. After that all dependencies will be at C:\TL5\terralib5-3rdparty-msvc-2017-win64. This location should be part of CMAKE_PREFIX_PATH (CMake tool) when configuring your environment.2)
MacOS and Linux users can check the dependencies document.
Once the environment is ready you can clone terralib source code and build the library. Alternatively, you can download the source code from a zip file .
qt-opensource-windows-x86-5.12.3.exe at C:/Qt and selecting Visual 2017terraview project, Properties→Configuration Properties→Debugging, set the Environment as PATH=C:\TL5\terralib5-3rdparty-msvc-2017-win64\lib;C:\Qt\Qt5.10.1\5.10.1\msvc2017_64\bin
