SDK Multiplataforma en C logo

SDK Multiplataforma en C

Inicio rápido

Siguiente ❯

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


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.
Siguiente ❯