Linux Guia de Plataforma

El backend de Linux usa GTK3 (C) para todos los widgets nativos, con Cairo para dibujo personalizado. Esta escrito en C puro y compilado con GCC, proporcionando una experiencia Linux nativa que se integra con GNOME, XFCE, KDE y otros entornos de escritorio compatibles con GTK.

Vision General de la Arquitectura

Cada formulario de HarbourBuilder es un GtkWindow con un contenedor GtkFixed para controles hijos posicionados absolutamente. El backend crea widgets GTK y almacena sus punteros en una tabla de manejadores:

// gtk3_backend.c - Creacion de ventana de formulario
HB_FUNC( UI_FORMNEW )
{
   const char * cTitle = hb_parc( 1 );
   gint nWidth  = hb_parni( 2 );
   gint nHeight = hb_parni( 3 );

   GtkWidget * window = gtk_window_new( GTK_WINDOW_TOPLEVEL );
   gtk_window_set_title( GTK_WINDOW( window ), cTitle );
   gtk_window_set_default_size( GTK_WINDOW( window ), nWidth, nHeight );
   gtk_window_set_position( GTK_WINDOW( window ), GTK_WIN_POS_NONE );

   // Usar GtkFixed para posicionamiento absoluto de controles hijos
   GtkWidget * fixed = gtk_fixed_new();
   gtk_container_add( GTK_CONTAINER( window ), fixed );

   // Almacenar manejador en la tabla de objetos del lado de Harbour
   hb_retnint( (gintptr) window );
}

Manejo de Eventos (g_signal)

El backend GTK3 usa el sistema de senales de GObject (g_signal_connect()) para conectar eventos nativos de widgets a manejadores de eventos de Harbour:

// gtk3_backend.c - Vinculacion de eventos basada en senales
HB_FUNC( UI_ONEVENT )
{
   gint nHandle = hb_parnint( 1 );
   gint nEventId = hb_parnint( 2 );
   PHB_ITEM pBlock = hb_param( 3, HB_IT_BLOCK );

   GtkWidget * widget = GTK_WIDGET( GetHandlePtr( nHandle ) );

   // Almacenar el bloque de codigo Harbour
   StoreEventBlock( nHandle, nEventId, pBlock );

   // Conectar la senal GTK a nuestra funcion de despacho
   switch( nEventId )
   {
      case EVENT_CLICK:
         g_signal_connect( widget, "clicked",
                           G_CALLBACK( on_clicked_signal ),
                           GINT_TO_POINTER( nHandle ) );
         break;
      case EVENT_CHANGE:
         g_signal_connect( widget, "changed",
                           G_CALLBACK( on_changed_signal ),
                           GINT_TO_POINTER( nHandle ) );
         break;
      case EVENT_KEYDOWN:
         g_signal_connect( widget, "key-press-event",
                           G_CALLBACK( on_key_signal ),
                           GINT_TO_POINTER( nHandle ) );
         break;
   }
}

Modo Oscuro

El modo oscuro de GTK3 se controla mediante configuraciones de GTK:

• gtk-application-prefer-dark-theme — El backend establece esta propiedad GTK a TRUE cuando el sistema esta en modo oscuro. Los temas GTK3 (como Adwaita-dark) responden proporcionando esquemas de color oscuros para todos los widgets.
• Daemon de configuraciones GTK — En entornos de escritorio que lo soportan (GNOME, XFCE), GTK3 lee la preferencia del tema del sistema desde el daemon de configuraciones automaticamente.
• Sobreescritura manual — Los usuarios pueden forzar el modo oscuro estableciendo la variable de entorno:

  export GTK_THEME=Adwaita:dark

Integracion de Scintilla

En Linux, Scintilla 5.6.1 se construye como biblioteca compartida:

Scintilla se carga con dlopen() y dlsym() en tiempo de ejecucion.

Proceso de Construccion

Requisitos Previos

1. Compilador GCC:

   sudo apt install gcc g++

2. Bibliotecas de desarrollo GTK3:

   sudo apt install libgtk-3-dev

3. Harbour 3.2+ — Instala desde el gestor de paquetes de tu distribucion o construye desde el codigo fuente:

   sudo apt install harbour

Script de Construccion (build_linux.sh)

El script realiza estos pasos:

1. Verificar requisitos previos — Verifica que GCC y las cabeceras GTK3 esten disponibles.
2. Construir Scintilla — Compila las bibliotecas compartidas de Scintilla y Lexilla desde el codigo fuente.
3. Compilar codigo fuente Harbour — Ejecuta el compilador Harbour en los archivos fuente del IDE.
4. Compilar el backend — Compila gtk3_backend.c con GCC.
5. Enlazar — Enlaza todo junto con GTK3, Cairo, Pango y el runtime de Harbour.

# build_linux.sh - Sesion de construccion tipica en Ubuntu/Debian
# Instalar dependencias
sudo apt update
sudo apt install libgtk-3-dev gcc g++ harbour

# Construir
cd HarbourBuilder/samples
./build_linux.sh

# Ejecutar
../bin/hbbuilder_linux

Caracteristicas Especificas de la Plataforma

Limitaciones Conocidas

• Varianza del entorno de escritorio — Los widgets GTK3 se ven diferentes en GNOME, XFCE, KDE, etc. El backend apunta al tema Adwaita predeterminado. Otros temas pueden producir apariencias ligeramente diferentes.
• Diseno GtkFixed — El backend usa GtkFixed para posicionamiento absoluto (coincidiendo con el modelo de Windows/macOS). Esto significa que los controles no se redimensionan o reflujo automaticamente cuando cambia el tamano de la ventana. Usa el evento OnResize para diseno dinamico.
• Biblioteca compartida Scintilla — libscintilla.so debe estar en la ruta de busqueda de bibliotecas (LD_LIBRARY_PATH o /usr/local/lib). Ejecuta sudo ldconfig despues de instalar.
• Wayland — GTK3 soporta Wayland, pero algunas caracteristicas (bandeja del sistema, menus globales) pueden no funcionar bajo sesiones Wayland puras. X11 esta totalmente soportado.

Dependencias