Inicio rápido

"...el número de instalaciones UNIX ha aumentado a 10, y se esperan más..." Dennis Ritchie y Ken Thompson - Junio de 1972

1. Pre-requisitos
2. Descarga
3. Compilar los ejemplos
4. Crear un nuevo proyecto
5. ¿Y ahora que?

NAppGUI es un SDK para desarrollar aplicaciones o librerías en lenguaje C que funcionen en cualquier plataforma de escritorio (Windows, macOS o Linux) (Figura 1). Se puede utilizar C++ pero no es indispensable. Podemos desarrollar un programa completo utilizando únicamente ANSI-C.

Captura de una aplicación en Windows, macOS y Linux escrita en C con NAppGUI. — Figura 1: NAppGUI permite portar de manera sencilla aplicaciones escritas en ANSI C.

1. Pre-requisitos

Antes de empezar necesitas tener instaladas estas herramientas (Figura 2):

Visual Studio 2019 para compilar bajo Windows. Microsoft ofrece la versión gratuita Community para desarrolladores independientes o pequeñas empresas.
CMake. Herramienta multiplataforma para crear los proyectos de compilación de forma automática, a partir del código fuente.

Iconos de Visual Studio y CMake. — Figura 2: Visual Studio 2019 y CMake.

2. Descarga

La última versión estable del SDK está disponible en nuestro repositorio de GitHub (Listado 1). Supondremos que la copia de trabajo local está ubicada en C:\nappgui (Figura 3).

Listado 1: Clonando el repositorio de NAppGUI.

1 2	cd C:\ git clone https://github.com/frang75/nappgui.git

Captura de la copia de trabajo descargada y descomprimida. — Figura 3: Copia de trabajo lista para empezar.

inc: Ficheros de cabecera del SDK.
lib: Versiones pre-compiladas de las librerías que forman NAppGUI. La versión gratuita solo incluye soporte para Visual Studio 2019 x64.
prj: Scripts que utilizará CMake para generar los proyectos.
src: Código fuente de los ejemplos y futura ubicación de tus propios proyectos.

3. Compilar los ejemplos

Vamos a crear una solución en Visual Studio y compilar una de las aplicaciones de ejemplo.

Abrimos CMake.
Where is the source code: C:\nappgui\src.
Where to build the binaries: C:\nappgui_build. Este nuevo directorio se genera automáticamente y debe estar fuera del control de versiones.
Pulsa [Configure]. CMake te pedirá la versión del compilador. Utilizamos Visual Studio 16 2019 (Figura 4).

Captura del diálogo de CMake para establecer el generador. — Figura 4: Selección del compilador en CMake. Esta pantalla solo aparecerá la primera vez.

Pulsa [Generate] (Figura 5). Se creará la solución NAppGUI.sln en C:\nappgui_build.
Pulsa [Open Proyect] para abrir dicha solución en Visual Studio.

Captura de CMake generando la solución en Visual Studio. — Figura 5: Generación de `NAppGUI.sln` mediante CMake.

Ya dentro de Visual Studio, Build->Build Solution.
Clic derecho sobre demo/Products en el Solution Explorer y Set as StartUp Project.
Debug->Start Debugging.
Ya podemos depurar la aplicación de ejemplo Products (Figura 6).

Captura del depurador de Visual Studio ejecutando la aplicación de ejemplo. — Figura 6: Depurando ejemplos en Visual Studio.

Te recomendamos que dediques algo de tiempo a investigar, compilar y probar los ejemplos.

4. Crear un nuevo proyecto

Para crear una nueva aplicación de escritorio, abre el archivo src/CMakeLists.txt de tu copia de trabajo. Puedes acceder a él desde el proyecto ALL_BUILD en VisualStudio. Ves al final del archivo y añade esta línea:

1 2	# Your projects here! desktopApp("MyApp" "myapps/myapp" "" NRC_EMBEDDED NO)

Vuelve a pulsar [Generate] en CMake, lo que creará el proyecto en /src/myapps/myapp (Figura 7). Visual Studio detectará los cambios e importará el nuevo proyecto. Ya está listo para compilar y ejecutar (Figura 8).

Nuevo proyecto en CMake. — Figura 7: CMake ha creado y configurado el nuevo proyecto.

Captura de la aplicación recién creada. — Figura 8: Ejecutando la nueva aplicación.

Puedes ubicar los proyectos en cualquier nivel de profundidad dentro de /src. Rutas como "myapps/games/mygame" o simplemente "mygame" son perfectamente válidas.

5. ¿Y ahora que?

En Bienvenidos a NAppGUI continuamos con un detallado tutorial.
En Products tienes más detalles sobre la aplicación de ejemplo que has ejecutado.
En Nuevo proyecto verás como añadir archivos y recursos a los proyectos.
En Portabilidad mostraremos como compilar y ejecutar en macOS y Linux.
En Referencia del SDK tienes la documentación completa de las librerías y funciones.