TerraLib and TerraView Wiki Page

TerraLib and TerraView - Working Environment

Tools

The basic tools you have to install in your environment to work with TerraLib and TerraView are:

SoftwareVersionWebsite
Git ​ Latest http://git-scm.com/
CMake ​ 3.11 http://www.cmake.org/cmake
Qt​ 5.10.1 https://download.qt.io/archive/qt/5.10/5.10.1/1)

The following tools are optional, and their use is described below:

SoftwareWebsiteFunction
TortoiseGIThttp://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 split into several modules providing different functionality, therefore, each have a particular set of dependencies. Microsoft Visual Studio 2013/2017 C++ users can download and unpack the suitable third-party libraries compiled for building 64-bit version of TerraLib with Qt5.4.1/Qt5.10 support.

Copy the right one from the links below or access all of them at http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/

Alternatively, developers working on specific branches improving functionalities, correcting 3rdparty, fixing bugs on “RELEASE-5.Y” branch and so on must take the third party currently used from:

Branch3rdparty Zip Comments
DEVELOPhttp://www.dpi.inpe.br/terralib5-devel/3rdparty/bin Pick the 3rdparty here
release-5.Yhttp://www.dpi.inpe.br/terralib5-devel/3rdparty/bin Go to the corresponding directory '5.Y' to pick up the right 3rdparty

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 .

1) copy and install this file qt-opensource-windows-x86-5.10.1.exe at C:/Qt and selecting Visual 2017
2) Also, it is used to run your application inside Visual Studio, after ALL_BUILD. Set the debugging environment to terraview 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