PROJETO HARBOUR
PROJETO HARBOUR
PROJETO HARBOUR
|
Harbour Project Estava faltando descomplicar... |
[ Download |
Instalação | Funcionamento
| CDX
| CVS | Links
ADS -Instalação e Funcionamento ]
|
INTRODUÇÃO |
Prezados colegas,
O Projeto Harbour é uma linguagem de programação baseada em xBase compatível com o Clipper que trouxe interatividade ao Windows nunca vista antes. É uma obra fantástica que trouxe o Clipper para Open Source, como o Linux, e promete ser totalmente compatível com a versão 5.x do Clipper, além de ser Freeware! Grátis! Sem embargo, nem tudo são flores... encontrei problemas desde o download dos arquivos necessários e, principalmente, na configuração, portanto, decidi colaborar com esta página especial com um guia completo.
Estava cansado de encontrar tanta coisa dizendo nada sobre o Harbour... Agora eu consegui compilar um .EXE e até uma .LIB, agora é a sua vez ! AVANÇA BRASIL!
Em nome de todos os clippeiros, agradeço a ajuda
de Taibnis S. Vieira da empresa
Futura Tecnologia em Brasília por revelar o caminho das pedras...
Agradeço a todos os outros que também colaboraram para manter esta página o mais
operacional possível !
Não fique por aí pedindo o instalador do Clipper!!!
Pegue a instalação do Projeto Harbour de forma gratuita e legal aqui mesmo no CA-CLIPPER WEBSITE !!!
Saia da ilegalidade!!! |
|
Não peça o instalador do Clipper porque eu não posso fornecer! |
|
DOWNLOAD DOS ARQUIVOS
|
Patrocinadores: |
Os links abaixo proporcionam um acesso direto de download dos arquivos: (Sem complicação ou perda de tempo)
Versão atual 1.0.0beta As versões mais novas sempre saem primeiro pelo CVS.
NOVO: http://free.xharbour.com Baixe o instalador do site acima que faz tudo sozinho para você!
ATENÇÃO:
Para fazer o downloads do xHarbour acima funcionarem, pode ser que você
tenha que
clicar com o botão direito do mouse e escolher "Salvar destino
como...".
-Acreditamos que seja um problema
esporádico da
SourceForge.
|
|
|
TODOS OS ARQUIVOS ACIMA SÃO FREEWARE, GRATUITOS! Abaixo dos dois primeiros links estão instruções de como baixar os arquivos diretamente do site em caso de os links acima estiverem "quebrados". |
|
DICAS DE INSTALAÇÃO
|
Patrocinadores:
|
|
1. Descompacte o xHarbour (Binários e LIBs) no diretório raíz do C:\ e já será criado a pasta C:\XHARBOUR com os subdiretórios. 2. Instale o Borland C++ 5.5 no diretório C:\BCC55 3. Descompacte o arquivo harbour_cfg.zip dentro do subdiretório C:\BCC55\bin 4. Inclua no AUTOEXEC.BAT o caminho para C:\XHARBOUR\BIN e C:\BCC55\BIN na variável PATH. 4.1 Localize a linha SET PATH 4.2 Abaixo da linha SET PATH, inclua a seguinte linha: SET PATH=%PATH%;C:\XHARBOUR\BIN;C:\BCC55\BIN 5. Inclua no AUTOEXEC.BAT, da mesma forma que no passo anterior, as seguintes linhas: SET LIB=%LIB%;C:\XHARBOUR\LIB;C:\BCC55\LIB SET INCLUDE=%INCLUDE%;C:\XHARBOUR\INCLUDE;C:\BCC55\INCLUDE
ATENÇÃO! Não altere os diretórios de instalação sugeridos aqui! Observe que as definições do Clipper vem antes do xHarbour, caso contrário não funcionará com ambos. |
|
DICAS DE
FUNCIONAMENTO
|
|
Como criar um EXEcutável: É obrigatório a existência de um FUNCTION MAIN() dentro do seu sistema, isso você já sabe, mas no xHarbour, mesmo que você esteje compilando um único PRG, será necessário começar com FUNCTION MAIN() também!
Vamos compilar o clássico "hello world". Em um editor de texto qualquer, crie o seguinte arquivo:
function main() Salve-o como "OI.prg".
No prompt do MS-DOS, você vai usar: HBMAKE OI.BC /EX HBMAKE OI.BC
Veja o passo-a-passo a seguir:
Os comandos para criação de um executável são:
Para compilar: HBMAKE nome.bc /EX
...e para linkar: HBMAKE nome.bc Irá compilar somente os PRGs alterados desde a última compilação.
Para forçar a recompilação de todos os PRGs: HBMAKE nome.bc /F Este parâmetro /F também regera o arquivo HARBOUR.CFG, não há problema nisso.
Onde "nome.bc" é o nome do script que você vai criar, ponha o nome que quiser, mas deixe a extensão .BC. No primeiro passo, é criado um arquivo com o nome nome.bc (pode ser qualquer nome, mas a extensão é bc). Este arquivo é um tipo de mescla de RMK e LNK do Clipper. É um roteiro (ou script, como preferir) de compilação. Nesta primeira chamada é aberta uma janela do DOS com algumas perguntas sobre qual o sistema operacional, compilador, LIB gráfica, RDDs etc. Vamos aprender agora os passos básicos para a compilação de um programa comum (sem Libs gráficas ou RDDs) para ser executado na plataforma Windows e compilado usando o Borland C++ que você baixou deste site. HBMAKE oi.bc /EX A tela que se apresenta é a seguinte: Basta você ir teclando <Enter> até "[X]Comprimir App"*, marque-o para produzir executáveis menores e até o "Nome Executável", onde você vai por o nome do arquivo .EXE que será gerado. Neste exemplo acima, será gerado OI.EXE. *Para comprimir o executável, você precisará baixar o UPX. Após por o Nome do Executável, abrirá outros campos como visto a seguir:
Vá teclando <Enter> até o "[X] Compila apenas o módulo /m", marque-o e continue teclando <Enter> até aparecer uma pequena janela com uma lista de todos os arquivos .PRG do diretório corrente, como na tela seguir:
Nesta janela que se abre, você vai selecionar, teclando com a barra de espaços do seu teclado, todos os arquivos .PRG que vão fazer parte do seu sistema e depois deverá teclar <Enter> para finalizar. Esta janela irá fechar e aparecerá outras opções, mas vá teclando <Enter> até a pergunta "Compilar app?", no canto inferior esquerdo da tela, veja a tela seguinte:
Responda com "S" para compilar o seu sistema agora ou "N" para compilar depois com HBMAKE OI.BC no prompt do MS-DOS.
Voilà! Está pronto o seu roteiro (ou script, como preferir) para compilar o arquivo EXEcutável. Observe que este processo todo serve apenas para criar o arquivo com a extensão .BC, que nunca mais necessitará ser criado de novo ao menos que você queira incluir um novo arquivo .PRG no seu sistema posteriormente.
No segundo passo é feita a criação do executável. HBMAKE oi.bc ou HBMAKE oi.bc /F Caso seu programa não apresente erros, a tela que se apresenta é a seguinte:
Caso dê algum erro, abra o arquivo com a extensão .OUT ou .LOG para entender o que aconteceu.
Para criar uma LIB: HBMAKE nomedalib.bc /ELX HBMAKE nomedalib.bc O programa da LIB deve começar com a criação de uma função qualquer, tipo FUNCTION TESTE(). Não ponha o nome de "MAIN" porque esta função FUNCTION MAIN() é reservada para chamar o programa principal do sistema, ou seja, o programa do sistema que executa primeiro, aquele que prepara o ambiente, a tela e o menu do sistema, por exemplo. A primeira chamada de HBMAKE cria um arquivo com a extensão .BC, que já falamos anteriormente. Marque apenas a opção: [X] Compila apenas o módulo /m A segunda chamada de HBMAKE cria a LIB propriamente dita. Os problemas de programação só aparecem na segunda chamada e podem ser analisados abrindo o arquivo com a extensão .OUT ou .LOG.
Indexar nomes com acentos gráficos da língua portuguesa: Insira as seguintes linhas no seu programa: REQUEST HB_CODEPAGE_PT850 HB_SETCODEPAGE("PT850") |
|
Patrocinadores: |
|
|
Para utilizar-se dos índices CDX, insira as seguintes linhas no seu programa:
*** DBFCDX Nativo ***
|
|
Páginas oficiais
Projeto Harbour - Versão Freeware/Open Source (Compilador)
Borland C++ Compiler Freeware (Linkador)
Projeto Harbour - Versão Comercial (Compilador+Linkador)
HBMAKE v1.167 (Harbour Make Utility
-Versão mais nova [CVS]) ( É a versão mais nova! É recomendável baixar esta versão para dar compatibilidade com a versão dos binários baixados de http://www.xharbour.org. Pode ocorrer incompatibilidade quando você usar uma LIB compilada na versão dos fontes (CVS) com a versão dos binários. Versão mais nova com a mais antiga.
----------------------------------------------------------------------------------
Grupo de Notícias (Newsgroup) - Obtenha ajuda aqui (Use MS Outlook)
----------------------------------------------------------------------------------
Outros sites sobre o Projeto Harbour etc.
Turbo Assembler 5 Freeware (completo)
BISON Freeware
DJGPP Freeware
-----------------------------------------------------------------------------------------------
Libs Gráficas
Quem quiser migrar para Windows gratuitamente, use esta LIB.
Linguagem Visual interativa para Windows e programável para Clipper (xBase). Quem disse que o navio iria afundar e você iria morrer na praia?! Quem programa em Clipper pode ancorar o navio neste porto!!! Quem abandonou o navio (Clipper) e está no Delphi ou VB, pode voltar ao porto (Harbour) e entrar no navio (Clipper) de novo!!! (A linguagem Clipper é simbolizada por um navio e "Harbour" quer dizer "porto")
A mesma Visual Lib do Clipper agora na versão compatível com o Harbour/xHarbour. Continua sendo uma LIB pseudo visual, fazendo o mesmo que antes. Para conseguir arquivos reais do Windows, use uma das outras LIBs acima.
A MWVW.LIB tem como objetivo principal,
facilitar na conversão e utilização moderada de recursos gráficos visuais,
usando parcialmente o que esta presente na GTWVW.LIB (OpenSource criado
por Budyanto Dj). ----------------------------------------------------------------------------------------------- Outras LIBs
Para quem quiser imprimir em qualquer impressora sem precisar aprender muita coisa e aproveitar o melhor do xHarbour! Imprime gráficos, código de barras etc. Já estão embutidos a GDLIB e a FreeImage dentro desta LIB.
LIB para imprimir em código de barras: EAN13, EAN8 e EAN128 A/B/C. Possui capacidade para desenhar etc. -Coloque o arquivo bgd.dll no diretório indicado e chame "MAKE_B32.BAT". *Caso dê erro, abra o arquivo "makefile.bc" e edite a linha "BCC_DIR=C:\XHARBOUR\BCC55".
LIB para tratamento de imagens. Converte um tipo de imagem em outro etc. -Coloque o arquivo freeimage.dll no diretório indicado e chame "MAKE_B32.BAT". *Caso dê erro, abra o arquivo "makefile.bc" e edite a linha "BCC_DIR=C:\XHARBOUR\BCC55".
|
|
Para compilar o xHarbour a partir dos fontes, você precisa baixar os fontes com o Tortoise CVS e instalar as ferramentas para compilá-lo: o DJGPP; BISON e TASM32.EXE (do Turbo Assembler 5). O Borland C++ Compiler 5.5 também precisa estar instalado, deixe-o no c:\bcc55. Depois, você configura algumas variáveis de ambiente do MS-DOS e chama dois arquivos de lote (.BAT). Veja a seguir:
CVS Freeware/Open Source Clique em "Downloads", procure uma versão estável (stable), normalmente é o primeiro download listado. Exemplo: Stable (for deployment) - TortoiseCVS-1.8.25.exe - 5.67 MB - 11th February 2006 Release announcement, including list of major changes
Você será redirecionado para uma página de
mirror. Escolha um qualquer (de preferência no Brasil ou mais
próximo) e clique no link Download da coluna Download. O Tortoise CVS é o aplicativo por meio do qual você baixa os fontes do xharbour no seu computador.
1) Baixe o CVS, instale (sem mudar nada) e reinicie seu computador. 2) Como usar: Execute o "Windows Explorer"; clique com o botão direito do mouse na "unidade C:\"; clique em "Obter módulo" e preencha os dados conforme a figura abaixo; clique em "Ok".
Borland C++
Compiler 5.5 c:\bcc55
(
8.7Mb
 [an error occurred while processing this directive]
)
Harbour_cfg.zip c:\bcc55\bin (
287Bytes [an error occurred while processing this directive]
)
-Baixe e instale no diretório indicado.
O BORLAND C++ 5.5 é o compilador oficial dos fontes do xHarbour para Windows.
- Com FTP, use: Usuário, anonymous e senha, seu email.
-Baixe e instale no diretório indicado.
"Use folder names" deve estar
marcado, se você usar o Winzip para descompactação.
O DJGPP é o compilador oficial dos fontes do xHarbour para DOS.
C:\BISON (clique aqui)
-Baixe e descompacte o .ZIP no diretório indicado.
A versão recomendada atualmente é a 2.1. Instale no C:\BISON e altere o PATH de C:\BISON para C:\BISON\BIN, neste caso.
Observação:
Eu compilava o xharbour apenas com a primeira sugestão deste
download, nunca precisei baixar a versão completa; no entanto, quis baixar
a versão completa, mas não mudou em nada; continua compilando do mesmo
jeito. Se a sua conexão com a internet é devagar, você deverá preferir
baixar só os arquivos necessários do BISON, na primeira sugestão. BISON é o parser (analisador gramatical), usado para construir o compilador xharbour.
C:\BCC55\Bin\tasm32.exe
(só o necessário) -Baixe, descompacte o .ZIP e copie o arquivo no diretório indicado.
Compactador do executável (do seu aplicativo gerado pelo xharbour). -Coloque o UPX.EXE no C:\BCC55\BIN
Defina as seguintes variáveis de ambiente: (Crie um arquivo de lote ou insira estas linhas no AUTOEXEC.BAT) SET PATH=%PATH%;C:\BCC55\BIN;c:\bison\bin;c:\xharbour;c:\xharbour\bin; C:\DJGPP\BINSET INCLUDE=%INCLUDE%;c:\Bcc55\include;c:\xHarbour\include SET LIB=%LIB%;c:\Bcc55\lib;c:\xHarbour\lib SET HB_LEX=SIMPLEX SET BISON_SIMPLES=c:/bison/bison.simple SET CFLAGS= -5 -OS -a8 SET HB_PATH=C:\XHARBOUR SET DJGPP=C:\DJGPP\DJGPP.ENV (grifos cinza para ficar mais legível, não significa nada)
Chamar os arquivos de lote (.BAT) a seguir; na ordem: MAKE_B32 clean MAKE_B32 all -Estes arquivos de lote estão no diretório "C:\xharbour". Estes arquivos de lote é que executarão a compilação dos fontes do xHarbour.
Caso tenha problemas, compare as pastas instaladas com as pastas indicadas nas variáveis de ambiente (listadas nos arquivos ".BAT" ou ".CFG") ou busque ajuda no Grupo de Notícias (Newsgroup). |
|
1. INSTALAÇÃO
1.1 Faça o download das DLLs requeridas no link abaixo: É preciso se cadastrar para fazer o download, mas é muito fácil e rápido. Depois, aparece na tela todos os links para download. Não precisa ficar esperando nada por email.
1.2 Depois de instalar, você irá copiar as DLLs da pasta: C:\Arquivos de programas\Extended Systems\Advantage 8.1\acesdk Para a pasta: c:\Windows\System32
1.3 Copie o arquivo ads.ch da pasta: C:\xharbour\contrib\rdd_ads Para a pasta: c:\xharbour\include
1.4 Executar o comando: implib c:\xharbour\lib\ace32.lib c:\windows\system32\ace32.dll
2. UTILIZAÇÃO
2.1 Inclua as seguintes linhas no seu programa principal:
REQUEST ADS
REQUEST HB_CODEPAGE_PT850 &&& PARA
INDEXAR CAMPOS ACENTUADOS
2.2 Edite o seu arquivo de compilação do HBMAKE para incluir o seguinte: Rdd Terceiros: RddAds 2.3 Você precisará do arquivo RDDADS.LIB que vem na pasta CONTRIB do xHarbour em CVS, se você estiver baixado o xHarbour pelos binários não terá este arquivo, portanto baixe-o no link abaixo:
RDDADS.LIB
(
3. DICAS
3.1 Para deixar a abertura dos DBFs mais rápida, use:
AdsRightsCheck( .F. ) 3.2 Para evitar que o arquivo de índice (CDX) seja aberto automaticamente (impedindo a reindexação), use:
SET AUTOPEN OFF ***Você pode querer usar o comando acima apenas na rotina de reindexação dos arquivos, ou seja, SET AUTOPEN OFF no início da rotina e SET AUTOPEN ON no final dela.
Pronto!
Agora é só tratar os DBF como se fossem RDDCDX, com indices CDX. Veja mais. |
http://harbour.caclipperwebsite.com
Anderson Cardoso Silva