Zeos tutorial/pt: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: Zeos tutorial/pt

New		Line
1	+	## Descrição
2	+
3	+	[Link do tutorial Instalação do ZeosLib no Lazarus (for Windows) pelo Professor Paulo do Amaral Costa, datado de Abril/2006](http://www.pauloamaral.com.br/cefetse.pa/zeos_lazarus.htm).\
4	+	[Link com breve explicação sobre os componentes da biblioteca ZeosLib pelo Professor Paulo do Amaral Costa](http://www.pauloamaral.com.br/cefetse.pa/zeoslib_tutorial.htm).\
5	+	Versão da ZeosLib: zeosdbo-6.5.1-alpha_cvs_13-10-2005\
6	+	Versão do Lazarus: Lazarus-0.9.14.1-20060402-win32 (Freepascal 2.0)\
7	+	Sistema Operacional: Windows XP\
8	+	Obrigado por sua contribuição, Professor.
9	+
10	+	Este tutorial trata de como começar, instalar e usar [Zeoslib](http://zeos.firmos.at/portal.php) com [[Glossary\|Lazarus]] e [[Glossary\|FPC]].
11	+
12	+	A equipe do Zeos recentemente fez um novo fórum. Por favor, viste-o para maiores informações a respeito do Zeoslib e perguntar/responder a respeito de como usar o Zeos e reportar seus bugs. O novo fórum se encontra em [Forum for ZeosLib](http://zeos.firmos.at).
13	+
14	+	## Começando com o Zeos
15	+
16	+	Zeos foi recentemente portado para o Lazarus já com sua liberação oficial zeosdbo-6.6.0-beta liberado em 25-10-2006 [Zeosdbo-6.6.0](http://sourceforge.net/project/showfiles.php?group_id=35994).
17	+
18	+	## Instalando os componentes
19	+
20	+	Esta é uma parte um pouco complicada, assim você deve ter um pouco de paciência e ler esta parte com cuidado.
21	+
22	+	- Certifique-se de ter a última versão do [Lazarus](http://sourceforge.net/project/showfiles.php?group_id=92177) e do último [Free Pascal](http://sourceforge.net/project/showfiles.php?group_id=2174) .
23	+
24	+	- Inicie o Lazarus.
25	+
26	+	1. Opção Componentes/Open Package File(.lpk) no menu principal.
27	+	2. Abra o diretório zeosdbo-6.6.0-beta\packages\lazarus\ selecione os arquivos zcomponent.lpk zcore.lpk zdbc.lpk zparsesql.lpk zplain.lpk e clique em abrir, quando abrirá cada pacote em uma janela
28	+	3. Pressione \[Compilar\] em cada pacote ( janela aberta )
29	+	4. Pressione \[Instalar\] na janela zcomponent.lpk
30	+	5. Você será perguntado se deseja recompilar o lazarus.
31	+
32	+	- Responda \[Sim\] .
33	+	- Espere até a compilação concluir, Lazarus reiniciará em seguida.
34	+	- Se tudo ocorrer bem você deverá ver agora a aba de \[acesso da lib Zeos\] na Paleta de componentes.
35	+
36	+	Se você receber o erro "Cannot find unit ZClasses" (não pude encontrar a unit ZClasses) ou algo similar, você necessitará verificar com cuidado os nomes dos arquivos na sua fonte do Zeos.
37	+
38	+	- Mesmo se maiúsculas e minúsculas coincidirem exatamente, o arquivo dos fontes do pacote auto-gerado pode gerar coincidências maiúscula/minúscula erradas na cláusula uses (Lazarus 0.9.18). Exemplo:
39	+
40	+	` { This file was automatically created by Lazarus. Do not edit!`\
41	+	` This source is only used to compile and install the package.`\
42	+	` }`\
43	+	` unit Zcore; `\
44	+	` interface`\
45	+	` uses`\
46	+	` Zclasses, Zcollections, Zcompatibility, Zexprparser, Zexprtoken, Zexpression, `\
47	+	` Zfunctions, Zmatchpattern, Zmessages, Zsysutils, Ztokenizer, Zvariables, `\
48	+	` Zvariant; `\
49	+	` implementation`\
50	+	` end. `
51	+
52	+	- Note que o Lazarus nomeou a unidade ZClasses como Zclasses, resultando em um conflito de nomes. Presumivelmente esse é um bug do Lazarus, não do pacote Zeos. Uma maneira de contornar isso é nomear todos os arquivos de fontes do Zeos para minúsculas. Vasculhe os subdiretórios em src/ e execute este comando numa janela bash:
53	+
54	+	` rename -v 'y/A-Z/a-z/' *`
55	+
56	+	- Depois, no Lazarus, reabra o pacote (.lpk) e conserte o nome do arquivo clicando em "More..."/"Fix Files Case".
57	+	- O pacote deverá compilar.
58	+
59	+	## Comentários
60	+
61	+	Atualmente o CVS do Zeos para Lazarus tem pacotes quebrados. Alguns comentários do IgD:
62	+
63	+	Usando uma instalação recente do Lazarus 0.9.12 (latest stable version) eu pude instalar a ZeosLib datada de 13 de Out de 05. Primeiro conserte os seguintes bugs na ZeossLib:
64	+
65	+	- 1\. Mude ZplainPostgreSql81.pas para ZPlainPostgresSql8x.pas em zplain.lpk
66	+
67	+	`<Item22>`\
68	+	` <Filename Value="../../src/plain/ZPlainPostgreSql81.pas"/>`\
69	+	` <UnitName Value="ZPlainPostgreSql8x"/>`\
70	+	`</Item22>`\
71	+
72	+	- 2\. Conserte os seguintes erros em zdbc.lpk:
73	+
74	+	a\. Remova os "/" extra de "build/" (remova o que está entre as aspas)
75	+
76	+	`<SearchPaths>`\
77	+	` <OtherUnitFiles Value="../../src/dbc/"/>`\
78	+	` <UnitOutputDirectory Value="build/"/>`\
79	+	`</SearchPaths>`\
80	+
81	+	b\. Coloque as aspas que faltam em unitname value
82	+
83	+	`<Item43>`\
84	+	` <Filename Value="../../src/dbc/ZDbcASA.pas"/>`\
85	+	` <UnitName Value="ZDbcASA/>`\
86	+	`</Item43>`
87	+
88	+	Aqui estão as instruções de instalação:
89	+
90	+	Antes do Lazarus 0.9.13 você precisa abrir cada um dos pacotes por Components/Open Package File na seguinte ordem:
91	+
92	+	1. zcore.lpk
93	+	2. zparsesql.lpk
94	+	3. zplain.lpk
95	+	4. zdbc.lpk
96	+
97	+	Finalmente abra zcomponent.lpk, compile e instale este pacote. 0.9.13 pode simplesmente abrir zcomponent.lpk. A IDE vai abrir o resto automaticamente.
98	+
99	+	Nota: os primeiros quatro pacotes só precisam ser compilados e não podem ser instalados.
100	+
101	+	--Forest 17:41, 2 Nov 2005 (CET)
102	+
103	+	- 3\. Se você compilar e instalar o Zeos com sucesso, mas não o Lazarus, depois de reconstruir comece com:
104	+
105	+	![](/wiki-images/5/57/Zeoserror.gif)
106	+
107	+	Então você pode fazer:
108	+
109	+	No arquivo Zeos.Inc substitua, na seção "// Settings for Debug mode": {\$R-} por {\$R+}
110	+
111	+	--Junior 19:48, 15 Apr 2006 (GMT)
112	+
113	+	## Fazendo sua primeira aplicação Zeos
114	+
115	+	- Insira no formulário o componente ZConnection para estabelecer a conexão com o banco de dados.
116	+	- Configure no Object Inspector selecionando seu Banco de Dados "Database", seu Usuário "User", sua senha "Password", o Host, a porta "Port" e o protocolo "Protocol" (e outros parâmetros se necessário) para a conexão com o banco de dados.
117	+	- Configure Conectado "Connected" como Verdadeiro "True".
118	+
119	+	- Drop a ZQuery (do not mistake with ZReadOnlyQuery).
120	+	- Set the Connection to your active ZConnection.
121	+	- Set the Sql property to something like *SELECT FROM MyTable**
122	+	- Set Active to True.
123	+
124	+	- Drop a DataSource from the \[Data Access\] tab.
125	+	- Set the DataSet to your active ZQuery.
126	+
127	+	- Drop a DBGrid from the \[Data Controls\] tab.
128	+	- Set the Datasource to your DataSource.
129	+	- If all is ok you should now be able to see the records from your table.
130	+
131	+	## Maiores informações sobre como trabalhar com Zeos
132	+
133	+	Aqui você encontra alguns artigos explicando o uso do Zeos, alguns deles falam especificamente no uso com a linguagem Delphi, mas na maioria das vezes as mesmas técnicas podem ser usadas também no Lazarus.\
134	+
135	+	- [Tutorial ZeosLib DBOs 6.1.5 - com Delphi 7 e Firebird 1.5](http://zeos.firmos.at/kb.php?mode=article&k=6)
136	+	- [Tradução e adaptação do Tutorial ZeosLib DBOs 6.1.5 - With Delphi 7 and Firebird 1.5](http://www.pauloamaral.com.br/cefetse.pa/zeoslib_tutorial.htm)
137	+	- [Overview of the Zeos Database Objects Architecture](http://zeos.firmos.at/kb.php?mode=article&k=4)
138	+	- [Uma introdução a API ZDBC](http://zeos.firmos.at/kb.php?mode=article&k=5)
139	+	- Verifique na seção [Downloads](http://zeos.firmos.at/downloads.php) exemplos reais que podem ser facilmente portados para o Lazarus.
140	+
141	+	Por favor complete-me :)
142	+
143	+	## Possible Bugs and Issues
144	+
145	+	1. Eu notei que às vezes, ao construir o Lazarus, ele não consegue achar alguns arquivos do Zeos. Para contornar, tente isso:
146	+	- Vá a Components/Package Graph no menu principal .
147	+	- Abra o pacote ZComponent .
148	+	- Clique com o botão direito em Files.
149	+	- Escolha \[Recompile all required\].
150	+	- Quando perguntado "Re-Compile this and all required packages?" responda \[Yes\].
151	+	- Recompile o Lazarus normalmente (com os pacotes).\
152	+	\
153	+	2. Existe um bug em [[Glossary\|FPC's]] [AnsiStrComp](http://lazarus-ccr.sourceforge.net/docs/rtl/sysutils/ansistrcomp.html) que causa unreliable PChar comparison, isso é óbvio ao usar um DBGrid para editar dados, AnsiStrComp('abc', 'abcd') can't detect them as being different but it detects AnsiStrComp('abd', 'abcd') ignoring multiple chars from the second string. Este bug foi encontrado porJesusrmx. Provavelmente vai ser corrigido logo, veja [Bug Report](http://www.freepascal.org/bugs/showrec.php3?ID=4325).
154	+
155	+	---
156	+	From the Free Pascal wiki, page "Zeos tutorial/pt", as it stood on 2008-06-23 after a change by Pamaral, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history