===== 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.18.0| http://www.cmake.org/cmake|
|Qt|​ 5.12.3| https://download.qt.io/archive/qt/5.12/5.12.3//((copy and install this file ''qt-opensource-windows-x86-5.12.3.exe'' at C:/Qt and selecting Visual 2017))|


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: [[ http://git-scm.com/downloads| 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.6.4, 5.6.5 | [[http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib-5.6.4-and-5.6.5-3rdparty-msvc-2017-win64.zip| terralib-5.6.4-and-5.6.5-3rdparty-msvc-2017-win64]]|
|2017| Qt5.12.3| 5.6.0, 5.6.1, 5.6.3 | [[http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib-5.6.1-upto-5.6.3-3rdparty-msvc-2017-win64.zip| terralib-5.6.1-upto-5.6.3-3rdparty-msvc-2017-win64]]|
|2017| Qt5.12.3| 5.5.2 | [[http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib-5.5.2-3rdparty-msvc-2017-win64.zip| terralib-5.5.2-3rdparty-msvc-2017-win64]]|
|2017| Qt5.12.3| 5.5.1 | [[http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib-5.5.1-3rdparty-msvc-2017-win64.zip| terralib-5.5.1-3rdparty-msvc-2017-win64]]|
|2017| Qt5.12.3| 5.5.0 | [[http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib-5.5.0-3rdparty-msvc-2017-win64.zip| terralib-5.5.0-3rdparty-msvc-2017-win64]]|
|2017| Qt5.10.1| 5.4.3, 5.4.2 | [[http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib-5.4.3-and-5.4.2-3rdparty-msvc-2017-win64.zip| terralib-5.4.3-and-5.4.2-3rdparty-msvc-2017-win64]]|
|2017| Qt5.10.1| 5.4.1 | [[http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib-5.4.1-3rdparty-msvc-2017-win64.zip| terralib-5.4.1-3rdparty-msvc-2017-win64]]|
|2017| Qt5.10.1| 5.4.0 | [[http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib-5.4.0-3rdparty-msvc-2017-win64.zip| terralib-5.4.0-3rdparty-msvc-2017-win64]]|
|2013| Qt5.4.1| 5.3.x | [[http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib-5.3.3and5.3.2and5.3.1and5.3.0-3rdparty-msvc-2013-win64.zip| terralib-5.3.3and5.3.2and5.3.1and5.3.0-3rdparty-msvc-2013-win64]]|
|2013| Qt5.4.1| 5.2.4 | [[http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/terralib-5.2.4-3rdparty-msvc-2013-win64.zip|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.((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.12.3\5.12.3\msvc2017_64\bin))

MacOS and Linux users can check the [[wiki:documentation:devguide:dependencies]] document. 

Once the environment is ready you can [[wiki:documentation:devguide:cloning|clone]] terralib source code and build the library.  Alternatively, you can download the source code from a [[wiki:documentation:devguide:cloning#getting_the_source_code_from_compressed_files|zip file ]].