Создание Pzl-Контейнера: различия между версиями
(не показано 6 промежуточных версий этого же участника) | |||
Строка 1: | Строка 1: | ||
Pzl-Контейнер - это место хранения Pzl-Компонент. В этом смысле как основное исполняемое приложение, так и DLL | {{copyright}} | ||
Pzl-Контейнер - это место хранения Pzl-Компонент. В этом смысле как основное исполняемое приложение, так и DLL являются Pzl-Контейнерами. | |||
Pzl-Технология предусматривает, что основное исполняемое приложение приобретает свойства Pzl-Контейнера вместе с наделением его свойствами Pzl-Порта. Следовательно, выполнив операцию добавления PzlPort к основному исполняемому приложению, мы, тем самым, создаем и Pzl-Контейнер исполняемого приложения. | Pzl-Технология предусматривает, что основное исполняемое приложение приобретает свойства Pzl-Контейнера вместе с наделением его свойствами Pzl-Порта. Следовательно, выполнив операцию добавления PzlPort к основному исполняемому приложению, мы, тем самым, создаем и Pzl-Контейнер исполняемого приложения. | ||
Строка 16: | Строка 18: | ||
Перечень свойств в вызванной форме включает | Перечень свойств в вызванной форме включает | ||
*[[#Базовая Директория Контейнеров|Containers Root Directory]] - Базовая директория Ваших Контейнеров | *[[#Базовая Директория Контейнеров|Containers Root Directory]] - Базовая директория Ваших Контейнеров | ||
*[[#Директория pzl-Контейнера|Containers SubDirectory]] - | *[[#Директория pzl-Контейнера|Containers SubDirectory]] - Маршрут к поддиректории, в которой будет создан проект контейнера. | ||
*[[#Имя Pzl-Контейнера|Container Name]] - Имя создаваемого Контейнера (это будет имя проекта .prj6) | *[[#Имя Pzl-Контейнера|Container Name]] - Имя создаваемого Контейнера (это будет имя проекта .prj6) | ||
*[[#Уровень лицензии|License Level]] - уровень лицензии | *[[#Уровень лицензии|License Level]] - уровень лицензии | ||
Строка 35: | Строка 37: | ||
Кнопка '''Close (Закрыть)''' закрывает форму. | Кнопка '''Close (Закрыть)''' закрывает форму. | ||
=Базовая Директория Контейнеров= | =Выполнение операции= | ||
При успешном выполнении операции в окно сообщений среды Elementary PzlStudio выводится отчет о произведенных изменениях проекте. | |||
[[Изображение:PzlStudio_ContainerCreatedMsg.png]] | |||
Созданный таким образом Dll-Контейнер можно теперь открыть с помощью IDE и откомпилировать. | |||
В проектном окне IDE пустой Dll-Контейнер, не содержащий pzl-Компонент, выглядит так | |||
[[Изображение:PzlStudio EmptyContainerProjectView.png]] | |||
=Параметры для создания Dll-Контейнера= | |||
==Базовая Директория Контейнеров== | |||
Собственно, это имя директории, установленной в [[Установка Базовых Свойств#User PzlConteiners Location|Базовых Свойствах]]. Если в Ваших намерениях по организации директорий ничего не изменилось, можно ничего здесь не менять. | Собственно, это имя директории, установленной в [[Установка Базовых Свойств#User PzlConteiners Location|Базовых Свойствах]]. Если в Ваших намерениях по организации директорий ничего не изменилось, можно ничего здесь не менять. | ||
Строка 48: | Строка 64: | ||
Если Вы согласитесь, то Вам будет теперь предлагаться в качестве значения по умолчанию это последнее имя базовой директории контейнеров. | Если Вы согласитесь, то Вам будет теперь предлагаться в качестве значения по умолчанию это последнее имя базовой директории контейнеров. | ||
Директория | ==Директория Dll-Контейнера== | ||
Директория Dll-Контейнера - это именно та директория, в которую будут помещены все файлы контейнера. | |||
Директорию Dll-Контейнера следует рассматривать как маршрут (например, в форме Дир1/Дир2/Дир3 или просто Дир1), который в совокупности с Базовой директорией контейнеров даст окончательный маршрут к директории, где будут создаваться файлы контейнера. | |||
Поле '''Директория | Поле '''Директория Dll-Контейнера''' не может быть пустым. | ||
Если директория, маршрут который создается в совокупности с Базовой директорией контейнеров не существует, то она будет создана без предупреждения. | Если директория, маршрут который создается в совокупности с Базовой директорией контейнеров не существует, то она будет создана без предупреждения. | ||
Если '''Директория | Если '''Директория Dll-Контейнера''' по каким-либо причинам не может быть создана, то появится диалог с сообщением об ошибке. | ||
'''''Обращаем внимание на то, что имя конечной | '''''Обращаем внимание на то, что имя конечной директории Dll-Контейнера и имя контейнера (проекта) могут различаться, хотя первоначально они будет предложены одинаковыми.''''' Это несколько отличается от правила, действующего в IDE системы Visual Prolog. Там, задав имя проекту, Вы однозначно определяете и имя директории, в которую будут сгенерированы файлы проекта. | ||
=Имя контейнера= | ==Имя контейнера== | ||
Имя контейнера определяет имя файла проекта <Имя Контейнера>.prj6. Должно быть не менее 8 символов. | Имя контейнера определяет имя файла проекта <Имя Контейнера>.prj6. Должно быть не менее 8 символов. | ||
=Уровень лицензии= | ==Уровень лицензии== | ||
Pzl-Система использует принцип лицензирования. | Pzl-Система использует принцип лицензирования. | ||
Строка 94: | Строка 111: | ||
[[Изображение:PzlContainerLicenseLevelErrorDlg.png]] | [[Изображение:PzlContainerLicenseLevelErrorDlg.png]] | ||
=Библиотека | ==Библиотека Dll-Контейнера== | ||
Это поле не редактируется и является справочным. Отражает имя библиотеки pzlContainer_X.lib, соответствующее уровню [[#Уровень лицензии|лицензии]] главного приложения. | Это поле не редактируется и является справочным. Отражает имя библиотеки pzlContainer_X.lib, соответствующее уровню [[#Уровень лицензии|лицензии]] главного приложения. | ||
=Версия | ==Версия Dll-Контейнера== | ||
Версия Pzl-Конейнера является строкой, контролируемой только пользователем. Все, что делает Elementary PzlStudio с этой информацией - помещает ее в качестве значения константы pzlContainerVersion_C в файле PzlConfig.i после его создания. | Версия Pzl-Конейнера является строкой, контролируемой только пользователем. Все, что делает Elementary PzlStudio с этой информацией - помещает ее в качестве значения константы pzlContainerVersion_C в файле PzlConfig.i после его создания. | ||
Строка 111: | Строка 128: | ||
</vip> | </vip> | ||
=Атрибуты из базовых свойств= | ==Атрибуты из базовых свойств== | ||
Последние три позиции в форме | Последние три позиции в форме | ||
*Company | *Company |
Текущая версия на 21:23, 22 ноября 2007
Автор: Виктор Юхтенко
Pzl-Контейнер - это место хранения Pzl-Компонент. В этом смысле как основное исполняемое приложение, так и DLL являются Pzl-Контейнерами.
Pzl-Технология предусматривает, что основное исполняемое приложение приобретает свойства Pzl-Контейнера вместе с наделением его свойствами Pzl-Порта. Следовательно, выполнив операцию добавления PzlPort к основному исполняемому приложению, мы, тем самым, создаем и Pzl-Контейнер исполняемого приложения.
Поэтому Elementary PzlStudio не содержит операций по созданию pzl-Контейнера в главном исполняемом приложении. А операция создания pzl-Контейнера в Elementary PzlStudio означает создание DLL, которая является pzl-Контейнером.
Проект, который соответствует Dll-контейнеру может быть создан и вручную с помощью IDE, но делать это не рекомендуется, поскольку это требует знания ряда деталей структуры проекта pzl-Контейнера. Вместо этого Elementary PzlStudio предлагает весьма простую операцию создания такого проекта.
Вызвав эту операцию, следует заполнить форму с основными свойствами pzl-Контейнера, и одним нажатием на кнопку Вы получаете готовый Pzl-Контейнер. Этот контейнер затем следует открыть с помощью IDE и запустить его построение.
Вызов операции
Форма для создания pzl-Контейнера вызывается через меню File/New.../Container.
Перечень свойств в вызванной форме включает
- Containers Root Directory - Базовая директория Ваших Контейнеров
- Containers SubDirectory - Маршрут к поддиректории, в которой будет создан проект контейнера.
- Container Name - Имя создаваемого Контейнера (это будет имя проекта .prj6)
- License Level - уровень лицензии
- Container Library - имя библиотеки
- Container Version - версия контейнера
- Company - имя компании
- Author - имя автора
- Copyright - авторские права
Редактирование значений свойств производится в правой части таблицы либо непосредственным редактированием (если допускается), либо вызовом следующего уровня редактирования нажатием на кнопку справа в активной строке. Двойной щелчек на поле редактирования равносилен нажатию на кнопу справа.
Операция выполняется по нажатию на кнопку Create (Создать).
Кнопка может быть неактивной, если введенных данных недостаточно для выполнения операции.
После выполнения операции форма остается активной и Вы можете продолжить создание pzl-Контейнеров.
Кнопка Close (Закрыть) закрывает форму.
Выполнение операции
При успешном выполнении операции в окно сообщений среды Elementary PzlStudio выводится отчет о произведенных изменениях проекте.
Созданный таким образом Dll-Контейнер можно теперь открыть с помощью IDE и откомпилировать.
В проектном окне IDE пустой Dll-Контейнер, не содержащий pzl-Компонент, выглядит так
Параметры для создания Dll-Контейнера
Базовая Директория Контейнеров
Собственно, это имя директории, установленной в Базовых Свойствах. Если в Ваших намерениях по организации директорий ничего не изменилось, можно ничего здесь не менять.
Но Базовую директорию контейнеров можно и поменять, выбрав в качестве базовой директории для контейнеров другую.
Двойной щелчек или нажатие на кнопку вызовут файловый диалог для выбора имени директории. Вы можете в Файловом диалоге установить и новое, не существующее имя директории. Elementary PzlStudio создаст ее, если это возможно.
Если Вы изменили имя базовой директории контейнеров относительно того, что установлено в Базовых Свойствах, то при закрытии формы будет задан вопрос о внесении изменения в Базовые Свойства.
Если Вы согласитесь, то Вам будет теперь предлагаться в качестве значения по умолчанию это последнее имя базовой директории контейнеров.
Директория Dll-Контейнера
Директория Dll-Контейнера - это именно та директория, в которую будут помещены все файлы контейнера.
Директорию Dll-Контейнера следует рассматривать как маршрут (например, в форме Дир1/Дир2/Дир3 или просто Дир1), который в совокупности с Базовой директорией контейнеров даст окончательный маршрут к директории, где будут создаваться файлы контейнера.
Поле Директория Dll-Контейнера не может быть пустым.
Если директория, маршрут который создается в совокупности с Базовой директорией контейнеров не существует, то она будет создана без предупреждения.
Если Директория Dll-Контейнера по каким-либо причинам не может быть создана, то появится диалог с сообщением об ошибке.
Обращаем внимание на то, что имя конечной директории Dll-Контейнера и имя контейнера (проекта) могут различаться, хотя первоначально они будет предложены одинаковыми. Это несколько отличается от правила, действующего в IDE системы Visual Prolog. Там, задав имя проекту, Вы однозначно определяете и имя директории, в которую будут сгенерированы файлы проекта.
Имя контейнера
Имя контейнера определяет имя файла проекта <Имя Контейнера>.prj6. Должно быть не менее 8 символов.
Уровень лицензии
Pzl-Система использует принцип лицензирования.
Лицензии различаются по уровням:
- Public - публичная
- Commercial - коммерческая
- Exclusive - эксклюзивная (исключительная)
- SuperExclusive
Уровень лицензии устанавливается:
- для главного приложения - библиотекой pzlPort_X.lib
- для pzl-Контейнера - библиотекой pzlContainer_X.lib
где X - идентификатор уровня лицензии.
Dll-Контейнер не может иметь уровень SuperExclusive. Этот уровень может иметь только PzlPort, причем, созданный компанией-разработчиком Pzl-Технологии.
Соответствие уровня лицензии и идентификатора библиотеки приведено ниже:
- Public - pzlContainer_P.lib
- Commercial - pzlContainer_C.lib
- Exclusive - pzlContainer_EX.lib (X - персонифицирующий идентификатор)
Поэтому при создании нового контейнера Вы должны установить уровень лицензии, которым должно обладать Ваш контейнер. Выбор уровня лицензии однозначно определяет выбор имени pzl-библиотеки, которая будет включена в проект. В случае, если выбирается уровень лицензии Exclusive, то этому уровню может соответствовать множество библиотек уровня Exclusive.
PzlStudio предлагает значение по умолчанию - Public, которому соответствует библиотека pzlContainer_P.lib.
При выборе уровня лицензии, Elemantary PzlStudio автоматически установливает имя библиотеки в поле Container Library (это поле не редактируется, а является справочным). Если выбирается уровень лицензии Exclusive, то Вам предлагается файловый диалог со списком имеющихся в Вашем распоряжении библиотек. Вы должны выбрать одну из библиотек, относящися к библиотекам уровня Exclusive. Если выбрана библиотека, не относящаяся к уровню Exclusive, то появляется сообщение
Библиотека Dll-Контейнера
Это поле не редактируется и является справочным. Отражает имя библиотеки pzlContainer_X.lib, соответствующее уровню лицензии главного приложения.
Версия Dll-Контейнера
Версия Pzl-Конейнера является строкой, контролируемой только пользователем. Все, что делает Elementary PzlStudio с этой информацией - помещает ее в качестве значения константы pzlContainerVersion_C в файле PzlConfig.i после его создания.
interface iPzlConfig constants pzlContainerVersion_C="1.0;001". % Container Configuration constants end interface iPzlConfig
Атрибуты из базовых свойств
Последние три позиции в форме
- Company
- Author
- Copyright
устанавливаются в Базовых свойствах и здесь могут быть переопределены в случае, отличном от типового. Если Вы их здесь изменили, то значения этих параметров в Базовых свойствах не изменяются.