O primeiro passo para podermos iniciarmos a instalação do xHarbour em nossa CPU é obtermos a última cópia estável do compilador.
Para isto, abra seu browser e vá diretamente no site do projeto: www.xharbour.org. É neste site que devemos baixar o xHarbour mais estável.

No site do projeto logo abaixo na opção downloads, escolha a opção BINARIES para baixar os arquivos em formato binário (já compilados). Visto que o xHarbour é um aplicativo open source, há também neste site a opção para download do código fonte (source code) do compilador que pode ser usado para estudos.

Como o xHarbour é uma ferramenta multi-plataforma, logo após selecionar o formato de download desejado, o site irá solicitará que você escolha o seu tipo de plataforma (sistema operacional) com o qual você trabalha. Para este exemplo clique em Windows e em seguida será exibido todos os downloads disponíveis para esta plataforma.
Nosso interesse é o download do xHarbour para o Borland C++ 5.5.1, disponível nesta página.
O Borland C++ Compiler - ou simplesmente BCC para os íntimos - é um compilador C gratuito desenvolvido pela mesma empresa que produz o DELPHI. O Borland C++ é um componente obrigatório para se trabalhar com xHarbour e maiores informações podem ser encontradas num artigo específico.

O pacote binaries já contém todas as LIBs, EXEs e .CHs necessários para iniciarmos os trabalhos com xHarbour. Agora um detalhe interessante é que nesta mesma página temos a opção para baixarmos também as contribs do xHarbour.   Este pacote é interessante, pois as contribs representam as contribuições de terceiros ao projeto xHarbour. Há funções para se gerar PDF, código de Barras ou até para manipular imagens e muitas outras coisas - tudo à partir do seus programas!   Portanto este é um download mais que recomendável para qualquer usuário que deseje conhecer os recursos fantásticos que este projeto oferece!

Para baixar as contribuições basta clicar no respectivo link na página de downloads e salvar o arquivo em seu micro.

Efetuada estas etapas você já tem todos pactores necessários para se instalar e configurar o xHarbour em seu micro e o próximo passo agora é instalar!

Instalando os pacotes do xHarbour
Até a versão a versão 0.99.60 do xHarbour, ao se efetuar o download dos binários através do site do projeto você recebia um arquivo zipado com o conteúdo a ser extraído em seu micro. Porém desde a versão 0.99.70 este processo aparentemente mudou e agora você recebe um arquivo auto-extraível. Veja como proceder para instalar o conteúdo de cada pacote dependendo do seu caso:

• Para instalar o xHarbour usando um arquivo ZIP:
  Descompacte o arquivo ZIP com um aplicativo de sua preferência e extraia todo o conteúdo na sua unidade C:\ ou C:\XHARBOUR (dependendo do conteúdo do arquivo ZIP) de modo que seja criada uma pasta C:\XHARBOUR.
  
  A estrutura de pastas após o processo de extração deve ficar como na demonstrada na imagem abaixo.
   
• Instalando o xHarbour usando o arquivo auto-extraível:
  Execute o arquivo auto-extraível obtido via download, para iniciar o processo de instalação. Este processo é relativamente simples e resume-se à:
   
  • Clique em Next na primeira tela de apresentação que surge.
     
  • Na próxima tela será necessário informar a pasta de destino para os arquivos do pacote. Digite C:\XHARBOUR (se este já não for o local padrão) e clique em Next para continuar.
     
  • Quando o processo tiver sido concluído, uma janela irá se abrir exibindo os arquivos que foram extraídos.
    

Após ter executado os passos descritos acima para instalação (seja usando o arquivo ZIP ou o arquivo auto-extraível), o resultado é que o xHarbour deve estar descompactado em C:\XHARBOUR e a estrutura de pastas deve ficar como na imagem demonstrada ao lado.	Estrutura de pastas após extração
Nós recomendamos que o xHarbour seja instalado na unidade C: embora seja possível instalá-lo em outra unidade ou pasta para facilitar o acompanhamento deste e de outros tutoriais.

Se a sua estrutura das pastas estiver diferente da imagem exibida acima, exclua os arquivos que você extraiu (enviando-os para a lixeira) e efetue os passos de instalação novamente. Óbviamente certifique-se de ter efetuado o backup de qualquer arquivo importante antes de excluir quaisquer informações do seu computador.

Se você baixou também as contribuições do projeto e deseja instalá-las, basta decompactar o arquivo ZIP dentro da pasta C:\XHARBOUR de modo que seja criada a pasta C:\XHARBOUR\CONTRIB.

Concluida esta etapa, o próximo passo é configurar os arquivos de sistema!
 
Ajustando os arquivos CONFIG E AUTOEXEC
Assim como no Clipper, alguns ajustes são necessários nos seus arquivos de configuração. Basicamente iremos ajustar os arquivos AUTOEXEC e CONFIG para refletirem os novos programas.

• AUTOEXEC.BAT ou AUTOEXEC.NT
  A variável PATH do seu AUTOEXEC.BAT (apenas no Windows 9x, ME) deverá apontar para a pasta onde estão o executavél e os binários do xHarbour (harbour.exe, hbmake.exe, etc).
  
  Caso seu Windows seja 2000, XP etc. seu AUTOEXEC não possui extensão .BAT e sim .NT e normalmente esta localizado na pasta Windows\System32.
  
  Abra este arquivo com um editor de textos de sua preferência e localize a linha que normalmente começaria com "SET PATH="
  
  O que será feito é bem simples: nesta linha iremos acrescentar o local onde o sistema operacional localizará os novos programas instalados. Para isto, edite esta linha de modo que ele fique mais ou menos com essa característica:
   
  SET PATH=C:\WINDOWS\SYSTEM; C:\XHARBOUR\BIN;
  
  Observe que no o exemplo acima, tudo que inicialmente fazia parte da instrução SET PATH deve permanecer. Apenas adicione o local de instalação do xHarbour no final da linha.
  
  

  	Detalhe importante: Nem sempre o XP considera o que se informa no AUTOEXEC.NT! Mas isto não chega a se tornar um grande problema pois, você pode incluir também suas variáveis de ambiente usando outro processo: No ícone Meu Computador clique com o botão direito e selecione Propriedades.   Na guia Avançado clique na opção Variáves de Ambiente.   Na tela que irá ser exibida há uma painel rotulado de Variáveis do Sistema. Nele localize a variável com o nome PATH e clique em Editar.   No final desta linha incluia o PATH desejado: C:\XHARBOUR\BIN Será necessário reiniciar a CPU para que as alterações sejam efetuadas no sistema.

      
• CONFIG.SYS ou CONFIG.NT
  O xHarbour não depende de informações tais como FILES para abertura de arquivos. Sendo assim não será necessário se efetuar nenhuma configuração nestes arquivos.

Se o seu sistema operacional for Win9x ou WinME, será necessário reiniciar o micro para que as alterações entrem em vigor.

	Se você já tiver instalado o Borland C++ Compiler em sua máquina, será necessário ainda editar as configurações do BCC para informar a localização de onde o seu xHarbour está instalado.

Após o termino destas etapas o xHarbour está instalado com sucesso em seu micro.

ConsideraÇÕes Finais
Instalar o xHarbour é um processo fácil e rápido. Após baixarmos os arquivos necessários do site do projeto, vimos onde devemos extrair o conteúdo recebido e quais configurações no sistema são necessárias.

Após efetuada estas etapas você já tem quase todos pacotes necessários instalados e configurados para se trabalhar com xHarbour - falta agora apenas o download e instalação do Borland C++ Compiler, que iremos considerar num artigo específico.

Sucesso à todos e até a próxima!