ERRO ZeosLib + Delphi7
Marcelo Bortolini
Alguém já passou por isso ? Ou teria outra forma de instalar o Zeos ?
Veja quais são os assuntos do momento no Yahoo! + Buscados: Top 10 - Celebridades - Música - Esportes
Tony Maucyr
Como instalar os componentes ZeosDbo 6.x no Delphi
Este documento descreve os passos e oferece dicas de como instalar o ZeosDbo 6.x no
Delphi. Foi escrito para Delphi 7 mas, possivelmente, funcionará com o Delphi 6 e versões
anteriores.
Este documento é para fins de orientação apenas- ele não estabelece regras ("tem que ser
feito dessa forma") de como instalar o ZeosDbo; ele apresenta algumas etapas e dicas que
os autores usam para instalar a biblioteca ZeosDbo assim como outros componentes no IDE do Delphi.
Requisitos iniciais Primeiramente, você precisa saber como compilar e instalar pacotes de componentes
no IDE do Delphi- refira à documentação do Delphi para aprender a fazer isso.
Se você precisa apenas de uma referência rápida de como instalar a biblioteca ZeosDbo, leia os arquivos
Install e Readme que acompanham a distribuição.
A estrutura de diretórios da biblioteca ZeosDbo A distribuição do ZeosDbo 6.x contém a seguinte
estrutura de diretórios:
/doc: contém a documentação da biblioteca ZeosDbo.
/examples: contém projetos de exemplo para teste das funcionalidades dos componentes ZeosDbo.
/lib: contém arquivos de carga dinâmica (dlls) para acesso ao MySQL, PostgreSQL, etc. Esses arquivos
também podem ser encontrados nas distribuições de cada servidor banco de dados mas recomenda-se
que se utilize os arquivos fornecidos com a distribuição do ZeosDbo pois estas versões foram testadas
pela equipe de desenvolvimento Zeos. Essa pasta também contém alguns pacotes para rodar o ZeosDbo
no Kylix.
/packages: contém os arquivos de projeto necessários (ZCore.dpk, ZParseSql.dpk, ZPlain.dpk, ZDbc.
dpk, ZComponent.dpk) para instalar a biblioteca ZeosDbo. Contém subpastas para cada versão de
Delphi, C++Builder e Kylix suportada. Esse será nossa pasta de trabalho. Cada subpasta contém uma
pasta chamada build onde as unidades compiladas (arquivos dcu quando falamos do Delphi) serão
geradas por padrão.
/src: contém os fontes da biblioteca ZeosDbo. Cada arquivo dpk utiliza os fontes localizados numa
subpasta de /src com o mesmo nome- por exemplo, o arquivo ZCore.dpk utiliza os fontes da pasta /src/
core, ZParseSql.dpk utiliza os fontes da pasta /src/parsesql, e assim por diante.
Instalando os Pacotes da Biblioteca ZeosDBO DICAS para Inicialização
Sempre recomendo o seguinte quando da instalação de componentes no IDE do Delphi:
l Para facilitar a administração, procure colocar a pasta do componente numa subpasta abaixo do
diretório de instalação do Delphi (que pode ser chamada de 'Vcls', por examplo). Se queremos instalar o
ZeosDbo, podemos ter uma pasta como: 'C:/Arquivos de Programas/Borland/Delphi7/Vcls/
ZeosDbo6'. Nessa pasta, podemos instalar todos os arquivos e subpastas da biblioteca ZeosDBO. Por
que assim? Bem, cada vez que instalamos um componente no Delphi, temos que acrescentar o caminho
dos fontes ou unidades compiladas à configuração 'library path' (localizada na guia 'Library' na janela
'Environment Options' que pode ser acessada através do item de menu 'Tools' no menu principal, opção
'Environment options...'). O 'library path' pode ficar muito longo se instalamos muitos componentescomo
eu :) - e, no caso do Delphi 6 e versões anteriores, o 'library path' é limitado a uma certa
quantidade de caracteres de modo que podemos vir a ter problemas de compilação de nossa aplicação se
temos muitos componentes instalados. Então, como fazer o 'library path' mais curto? Podemos utilizar a
variável de ambiente $(DELPHI) para substituir a pasta base de instalação do Delphi de modo que o
caminho 'C:/Arqivos de Programas/Borland/Delphi7/Vcls/ZeosDbo6/packages/delphi7/build'
fique da seguinte forma: '$(DELPHI)/Vcls/ZeosDbo6/packages/delphi7/build'- um pouco mais
curto, não? :) E isso não é tudo! Você pode criar suas próprias variáveis de ambiente que pode apontar
diretamente para uma pasta específica através da guia 'Environment Variables' na janela 'Environment
Options'.
l Redirecione a saída das unidades e pacotes compilados (arquivos .dcu e bpl no caso do Delphi) para
uma subpasta na pasta do componente; essa subpasta pode ser chamada 'build', 'lib' ou 'dcus'.
Procedendo dessa forma, você manterá suas pastas de código fonte limpas. Não esqueça de acrescentar
esse caminho à configuração 'search path' (ao invés de acrescentar o caminho dos fontes ao caminho).
Algumas vezes, você também terá que copiar os arquivos .dfm, .res e .dcr (normalmente localizados na
pasta dos fontes) para a pasta das unidades compiladas para que consiga compilar seu aplicativo. Como
redirecionar a saída das unidades compiladas? Após criar ou abrir um pacote no Delphi (arquivo dpk),
você verá a janela 'Package Window' aberta; clique no botão 'Options' e vá para a guia 'Directories/
Conditionals'; nessa guia, você verá 5 opções no grupo de diretórios:
- Output directory: onde os arquivos bpl serão criados.
- Unit output directory: onde os arquivos dcu serão criados.
- Search path: pastas onde o compilador irá procurar por arquivos pas ou dcu para criar o
arquivo bpl; se esses arquivos estão na mesma pasta que o arquivo dpk você pode deixar essa
configuração em branco.
- Debug source path: pastas onde o compilador irá procurar pelos fontes (pas); pode ser
deixado em branco.
- DCP output directory: onde os arquivos dcp serão criados, normalmente na mesma pasta que
os arquivos bpl.
Se você quer redirecionar apenas a saída dos arquivos dcu, altere a configuração 'Unit Output
directory' para a pasta desejada (você pode usar variáveis de ambiente mas lembre-se que
variáveis de ambiente são precedidas de um caractere $ entre os parênteses); por exemplo:
$(DELPHI).
Por padrão, cada arquivo de pacote da ZeosLib (dpk) vem com as configurações abaixo, todas
apontando para a subpasta 'build' localizada na pasta da versão do Delphi desejada na pasta /
packages:
- Output directory: (vazio)
- Unit output directory: build
- Search path: build
- Debug source path: build
- DCP output directory: (vazio)
Se seu componente não usa pacotes de tempo de execução (runtime packages), mas apenas
pacotes de tempo de desenvolvimento ou de tempo de desenvolvimento e tempo de execução,
como os pacotes do Zeos fazem, você pode redirecionar a saída dos bpl e dcp para a mesma
pasta de saída dos arquivos dcu (recomendado). Assim, cada arquivo de pacote Zeos ficará com a
seguinte configuração:
- Output directory: build
- Unit output directory: build
- Search path: build
- Debug source path: build
- DCP output directory: build
DICA: Você deve alterar a configuração Debug source path para o caminho correto dos fontes
para cada arquivo de pacote se você deseja depurar seus fontes em tempo de execução. No
ZCore.dpk, por examplo, você deve atribuir o valor: '..../src/core' ou '$(DELPHI)/Vcls/
zeoslib6/src/core'.
Se você modificar qualquer opção, salve o projeto antes de compilar e instalar.
Instalação
Como mencionado acima, o ZeosDBO é dividido em 5 pacotes que devem ser compilados e instalados na
seguinte ordem:
1.- ZCore.dpk (Classes e Interfaces Principais)
2.- ZParseSql.dpk (Classes e Interfaces de Interpretação de SQL)
3.- ZPlain.dpk (API Padrão de Bancos de Dados)
4.- ZDbc.dpk (API em Baixo Nível de Bancos de Dados)
5.- ZComponent.dpk (Componentes de Bancos de Dados)
Eles podem ser instalados de duas formas:
a) Abra, compile e instale cada arquivo dpk na ordem acima:
1.- Você tem que abrir cada arquivo dpk- por examplo, abra ZCore.dpk.
2.- Quando a janela com o projeto ZCore for aberta, clique no botão 'Compile'.
3.- Se houver algum erro, clique no botão 'Install'. Você deve receber uma mensagem informando
que o ZCore.bpl foi instalado com sucesso.
4.- Feche o arquivo dpk; algumas vezes o Delphi pede para salvar as alterações- clique em 'No'
para deixar o projeto intacto.
5.- Proceda da mesma forma com os demais arquivos dpk até que você tenha finalizado a
instalação de ZComponent.bpl. Uma vez terminado o processo, os componentes estarão
instalados na guia 'Zeos Access' na paleta de componentes.
Lembre-se que os arquivos dpk para Delphi 7 estão localizados na pasta '/packages/delphi7'.
b) Abrindo 'ZeosDbo.bpg' (arquivo de grupo de projeto)
1.- Abra esse arquivo, localizado na pasta '/packages/delphi7',
2.- clique no item de menu 'View' e, em seguida, no 'Project manager' para ver todos os projetos
contidos no grupo.
3.- Compile todos os projetos utilizando a opção 'Build all Projects' no item de menu 'Project'.
4.- Após terminar, clique com o botão direito em cada projeto listado (de cima para baixo) e, no
menu de contexto do gerenciador de projetos, selecione a opção 'Install'. A ordem deve ser a
mesma mencionada acima.
Não esqueça de acrescentar o caminho (pasta zeosdbo)'/packages/delphi7/build' na configuração 'library
path' localizada na guia 'Library' na janela 'Environment options...' no menu Tools.
NOTAS:
- Sempre certifique-se de que não haja outros projetos abertos quando estiver abrindo um pacote.
- Lembre-se de remover referências antigas (configuração 'library path') a versões antigas do ZeosDbo.
- Se você deseja reinstalar ou instalar uma nova versão do ZeosDbo, sempre verifique que todos os
arquivos bpl do Zeos bpl tenham sido removidos do IDE do Delphi. Se não, remova-os na janela 'Default
project options' que pode ser acessada selecionando a opção 'Install Packages...' no item de menu
'Component' no IDE do Delphi.
- Se você ainda está usando ZeosDbo 5.x, tente atualizar para a versão 5.5 que foi modificada de forma
a coexistir com as novas versões 6.x.
Espero que esse documento seja de ajuda.
Marcelo Bortolini
Aquele abraço galera e Feliz Pascoa a todos.
até a próxima
De: Tony Maucyr <tma...@gmail.com>
Para: dug...@googlegroups.com
Enviadas: Quarta-feira, 8 de Abril de 2009 17:48:26
Assunto: [dug-rs] Re: ERRO ZeosLib + Delphi7