Guia de Instalacion

HarbourBuilder funciona en Windows, macOS y Linux. Esta guia cubre la instalacion para todas las plataformas.

Requisitos del Sistema

Plataforma	Minimo	Recomendado	Compilador
Windows	Windows 10, 2 GB RAM	Windows 11, 4 GB RAM	MSVC 2022 o BCC 7.7
macOS	macOS 12+, 2 GB RAM	macOS 14+, 4 GB RAM	Xcode CLT (Clang)
Linux	GTK3, 2 GB RAM	GTK3, 4 GB RAM	GCC 11+

Instalacion en Windows

Requisitos previos

1. Harbour 3.2+ — Descarga desde harbour.github.io o usa binarios precompilados
2. Compilador C — Elige uno:
   • MSVC (recomendado): Visual Studio 2022 Community (gratis) o Build Tools
   • BCC: Embarcadero Borland C++ Compiler 7.7 (gratis)

Paso a paso

1. Clonar el repositorio:

   git clone https://github.com/yourusername/HarbourBuilder.git
   cd HarbourBuilder

2. Establecer la ruta de Harbour (si aun no esta en PATH):

   set HBDIR=C:\harbour

3. Ejecutar el script de construccion:

   build_win.bat

   Esto compila Harbour (si es necesario), Scintilla y el IDE.
4. Ejecutar el IDE:

   bin\hbbuilder_win.exe

Instalacion en macOS

Requisitos previos

1. Xcode Command Line Tools:

   xcode-select --install

   Este es el unico requisito previo. Harbour y Scintilla se descargan y compilan automaticamente.

Paso a paso

1. Navegar a samples:

   cd HarbourBuilder/samples

2. Ejecutar el script de construccion:

   ./build_mac.sh

   En la primera ejecucion, este script:
   • Clona y compila Harbour en ~/harbour (si no se encuentra)
   • Construye Scintilla 5.5.3 + bibliotecas estaticas Lexilla desde el codigo fuente
   • Compila el IDE de HarbourBuilder
3. Copiar a bin/ y ejecutar:

   cp HbBuilder ../bin/
   ../bin/HbBuilder

Instalacion en Linux

Requisitos previos

1. Harbour 3.2+ — Instala desde el gestor de paquetes o compila desde el codigo fuente
2. Bibliotecas de desarrollo GTK3:

   sudo apt install libgtk-3-dev

3. Compilador GCC:

   sudo apt install gcc g++

4. Scintilla — Se construye automaticamente con el script de construccion

Paso a paso (Ubuntu/Debian)

1. Instalar dependencias:

   sudo apt update
   sudo apt install libgtk-3-dev gcc g++ harbour

2. Navegar a samples:

   cd HarbourBuilder/samples

3. Ejecutar el script de construccion:

   ./build_linux.sh

4. Ejecutar el IDE:

   ../bin/hbbuilder_linux

Configuracion de Scintilla

Scintilla es el componente de edicion de codigo utilizado por HarbourBuilder. La configuracion varia segun la plataforma:

Plataforma	Metodo	Archivos
Windows	Bibliotecas dinamicas	Scintilla.dll, Lexilla.dll en bin/
macOS	Bibliotecas estaticas	libscintilla.a, liblexilla.a (compilados desde el codigo fuente)
Linux	Bibliotecas compartidas	libscintilla.so, liblexilla.so

Los scripts de construccion se encargan de Scintilla automaticamente — no necesitas compilarlo manualmente a menos que quieras una version personalizada.

Verificar la Instalacion

Despues de la instalacion, verifica que todo funciona:

1. Iniciar el IDE: Debe abrirse sin errores
2. Crear un nuevo proyecto: Archivo > Nuevo proyecto
3. Presionar F9: Debe compilar y ejecutar un formulario simple
4. Probar el disenador: Arrastra un boton desde la paleta al formulario
5. Probar el editor: Abre la pestana de codigo, verifica que el resaltado de sintaxis funciona

Solucion de problemas

Problema	Causa	Solucion
"harbour: comando no encontrado"	Harbour no esta en PATH	Establece la variable de entorno HBDIR o agrega Harbour a PATH
"gtk/gtk.h: No existe tal archivo"	Faltan las cabeceras de desarrollo GTK3	Instala libgtk-3-dev (Linux) o Xcode CLT (macOS)
"Scintilla no encontrado"	No se han compilado las bibliotecas de Scintilla	Ejecuta el script de construccion de tu plataforma (build_win.bat, build_mac.sh, build_linux.sh)
La compilacion falla en Windows	No se detecta el compilador	Ejecuta build_win.bat o usa Herramientas > Seleccionar compilador
El IDE no se inicia en macOS	Gatekeeper lo esta bloqueando	Clic derecho > Abrir, o elimina la cuarentena: xattr -d com.apple.quarantine HbBuilder
El modo oscuro no funciona	El tema del sistema no esta configurado	Asegurate de que tu sistema operativo este en modo oscuro; HarbourBuilder sigue el tema del sistema

Siguientes pasos

Una vez instalado, continua con:

• Guia de inicio rapido — Crea tu primera aplicacion
• Vision general de la arquitectura — Comprende como funciona HarbourBuilder
• Tutorial Hola Mundo — Guia paso a paso para principiantes