Tutorial para configurar as bibliotecas

TerraView e Qt 3 no Visual Studio 2003.

Por: Joao Tacio

1. Introdução

Este tutorial tem o objetivo de explicar como configurar o ambiente de

programação para desenvolver aplicações utilizando a IDE Visual Studio 2003,

e as bibliotecas TerraView e Qt 3.

2. Configurar TortoiseCVS para acessar o repositório do TerraLib.

Após instalar o TortoiseCVS, crie uma pasta na raiz do disco principal, por

exemplo TerraDIR e siga os passos abaixo:

• Clique com o botão direito sobre a pasta;

• Escolha SVN Checkout;

• A figura 1 apresenta a janela que vai aparecer.

Figura 1 - Tela de Checkout

Para acessar o repositório do TerraView, é necessário informar a URL of

repository, que deverá ser usado sempre o caminho atualizado no site do

TerraView, na guia Downloads e subitem Fontes (desenvolvedor).

A figura 2 apresenta o endereço acessado no dia 21/05/2010. Este tutorial vai utilizar a versão 3-3-1.

Figura 2 – Endereço para acessar o TerraView

3. Configura a biblioteca Qt.

Qt é uma biblioteca C++ que permite que você possa programar para Windows,

Unix/Linux e Mac, de modo portável, escrevendo o código uma única vez para

esses sistemas. Atualmente essa biblioteca pertence à Nokia. Para maiores

informações consulte o site trolltech.

Crie uma pasta em C:/, com o nome de Qt3 e em seguida baixe a biblioteca

para essa pasta. Para baixar a biblioteca Qt, siga os mesmos passos utilizados

ao obter a biblioteca TerraView porém, em URL of repository, insira o caminho:

https://qtwin.svn.sourceforge.net/svnroot/qtwin/qt-3/trunk ~ 40 MB

4. Variáveis de ambiente

As variáveis de ambiente são criadas a partir da tela de propriedades do sistema. Para exibir essa tela, clique em iniciar/painel de controle/sistema. Escolha a guia avançado e em seguida clique em variáveis de ambiente, conforme é apresentado na figura 3.

Figura 3 – Variáveis de ambiente

A seguir é necessário criar duas variáveis de ambiente (de usuário), QTDIR e QMAKESPEC. A figura 4 ilustra como essas variáveis são configuradas. Atenção o valor da variável QTDIR, deverá ser o diretório do Qt, QMAKESPEC varia conforme o compilador.

Figura 4 – Variáveis QTDIR e QMAKESPEC

Após criar QTDIR e QMAKESPEC, é necessário atualizar a variável Path (de usuário). Clique sobre a variável path, escolha a opção editar e sem seguida adicione ao final a linha (;%QDIR%\bin\), apresentado na figura 5.

Nota: Observe que existe um ponto e vírgula (;) antes da linha %QDIR%\bin\.

Figura 5 – Variável de ambiente Path

5. Realizar um Build da biblioteca Qt.

O compilação (Build) será realizado usando o Prompt de Comando do Visual Studio. Clique em iniciar/programas/Microsoft Visual Studio 2003/Visual Studio Tools/Visual Studio 2003 Command Prompt.

A figura 6 apresenta o Prompt de Comando.

Figura 6 - Prompt de comando do Visual Studio

Na tela do Prompt Command digite os comando abaixo:

• cd\ e pressione Enter;

• cd Qt3 Enter;

• digite configure Enter.

Aguarde todo o Build ser realizado. O tempo aproximado são 30 minutos. Após concluir o Build digite nmake, e aguarde pouco minutos. Para certificar-se que a instalação ocorreu de maneira correta, abra o projeto t1, no endereço C:\Qt3\tutorial\t1\ t1.vcproj. Faça um Build e execute o projeto para aparecer uma tela com um botão escrito Hello Word.

5.1 Atalho para a biblioteca Qt.

Pressione com o botão direito do mouse no arquivo designer.exe, que está em C:\Qt3\bin, escolha enviar para e por fim clique em área de trabalho(criar atalho).

6 Compilando o TerraView

O projeto TerraView no Visual Studio já vem configurado com a seqüência correta que os projetos agregados a ele serão compilados, portanto para compilar o TerraView basta selecionar o menu Build/Rebuild Solution. Caso não por possível compilar o projeto por falta de alguma configuração no Visual Studio, compile os projetos na seguinte ordem abaixo:

• libjpeg;

• tiff;

• shapelib;

• terralib;

• qtw;

• libspl;

• stat;

• terralibpdi;

• terraView.

A figura 7 apresenta a maneira de compilar os projetos separadamente. Clique com o botão direito sobre o projeto, por exemplo: libjpeg e escolha Rebuild.

Figura 7 – Rebuild projeto

6.3 Compilando Plugin no TerraView

Esta sessão apresenta os passos para inserir um plugin personalizado no TerraView. Primeiramente verifique se o plugin HelloWorld está criado no projeto do TerraView. Essa verificação é feita visualizando se existem a pasta HelloWorld, no caminho C:\FullTerraib\terraViewPlugins\HelloWorld. Caso o seu projeto não possua essa pasta, veja com criar os primeiros artifícios para o plugin no tutorial do TerraView 3.3.1 , páginas 3 até 14.

A ferramenta qmake da biblioteca Qt, será usada na criação de um projeto para o Visual Studio, através do arquivo de projeto do plugin (HelloWorld.pro). A figura 9 apresenta como criar o um projeto para o Visual Studio através da tela de Prompt de Comando. Inicie a janela do prompt de comando, através do caminho: iniciar/executar/digite cmd + Enter. No prompt de comando digite C:/Qt3/bin + Enter. Informe o caminho completo do arquivo HelloWorld.pro entre aspas duplas + Enter. Consulte a figura 8, para esclarecer as dúvidas.

Figura 8 – Criar projeto para Visual Studio usando o prompt de comando

O arquivo de projeto para o Visual Studio (HelloWorld.vcproj), será criado após terminar a execução do qmake. Para visualizá-lo, entre na pasta C:\FullTerraib\terraViewPlugins\HelloWorld.

O TerraView carrega os plugin´s que estão dentro da pasta C:\FullTerraib\terraView\windows\plugins. Antes de continuar, verifique que esta pasta não contém arquivos de projetos. O próximo passo é compilar o plugin do Visual Studio. Clique duas vezes sobre o arquivo de projeto HelloWorld.vcproj no diretório C:\FullTerraib\terraViewPlugins\HelloWorld, em seguida selecione o menu Build e escolha a opção Rebuild Solution. Consulte novamente a pasta C:\FullTerraib\terraView\windows\plugins e veja que todo o resultado da compilação do projeto. Pode fechar o Visual Studio.

O plugin HelloWorld já poderá ser visto. Abra novamente a solution do TerraView, no diretório C:\FullTerraib\terraView\windows\ terraView.sln e em seguida clique sobre o menu Build/Rebuild Solution. Assim que terminar o build com sucesso, clique em start debugging e será apresentado o plugin, conforme a figura 9.

Figura 9 – Plugin para TerraView

7 Erros comuns

7.1 Não encontrou qt.lib

Não foi possível encontrar o qt.lib. Clique com o botão direito sobre o projeto que gerou o erro e selecione propriedades para exibir a figura 10.

Figura 10 – Propriedades do projeto

Selecione a tag Linker e escolha input. No lugar de \lib\qt.lib, insira \lib\qt-mt3.lib.

7.2 (...Binary was not built with debug information...)

Clique com o botão direito sobre o projeto TerraView;

Escolha propriedades;

Selecione a guia Configuration Properties/CC++/Optimization

Optimization: escolha Disabled (/Od)

Selecione a guia Linker na guia Configuration Properties/ Linker/Debugging

Debugging Debug Info: escolha Yes (/DEBUG)

7.3 Erro ao compilar projeto qwt

Descrição do erro:

qwt error PRJ0019: A tool returned an error code from "Moc'ing .\..\src\qwt\include\qwt_wheel.h..."

Verifique se as variáveis de ambiente estão corretas

Nome da variável: QTDIR

Valor da variável: Diretório que está o Qt, por exemplo C:\Qt\3.2.0

Nome da variável: QMAKESPEC

Valor da variável: win32-msvc.net (para o compilador visual studio 2003)

Em seguida procure e selecione a variável path.

Nota: Geralmente a variável que necessita ser alterada é a variável de ambiente do sistema, porém já encontrei

algumas máquinas que por algum motivo, é necessário editar a variável de ambiente do usuário.

Para alterar o conteúdo da variável path, clique sobre o botão editar e adicione ao final -> ;%QDIR%\bin\.

Não esqueça do ponto-e-vírgula antes do sinal %.

Após verificar os itens acima, compile o projeto qwt. Casoo erro persista, clique com o botão direito

sobre o projeto qtw, selecione propriedades e faça a configuração abaixo.

Guia C C++/General/Additional Include Directories

..\..\src\qwt\include;"$(QTDIR)\include"

Guia Linker/Input

$(QTDIR)\lib\qt-mt3.lib

Se esse tutorial foi útil, deixe um comentário por favor. Obrigado

Referências

Configurar Qt para Windows. Disponível em http://qtwin.sourceforge.net/qt3-win32/compile-msvc-2005.php. Acesso 21/05/2010.

TortoiseCVS. Disponível em: http://www.tortoisecvs.org. Acesso 18/05/2010.

TerraView. Disponível em: http://www.terralib.org. Acesso 18/05/2010.

Trolltec. Disponível em: hhttp://www.trolltech.com. Acesso 18/05/2010.

Visual Studio. Disponível em: http://social.msdn.microsoft.com 11-06. Acesso 15/05/2010.

Construindo um Plugin - TerraView 3.3.1. Disponível em http://www.dpi.inpe.br/terraview/php/plugins.php. Acesso 11/05/2010.

Joao Tacio/TerraLab/UFOP-MG