Difference between revisions of "Zeos tutorial/ru"

From Free Pascal wiki
Jump to navigationJump to search
Line 33: Line 33:
 
= Установка компонентов =
 
= Установка компонентов =
  
This is a tricky part so you should have a little patience and read this part carefully.
+
Это сложная часть, поэтому вам следует проявить немного терпения и внимательно прочитать эту часть.
* Make sure you have the latest [http://www.de.freepascal.org/lazarus/ Lazarus snapshot] and the at least FPC 2.0.3 not older than 6th March 2006.
+
* Убедитесь, что у вас последний [http://www.de.freepascal.org/lazarus/ снапшот Lazarus] и версия FPC 2.0.3 не ранее 6 марта 2006г.
* Start one instance of Lazarus.
+
* Запустите один экземпляр Lazarus.
# Use '''Components/Open Package File(.lpk)''' from the main menu.
+
# Используйте '''Components/Open Package File(.lpk)''' из главного меню.
# Go to '''zeosdbo_rework\packages\lazarus\''' and open '''zcomponent.lpk'''
+
# Перейдите в '''zeosdbo_rework\packages\lazarus\''' и откройте '''zcomponent.lpk'''
# Press '''[Compile]''' only if you don't want to install the components into the IDE
+
# Нажмите только '''[Compile]''' в том случае, если вы не хотите устанавливать компоненты в IDE
# Press '''[Install]'''
+
# Нажмите '''[Install]'''
# You are asked if you want to recompile Lazarus.  
+
# Вас спросят, хотите ли вы перекомпилировать Lazarus.
* Answer '''[Yes]''' this time.
+
* Ответьте '''[Yes]''' на этот раз.
* Wait until compilation ends, Lazarus should restart itself after that.
+
* Дождитесь завершения компиляции, после этого Lazarus должен перезапуститься.
* If all is ok you should now be able to see the '''[Zeos Access]''' tab in the Component Palette.
+
* Если все в порядке, теперь вы должны увидеть вкладку '''[Zeos Access]''' на палитре компонентов.
 +
 
 +
----
 +
[[user:zoltanleo|Прим.перев]]: на момент перевода статьи (май 2021г) установка немного изменилась:
 +
* качаете исходный код отсюда https://svn.code.sf.net/p/zeoslib/code-0/trunk
 +
* открываете файл zeos\packages\lazarus\zcomponentdesign.lpk
 +
* жмете последовательно '''[Compile]''' и '''[Install]'''
 +
* пересобираете Лазарус
 +
----
  
 
[[image:Zeos_Components.png]]
 
[[image:Zeos_Components.png]]
  
If you receive the error "Cannot find unit ZClasses" or something similar, then you need to carefully check the case of the filenames in your Zeos source distribution.
+
Если вы получаете сообщение об ошибке "Cannot find unit ZClasses"(Не удается найти модуль ZClasses) или что-то подобное, вам необходимо внимательно проверить регистр имен файлов в исходном дистрибутиве Zeos.
* Even if the cases match exactly, the autogenerated package source file can generate the wrong case name in the uses clause (Lazarus 0.9.18), i.e.:
+
* Даже если случаи полностью совпадают, автоматически сгенерированный исходный файл пакета может сгенерировать неправильное имя случая в разделе uses (Lazarus 0.9.18), то есть:
 
    
 
    
 
<syntaxhighlight lang=pascal>
 
<syntaxhighlight lang=pascal>
Line 64: Line 72:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
* Notice that Lazarus has named the unit ZClasses Zclasses, resulting in a naming conflict. Presumably this is a bug in Lazarus, not the Zeos packages. One way around this is to rename all the zeos source files to lowercase. Trawl through each subdirectory under src/ and execute this command in a bash window:
+
* Обратите внимание, что Lazarus переименовал модуль Z<b>C</b>lasses на Z<b>c</b>lasses, что привело к конфликту имен. Предположительно это ошибка в Lazarus, а не в пакетах Zeos. Один из способов обойти это - переименовать все исходные файлы zeos в нижний регистр. Просмотрите каждый подкаталог в src/ и выполните эту команду в окне bash:
  
 
   rename -v 'y/A-Z/a-z/' *
 
   rename -v 'y/A-Z/a-z/' *
  
* Then, in Lazarus, reopen the package (.lpk) and fix the filename cases by clicking on "More..."/"Fix Files Case"
+
* Затем в Lazarus повторно откройте пакет (.lpk) и исправьте регистры имен файлов, нажав "More..."/"Fix Files Case"(Еще .../Исправить регистр файлов).
* The package should compile now.
+
* Теперь пакет должен скомпилироваться.
  
 
= Make your first Zeos application =
 
= Make your first Zeos application =

Revision as of 17:01, 19 May 2021

Deutsch (de) English (en) español (es) français (fr) português (pt) русский (ru) 中文(中国大陆)‎ (zh_CN)

Databases portal

References:

Tutorials/practical articles:

Databases

Advantage - MySQL - MSSQL - Postgres - Interbase - Firebird - Oracle - ODBC - Paradox - SQLite - dBASE - MS Access - Zeos

Обзор

Это руководство посвящено получению, установке и использованию Zeoslib с Lazarus и FPC.

Получение Zeos

Zeos недавно был перенесен на Lazarus, и пока нет выпусков, которые официально поддерживают его, но вы можете легко получить его из SVN, если выполните следующие действия:

SVN

Windows

Linux/BSD

  • FreeBSD поставляется с предустановленным svnlite (клиент svn)
  • получите клиент SVN (esvn, kdesvn и т.д.)
  • создайте каталог zeosdbo, перейдите в этот каталог и выполните
  • svn checkout http://svn.code.sf.net/p/zeoslib/code-0/trunk

ZIP

Вы можете скачать последнюю версию в виде ZIP-файла с sourceforge.net:

Установка компонентов

Это сложная часть, поэтому вам следует проявить немного терпения и внимательно прочитать эту часть.

  • Убедитесь, что у вас последний снапшот Lazarus и версия FPC 2.0.3 не ранее 6 марта 2006г.
  • Запустите один экземпляр Lazarus.
  1. Используйте Components/Open Package File(.lpk) из главного меню.
  2. Перейдите в zeosdbo_rework\packages\lazarus\ и откройте zcomponent.lpk
  3. Нажмите только [Compile] в том случае, если вы не хотите устанавливать компоненты в IDE
  4. Нажмите [Install]
  5. Вас спросят, хотите ли вы перекомпилировать Lazarus.
  • Ответьте [Yes] на этот раз.
  • Дождитесь завершения компиляции, после этого Lazarus должен перезапуститься.
  • Если все в порядке, теперь вы должны увидеть вкладку [Zeos Access] на палитре компонентов.

Прим.перев: на момент перевода статьи (май 2021г) установка немного изменилась:

  • качаете исходный код отсюда https://svn.code.sf.net/p/zeoslib/code-0/trunk
  • открываете файл zeos\packages\lazarus\zcomponentdesign.lpk
  • жмете последовательно [Compile] и [Install]
  • пересобираете Лазарус

Zeos Components.png

Если вы получаете сообщение об ошибке "Cannot find unit ZClasses"(Не удается найти модуль ZClasses) или что-то подобное, вам необходимо внимательно проверить регистр имен файлов в исходном дистрибутиве Zeos.

  • Даже если случаи полностью совпадают, автоматически сгенерированный исходный файл пакета может сгенерировать неправильное имя случая в разделе uses (Lazarus 0.9.18), то есть:
{ 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.
  • Обратите внимание, что Lazarus переименовал модуль ZClasses на Zclasses, что привело к конфликту имен. Предположительно это ошибка в Lazarus, а не в пакетах Zeos. Один из способов обойти это - переименовать все исходные файлы zeos в нижний регистр. Просмотрите каждый подкаталог в src/ и выполните эту команду в окне bash:
 rename -v 'y/A-Z/a-z/' *
  • Затем в Lazarus повторно откройте пакет (.lpk) и исправьте регистры имен файлов, нажав "More..."/"Fix Files Case"(Еще .../Исправить регистр файлов).
  • Теперь пакет должен скомпилироваться.

Make your first Zeos application

  • Drop a ZConnection.
    • Set your User, Password, Host, Port and Protocol (and any other params if needed).
    • Set Connected to True.
  • Drop a ZQuery (do not mistake with ZReadOnlyQuery).
    • Set the Connection to your active ZConnection.
    • Set the Sql property to something like SELECT * FROM MyTable
    • Set Active to True.
  • Drop a DataSource from the [Data Access] tab.
    • Set the DataSet to your active ZQuery.
  • Drop a DBGrid from the [Data Controls] tab.
    • Set the Datasource to your DataSource.
    • If all is ok you should now be able to see the records from your table.

Possible Bugs and Issues

  • I have noticed that sometimes when building Lazarus it cannot find some Zeos files, as a quick workaround try this:
    • Use Components/Package Graph from the main menu.
    • Open the ZComponent package.
    • Right Click on the Files item in the list.
    • Choose [Recompile all required].
    • When asked "Re-Compile this and all required packages?" answer [Yes].
    • Recompile Lazarus normally (with packages).

See also