Guia de Instalacao

O HarbourBuilder roda em Windows, macOS e Linux. Este guia cobre a instalacao para todas as plataformas.

Requisitos do Sistema

Plataforma	Minimo	Recomendado	Compilador
Windows	Windows 10, 2 GB RAM	Windows 11, 4 GB RAM	MSVC 2022 ou 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+

Instalacao no Windows

Pre-requisitos

1. Harbour 3.2+ — Baixe em harbour.github.io ou use binarios pre-compilados
2. Compilador C — Escolha um:
   • MSVC (recomendado): Visual Studio 2022 Community (gratuito) ou Build Tools
   • BCC: Embarcadero Borland C++ Compiler 7.7 (gratuito)

Passo a Passo

1. Clone o repositorio:

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

2. Defina o caminho do Harbour (se ainda nao estiver no PATH):

   set HBDIR=C:\harbour

3. Execute o script de build:

   build_win.bat

   Isso compila o Harbour (se necessario), Scintilla e o IDE.
4. Execute o IDE:

   bin\hbbuilder_win.exe

Instalacao no macOS

Pre-requisitos

1. Xcode Command Line Tools:

   xcode-select --install

   Este e o unico pre-requisito. O Harbour e o Scintilla sao baixados e compilados automaticamente.

Passo a Passo

1. Navegue ate samples:

   cd HarbourBuilder/samples

2. Execute o script de build:

   ./build_mac.sh

   Na primeira execucao, este script ira:
   • Clonar e compilar o Harbour para ~/harbour (se nao encontrado)
   • Compilar Scintilla 5.5.3 + Lexilla como bibliotecas estaticas a partir do codigo fonte
   • Compilar o IDE do HarbourBuilder
3. Copie para bin/ e execute:

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

Instalacao no Linux

Pre-requisitos

1. Harbour 3.2+ — Instale pelo gerenciador de pacotes ou compile do codigo fonte
2. Bibliotecas de desenvolvimento GTK3:

   sudo apt install libgtk-3-dev

3. Compilador GCC:

   sudo apt install gcc g++

4. Scintilla — Compilado automaticamente pelo script de build

Passo a Passo (Ubuntu/Debian)

1. Instale as dependencias:

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

2. Navegue ate samples:

   cd HarbourBuilder/samples

3. Execute o script de build:

   ./build_linux.sh

4. Execute o IDE:

   ../bin/hbbuilder_linux

Configuracao do Scintilla

O Scintilla e o componente de edicao de codigo usado pelo HarbourBuilder. A configuracao varia por plataforma:

Plataforma	Metodo	Arquivos
Windows	Bibliotecas dinamicas	Scintilla.dll, Lexilla.dll em bin/
macOS	Bibliotecas estaticas	libscintilla.a, liblexilla.a (compilados do codigo fonte)
Linux	Bibliotecas compartilhadas	libscintilla.so, liblexilla.so

Os scripts de build cuidam do Scintilla automaticamente — voce nao precisa compila-lo manualmente a menos que queira uma versao customizada.

Verificando a Instalacao

Apos a instalacao, verifique se tudo funciona:

1. Inicie o IDE: Deve abrir sem erros
2. Crie um novo projeto: Arquivo > Novo Projeto
3. Pressione F9: Deve compilar e executar um formulario simples
4. Teste o designer: Arraste um botao da paleta para o formulario
5. Teste o editor: Abra a aba de codigo, verifique se o destaque de sintaxe funciona

Solucao de Problemas

Problema	Causa	Solucao
"harbour: comando nao encontrado"	Harbour nao esta no PATH	Defina a variavel de ambiente HBDIR ou adicione o Harbour ao PATH
"gtk/gtk.h: Arquivo inexistente"	Cabecalhos GTK3 ausentes	Instale libgtk-3-dev (Linux) ou Xcode CLT (macOS)
"Scintilla nao encontrado"	Bibliotecas Scintilla nao compiladas	Execute o script de build da plataforma (build_win.bat, build_mac.sh, build_linux.sh)
Falha no build no Windows	Compilador nao detectado	Execute build_win.bat ou use Ferramentas > Selecionar Compilador
IDE nao inicia no macOS	Gatekeeper bloqueando	Clique direito > Abrir, ou remova a quarentena: xattr -d com.apple.quarantine HbBuilder
Modo escuro nao funciona	Tema do SO nao configurado	Verifique se o SO esta em modo escuro; o HarbourBuilder segue o tema do sistema

Proximos Passos

Uma vez instalado, continue com:

• Guia de Inicio Rapido — Crie sua primeira aplicacao
• Visao Geral da Arquitetura — Entenda como o HarbourBuilder funciona
• Tutorial Hello World — Guia passo a passo para iniciantes