Instalação

Este guia conduz você pelo processo de instalação do FiveWin for Harbour (FWH) e pela verificação de que seu ambiente de desenvolvimento está pronto para construir aplicações Windows.

Requisitos do Sistema

Componente Mínimo Recomendado
Sistema Operacional Windows 7 SP1 Windows 10 / 11
Compilador Harbour Harbour 3.2.0 Harbour 3.2.0 (último nightly)
xHarbour (alternativa) xHarbour 1.2.3 xHarbour 1.3+ (último build)
Compilador C Qualquer um: BCC 5.5+, MSVC 2017+ ou MinGW GCC 8+ MSVC 2022 (64-bit)
Espaço em Disco 200 MB 500 MB (com exemplos e documentação)
RAM 2 GB 4 GB+

Fluxo de Instalação

flowchart LR A["Download FWH
from fivetech.com"] --> B["Run Installer
or Unzip"] B --> C["Set Environment
Variables"] C --> D["Install Harbour
Compiler"] D --> E["Install C Compiler
(BCC/MSVC/GCC)"] E --> F["Run First
Test Build"] F --> G{"Build OK?"} G -- Yes --> H["Ready to
Develop!"] G -- No --> I["Check Paths
& Libraries"] I --> F

Download e Instalação

Passo 1: Obter o FiveWin

Baixe o pacote mais recente do FiveWin for Harbour em fivetech.com. Você receberá um instalador auto-extraível ou um arquivo ZIP.

Passo 2: Instalar o Harbour

Se você ainda não tem o Harbour instalado, baixe-o em github.com/harbour/core ou use uma distribuição binária pré-compilada. Uma instalação típica do Harbour fica em C:\harbour. 

// Verify Harbour is installed:
C:\> harbour --version
Harbour 3.2.0dev (r2104281802)

Passo 3: Instalar um Compilador C

Escolha um ou mais dos seguintes compiladores:

Compilador Fonte de Download Caminho Típico
Borland BCC 5.5 Ferramentas gratuitas da Embarcadero C:\BCC55 ou C:\Borland\BCC55
Microsoft Visual C++ Visual Studio Build Tools C:\Program Files\Microsoft Visual Studio\2022
MinGW GCC mingw-w64.org ou MSYS2 C:\mingw64 ou C:\msys64\mingw64

Passo 4: Configurar Variáveis de Ambiente

Os scripts de build do FiveWin procuram certas variáveis de ambiente. Configure-as no seu sistema ou em um arquivo batch antes de compilar: 

// Example environment setup (add to your PATH or setenv.bat):
SET FWH=C:\FWH
SET HARBOURDIR=C:\harbour
SET BCCDIR=C:\BCC55
SET PATH=%BCCDIR%\BIN;%HARBOURDIR%\BIN;%PATH%

Estrutura de Diretórios

Após a instalação, o diretório do FWH contém as seguintes pastas:

graph TD ROOT["C:\FWH (root)"] ROOT --> LIB["lib/
Pre-built .lib files
for all compilers"] ROOT --> INC["include/
Header files (.ch)
FiveWin.ch, etc."] ROOT --> SRC["source/
FWH source code
classes/ function/"] ROOT --> SAM["samples/
Example programs
organized by topic"] ROOT --> MAK["makes/
Build scripts for
each compiler"] ROOT --> DOC["docs/
Documentation
HTML reference"] LIB --> L1["FiveH32.lib"] LIB --> L2["FiveHC32.lib"] LIB --> L3["FiveH64.lib"] LIB --> L4["FiveHM32.lib"] LIB --> L5["FiveHG32.lib"] SRC --> SC["source/classes/
TWindow.prg, TDialog.prg..."] SRC --> SF["source/function/
Utility functions"] SRC --> SW["source/winapi/
Win32 API wrappers (C)"] MAK --> M1["makes/hb_bcc32/"] MAK --> M2["makes/hb_msvc64/"] MAK --> M3["makes/hb_gcc64/"]

A Pasta lib/

Esta pasta contém as bibliotecas estáticas pré-compiladas do FiveWin. Cada variante de compilador possui seu próprio arquivo .lib:

Arquivo Compilador Arquitetura
FiveH32.libBCC 5.x (Borland)32-bit
FiveHM32.libMSVC32-bit
FiveH64.libMSVC64-bit
FiveHG32.libMinGW GCC32-bit
FiveHG64.libMinGW GCC64-bit

A Pasta include/

Os arquivos de cabeçalho fornecem definições de comandos e constantes. O arquivo de inclusão mais importante é o FiveWin.ch, que você inclui no topo de cada programa FWH: 

#include "FiveWin.ch"

Outros cabeçalhos comumente utilizados:

A Pasta samples/

Dezenas de programas de exemplo prontos para compilar, organizados por tópico. Cada pasta de exemplo tipicamente contém um arquivo .prg e um script de build (b32.bat ou b32.bc): 

samples/
  +-- ai/            // OpenAI, ChatGPT integration
  +-- misc/          // General-purpose examples
  +-- ui/
  |   +-- xbrowse/   // TXBrowse grid examples
  +-- manus/         // Automation examples

Primeiro Teste de Compilação

A forma mais rápida de verificar sua instalação é compilar um dos programas de exemplo incluídos usando o script de build fornecido. Navegue até a pasta makes do seu compilador e execute: 

// For BCC32 (Borland):
cd C:\FWH\makes\hb_bcc32
go.bat ..\samples\hello.prg

// For MSVC 64-bit:
cd C:\FWH\makes\hb_msvc64
go.bat ..\samples\hello.prg

// For GCC 64-bit:
cd C:\FWH\makes\hb_gcc64
go.bat ..\samples\hello.prg

Se o build for bem-sucedido, você verá hello.exe na pasta de saída. Execute-o e uma janela do FiveWin deverá aparecer. Se o build falhar, verifique:

Usando o build_new.bat

O FiveWin inclui um script de build universal build_new.bat que suporta todas as variantes de compilador com um único comando. Veja a página Sistema de Build para detalhes completos. 

// Quick test with BCC32:
build_new.bat hello.prg hb32

// Quick test with MSVC 64-bit:
build_new.bat hello.prg hm64

Lista de Verificação

Após a instalação, verifique o seguinte:

Verificação Comando / Ação Resultado Esperado
Harbour está no PATH harbour --version Exibe a versão 3.2.0+
Compilador C está no PATH bcc32 --version ou cl /? Exibe informações do compilador
Ambiente FWH configurado echo %FWH% Mostra o diretório raiz do FWH
Arquivo de biblioteca existe Verificar %FWH%\lib\ Contém FiveH32.lib (ou variante)
Exemplo compila Compilar hello.prg Gera hello.exe, executa corretamente

Solução de Problemas

Compilador Não Encontrado

Se você receber erros de "comando não encontrado", certifique-se de que o diretório bin\ do compilador está no PATH do sistema. Para MSVC, pode ser necessário executar a partir de um "Prompt de Comando do Desenvolvedor" ou chamar vcvarsall.bat primeiro.

Símbolos Externos Não Resolvidos

Isso geralmente significa que o linker não consegue encontrar uma biblioteca necessária. Certifique-se de que está usando a biblioteca FiveWin correta para o seu compilador (por exemplo, não use FiveH32.lib com MSVC — use FiveHM32.lib em vez disso).

Arquivo de Cabeçalho Não Encontrado

Adicione a pasta include\ do FiveWin ao caminho de inclusão do Harbour: 

harbour myapp.prg -i%FWH%\include -i%HARBOURDIR%\include -n -w

Próximos Passos