Guia de Inicio Rapido

Comece a usar o HarbourBuilder em cinco minutos. Este guia orienta voce na criacao do seu primeiro aplicativo, de um projeto vazio a um programa nativo em execucao.

1. Crie Seu Primeiro Projeto

Inicie o HarbourBuilder e selecione Arquivo → Novo Projeto. Escolha uma pasta e um nome para o projeto. O IDE cria um arquivo .prg principal com uma definicao de formulario inicial:

#include "hbbuilder.ch"

function Main()

   local oForm

   DEFINE FORM oForm TITLE "Meu Primeiro App" ;
      SIZE 640, 480 FONT "Segoe UI", 10

   ACTIVATE FORM oForm CENTERED

return nil

Isso lhe da uma janela vazia, com tamanho de 640×480, centralizada na tela. O comando DEFINE FORM e uma macro do pre-processador xBase que cria um objeto TForm nativo nos bastidores.

2. Adicione Controles

Abra o Designer de Formularios (clique duas vezes no formulario no Gerenciador de Projetos) e use a Paleta de Componentes na parte superior do IDE para soltar controles no formulario:

1. Clique na aba Padrao na paleta.
2. Clique no icone Botao e, em seguida, clique na superficie do formulario onde deseja coloca-lo.
3. O Inspetor de Objetos a esquerda mostra as propriedades do botao — defina cPrompt como "Diga Ola".
4. Arraste um Rotulo da paleta e coloque-o acima do botao.

Cada controle que voce solta gera o codigo xBase correspondente automaticamente:

local oForm, oBtn, oLabel

DEFINE FORM oForm TITLE "Meu Primeiro App" ;
   SIZE 640, 480 FONT "Segoe UI", 10

@ 30, 50 LABEL oLabel VALUE "Bem-vindo ao HarbourBuilder" ;
   OF oForm SIZE 250, 24

@ 70, 50 BUTTON oBtn PROMPT "Diga Ola" ;
   OF oForm SIZE 120, 32

3. Trate Eventos

Selecione o botao no designer, mude para a aba Eventos no Inspetor de Objetos e clique duas vezes em OnClick. O IDE salta para o editor de codigo com um stub de metodo pronto para voce. Voce tambem pode atribuir eventos diretamente no codigo:

oBtn:OnClick := { || MsgInfo( "Ola do HarbourBuilder!" ) }

Para logica mais complexa, use um bloco de codigo que chama uma funcao:

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

static function OnBtnClick( oForm, oLabel )

   oLabel:SetValue( "Botao clicado as " + Time() )
   oForm:SetTitle( "Clicado!" )

return nil

4. Compile & Execute

Pressione F9 (ou selecione Executar → Compilar & Executar) para compilar e iniciar seu aplicativo. O HarbourBuilder executa estas etapas automaticamente:

1. Pre-processamento — expande as macros #xcommand (DEFINE FORM, BUTTON, etc.) em chamadas OOP do Harbour.
2. Compilacao — o compilador Harbour produz codigo C e, em seguida, o compilador C/C++ da plataforma gera o binario nativo.
3. Linkagem — vincula ao backend da plataforma (API Win32, Cocoa ou GTK3).
4. Execucao — inicia o executavel nativo resultante.

A saida da compilacao aparece no painel Mensagens na parte inferior. Quaisquer erros sao mostrados com referencias clicaveis de arquivo/linha que saltam diretamente para o codigo-fonte.

5. Salve Seu Projeto

Use Arquivo → Salvar Projeto (Ctrl+S) para salvar seu trabalho. O HarbourBuilder armazena metadados do projeto em um arquivo .hbp, que rastreia:

• Todos os arquivos de codigo-fonte (.prg) do projeto.
• Dados de design do formulario (posicoes de controles, propriedades, eventos).
• Configuracao de compilacao (flags do compilador, plataforma alvo, caminho de saida).
• Referencias a bibliotecas de terceiros.

O arquivo .hbp e um formato de texto simples que funciona bem com sistemas de controle de versao como o Git.

Fluxo de Trabalho de Desenvolvimento

O ciclo tipico de desenvolvimento do HarbourBuilder segue quatro estagios:

Pressione F9 a qualquer momento para ir do design a um aplicativo em execucao em segundos. Bom trabalho!