How to: build NCL Composer from source code

For previous versions (<= 0.1.x) go to: How to build NCL Composer from source code (<= 0.1.x) tutorial.

Requirements

Getting Source Code

About Git (from sourceforge.net)

Git is a Source Code Management (SCM) tool for software developers which supports collaborative development of software within a team, and the tracking of changes to software source code over time.

Git is used by developers, and advanced users who need the very latest changes to the software (before releases occur). Software users generally do not need Git; typically they will download official file releases made available by the project instead.

Developers should familiarize themselves with Git by reading the Git Documentation.

NCL Composer's Git access

From command line, you just need to execute the following to get the NCL Composer source code: 

$ git clone http://git.telemidia.puc-rio.br/nclcomposer.git

Compiling Source Code

From command line, you just need to execute the following lines to compile the NCL Composer: 

$ qmake
$ make install
If you are compiling on Windows, you probably must change 'make' to: 
$ mingw32-make

and 'make install' to: 

$ mingw32-make install
If you are compiling on Debian (or Ubuntu, or Linux Mint, etc.), you probably must change 'make install' to: 
$ sudo make install
If you are compiling on MAC, you probably must change 'qmake' to 
$ qmake -spec macx-g++

and 'make install' to: 

$ sudo make install

Compiling with "Remote Run" feature

By default, you will not compile NCL Composer with “Remote Run” support. We do this in order to not include the libssh2 dependencies inside our source code. However, if you want to use that feature, you must to follow these steps, before compiling composer-gui subproject:

1. Get LIBSSH2 related libraries:

On Ubuntu/Debian you can install these dependencies through:
$ sudo apt-get install libssh2-1-dev libgcrypt11-dev
On Windows you can download them from:

http://composer.telemidia.puc-rio.br/downloads/deps/nclcomposer-gui-0.1.1-deps.zip

and uncompress that file inside src/gui directory. you should finish with something like that (see the to libssh folder): 

  + src
    + core
        ...
    + gui
      + data
      + deps
        + libssh2-1.3.0
      + images
      + src
      + translations
         ...
    + plugins
        ...
On Mac OS X you need first to install a software called port (http://www.macports.org/) , which is basically a package management system that simplifies the installation of software on the Mac OS X. Then you can install the dependencies with the following command: 
$ sudo port install libssh2 libgcrypt

2. Replace the qmake call above with: 

  $ qmake RUNSSHON=true

Testing

In order to test the NCL Composer, you need to execute on:

  • Windows:
$ C:\composer.exe
  • Linux
$ /usr/local/bin/composer
  • MAC OS X
$ open /Applications/Composer.app

Problems ?

If you have problems with any of the previous steps see the FAQ section, and if this does not resolve your problem, contact us.