Инструкция по сборке PSS OpenSource Введение. Система PSS, поставляемая в виде исходных кодов (далее «PSS - OpenSource») предназначена для упрощения разработки приложений под PSS. Наличие исходных кодов упрощает отладку приложений, разрабатываемых пользователем, и дает возможность изучения внутренних механизмов. «PSS - OpenSource» представляет из себя набор исходных кодов проектов PSS, достаточных для сборки полноценного клиента PSS (в частности, PSM.exe). При использовании «PSS - OpenSource» разработчик может собрать своего клиента PSS и использовать его при отладке своих проектов, например, для просмотра работы функций API PSS. 1. Настройка путей Visual Studio 2008: Для настройки путей необходимо в главном меню выбрать «Tools \ Options». В открывшемся диалоге слева выбрать «Projects and Solutions \ Visual C++ Directories» Справа в поле «Show Directories for:» выбрать «Include files» и задать пути «D:\_SWH\__debug\vc8» и «D:\_SWH\__release\vc8» (Рис.1) Рис.1. 1 Аналогично задать путь для «Library files» (Рис.2) Рис.2. Внимание! Внимательно следите за тем, какие пути у Вас настроены. Для сборки проекта под вариант OpenSource должны быть заданы пути, которые приведены на рисунках. Для сборки проекта под конкретную версию PSS необходимо вместо этих двух путей указывать один путь «С:\Program Files\PSS\_API\» (Или другой, если PSS установлено по другому пути) причем как для «Include files», так и для «Library files». Проект, собранный с путями для OpenSource не будет работать с PSS из дистрибутива. Даже если он запустится, он может работать некорректно. Аналогично проект, собранный с путями из дистрибутива, не будет работать с файлами собранными в OpenSource. 2. Сборка клиента PSS 1. Распакуйте архив с исходными кодами в папку D:\_SWH 2. Запустите BuildPSS_vc8.exe и откройте файл pss_opensrc.bld (Рис. 3). Если выполняется только разработка, рекомендуется компилировать «Только Debug». Для сборки финальной версии выберите в поле «Компилировать» значение «Все». Галочка «Компилять для VisualStudio 2008» должна быть установлена. Рекомендуется установить низкий приоритет (на скорость компиляции особо не влияет, но на компьютере можно будет параллельно что-то делать). 2 Количество параллельно компилируемых проектов лучше установить равным количеству ядер процессора. Рис. 3. 3. Нажмите кнопку «Поехали» 4. После окончания компиляции Вы получите полноценный клиент PSS: Debug – в папке D:\_SWH\__debug\vc8 Release – в папке D:\_SWH\__release\vc8 При правильной настройке путей нужные заголовочные и библиотечные файлы в Вашем проекте будут использованы автоматически. 3 3. Сборка и отладка своего проекта В свойствах своего проекта укажите (Рис. 4): Character Set: Use Multi-Byte Character Set Output Directory: для Debug: d:\_swh\__Debug\vc8 для Release: d:\_swh\__Release\vc8 Рис. 4. Если Ваш проект – это plugin для PSM.exe, то в свойствах проекта укажите запуск PSM.exe для отладки (Рис. 5). Звездочка в параметрах командной строки означает, что при запуске автоматически будет выведен запрос на соединение с БД. Также в качестве параметров можно использовать строку типа: «* /user=Administrator /db=DEMO /password=11» При таких параметрах будет использовано подключение «DEMO» с именем пользователя «Administrator» и паролем «11». Если пароль пустой, то после “/password=” надо поставить пробел: «* /user=Administrator /db=DEMO /password= » 4 Рис. 5. 4. Рекомендации 4.1. Организация разработки приложений В случае участия в разработке приложений под PSS нескольких сотрудников, во избежание путаницы с версиями PSS и настройками путей имеет смысл: 1. Каждому сотруднику разрабатывать приложения и отлаживать приложения на своем компьютере с использованием «PSS-OpenSource», с соответствующей настройкой путей VisualStudio. 2. Сборку приложений для тестирования и использование осуществлять на специальном сервере под конкретную версию PSS. «PSS-OpenSource» на этом сервере не устанавливать. 4.2. Сборка с использованием BuildPSS Сборка проекта с использованием BuildPSS будет происходить заметно быстрее (до 2х раз), если использовать для временных файлов RAM диск. Для использования RAM диска надо: 1. Установить RAM диск и назначит ему букву (далее - Z:) [Пример бесплатного RAM диска - RAMDisk "Enterprise" http://ramdisk.nm.ru/ramdiskent-rus.htm ] 2. Настроить переменную среды «BUILD_PSS_TMP» со значением буквы RAM диска. (Свойства компьютера, закладка «Дополнительно», кнопка «переменные среды» - см Рис. 6) 5 Рис. 6. 4.3. Создание своего Solution Отладка будет проекта намного удобнее, если в solution проекта добавить несколько проектов из PSS-OpenSource: D:\_SWH\_PSS_OPENSRC\_StepData\CaplData\CaplData.vcproj D:\_SWH\_PSS_OPENSRC\_StepData\CaplData_Client\AplTransportClientTCP.vcproj D:\_SWH\_PSS_OPENSRC\_PSS_base\aplStepMgr\aplStepMgr.vcproj 6