Руководство программиста в Photon (953920), страница 26

Просмтор этого файла доступен только зарегистрированным пользователям. Но у нас супер быстрая регистрация: достаточно только электронной почты!

Текст из файла (страница 26)

Рис. 8-2. Селектор платформы

1. После того как Вы выбрали платформу, дождитесь, чтобы счётчик прогресса достиг 100%.

2. Щёлкните на "Done" в диалоге прогресса.

Если Вы сгенерировали код в диалоге "Build+Run", список файлов обновляется, показывая все сгенерированные файлы с программным кодом.

Что генерирует PhAB

PhAB генерирует различные файлы и сохраняет их в директории приложения src.

Любое имя файла, начинающееся с префикса "ab", является файлом PhAB и не должно никогда модифицироваться. Если Вы попытаетесь отредактировать ab-файл, Вы можете потерять результаты работы (когда PhAB перепишет файл) или получить некорректное поведение (когда файлы выйдут из синхронизма).

Вы можете модифицировать любые другие файлы, генерируемые PhAB, при некоторых условиях. Эти условия описаны в следующих разделах.

Вот файлы, генерируемые PhAB:

Управление версиями

Вот файлы, которые Вам надо сохранять, если Вы используете ПО управления версиями (PhAB может генерировать некоторые из них, но хранить их все – не очень хорошая идея):

Вам понадобится содержать сопоставляемый набор всех файлов, генерируемых PhAB; сохраните ту же самую версию файлов abapp.dfn, src/ab_* и wgt/_*.wgt?

Некоторые рекомендации по использованию CVS

Сохранять приложение в PhAB легче, чем в RCS (RCS – Revision Control System; CVS – вероятно, Control Version System – система управления версиями. Прим. пер.).

Вот несколько вещей, которые надо помнить:

• Пометьте файлы _*.wgt? и abapp.dfn как бинарные (-kb).

• Поскольку бинарные файлы не могут быть объединены, попытайтесь исключить возможность модификации бинарных файлов несколькими людьми одновременно. CVS не поддерживает запирания; самое точное, что Вы можете получить, это установить "watch" (наблюдение) в abapp.dfn (cvs отслеживет abapp.dfn).

При таком подходе, если Вы заканчиваете работу над приложением, Ваша копия файла abapp.dfn имеет атрибут "только для чтения" и PhAB не позволит Вам загрузить приложение. Если Вы хотите модифицировать приложение, Вы запускаете редактирование файла abapp.dfn с помощью CVS, которая делает файл доступным для чтения. Хотя это и не препятствует другому народу выполнить эти же действия, по крайней мере добавляет Вас в список "редакторов" сервера CVS, который другие пользователи могут опрашивать.

Прототипы функций

PhAB генерирует прототипы функций, используемые для компиляции, чтобы проверить, правильно ли вызываются Ваши функции. Эти прототипы располагаются в abimport.h и, возможно, в proto.h. Вот сравнение этих файлов:

Чтобы подавить генерирование прототипов в proto.h:

1. Нажмите <F2> или выберите в меню "Application" пункт "Startup Info/Modules", чтобы открыть диалог "Application Startup Information".

2. Щёлкните на кнопке "Generate empty "proto.h" file".

Потенциальные проблемы с генерированием proto.h

Для повышения скорости программа, сканирующая Ваши файлы с исходным кодом на предмет прототипов функций, игнорирует препроцессорные директивы. Это может привести к определённым проблемам в файле proto.h.

Например, пусть мы имеем следующий код:

#ifdef DOUBLE

for (i=0; i<18; i++, i++) {

#else

for (i=0; i<18; i++) {

#endif

x += 2_*(i+x);

y += x

}

Поскольку процессорные директивы игнорируются, генератор прототипа видит следующее:

for (i=0; i<18; i++, i++) {

for (i=0; i<18; i++) {

x += 2_*(i+x);

y += x

}

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

Чтобы исправить код, приведённый выше, мы должны удалить открывающие скобки и разместить их в строке после #endif. Или же мы можем сделать таким образом:

#ifdef DOUBLE

#define ADDAMOUNT 2

#else

#define ADDAMOUNT 1

#endif

for (i=0; i<18; i += ADDAMOUNT) {

x += 2_*(i+x);

y += x;

}

Как организовать файлы приложения

PhAB хранит каждое приложение как структуру директорий. Эта структура состоит из главной директории, хранящей файл описания приложения, двух поддиректорий, содержащих файлы модулей и исходный программный код приложения и, потенциально, директории для различных платформ разработки:

Рис. 8-3. Директории для приложения PhAB

 Если Вы первый раз сгенерировали Ваше приложение с ранней версией Photon'а, оно могло быть создано как одноплатформенное приложение. В этом случае размещение файлов слегка различается, как описано в последующем разделе.

Вы можете выбрать платформы, для которых компилируется Ваше приложение. Если Вам не требуется чего-то иного, Вы можете выбрать в качестве платформы принимаемое по умолчанию (выбрать "default"). Если Вы выбрали default, при инсталляции новых версий компилятора они будут использоваться автоматически.

Многоплатформенные приложения

Вот что содержит каждая директория многоплатформенного приложения:

appl

Имя этой платформы – то же, что имя Вашего приложения. Она содержит файл описания приложения abapp.dfn. Поскольку этот файл является принадлежностью PhAB, Вам не следует пытаться его модифицировать.

appl/src

Директория src содержит исходный программный код, хеадеры и файл Makefile, сгенерированные PhAB, а также любой код, созданный Вами собственноручно. Диалог "Build+Run" при раскрытии отображает содержание этой директории. Для получения более подробной информации о файлах, содержащихся в этой директории, см. раздел "Что генерирует PhAB" в этой главе.

appl/src/platforms

Эти директории содержат файл Makefile, объектные файлы и исполняемые файлы для выбранной платформы. Файл Makefile в директории src запускает их в платформенных директориях.

apply/wgt

Директория wgt содержит модули Вашего приложения. Поскольку каждый тип модуля имеет своё отличающееся расширение файла, довольно легко опознать соответствующий нужный Вам модуль при импортировании модулей из другого приложения. Для получения более полной информации см. подручные таблицы в разделе "Типы модулей" главы "Работа с модулями".

Всегда используйте PhAB, чтобы отредактировать файлы модулей в директории wgt. Не пытайтесь редактировать эти бинарные файлы другим редактором.

Никогда не модифицируйте какие-либо файлы, начинающиеся с "ab".

Одноплатформенные приложения

Вот что содержит каждая директория одноплатформенного приложения:

appl

Имя этой директории – то же, что имя Вашего приложения. Она содержит файл описания приложения abdefn.app. Поскольку этот файл является собственностью PhAB, Вам не следует пытаться его модифицировать. После того как Вы откомпилировали и слинковали приложение, в этой директории также размещается исполняемый файл.

appl/src

Директория src содержит файлы с исходным кодом хеадера, объектные файлы и файл Makefile, сгенерированные PhAB, а также любые файлы с исходным кодом, созданные Вами собственноручно. При открытии диалог "Build+Run" отображает содержание этой директории.

Для получения более полной информации о файлах, хранящихся в этой директории, см. раздел "Что генерирует PhAB" в этой главе.

appl/wgt

Директория wgt содержит модули ВАшего приложения. Поскольку каждый тип модуля имеет своё отличающееся расширение файла, довольно легко опознать соответствующий нужный Вам модуль при импортировании модулей из другого приложения.

Для получения более полной информации см. подручные таблицы в разделе "Типы модулей" в главе "Работа с модулями".

Всегда используйте PhAB, чтобы редактировать файлы модулей в директории wgt. Не пытайтесь редактировать эти бинарные файлы другим редактором. Никогда не модифицируйте какие-либо файлы, начинающиеся с "ab".

Преобразование к мультиплатформенности

Если у Вас имеется одноплатформенное приложение, построенное в одной из ранних версий Photon'а, Вы можете преобразовать его под мультиплатформенность, но это необязательно. PhAB работает с обоими типами приложения.

Чтобы преобразовать к мультиплатформенности, выберите пункт "Convert to Multiplatform" из меню "Application". PhAB переместит все существующие файлы Makefile в src/default/Makefile.old. Используйте пункт "Generate" в меню "Application", или команду "Generate" в диалоге "Build+Run", чтобы сгенерировать новый файл Makefile для нужных платформ, и затем отредактируйте их, чтобы передать какие-либо требующиеся изменения из старого файла Makefile в новый.

Редактирование исходного кода

Как только Вы сгенерировали программный код Вашего приложения, Вы увидите модули с исходным программным кодом С и/или С++, отображаемые в списке файлов диалога "Build+Run". Рядом со списком файлов Вы увидите несколько кнопок , позволяющих выполнить над файлами различные действия. Чтобы редактировать, просматривать или удалять исходный код:

1. Щёлкните на файле с исходным кодом

2. Щёлкните на соответствующей кнопке действия ("Edit" – редактирование, "View" – просмотр, "Delete" – удаление, ...).

Вы можете также начать редактирование файла, дважды щёлкнув на его имени.

Выбор редактора или броузера

Чтобы выбрать, какой редактор или броузер вызывать по кнопкам "Edit" или "View", см. раздел "Подгонка Вашего окружения PhAB" в главе "Окружение PhAB".

Создание модуля с исходным кодом

Чтобы создать новый модуль с исходным кодом:

1. Щёлкните на кнопке "Create", чтобы открыть диалог "Create File", затем наберите имя нового файла.

2. Если Вы хотите создавать файл, используя шаблон (для хеадер-файла или ответной реакции виджета), выберите формат из комбинированного элемента управления "Template".

3. Щёлкните на "Create". Вы увидите окно терминала, отображающего либо пустой файл, либо файл, содержащий шаблон.

Если Вы создали какие-либо файлы, щёлкните на кнопке "Refresh" для просмотра директории приложения и обновления списка файлов в левой части диалога "Build+Run".

Изменение отображения файлов

Для управления тем, какие файлы отображаются диалогом "Build+Run", используйте следующее:

• "Refresh" – Вынуждает пересмотреть диркторию исходных кодов приложения для обеспечения правильности Вашего списка файлов.

• File Spec – позволяет Вам задать шаблон имён отображаемых файлов.

Компилирование и линковка

После генерации кода приложения Вам необходимо:

1. Выбрать библиотеки, используемые Вашим приложением

2. Использовать команду make для компиляции и линковки Вашего приложения.

Выбор библиотек

PhAB позволяет Вам использовать с Вашим приложением следующие библиотеки:

• Статические библиотеки – компоновка библиотек PhAB и Photon в исполняемый файл приложения. Приложение получается больше по размеру, нежели при использовании совместно используемой библиотеки, но выполняется без библиотек совместного использования. Это может быть полезным во встраиваемых приложениях.

• Совместно используемые библиотеки – библиотеки не включаются в приложение. Приложение получается намного меньшим по размеру, но для своего выполнения требует совместно используемые библиотеки Photon'а.

По умолчанию установлено использование совместно используемых библиотек. При запуске PhAB Вы также можете задать список библиотечных функций ответных реакций.

Характеристики

Список файлов книги