Compilar programas¶

El proceso de creación de un programa pasa por varias fases:

escribir el texto del programa (archivo fuente) y guardarlo
compilarlo para obtener un archivo binario ejecutable
ejecutarlo

Las labores de compilación y ejecución se pueden hacer de tres maneras:

mediante comandos, en una ventana de Terminal separada de Geany. Por ejemplo, si escribimos un programa en lenguaje C y lo guardamos como miprograma.c, podemos usar el compilador gcc, típico de sistemas Linux. El comando de compilación sería algo así como:
```
gcc -o miprograma miprograma.c
```
... lo que ejecuta el compilador gcc indicando que el archivo resultante (output) se llame miprograma, y que el fichero fuente es miprograma.c
también podemos ejecutar esos mismos comandos en la emulación de VTE de Geany
como tercera alternativa, podemos invocar los comandos desde el menú Construir de Geany.

Con esta tercera opción podemos hacer uso de los menús de Geany para lograr cosas tales como:

compilar el programa
ejecutar el programa
mostrar los errores de compilación en la ventana de mensajes
usar herramientas de análisis de sintaxis (lint)

El menú Construir se adapta al lenguaje de programación utilizado, de forma que se ocultan o muestran opciones de menú según la configuración que tengamos.

La opción Construir > Establecer comandos de construcción determina las entradas del menú y los comandos a ejecutar, tal y como los escribiríamos en un terminal de comandos.

Compilar desde Geany¶

Ejecutar los comandos desde el menú de Geany tiene varios beneficios:

El archivo actual se guarda automáticamente antes de ejecutar el comando.
Los mensajes de compilación se capturan en la ventana inferior, mostrándose en la pestaña del compilador, y se analizan en busca de advertencias o errores. Pulsando en un mensaje de error, nos lleva a la línea del programa donde se ha detectado ese problema.
Los errores de compilación se muestran en el texto del programa mediante un subrayado ondulado.

Tras analizar los fallos y reescribir el programa, puede que esos subrayados nos molesten. Podemos suprimirlos seleccionando la opción de menú Documento > Borrar indicadores de error.

Los indicadores subrayados solo se muestran si activamos la opción Editar > Preferencias > Editor > Características > Usar indicadores para mostrar errores de compilación

El menú Construir tiene una considerable flexibilidad y capacidad de configuración, adaptándose a diferentes lenguajes y necesidades del usuario. Hay cuatro tipos de elementos de menú, cada uno con un comportamiento diferente:

Comandos de compilación dependiendo del tipo de archivo. Muestran mensajes en la ventana inferior, pestaña del compilador y los analizan en busca de errores.
Comandos de compilación independientes del tipo de archivo. También capturan la salida en la pestaña del compilador.
Comandos para ejecutar el programa. Son configurables, pero el resultado no se analiza en busca de errores. Si la ejecución produce mensajes, se mostrarán en el terminal de comandos.
Comandos fijos. Realizan acciones integradas en Geany:
- Vaya al siguiente error.
- Ir al error anterior.
- Mostrar el cuadro de diálogo de configuración de comandos del menú de compilación.

El número máximo de elementos en cada uno de los grupos se puede configurar en Editar > Preferencias > Varias, usando las opciones con prefijo build. Podemos aumentar el número de elementos de menú, pero solo se mostrarán aquellos elementos que tienen un comando asociado.

Los elementos del menú se pueden configurar de cuatro formas, que por orden de prioridad son:

La configuración del proyecto, si tenemos uno abierto
Las preferencias del usuario
Las definiciones según tipo de archivo
Los valores predeterminados de Geany

Dependiendo del tipo de archivo, el menú predeterminado se divide en secciones:

Sección 1:
- Compilar
- Build (compilar + enlazar)
- Lint (analizar sintaxis)
Sección 2: ejecuta un comando make
- Make All
- Make objetivo personalizado
- Make archivo objeto
Sección 3:
- Siguiente error
- Error anterior
Ejecutar
Establecer comandos de construcción

Esta última es la que se usa para configurar los comandos a ejecutar para cada entrada de este menú.

Compilar¶

La traducción de texto a lenguaje máquina binario se denomina compilar el programa. Tendremos tres archivos, el texto escrito por nosotros (archivo fuente), el programa en formato binario (archivo objeto) y el ejecutable final, resultado de enlazar uno o varios archivos objeto.

El comando compilar tiene diferentes usos, dependiendo del tipo de archivo:

Para lenguajes compilables como C y C++, el comando está configurado para compilar el archivo fuente actual en un archivo objeto binario. Para completar la compilación + enlazado de archivos objeto, tenemos que usar la opción Build.
Los archivos fuente de Java se compilarán para obtener un archivo de clase en formato binario bytecode.
Los lenguajes interpretados como Perl, Python o Ruby son aquellos que se pueden ejecutar directamente, sin necesidad de compilar el texto fuente. De todas formas, algunos de ellos tienen la opción de compilar a formato binario bytecode. Si no es así, el comando compilar hará una verificación de sintaxis o, si no está disponible, ejecutará el archivo en modo intérprete.

El comando Build enlazará el archivo objeto correspondiente al archivo fuente actual, para obtener un archivo ejecutable. Funciona con lenguajes compilables como C y C++. Si el archivo objeto no existe, el fuente se compilará y vinculará en un único paso, generando el binario ejecutable.

Los lenguajes interpretados no utilizan el comando Build.

El proceso de compilación finalizará con un sonido de alerta si tenemos esta opción activada (menú Editar > Preferencias > General > Varios).

Make¶

Si necesitamos configuraciones complejas de compilación, o varias configuraciones alternativas, se recomienda escribir un archivo makefile con los pasos del proceso, y ejecutarlo usando un comando:

$ make

Este comando busca el archivo makefile y ejecuta los diferentes pasos.

Podemos ejecutar un paso concreto invocándolo por su nombre. Por ejemplo, si en el archivo makefile tenemos un paso llamado clean, podemos ejecutar:

$ make clean

y se ejecutaría ese paso, precedido por los relacionados en el archivo makefile (un paso puede estar condicionado a que se ejecuten otros previamente).

Cada entrada del menú de Geany ejecuta el comando make en la forma determinada por la opción de menú Establecer comandos de construcción. Por regla general:

la opción Make All ejecuta un comando make tomando todos los pasos del fichero makefile en el directorio del archivo actual.
la opción Make objetivo personalizado es similar a Make All pero se nos preguntará por uno de los pasos concretos dentro del archivo makefile.
la opción de menú Make objeto ejecutará un comando:
```
$ make archivo.o
```
cambiando "archivo" por el nombre del archivo actual.

Es útil para compilar solo el archivo actual. De todas formas, depende del contenido del archivo makefile.

Lint¶

La entrada de menú lint ejecuta un comando lint para encontrar texto en los programas que no corresponde a ciertas pautas de estilo: código no portable entre plataformas, errores comunes o difíciles de encontrar, código que "huele" mal, variables utilizadas antes de configurarse, funciones no utilizadas, división por cero, etc. Los linters inspeccionan el código y emiten advertencias. Esto se conoce formalmente como análisis de código estático.

Algunos linters comunes están preconfigurados en el menú Construir (pycodestyle para Python, cppcheck para C/C++, JSHint para JavaScript, xmllint para XML, hlint para Haskell, shellcheck para código shell, ...), pero todas estas son herramientas independientes que debemos instalar antes de usarlas.

Errores¶

Los errores de compilación se muestran en la ventana de mensajes. Pulsando en un error, se muestra la línea infractora en la ventana de edición. Las entradas de menú Construir > siguiente/anterior error permiten navegar entre errores.

Ejecutar¶

El menú Construir > Ejecutar ejecuta el programa en una ventana de terminal independiente de Geany, ejecutando un comando que se establece desde el menú Establecer comandos de construcción.

Una vez que nuestro programa o script haya terminado de ejecutarse, el script de ejecución pedirá que presionemos la tecla Enter. Esto nos permite revisar cualquier salida de texto del programa antes de que se cierre la ventana del terminal.

Alternativamente, podemos ejecutar los programas en la VTE. Establecer esta opción desde el menú Editar > Preferencias > Terminal > Ejecutar programas en la VTE.

Si usamos la ventana independiente de Terminal, tenemos que asegurarnos de que Geany tiene configurado el comando que la abre. Se puede determinar desde Editar > Preferencias > Terminal.

Detener procesos en ejecución¶

Cuando hay un programa en ejecución, el comando Ejecutar en el menú "Construir" y el icono Ejecutar en la barra de herramientas se convierten en un botón de parada para que pueda detener el programa en ejecución (y cualquier otro proceso secundario). Esto funciona internamente enviando una señal SIGQUIT al proceso.

De todas formas, es posible que el proceso no se pueda detener. Esto puede suceder, por ejemplo, cuando el proceso crea más de un proceso hijo.

Establecer comandos de construcción¶

Por defecto, compilar, compilar y ejecutar son comandos bastante básicos. Geany cuenta con comandos predeterminados, pero es posible que queramos personalizarlos. Por ejemplo, para el lenguaje C podemos agregar flags de compilación para el compilador, nombres de biblioteca, etc. tal y como lo haríamos si compilamos desde un terminal de comandos:

$ gcc -Wall -o miprograma miprograma.c -lm

La mayor parte de la configuración del menú Construir se realiza a través del cuadro de diálogo Establecer comandos de compilación.

Si tenemos un proyecto abierto, podemos establecer una configuración específica en la pestaña Construir del cuadro de diálogo Proyecto > Propiedades del proyecto.

Al pulsar en Construir > establecer comandos, la ventana de diálogo se divide en tres secciones:

Comandos de compilación según tipo de archivo.
Comandos de compilación independientes del tipo de archivo.
Comandos de ejecución según tipo de archivo.

Las secciones de tipo de archivo y de compilación independiente también contienen un campo para introducir una expresión regular a usar para mostrar mensajes de error y advertencia.

Las columnas de las primeras tres secciones permiten configurar:

el texto que se muestra en el menú
el comando a ejecutar
el directorio de trabajo para ejecutar el comando.

Un elemento con un nombre en blanco no se mostrará en el menú. Un directorio de trabajo vacío hará que se tome el directorio del documento de forma predeterminada.

Si no hay ningún documento actual, el comando no se ejecutará.

El cuadro de diálogo mostrará el comando a ejecutar según prioridades establecidas (configuración general, a nivel de proyecto, etc), no solo los comandos configurados para este tipo de archivos fuente. Esto garantiza que siempre veremos lo que hará la opción del menú si se pulsa.

Los botones de reiniciar que hay a la derecha de cada entrada, eliminan la definición que estamos editando. Cuando hagamos esto, se mostrará el comando con la siguiente prioridad.

Caracteres de sustitución en comandos y directorios¶

Antes de ejecutar el comando, la primera aparición de cada una de las siguientes secuencias de caracteres, en el texto de los comando y de los directorios de trabajo, se sustituyen por los elementos que se especifican a continuación:

%d: la ruta absoluta al directorio del archivo actual.
%e: el nombre del archivo actual sin la extensión ni la ruta.
%f: el nombre del archivo actual sin la ruta.
%p: si un proyecto está abierto, la ruta base del proyecto.
%l: el número de línea en la posición actual del cursor.

Se pueden definir atajos de teclado para:

los dos primeros elementos del menú de compilación de tipo de archivo
los primeros tres elementos del menú de construcción independiente
el primer elemento del menú de ejecución
los elementos del menú fijos (Error siguiente/anterior, Establecer comandos)

Se configura mediante el menú Editar > Preferencias > Combinaciones de teclas > Construir.

Navegación entre programas¶

Cuando estamos escribiendo un programa, el complemento Code Navigation incorpora funciones para ir de la declaración a la implementación de una función. Disponible para determinados lenguajes en el menú Editar.

Constructor de clases¶

El complemento constructor de clases es otra ayuda para escribir programas usando lenguajes que admiten una sintaxis orientada a objetos y clases. Al activarlo, pulsando en el menú Herramientas > Crear clase se abre una ventana de diálogo para generar el texto de una clase, a incorporarlo al programa.

Debugger¶

Geany proporciona un menú Construir para compilar y ejecutar programas que estamos escribiendo, pero en principio carece de las herramientas de depuración que tendríamos con un Entorno Integrado de Desarrollo (un IDE). El complemento Debugger añade una nueva pestaña Debug al panel inferior. Permite ejecutar los programas de una forma supervisada, deteniéndolos en un punto de ruptura, examinando variables, etc.

Inicialmente se basa en el depurador GDB, aunque contempla la posibilidad de usar otros depuradores.

Otro complemento es Scope Debugger, que proporciona una interfaz gráfica para GDB, con las funciones normales que esperaríamos (ejecución paso a paso, puntos de interrupción...) y algunas características añadidas. Añade una pestaña Debug al panel inferior.

Podemos ingresar cualquier comando gdb, en cualquier momento (por supuesto, para que el comando se ejecute, la herramienta gdb debe estar instalada y disponible en nuestro ordenador).