Difference between revisions of "Project Templates/ru"
Line 79: | Line 79: | ||
</code> | </code> | ||
− | ''Необязательно:'' | + | '''Необязательно:''' |
− | |||
Приятной особенностью Project Templates является то, что они поддерживают переменные. Так как проект, вероятно, не будет называться так же, как ваш пример шаблона, вам придется внести некоторые изменения в код и переименовать файл. | Приятной особенностью Project Templates является то, что они поддерживают переменные. Так как проект, вероятно, не будет называться так же, как ваш пример шаблона, вам придется внести некоторые изменения в код и переименовать файл. | ||
− | ''' | + | '''Файлы''': |
− | + | Переименуйте файл проекта (ico, lpi, lpr, res) в __PROJNAME __. Ext (где расширение, конечно, является исходным расширением). | |
− | + | Например: project.lpi становится __PROJNAME __. Lpi. | |
− | + | Примечание: содержимое файла lpi может нуждаться в некоторой очистке, например, удаление истории, ссылки на файлы, даже если вы не уверены, нужен ли файл lpi. | |
− | ''' | + | '''Содержимое файла''': |
− | + | Для всех файлов, которые ссылаются на project.lpi и т.д., измените содержимое ваших файлов, чтобы все ссылки на "project" превратились в "__PROJNAME__" (с кавычками) | |
− | + | Вы можете опционально определить свои собственные переменные, например, чтобы дать "unit.pas" другое имя файла. | |
− | + | Например, вы можете определить __MAINUNIT__ и __MAINFORM__ в project.ini как MAINUNIT и MAINFORM - во время создания Lazarus запросит у вас эти имена. | |
− | + | Теперь каждое вхождение __MAINUNIT__, например, будет заменено предоставленным вами текстом (избегайте специальных символов и пробелов). | |
− | + | Обратите внимание, что это работает для всех переменных; | |
− | + | Каждое вхождение переменной в именах файлов и содержимом файла будет заменено тем, что вы ввели при создании нового проекта на основе вашего шаблона. Предопределенными переменными являются PROJNAME и PROJDIR, но я пока не нашел назначения для PROJDIR. | |
− | + | Некоторые примеры: | |
− | project.ini | + | '''project.ini''' |
<syntaxhighlight> | <syntaxhighlight> | ||
Line 113: | Line 112: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | __PROJNAME__.lpr: | + | '''__PROJNAME__.lpr''': |
<syntaxhighlight> program __PROJNAME__; | <syntaxhighlight> program __PROJNAME__; | ||
Line 135: | Line 134: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | __MAINUNIT__.pas: | + | '''__MAINUNIT__.pas''': |
<syntaxhighlight> unit __MAINUNIT__; | <syntaxhighlight> unit __MAINUNIT__; | ||
Line 161: | Line 160: | ||
− | __MAINUNIT__.lfm: | + | '''__MAINUNIT__.lfm''': |
object __MAINFORM__: T__MAINFORM__ | object __MAINFORM__: T__MAINFORM__ | ||
Line 167: | Line 166: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | Имейте в виду, что этот краткий учебник только для начинающих, предлагаемый механизм замены переменных может использоваться для самых разных целей. | |
− | + | Например, чтобы определить заголовок формы, заявление об авторском праве, веб-ссылку на ваши формы, конкретные объекты и т.д. | |
--[[User:Hansaplast|Hansaplast]] 16:30, 4 August 2012 (UTC) | --[[User:Hansaplast|Hansaplast]] 16:30, 4 August 2012 (UTC) | ||
[[Category:Lazarus]] | [[Category:Lazarus]] | ||
[[Category:IDE]] | [[Category:IDE]] |
Revision as of 00:31, 22 December 2018
Обзор
Вы можете приспособиться при создании новых проектов. Среда IDE позволяет регистрировать собственные типы проектов с помощью пакетов designtime. Пакет projtemplates ( он предварительно установлен в обычных бинарных пакетах Lazarus) позволяет просто использовать существующие проекты в качестве шаблонов.
Пакет projtemplates
Этот пакет реализует шаблоны проектов и поставляется с исходными кодами lazarus (components/projecttemplates/projtemplates.lpk).
Пакет поставляется с предустановленными бинарными пакетами Lazarus (например, установщик Windows). Этот пакет добавляет категорию в диалог File-New: Template projects
Он также добавляет пункт меню New project from Template в меню File, а также меню project template options в разделе Tools [общего] меню. Этот пункт меню отображается только в том случае, если каталог шаблонов (см. следующий абзац) существует и содержит хотя бы один подкаталог шаблонов.
В [разделе] Project template options можно выбрать каталог. Этот каталог должен содержать подкаталог для каждого шаблона. Каждый каталог шаблонов содержит шаблон для проекта: набор файлов, которые будут скопированы и использованы в качестве нового проекта.
Во время копирования пакет будет сканировать имена файлов/каталогов и содержимое файлов для подстановки переменных: __VARNAME__ будет заменено значением переменной VARNAME
По умолчанию движок знает о 2 переменных:
- ProjDir: Каталог, в котором будет создан новый проект.
- ProjName: Название проекта.
Дополнительные переменные должны быть определены в файле с именем project.ini в каталоге проекта. Это - файл в формате Windows INI.
Раздел [Variables] будет сканироваться на предмет имен переменных:
[Variables] VarName1=Description 1 VarName2=Description 2
Найденные переменные будут представлены с их описанием в диалоговом окне, и пользователь должен представить значение для переменных.
Файл project.ini может содержать второй раздел, называемый Project, который может содержать некоторую информацию о проекте. Здесь можно найти следующие ключевые слова:
ProjectFile
Любой файл с именем, равным этому (без расширения), обрабатывается специально, он переименовывается в имя проекта. То есть, вот это ProjectFile=example заменит example.lpi, example.lpr и example.cfg на имя, данное пользователем. По умолчанию предполагается, что значением ProjectFile является project (обратите внимание, что файл .ini не копируется)
Name
Название шаблона. Имя и описание будут представлены в диалоге 'File-New'.
Author
Автор шаблона
Description
Краткое (однострочное) описание проекта. Имя и описание будут представлены в диалоге 'File-New'.
Recurse
Логическое значение (1/0), которое указывает движку [осуществлять] рекурсивный [поиск] в подкаталогах или нет.
Exclude
Разделенный запятыми список расширений имени файла, которые не следует искать для подстановки ключевых слов.
Как начать
Шаг 1;
Создайте свой собственный каталог шаблонов (например, ~ /.lazarus/mytemplates) и установите этот путь в Lazarus (меню: Tools -> Project Template Options).
Шаг 2:
Чтобы любые шаблонные функции появились в меню File Lazarus'а, вам понадобится как минимум один шаблон, который вы можете использовать в своем существующем (обычном) проекте;
- Создайте каталог в вашем каталоге шаблонов (например, ~/.lazarus/mytemplates/myfirsttemplate)
- Скопируйте файлы вашего проекта в этот новый каталог (*.lfm, *.pas, *.ico, *.lpi, *.lpr, *.res)
Шаг 3:
Создайте файл project.ini в новом каталоге шаблонов.
Минимум, [файл] должен выглядеть примерно так:
project.ini:
[Variables]
[Project]
Name=My Form Template
Необязательно: Приятной особенностью Project Templates является то, что они поддерживают переменные. Так как проект, вероятно, не будет называться так же, как ваш пример шаблона, вам придется внести некоторые изменения в код и переименовать файл.
Файлы: Переименуйте файл проекта (ico, lpi, lpr, res) в __PROJNAME __. Ext (где расширение, конечно, является исходным расширением). Например: project.lpi становится __PROJNAME __. Lpi. Примечание: содержимое файла lpi может нуждаться в некоторой очистке, например, удаление истории, ссылки на файлы, даже если вы не уверены, нужен ли файл lpi.
Содержимое файла: Для всех файлов, которые ссылаются на project.lpi и т.д., измените содержимое ваших файлов, чтобы все ссылки на "project" превратились в "__PROJNAME__" (с кавычками)
Вы можете опционально определить свои собственные переменные, например, чтобы дать "unit.pas" другое имя файла. Например, вы можете определить __MAINUNIT__ и __MAINFORM__ в project.ini как MAINUNIT и MAINFORM - во время создания Lazarus запросит у вас эти имена. Теперь каждое вхождение __MAINUNIT__, например, будет заменено предоставленным вами текстом (избегайте специальных символов и пробелов).
Обратите внимание, что это работает для всех переменных; Каждое вхождение переменной в именах файлов и содержимом файла будет заменено тем, что вы ввели при создании нового проекта на основе вашего шаблона. Предопределенными переменными являются PROJNAME и PROJDIR, но я пока не нашел назначения для PROJDIR.
Некоторые примеры:
project.ini
[Variables]
MAINUNIT=Filename for the default unit.pas file
MAINFORM=Form name
[Project]
Name=My Custom Form
Author=Hansaplast
Description=Lazarus LCL form specifically for my needs
__PROJNAME__.lpr:
program __PROJNAME__;
{$mode objfpc}{$H+}
uses
{$IFDEF UNIX}{$IFDEF UseCThreads}
cthreads,
{$ENDIF}{$ENDIF}
Interfaces, // this includes the LCL widgetset
Forms, __MAINUNIT__;
{$R *.res}
begin
Application.Initialize;
Application.CreateForm(T__MAINFORM__, __MAINFORM__);
Application.Run;
end.
__MAINUNIT__.pas:
unit __MAINUNIT__;
{$mode objfpc}{$H+}
interface
uses
Classes, SysUtils, FileUtil, Forms, Controls, Graphics, Dialogs, ExtCtrls,
Buttons, StdCtrls, LCLIntf, LCLType, ComCtrls;
type
{ __MAINFORM__ }
T__MAINFORM__ = class(TForm)
...
procedure T__MAINFORM__.FormPaint(Sender: TObject);
...
//etc
'''__MAINUNIT__.lfm''':
object __MAINFORM__: T__MAINFORM__
...
Имейте в виду, что этот краткий учебник только для начинающих, предлагаемый механизм замены переменных может использоваться для самых разных целей. Например, чтобы определить заголовок формы, заявление об авторском праве, веб-ссылку на ваши формы, конкретные объекты и т.д. --Hansaplast 16:30, 4 August 2012 (UTC)