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. Instalación
3. Compilar los ejemplos
4. Crear un nuevo proyecto
5. ¿Y ahora que?

NAppGUI es un SDK para desarrollar proyectos software 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. Instalación

Lo único que tienes que hacer es descomprimir el .zip con la última versión o clonar el repositorio GitHub. En él se encuentran las cuatro carpetas que conformarán tu copia de trabajo local (Figura 3). Supondremos que están ubicadas en el directorio C:\nappgui.

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.
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. Ves al final del archivo y añade esta línea:

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

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 el 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 daremos información detallada sobre la migración y compilación multiplataforma.
En Referencia del SDK tienes la documentación completa de las librerías y funciones.