4. Iniciando y ejecutando QtCreator y QGIS

QtCreator es una IDE bastante nuevo de los creadores de la librería Qt. Con QtCreator puede construir cualquier proyecto C++, pero esta realmente optimizado para la gente que trabaja con aplicaciones basadas en Qt(4) (incluyendo aplicaciones móviles). Todo lo que describo a continuación asume que está ejecutando en Ubuntu 11.04 “Natty”.

4.1. Instalando QtCreator

Esta parte es fácil:

sudo apt-get install qtcreator qtcreator-doc

Después de instalar debería encontrarlo en su menú gnome.

4.2. Estableciendo su proyecto

Supongo que ya tiene un clon de QGIS local que contiene el código fuente y ha instalado todas las dependencias de compilación necesarias, etc. Hay instrucciones detalladas para acceso a git y instalación de dependencia.

En mi sistema he descargado el código en $HOME/dev/cpp/QGIS y el resto del artículo está escrito suponiendo esto. Debería actualizar las rutas según corresponda para su sistema local.

Al iniciar QtCreator haga:

File -> Open File or Project

Después utilice el diálogo de selección de archivos resultante para buscar y abrir este archivo:

$HOME/dev/cpp/QGIS/CMakeLists.txt

A continuación, se le pedirá una ubicación de compilación. Cree un directorio de compilación específico para que QtCreator funcione en:

$HOME/dev/cpp/QGIS/build-master-qtcreator

Probablemente es una buena idea crear directorios de compilación separados para diferentes ramas si se lo permite su espacio de disco.

A continuación, se le preguntará si tiene alguna opción de compilación de CMake para pasar a CMake. Le diremos a CMake que queremos depurar la compilación añadiendo esta opción:

-DCMAKE_BUILD_TYPE=Debug

Y esto es lo básico. Cuando termine el asistente, QtCreator empezará a escanear el árbol de fuentes para el soporte de autocompletar y hacer algunas tareas propias de fondo. Sin embargo, queremos ajustar unas cuantas cosas antes de empezar a compilar.

4.3. Configurando el entorno de compilación

Pulse en el icono “Projects” a la izquierda de la ventana de QtCreator.

Seleccione la pestaña de opciones de compilación (normalmente está activa por defecto).

Ahora queremos añadir un paso personalizado en el proceso. ¿Por qué? Porque QGIS sólo puede ejecutarse desde un directorio de instalación, no en su directorio de compilación, por lo que necesitamos asegurarnos de que está instalado donde vayamos a compilarlo. En “Build Steps”, pulse en el botón “Add Build Step” y elija la opción “Custom Process Step”.

Ahora definimos los siguientes detalles:

Enable custom process step: [yes]

Command: make

Directorio de trabajo: $HOME/dev/cpp/QGIS/build-master-qtcreator

Argumentos de comando: install

Ya está casi listo para empezar a compilar. Sólo una nota adicional: QtCreator necesita permisos de escritura en la ruta de instalación. Por defecto (que es lo que usaré) QGIS se va a instalar en /usr/local/. Para los objetivos de mi máquina de desarrollo, simplemente me he dado permisos a mi mismo de escritura en el directorio /usr/local/.

Para iniciar la compilación, pulse en el icono del martillo grande que está situado en la parte inferior izquierda de la ventana.

4.4. Estableciendo su ambiente de ejecución

Como ya mencioné anteriormente, no podemos ejecutar QGIS directamente desde el directorio de compilación, por lo que tenemos que crear un destino de ejecución personalizado para decirle a QtCreator que ejecute QGIS desde el directorio de instalación (en mi caso /usr/local/). Para hacer eso, volvamos a la pantalla de configuración de proyectos.

Seleccione ahora la pestaña “Run Settings”

Necesitamos actualizar las opciones de ejecución por defecto para cambiar de la configuración de ejecución “qgis” a una personalizada.

Para ello, pulse el botón “Add v” junto al desplegable “Run configuration” y seleccione “Custom Executable” de la parte superior de la lista.

A continuación introduzca en el área de propiedades los siguientes detalles:

Executable: /usr/local/bin/qgis

Arguments :

Working directory: $HOME

Run in terminal: [no]

Debugger: C++ [yes]

Qml [no]

A continuación pulse el botón “Rename” y proporcione a su ejecutable personalizado un nombre con significado (p.ej. “QGIS instalado”)

4.5. Ejecución y depuración

Ya está listo para ejecutar y depurar QGIS. Para establecer un punto de ruptura, abra simplemente un archivo fuente y pulse en la columna de la izquierda.

Ahora inicie QGIS en el depurador pulsando el icono con el bicho que está situado en la parte inferior izquierda de la ventana.