Iniciando no QT, parte III – qmake e .pro
Neste terceiro post sobre QT vamos falar do utilitário qmake e dos arquivos de projeto *.pro. Vamos entender para que serve o qmake e como configurar diferentes tipos de projetos.
O qmake
O qmake é um utilitário que acompanha o framework QT. Sua função é parsear um arquivo de projeto (*.pro) e gerar um Makefile já com as regras do moc, uic e opções do QT embutidas. Sem ele por exemplo, teríamos que chamar o moc explicitamente para criar os arquivos moc_* e passar explicitamente para o compilador e linker, as opções corretas para incluir o QT aos nossos projetos.
A documentação oficial sobre o qmake e arquivos de projeto, pode ser encontrada aqui.
Arquivos de projeto *.pro
Para criar um arquivo de projeto simples pela linha de comando, entramos no diretório do projeto e digitamos:
user@host$ qmake -project
Feito isso, será criado um arquivo com o mesmo nome do diretório corrente, seguido da extensão .pro. Caso já existam nesse diretório arquivos reconhecidos pelo qmake, como arquivos de códigos fontes (.h, .cpp), forms (.ui), etc, eles serão automaticamente adicionados ao arquivo de projeto.
Criado o arquivo .pro, ao executarmos qmake sem argumentos ele tentará parsear um arquivo .pro com o mesmo nome do diretório corrente. Você ainda pode especificar um arquivo de projeto alternativo como argumento para o qmake. Se tudo deu certo, um arquivo Makefile foi criado, e com um simples make, podemos compilar o projeto.
Os arquivos de projeto são arquivos de texto normais, contendo macros e diretivas que serão interpretadas pelo qmake para criar o Makefile. A lista completa de opções pode ser encontrada na documentação online. As mais comuns são:
TEMPLATE: Indicam o tipo de projeto. Use ‘app’ para proramas executáveis ou ‘lib’ para criar bibliotecas.
CONFIG: Adicionam opções diversas ao projeto. Entre elas, ‘debug’ para adicionar informações de depuração, ‘staticlib’ em conjunto com o template ‘lib’, para que abiblioteca criada seja estática (.a no linux).
TARGET: O nome e a localização do alvo, ou seja, do aplicativo ou biblioteca.
MOC_DIR: Diretório onde serão grados os arquivos moc_*. Útil para não poluir o diretório de códigos fontes.
OBJECTS_DIR: Complementar à opção anterior, indica o diretório onde serão gerados os aquivos de código objeto (*.o).
INCLUDEPATH: Diretórios externos onde existem headers que serão utilizados no projeto, como headers de bibliotecas externas.
DEPENDPATH: Diretórios de códigos fontes externos que serão utilizados pelo projeto.
HEADERS: Os arquivos de cabeçalho do projeto (*.h).
FORMS: arquivos de interface gerados com o QtDesigner (*.ui).
SOURCES: Os arquivos de implementação de código fonte do projeto (*.cpp).
LIBS: Bibliotecas externas utilizadas pelo projeto. -L indica o path para a biblioteca, e -l diz o nome da biblioteca.
QT: Módulos do QT que devem ser adicionados/excluidos do projeto. Se for passado ‘QT =’ (QT igual vazio), nenhum módulo QT será utilizado no projeto.
SUBDIRS: Utilizado em conjunto com o template ‘subdirs’, indica os subdiretórios ons o qmake deve procurar por outros arquivos de projeto.
Com isso em mãos podemos criar algums projetos simples.
Um aplicativo simples:
# O primeiro caracter desta linha cria um comentário
# O nome deste arquivo é 'app.pro'
TEMPLATE = app # Nosso template é um aplicativo chamado
TARGET = bin/myapp.bin # myapp.bin, dentro do dir ./bin
MOC_DIR = tmp/moc # Diretório para mocs, opcional
OBJECTS_DIR = tmp/obj # Diretório para código objeto, opcional
HEADERS += myclass.h # Header da classe MyClass
SOURCES += main.cpp # Utilize para organizar os arquivos em
myclass.cpp # várias linhas.Uma biblioteca simples:
# O nome deste arquivo é 'lib.pro' TEMPLATE = lib # Nosso template é uma biblioteca CONFIG += dll # dinâmica, chamada TARGET = lib/mylib # mylib, dentro do dir ./lib MOC_DIR = tmp/moc # Diretório para mocs, opcional OBJECTS_DIR = tmp/obj # Diretório para código objeto, opcional HEADERS += myclass.h # Header da classe MyClass SOURCES += myclass.cpp # Implementação da classe MyClass
Um aplicativo que usa uma biblioteca externa:
# O nome deste arquivo é 'mixed.pro' TEMPLATE = app # Nosso template é um aplicativo chamado TARGET = bin/myapp.lkd # myapp.lkd, dentro do dir ./bin MOC_DIR = tmp/moc # Diretório para mocs, opcional OBJECTS_DIR = tmp/obj # Diretório para código objeto, opcional INCLUDEPATH += . # Dir onde estão os Headers da lib externa SOURCES += main.cpp # Implementação do aplicativo.
Diretórios aninhados:
Para utilizarmos diretórios aninhados, precisamos de um arquivo de projeto no diretório atual, e outro no subdiretório.
No diretório atual, utilizamos as opções:
TEMPLATE = subdirs SUBDIRS = [lista de subdirs para serem compilados em sequência]
Caso seja fornecido apenas o nome do diretório, ele precisa conter uma arquivo de projeto com o seu próprio nome. É possível no entando, informar diretamente na lista de subdiretórios, um diretório seguido por um arquivo de projeto com quaquer nome.
O código fonte completo dos exemplos abordados neste tutorial pode ser encontrado aqui.
Concluindo
O qmake é uma ferramenta simples e muito poderosa que facilita enormemente a vida de quem tem de gerenciar aŕvores de projeto complexas, mesmo que o projeto não utilize QT (basta acrescentar no final a opção ‘QT = ‘). Adicione a isso o fato de os arquivos de projeto terem uma sintaxe bastante simples e até certo ponto intuitiva. Se você precisar de ajustes mais finos, a documentação online lhe dará uma dezena de opções para se divertir.
Com QT ou sem QT, o qmake é sempre uma boa opção para gerenciamento de árvore de build.
Comments
Translator
