Difference between revisions of "Zeos tutorial/de"
m (typos) |
|||
Line 3: | Line 3: | ||
== Überblick == | == Überblick == | ||
− | Dieses Tutorial handelt vom | + | Dieses Tutorial handelt vom Bekommen, Installieren und Verwenden von [http://zeos.firmos.at/portal.php Zeoslib] mit [[Glossary#Lazarus|Lazarus]] und [[Glossary#FreePascal|FPC]]. |
<br> | <br> | ||
<br> | <br> | ||
− | Das Zeos Team hat vor kurzem ein neues Forum erstellt. Bitte besuchen | + | Das Zeos Team hat vor kurzem ein neues Forum erstellt. Bitte besuchen Sie das neue Forum für mehr Informationen über ZeosLib und um Fragen zu stellen / zu beantworten über die Verwendung von Zeos und um Bugs zu melden. Das neue Forum ist hier zu finden [http://forum.zeoslib.net.ms Forum für ZeosLib] |
== Erhalten von Zeos == | == Erhalten von Zeos == | ||
− | Sie können Zeos einfach mittels SVN erhalten, wenn | + | Sie können Zeos einfach mittels SVN erhalten, wenn Sie diesen Schritten folgen: |
=== Windows === | === Windows === | ||
− | * Besorgen | + | * Besorgen Sie sich einen SVN Client (z.B.[http://tortoisesvn.tigris.org TortoiseSVN]) und installieren Sie diesen. |
* Siehe [http://tortoisesvn.net/docs/release/TortoiseSVN_en/help-onepage.html#tsvn-dug-general Getting Started with TortoiseSVN] | * Siehe [http://tortoisesvn.net/docs/release/TortoiseSVN_en/help-onepage.html#tsvn-dug-general Getting Started with TortoiseSVN] | ||
− | * machen | + | * machen Sie einen Checkout vom Windows Explorer aus: svn://zeos.firmos.at/zeos/trunk |
=== Linux/BSD === | === Linux/BSD === | ||
− | * Besorgen | + | * Besorgen Sie sich einen SVN Client (esvn, kdesvn, etc.) |
− | * Erstellen | + | * Erstellen Sie ein Verzeichnis ''zeosdbo'', gehen in das Verzeichnis und starten |
* svn checkout svn://zeos.firmos.at/zeos/trunk | * svn checkout svn://zeos.firmos.at/zeos/trunk | ||
== Installieren der Komponenten == | == Installieren der Komponenten == | ||
− | * Stellen | + | * Stellen Sie sicher, dass Sie den neuesten [http://www.de.freepascal.org/lazarus/ Lazarus Snapshot] haben und mindestens FPC 2.0.3 nicht älter als vom 6. März 2006. |
− | * Starten | + | * Starten Sie eine Instanz von Lazarus. |
− | # Benutzen | + | # Benutzen Sie '''Komponenten/Paketdatei (.lpk) öffnen''' im Hauptmenü. |
− | # Gehen | + | # Gehen Sie zu '''zeosdbo_rework\packages\lazarus\''' und öffnen Sie '''zcomponent.lpk''' |
− | # Drücken | + | # Drücken Sie '''[Kompilieren]''' nur dann, wenn Sie die Komponenten nicht in die IDE installieren wollen |
− | # Drücken | + | # Drücken Sie '''[Installieren]''' |
− | # Sie werden gefragt, ob | + | # Sie werden gefragt, ob Sie Lazarus rekompileren wollen. |
− | # Antworten | + | # Antworten Sie diesmal mit '''[Yes]''' . |
− | # Warten | + | # Warten Sie bis die Kompilierung beendet ist. Lazarus sollte sich danach selbst neu starten. |
− | # Wenn alles ok ist, sollten | + | # Wenn alles ok ist, sollten Sie jetzt den '''[Zeos Access]''' Tab in der Komponentenpalette sehen. |
[[image:Zeos_Components.png]] | [[image:Zeos_Components.png]] | ||
Line 61: | Line 61: | ||
end. | end. | ||
− | * Beachten Sie, dass Lazarus die unit ZClasses in Zclasses umgeschrieben hat, so dass | + | * Beachten Sie, dass Lazarus die unit ZClasses in Zclasses umgeschrieben hat, so dass sich ein Namenskonflikt ergibt. Das scheint ein Lazarus-Fehler zu sein, keiner des Zeos-Packages. Eine Möglichkeit, diesen Konflikt zu umgehen ist es, alle Zeos-Quelldateinamen kleinzuschreiben. Gehen Sie durch alle Unterverzeichnisse unter src/ and führen den Sie folgenden Befehl in einer bash-Kommandozeile aus: |
rename -v 'y/A-Z/a-z/' * | rename -v 'y/A-Z/a-z/' * | ||
Line 67: | Line 67: | ||
== Anmerkungen == | == Anmerkungen == | ||
− | == Erstellen | + | == Erstellen Ihrer ersten Zeos-Anwendung == |
− | * Legen | + | * Legen Sie eine '''ZConnection''' ab (auf Ihrem Formular). |
− | ** Setzen | + | ** Setzen Sie ihren User, Password, Host, Port und Protocol (und jeden anderen Parameter falls benötigt). |
− | ** Setzen | + | ** Setzen Sie Connected auf True. |
− | * Legen | + | * Legen Sie eine '''ZQuery''' ab (<font color=red>nicht mit ZReadOnlyQuery verwechseln</font>). |
− | ** Setzen | + | ** Setzen Sie Connection auf ihre aktive ZConnection. |
− | ** Setzen | + | ** Setzen Sie die SQL-Eigenschaft auf etwas wie '''SELECT * FROM MyTable''' |
− | ** Setzen | + | ** Setzen Sie Active auf True. |
− | * Legen | + | * Legen Sie eine '''DataSource''' vom '''[Data Access]''' Tab ab. |
− | ** Setzen | + | ** Setzen Sie DataSet auf Ihre aktive ZQuery. |
− | * Legen | + | * Legen Sie ein '''DBGrid''' vom '''[Data Controls]''' Tab ab. |
− | ** Setzen | + | ** Setzen Sie Datasource auf Ihre DataSource. |
− | ** Wenn alles ok ist, sollten | + | ** Wenn alles ok ist, sollten Sie jetzt die Datensätze aus Ihrer Tabelle sehen. |
== Mehr Informationen über das Arbeiten mit Zeos == | == Mehr Informationen über das Arbeiten mit Zeos == | ||
− | Hier können | + | Hier können Sie einige wirklich hilfreiche Artikel finden, welche die Verwendung von Zeos beschreiben und seine Interna. Einige von ihnen handeln auch über Delphi-spezifischen Stoff, aber meistens können die gleichen Techniken ebenfalls in Lazarus verwendet werden.<br> |
* [http://zeos.firmos.at/kb.php?mode=article&k=6 Die ZeosLib DBOs 6.1.5 - Mit Delphi 7 und Firebird 1.5] | * [http://zeos.firmos.at/kb.php?mode=article&k=6 Die ZeosLib DBOs 6.1.5 - Mit Delphi 7 und Firebird 1.5] | ||
* [http://zeos.firmos.at/kb.php?mode=article&k=4 Überblick über die Zeos Database Objects Architecture] | * [http://zeos.firmos.at/kb.php?mode=article&k=4 Überblick über die Zeos Database Objects Architecture] | ||
* [http://zeos.firmos.at/kb.php?mode=article&k=5 Eine Einführung in das ZDBC API] | * [http://zeos.firmos.at/kb.php?mode=article&k=5 Eine Einführung in das ZDBC API] | ||
− | * Prüfen | + | * Prüfen Sie auch den [http://zeos.firmos.at/downloads.php Downloads] Abschnitt für echte Beispiele, welche einfach nach Lazarus portiert werden können. |
<br> | <br> | ||
− | '''Bitte ergänzen | + | '''Bitte ergänzen Sie diesen Bereich''' |
== Mögliche Bugs und Probleme == | == Mögliche Bugs und Probleme == | ||
− | # Ich habe bemerkt, dass manchmal wenn Lazarus erstellt wird, einige Zeos Dateien nicht gefunden werden, als provisorische Hilfe versuchen | + | # Ich habe bemerkt, dass manchmal wenn Lazarus erstellt wird, einige Zeos-Dateien nicht gefunden werden, als provisorische Hilfe versuchen Sie dies: |
− | #* Benutzen | + | #* Benutzen Sie '''Komponenten/Paketgraph''' im Hauptmenü. |
− | #* Öffnen | + | #* Öffnen Sie das '''ZComponent''' Package. |
− | #* Klicken | + | #* Klicken Sie rechts auf den '''Dateien''' Punkt in der Liste. |
− | #* Wählen | + | #* Wählen Sie '''[Recompile all required]'''. |
− | #* Wenn gefragt wird "Re-Compile this and all required packages?" antworten | + | #* Wenn gefragt wird "Re-Compile this and all required packages?" antworten Sie '''[Ja]'''. |
− | #* Rekompilieren | + | #* Rekompilieren Sie Lazarus normal (mit Packages).<br><br> |
− | # Es gibt einen Bug in [[Glossary#Freepascal|FPC's]] [http://lazarus-ccr.sourceforge.net/docs/rtl/sysutils/ansistrcomp.html AnsiStrComp], welcher einen unzuverlässigen PChar Vergleich verursacht, das ist deutlich wenn ein DBGrid zum Bearbeiten der Daten verwendet wird | + | # Es gibt einen Bug in [[Glossary#Freepascal|FPC's]] [http://lazarus-ccr.sourceforge.net/docs/rtl/sysutils/ansistrcomp.html AnsiStrComp], welcher einen unzuverlässigen PChar-Vergleich verursacht, das ist deutlich, wenn ein DBGrid zum Bearbeiten der Daten verwendet wird. '''AnsiStrComp('abc', 'abcd')''' kann sie nicht als unterschiedlich erkennen aber es erkennt '''AnsiStrComp('abd', 'abcd')''' und ignoriert mehrere Zeichen in der zweiten Zeichenkette. Dieser Bug wurde von [[User:Jesusrmx|Jesusrmx]] gefunden. Er wird wahrscheinlich bald bereinigt, siehe [http://www.freepascal.org/bugs/showrec.php3?ID=4325 Bug Report]. |
Revision as of 20:14, 6 May 2011
│
Deutsch (de) │
English (en) │
español (es) │
français (fr) │
português (pt) │
русский (ru) │
中文(中国大陆) (zh_CN) │
Überblick
Dieses Tutorial handelt vom Bekommen, Installieren und Verwenden von Zeoslib mit Lazarus und FPC.
Das Zeos Team hat vor kurzem ein neues Forum erstellt. Bitte besuchen Sie das neue Forum für mehr Informationen über ZeosLib und um Fragen zu stellen / zu beantworten über die Verwendung von Zeos und um Bugs zu melden. Das neue Forum ist hier zu finden Forum für ZeosLib
Erhalten von Zeos
Sie können Zeos einfach mittels SVN erhalten, wenn Sie diesen Schritten folgen:
Windows
- Besorgen Sie sich einen SVN Client (z.B.TortoiseSVN) und installieren Sie diesen.
- Siehe Getting Started with TortoiseSVN
- machen Sie einen Checkout vom Windows Explorer aus: svn://zeos.firmos.at/zeos/trunk
Linux/BSD
- Besorgen Sie sich einen SVN Client (esvn, kdesvn, etc.)
- Erstellen Sie ein Verzeichnis zeosdbo, gehen in das Verzeichnis und starten
- svn checkout svn://zeos.firmos.at/zeos/trunk
Installieren der Komponenten
- Stellen Sie sicher, dass Sie den neuesten Lazarus Snapshot haben und mindestens FPC 2.0.3 nicht älter als vom 6. März 2006.
- Starten Sie eine Instanz von Lazarus.
- Benutzen Sie Komponenten/Paketdatei (.lpk) öffnen im Hauptmenü.
- Gehen Sie zu zeosdbo_rework\packages\lazarus\ und öffnen Sie zcomponent.lpk
- Drücken Sie [Kompilieren] nur dann, wenn Sie die Komponenten nicht in die IDE installieren wollen
- Drücken Sie [Installieren]
- Sie werden gefragt, ob Sie Lazarus rekompileren wollen.
- Antworten Sie diesmal mit [Yes] .
- Warten Sie bis die Kompilierung beendet ist. Lazarus sollte sich danach selbst neu starten.
- Wenn alles ok ist, sollten Sie jetzt den [Zeos Access] Tab in der Komponentenpalette sehen.
Wenn Sie die Fehlermeldung "Cannot find unit ZClasses" oder Ähnliches erhalten, prüfen Sie sorgfältig die Groß/Klein-Schreibung des Dateinamens Ihrer Zeos Dateien (orig.: Zeos source distribution).
Schreiben Sie alle Datei- und Verzeichnisnamen des zeoslib-Verzeichnisses in Kleinbuchstaben. (Mit dem freeware programm "freecommander" geht das z.B. ganz einfach) In Lazarus öffen Sie danach wieder alle Packages (.lpk) und passen die Schreibweise der Dateinamen an, indem Sie anklicken : "More..."/"Fix Files Case". Compile them.
- Auch wenn die Groß/Klein-Schreibung genau passt, können die automatisch erzeugten Package Quell-Dateien Namen mit falscher Schreibweise (Groß/klein) in der uses Clause erzeugen : (Lazarus 0.9.18), i.e.:
{ This file was automatically created by Lazarus. Do not edit! This source is only used to compile and install the package. } unit Zcore; interface uses Zclasses, Zcollections, Zcompatibility, Zexprparser, Zexprtoken, Zexpression, Zfunctions, Zmatchpattern, Zmessages, Zsysutils, Ztokenizer, Zvariables, Zvariant; implementation end.
- Beachten Sie, dass Lazarus die unit ZClasses in Zclasses umgeschrieben hat, so dass sich ein Namenskonflikt ergibt. Das scheint ein Lazarus-Fehler zu sein, keiner des Zeos-Packages. Eine Möglichkeit, diesen Konflikt zu umgehen ist es, alle Zeos-Quelldateinamen kleinzuschreiben. Gehen Sie durch alle Unterverzeichnisse unter src/ and führen den Sie folgenden Befehl in einer bash-Kommandozeile aus:
rename -v 'y/A-Z/a-z/' *
Anmerkungen
Erstellen Ihrer ersten Zeos-Anwendung
- Legen Sie eine ZConnection ab (auf Ihrem Formular).
- Setzen Sie ihren User, Password, Host, Port und Protocol (und jeden anderen Parameter falls benötigt).
- Setzen Sie Connected auf True.
- Legen Sie eine ZQuery ab (nicht mit ZReadOnlyQuery verwechseln).
- Setzen Sie Connection auf ihre aktive ZConnection.
- Setzen Sie die SQL-Eigenschaft auf etwas wie SELECT * FROM MyTable
- Setzen Sie Active auf True.
- Legen Sie eine DataSource vom [Data Access] Tab ab.
- Setzen Sie DataSet auf Ihre aktive ZQuery.
- Legen Sie ein DBGrid vom [Data Controls] Tab ab.
- Setzen Sie Datasource auf Ihre DataSource.
- Wenn alles ok ist, sollten Sie jetzt die Datensätze aus Ihrer Tabelle sehen.
Mehr Informationen über das Arbeiten mit Zeos
Hier können Sie einige wirklich hilfreiche Artikel finden, welche die Verwendung von Zeos beschreiben und seine Interna. Einige von ihnen handeln auch über Delphi-spezifischen Stoff, aber meistens können die gleichen Techniken ebenfalls in Lazarus verwendet werden.
- Die ZeosLib DBOs 6.1.5 - Mit Delphi 7 und Firebird 1.5
- Überblick über die Zeos Database Objects Architecture
- Eine Einführung in das ZDBC API
- Prüfen Sie auch den Downloads Abschnitt für echte Beispiele, welche einfach nach Lazarus portiert werden können.
Bitte ergänzen Sie diesen Bereich
Mögliche Bugs und Probleme
- Ich habe bemerkt, dass manchmal wenn Lazarus erstellt wird, einige Zeos-Dateien nicht gefunden werden, als provisorische Hilfe versuchen Sie dies:
- Benutzen Sie Komponenten/Paketgraph im Hauptmenü.
- Öffnen Sie das ZComponent Package.
- Klicken Sie rechts auf den Dateien Punkt in der Liste.
- Wählen Sie [Recompile all required].
- Wenn gefragt wird "Re-Compile this and all required packages?" antworten Sie [Ja].
- Rekompilieren Sie Lazarus normal (mit Packages).
- Es gibt einen Bug in FPC's AnsiStrComp, welcher einen unzuverlässigen PChar-Vergleich verursacht, das ist deutlich, wenn ein DBGrid zum Bearbeiten der Daten verwendet wird. AnsiStrComp('abc', 'abcd') kann sie nicht als unterschiedlich erkennen aber es erkennt AnsiStrComp('abd', 'abcd') und ignoriert mehrere Zeichen in der zweiten Zeichenkette. Dieser Bug wurde von Jesusrmx gefunden. Er wird wahrscheinlich bald bereinigt, siehe Bug Report.