Guia de Inicio Rapido

Ponga en marcha HarbourBuilder en cinco minutos. Esta guia lo lleva a traves de la creacion de su primera aplicacion, desde un proyecto vacio hasta un programa nativo en ejecucion.

1. Cree su Primer Proyecto

Inicie HarbourBuilder y seleccione Archivo → Nuevo Proyecto. Elija una carpeta y un nombre de proyecto. El IDE crea un archivo .prg principal con una definicion de formulario inicial:

#include "hbbuilder.ch"

function Main()

   local oForm

   DEFINE FORM oForm TITLE "Mi Primera App" ;
      SIZE 640, 480 FONT "Segoe UI", 10

   ACTIVATE FORM oForm CENTERED

return nil

Esto le da una ventana vacia, de tamano 640×480, centrada en la pantalla. El comando DEFINE FORM es una macro del preprocesador xBase que crea un objeto TForm nativo entre bastidores.

2. Agregue Controles

Abra el Disenador de Formularios (doble clic en el formulario en el Gestor de Proyectos) y use la Paleta de Componentes en la parte superior del IDE para soltar controles en el formulario:

1. Haga clic en la pestania Estandar en la paleta.
2. Haga clic en el icono Boton, luego haga clic en la superficie del formulario donde desee colocarlo.
3. El Inspector de Objetos a la izquierda muestra las propiedades del boton; establezca cPrompt en "Say Hello".
4. Arrastre una Etiqueta desde la paleta y coloquela encima del boton.

Cada control que suelta genera el codigo xBase correspondiente automaticamente:

local oForm, oBtn, oLabel

DEFINE FORM oForm TITLE "Mi Primera App" ;
   SIZE 640, 480 FONT "Segoe UI", 10

@ 30, 50 LABEL oLabel VALUE "Bienvenido a HarbourBuilder" ;
   OF oForm SIZE 250, 24

@ 70, 50 BUTTON oBtn PROMPT "Say Hello" ;
   OF oForm SIZE 120, 32

3. Maneje Eventos

Seleccione el boton en el disenador, cambie a la pestania Eventos en el Inspector de Objetos y haga doble clic en OnClick. El IDE lo lleva al editor de codigo con un esqueleto de metodo listo para usar. Tambien puede asignar eventos directamente en el codigo:

oBtn:OnClick := { || MsgInfo( "Hola desde HarbourBuilder!" ) }

Para logica mas compleja, use un bloque de codigo que llame a una funcion:

oBtn:OnClick := { || OnBtnClick( oForm, oLabel ) }

static function OnBtnClick( oForm, oLabel )

   oLabel:SetValue( "Boton pulsado a las " + Time() )
   oForm:SetTitle( "Pulsado!" )

return nil

4. Compilar y Ejecutar

Presione F9 (o seleccione Ejecutar → Compilar y Ejecutar) para compilar e iniciar su aplicacion. HarbourBuilder realiza estos pasos automaticamente:

1. Preprocesar — expande las macros #xcommand (DEFINE FORM, BUTTON, etc.) en llamadas Harbour OOP.
2. Compilar — el compilador Harbour produce codigo C, luego el compilador C/C++ de la plataforma genera el binario nativo.
3. Enlazar — enlaza con el backend de la plataforma (Win32 API, Cocoa o GTK3).
4. Ejecutar — lanza el ejecutable nativo resultante.

La salida de compilacion aparece en el panel Mensajes en la parte inferior. Cualquier error se muestra con referencias de archivo/linea en las que se puede hacer clic para ir directamente al fuente.

5. Guarde su Proyecto

Use Archivo → Guardar Proyecto (Ctrl+S) para guardar su trabajo. HarbourBuilder almacena los metadatos del proyecto en un archivo .hbp, que rastrea:

• Todos los archivos fuente (.prg) en el proyecto.
• Datos de diseno del formulario (posiciones de controles, propiedades, eventos).
• Configuracion de compilacion (banderas del compilador, plataforma objetivo, ruta de salida).
• Referencias a bibliotecas de terceros.

El archivo .hbp es un formato de texto plano que funciona bien con sistemas de control de versiones como Git.

Flujo de Trabajo de Desarrollo

El ciclo tipico de desarrollo de HarbourBuilder sigue cuatro etapas:

Presione F9 en cualquier momento para pasar del diseno a una aplicacion en ejecucion en segundos. Feliz construccion!