next_inactive up previous


GradC++ ToolBox: Руководство администратора
DocumentId:GradSoft-PR-r-09.04.2000-v1.2.0


Contents

Общие сведения

Состав и назначение пакета

Пакет GradC++ToolBox - это набор из нескольких кроссплатформенных компонент на C++, каждая из которых предназначена для решения простой, но часто возникающей задачи:

-
реализации шаблонов умных указателей;
-
организации многопоточности;
-
обработки командной стороки;
-
записи информационных и отладочных сообщений;
-
чтения директории;
-
создания потоков управления и т.п.
Мы можем предложить пакет тем разработчикам ПО на С++, которые, c одной стороны, хотели бы освободить себя от части рутинной работы, с другой - хотят писать переносимый код для UNIX и для Windows NT. Данное руководство описывает порядок получения, инсталляции и использования пакета GradC++ToolBox версии 1.6.0 Пакет GradC++ToolBox 1.6.0 включает следующие компоненты:
  1. ptrs - набор шаблонов умных указателей;
  2. Threading - набор классов для организации мультипотоковых программ;
  3. ProgOptions - класс для обработки опций командной строки;
  4. Logger - класс для записи информационных и отладочных сообщений;
  5. DirectoryContainer - набор классов для чтения списков файлов, поддерживаемых операционной системой компьютера;
  6. DynamicModules -компонета для динамической загрузки разделяемых библиотек.
  7. ServiceOptions - специализация ProgOptions для CORBA сервисов;
Вы можете установить у себя все перечисленные компоненты, либо, как вариант, все не связанные с CORBA компоненты пакета (т.е. ptrs, Threading, ProgOptions, Logger, DirectoryContainer и DynamicModules) в одном процессе инсталляции, "одним движением руки" - и так рекомендуется. Кроме того, взявшись учитывать связи между отдельными компонентами пакета, разные компоненты можно устанавливать отдельно.

Где взять

Последняя версия пакета GradC++ToolBox всегда доступна на сайте разработчика по адресу http://www.gradsoft.com.ua

При условии соблюдения лицензии (файл LICENSE.rus из комплекта поставки) пакет GradC++ToolBox распространяется бесплатно.

Авторская группа

Пакет GradC++ToolBox разработан компанией GradSoft, домашняя страничка GradSoft http://www.gradsoft.com.ua

Порядок инсталляции пакета

Общие сведения

Пакет GradC++ToolBox распространяется в исходных кодах, его установка включает следующие действия:

  1. компиляцию исходного кода в окружении пользователя;
  2. копирование заголовочных файлов и созданных при компиляции библиотек в указанные пользователем каталоги.
В процессе работы Вы можете:
  1. откомпилировать пакет;
  2. переписать ("инсталлировать") файлы;
  3. удалить объекты, созданные в процессе компиляции;
  4. удалить переписанные файлы
при помощи команды make с нужными опциями (см. ниже).

Необходимое ПО

  1. Компилятор C++ :
  2. make:
  3. CORBA ORB (не требуется, если вы не используете ServiceOptions):

Порядок инсталляции под UNIX

  1. Убедиться, что необходимое ПО установленно и работатет.
  2. Развернуть архив Gen-1.6.3.tar.gz либо Gen-1.6.3.zip в избранном Вами каталоге (в дальнейшем этот каталог мы будем называть "корневым каталогом проекта", и обозначать <project_root>).
  3. Перейти в этот каталог.
  4. Запустить configure командой ./configure с нужными опциями (список опций выводтися при запуске ./configure с опцией --help; в частности, можно задать опцию --prefix=<smth> для назначения каталога инсталляции либо опцию --with-corba=<yes/no> для того, чтобы указать объем компиляции/инсталляции)
  5. Запустить компиляцию, с помощью команды gmake
  6. Перейти в root режим с помощью команды su
  7. Запустить инсталляцию с помощью команды gmake install
  8. Для деинсталяции пакета можно воспользоваться командой gmake uninstall

Замечание:

Порядок инсталляции под Windows NT

  1. Убедиться, что необходимое ПО установленно и работатет. В настоящее время для работы с MSVC требуется, чтобы:
    1. переменные среды пользователя INCLUDE и LIB были определены и содержали пути к включаемым файлам и библиотекам MSVC соответственно.
    2. пути к утилитам nmake, cl, link были прописаны в переменной среды пользователя PATH.
  2. Развернуть архив Gen-1.6.3.tar.gz либо Gen-1.6.3.zip в избранном Вами каталоге (пусть его имя будет <project_root>), отредактировать файл environment.nt.mak в подкаталоге <project_root>\config\Win32, а также одноименный файл environment.nt.mak в подкаталоге <project_root>\CORBA\config\Win32 в том случае, если Вы собираетесь использовать ServiceOptions. При редактировании установить значения следующих nmake-переменных:

I.

<project_root>\config\Win32\environment.nt.mak:

II.

<project_root>\CORBA\config\Win32\environment.nt.mak:

Для компиляции пакета перейти в каталог <project_root> и воспользоваться командой make ( make build ), если Вы НЕ собираетесь использовать ServiceOptions, либо командой make with-corba (make with-corba build, make build with-corba - все равно), если собираетесь.

Для инсталляции пакета перейти в каталог <project_root> и воспользоваться командой make install, если Вы НЕ собираетесь использовать ServiceOptions, либо make install with-corba, если собираетесь.

Для удаления инсталлированных файлов перейти в каталог <project_root> и воспользоваться командой make uninstall либо make with-corba uninstall соответственно тому, используете ли Вы ServiceOptions.

Для для удаления файов, созданных в процессе компиляции перейти в каталог <project_root> и воспользоваться командой make clean либо make with-corba clean соответственно.

Для компиляции, инсталляции, удаления инсталлированных файлов и файлов, созданных в процессе компиляции в пределах одной отдельно взятой компоненты - перейти в соответствующий ей каталог (один из:

и воспользоваться командой make с опциями build, install, uninstall и clean соответственно.

Замечание:

Если вы скажете make install без предварительной компиляции пакета (компонеты), компиляция будет запущена автоматически в объеме, достаточном для инсталляции пакета (компоненты), однако тестовые примеры компилироваться не будут.

Тестирование

Общие сведения

Тестовые примеры, входящие в комплект поставки пакета GradC++ToolBox, соответствует примерам использования пакетов Threading, ProgOptions, ServiceOptions, Logger, DirectoryContainer и DynamicModules, приведенным в руководствах программиста для каждого пакета. Для того, чтобы было, что запускать, надо сначала откомпилировать пакет.

Порядок тестирования

ProgOptions

ServiceOptions

Logger

DirectoryContainer

Threading

Поочередно перейти в каталоги убедиться, что исполняемые файлы созданы и работают.

DynamicModules

Использование

A.

Windows NT: переменная препроцессора WIN32 должна быть определена перед включением любого из заголовочных файлов пакета GradC++ToolBox

B.

Программы, которые будут использовать возможности отдельных компонент GradC++ToolBox, должны компилироваться со следующими библиотеками:

Для Unix:

компонента статические библиотеки
  динамические библиотеки
ProgOptions libProgOptions.a
  libProgOptions.so
ServiceOptions libServiceOptions.a, libProgOptions.a
  libServiceOptions.so, libProgOptions.so
Threading libThreading.a
  libThreading.so
Logger libLogger.a, libThreading.a
  libLogger.so, libThreading.so
DirectoryContainer libDirectoryContainer.a, libThreading.a
  libDirectoryContainer.so, libThreading.so
DynamicModules libDynamicModules.a
  libDynamicModules.so



Для Windows NT:

компонента статические библиотеки
ProgOptions ProgOptions.lib
ServiceOptions ServiceOptions.lib, ProgOptions.lib
Threading Threading.lib
Logger Logger.lib, Threading.lib
DirectoryContainer DirectoryContainer.lib
DynamicModules DynamicModules.lib


Зависимости

Если вы компилируете компоненты GradC++TooolBox по отдельности, Вы должны учитывать следующие связи между ними:

Т. е. получающаяся диаграмма зависимостей: 

 ptrs                  ProgOptions
  |                        |
  *-- Threading            *--ServiceOptions
         |
         |
         *--Logger
         |
         *--DirectoryContainer

История документа

11.03.2003
  1. Добавлено описание тестирования с Mico ORB.
  2. изменен номер версии (1.6.0 -> 1.6.3)
28.08.2002
  1. изменен номер версии (1.5.0 -> 1.6.0)
  2. изменен номер версии поддерживаемого компилятора Sun CC.
28.03.2002
  1. изменен номер версии (1.4.2 -> 1.5.0)
  2. добавлено описание компоненты ptrs
  3. добавлена диаграмма зависимостей.
06.02.2002
- изменен номер версии (1.4.1 -> 1.4.2)
24.01.2002
- изменен номер версии (1.4.0 -> 1.4.1)
28.12.2001
- изменения, отражающие:
  1. изменения в порядке компиляции пакета под Windows NT;
  2. добавление возможности использовать omniORB и TAO под Windows NT;
  3. добавление новой компоненты пакета DynamicModules.
17.09.2001
- оптимизация ;)
16.09.2001
- добавлено описание компоненты DirectoryContainer
04.07.2001
- изменен номер порта для запуска тестового примера из пакета ServiceOptions (1100 вместо 1025).
29.04.2001
- исправлено несколько опечаток
14.02.2001
- добавлена информация о параметрах ORB в разделе "тестирование ServiceOptions"
09.04.2000
- создан

next_inactive up previous
GradSoft