Итак, POSE это MustHave для любого PalmOS программиста.

Чтобы создать простое приложение для PalmOS с помощью PRC-Tools, необходимо установить CygWin(эмуляция unix среды в Windiws), PRC-Tools (gcc компилятор), PilRc for Win32 (компилятор ресурсов), PalmOS SDK 3.5 , PalmOS Emulator. Дополнительные сведения об установке можно найти в интернете.

Простое Приложение состоит из 3 файлов: исходный код на С или другом языке, и два файла ресурсов приложения (resource.h, resource.rcp).

Каждое Palm приложение имеет уникальный CreatorID, это 4 байта, например “MyAp”. Палм использует CrID для того что-бы различать приложения и его файлы. Если два приложения имеют одинаковый CrID то одно из них может затереть второе при синхронизации, либо повредить файлы другого приложения. Для каждого приложения которое “выходит в мир” нужно регистрировать CreatorID на сайте www.palmos.com

После компиляции и сборки получается файл с расширением “prc” – это файл приложения для PalmOS, его можно поместить в эмулятор для тестирования (или инсталлировать в КПК через HotSync).

В отличии от PRC-Tools , CodeWarrior (версия 7) это полностью самодостаточная среда для создания приложений для PalmOS, там есть все что нужно. Ее можно сравнить с MS Visual C++ 6.0. . В этой среде работа над проектом приложения выполняется в одном окне. При создании приложения создается его заготовка (шаблон приложения). CodeWarrior может работать с внешней системой управления исходным кодом приложения (например MS Visual SourceSave).

PalmOS однозадачная операционная система т.е. активным бывает только одно приложение. Когда пользователь запускает другое приложение, то предыдущее текущее приложение завершает свою работу (все данные автоматически сохраняются).

Точка входа в приложение – функция PilotMain.

UInt32 PilotMain (UInt16 launchCode, void *cmdPBP, UInt16 launchFlags).

На вход этой функции передается несколько параметров, самый важный параметр это - LaunchCode - код запуска приложения. SysAppLaunchCmdNormalLaunch это код нормального запуска, - приложение должно показать свое главное окно. Иногда операционная система вызывает приложение с целью “сообщить” что-то важное или “узнать” что-то от приложения (например, при рестарте КПК или синхронизации или в случае глобального поиска), в этом случает приложение обрабатывает событие и возвращает управление.

на рисунке показано схема работы приложения.

Вначале приложение создает главную форму (FrmGotoForm). Затем в бесконечном цикле приложение ожидает события (EvtGetEvent) от пользователя или системы. Если происходит событие, приложение определяет кому оно предназначено, например если событие произошло на форме (окно) приложения - вызвать обработчик FormEvtHandler. При закрытии приложения поступает событие – AppStopEvent.

!!! расказать подробнее

За событийную модель в PalmOS отвечает модуль EventManager.

Операционная система PalmOS автоматически управляет питанием компьютера. Например, по истечении одной минуты бездействия, КПК выключается; если приложение не выполняет никакой работы, то процессор приостанавливает свою работу. Для приложений это прозрачно. Существует 3 состояния, в которых может находиться устройство:

Doze mode – Режим бездействия, Дисплей включен, приложение активно, но оно ничего не выполняет. Процессор готов к работе, но не выполняет инструкций (halted). Это состояние активируется после вызова функции EvtGetEvent. (это случается когда пользователь не прикасается стилусом к экрану, и не нажимает кнопки)

Sleep mode – Режим “сна”. Активируется, если Doze mode по времени продолжается дольше установленного тайм-аута (обычно одна минута). Выключаются: Дисплей, дигитайзер (сенсоры экрана), главные часы, работает только контролер прерываний. Все устройства КПК переводятся на режим экономии питания, система ждет событий от кнопок либо от часов реального времени.

Running mode – Режим активной работы, Дисплей включен, приложение активно, процессор выполняет инструкции. Все устройства готовы к работе либо работают. Обычно это происходит если функция EvtGetEvent возвращает какое-то событие и приложение его обрабатывает. (например, пользователь работает стилусом, жмет на кнопки, или приложение выполняет работу)

В режиме Running mode КПК находится 5%-10% от времени проведенного в Doze mode (когда экран включен, а пользователь ничего не делает), это объясняется тем , что пользователь обычно большую часть времени изучает информацию на дисплее нежели производит действия. В активных играх это конечно не соблюдается т.к. пользователь постоянно жмет на кнопки или тычет стилусом в экран. Для того чтобы приложения не противоречили этой стратегии нужно программистам следует придерживаться определенных правил событийной модели в PalmOS (см. в SDK ).

PalmOS это графическая операционная система обладающая средствами для создания практически любого GUI (graphical user interface).

Базовые элементы GUI - это Форма (Form), Диалог, Меню. Плюс традиционные элементы любого графического интерфейса: кнопки, флажки (checkbox), списки, поля с текстом, селекторы, таблицы, картинки.

Экран имеет размеры 160*160 точек, поэтому при проектировании интерфейса приложении нужно постараться его не загромождать, а сделать максимально понятным пользователю.

Интерфейс создается в виде словесного описания в файле ресурсов (см. пример приложения). В этом файле описывается, какие формы будет показывать приложение и какие элементы (кнопки, надписи ...) будут на формах.

Обычно приложение содержит несколько Форм и одно Меню, форма может занимать только часть экрана. Все формы модальные, т.е. пока одна форма активна, другая форма не может обрабатывать события

События которые происходят на форме (нажатие кнопки, ввод буквы, команда меню выделение строки списка) приходят в процедуру – обработчик сообщений формы. В это процедуре можно определить тип события, и считать данные с элементов на форме (например тест из текстового поля или состояние флажка)

Меню в PalmOS существует, для того чтобы “снять нагрузку” с формы и спрятать в себе все второстепенные команды приложения. Однако нужно помнить что, для того чтобы добраться до меню пользователь делает 3 клика стилусом, поэтому там обычно находятся редко употребляемые команды.

Для быстрого доступа к командам из меню приложение может использовать Command Toolbar – это панель с которая появляется нижней части экрана , после росчерка “/”. (введено в PalmOS 4.0)

Интерфейс можно создавать динамически, а также создавать нестандартные элементы, но это довольно сложная задача.

В PalmOS есть средства для работы с простейшей графикой: точки, линии, круги, прямоугольники, заливка, инверсия, картинки. Поддержку графики осуществляет модуль Window Manager, с помощью его API функций можно устанавливать цвет пера, заливки, текущий шрифт и другие параметры. Для создания “быстрой” графики приложение может воспользоваться видео буфером – это область памяти доступная для чтения/записи, содержимое этой области сразу же отображается на экране.

PalmOS 4.0 поддерживает 1-, 2-, 4- 8 и 16-битовые цвета и оттенки серого а PalmOS 3.0 поддерживает только 4 градации серого.

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

В PalmOS все API функции модулей имеют префикс из 2-3 букв, который обозначает к какому модулю приналежит функция, например в функциях DmOpenDatabase, MemFreePtr Dm - означает Data Manager, Mem - Memory Manager. Если знать все префиксы то становится удобнее читать исходный код программ.

Таблица префиксов к именам функций различных модулей:

Имя модуля	Префикс	имени функций
Alarm Manager	Alm	программируемый будильник
Time Manager	Tim, Date	работа с датой
Sound Manager	Snd	работа со звуком
System Manager	Sys	системный сервис
Form Manager	Frm	работа с формами

Всем программистам, особенно тем кто “перешёл” на PalmOS с другой системы рекомендуется прочитать главу “Good Design Practices” из документации по PalmOS (Palm OS Programmer's Companion). В этой главе рассматриваются наиболее отличительные моменты PalmOS приложения, эту главу нужно прочитать несколько раз по мере ознакомления с PalmOS.

Системные Характеристики - аналог переменных окружения в ДОС. Это глобальное значение (только 4 байта) которое можно установить и обращаться к этому значению по мере необходимости из приложения или библиотеки. После легкого рестарта эти значения пропадают. Есть системные характеристики, например версия операционной системы - sysFtrNumROMVersion, или версии какой-то библиотеки. Обозначения всех системных характеристик даны в файле SystemMgr.h .

Err FtrSet (UInt32 creator, UInt16 featureNum, UInt32 newValue) – установка значения

Err FtrGet (UInt32 creator, UInt16 featureNum, UInt32 *valueP) – получение зачения

При установке или считывании характеристик используется идентификатор создателя приложения. Для получения системных характеристик (Features) вместо идентификатора создателя используется номер - sysFtrCreator. Этим сервисом удобно пользоваться если необходимо хранить какие ни будь 2-3 числовых настройки, или если функции доступа к файлам временно недоступны (например из “хаков”, см. Расширения PalmOS)

Аналог реестра в Windows. Это общее хранилище для хранения настроек от всех приложений. Существую также системные настройки - там хранятся значения типа формата даты и времени, единиц измерения.

SoundManager позволяет генерировать простые сигналы, разной частоты и длительности.

PalmOS, начиная с версии 3.5 поддерживает воспроизведение стандартных MIDI-звуков.

Приложение может получать различные уведомления о системных событиях, например: вставление / извлечение модуля расширения, удаление файла, изменение настроек экрана или сети, изменение времени, подключение / отключение от сети, переход в режим “сна”, легкий рестарт, синхронизация.

Уведомления “приходят” в приложения в виде кода запуска (launch code).

Приложения может поставить “будильник” для себя, когда время подойдет то Alarm Manager сообщит приложению что время пришло, если приложение закрыто то PalmOS запустит его. А с помощью Attention Manager приложение показывает диалог с сообщением, и если пользователь захочет, то может отложить это событие на пару минут (Snooze).

Приложение может самостоятельно сделать легкую перегрузку операционной систему.

Легкий рестарт - это отчистка Dynamic Heap памяти, проверка целостности Storage Heap , и дефрагментация всей памяти.

Полный Рестарт это обнуление всей памяти (уничтожение всей файловой системы) и создание файловой системы заново, потом туда копируются приложения операционной системы и производится установка настроек, в которой принимает участие пользователь.

Инфракрасный порт, последовательный порт, и сеть - это 3 основных типа коммуникаций в PalmOS. Приложение может пользоваться инфракрасным портом на высоком уровне – это пересылка файлов между КПК, и на низком уровень эта работа с портом напрямую.

С помощью TCP/IP протокола можно работать с интернетом или локальной сетью. В PalmOS реализованы Berkley Sockets функции, можно работать в асинхронном или синхронном режимах (не блокируемые вызовы и блокируемые)

Этот вопрос очень важный для PalmOS, сейчас самые распространенные версии 3.0 – 4.0. Концептуальной разницы в них нет, главное отличие в сервисе операционной системы для приложений. Feature Set – список того, что нового появилось в определенной версии PalmOS. В документации PalmOS (Palm OS Programmer's Companion) есть глава Compatibility Guide – в которой перечисляются новые функции константы и другие вещи которые появились после PalmOS 1.0 .

Приложение должно проверять версию операционной системы, чтобы быть уверенным что необходимый сервис присутствует в данной версии PalmOS. Например, Alarm Manager присутствует не во всех версиях.

Как уже ранее говорилось все приложения вызывают API функции PalmOS для выполнения каких либо действий , например открытие файла, вывод на экран, ввод/вывод. Но PalmOS так устроена, что в ней можно переопределять поведение этих функций.

Например, при вызове DmOpenDatabase (открытие файла) вызывается функция с номером sysTrapDmOpenDatabase в специальной таблице указателей. Этот механизм называется - Palm OS trap dispatch mechanism – т.е. когда вызывается API функция, то на самом деле приложение обращается к обработчику API вызовов (trap dispatch) и просит его вызвать такой-то номер функции (а параметры передаются в стеке). Эту таблицу указателей можно спокойно изменять с целью подмены функций.

Подменить системную функцию может любое приложение (например CyrHack, подменяет ряд функция для русификации PalmOS). Но есть еще специальный вид приложений для PalmOS – это Хаки (от слова hack, а официальное название System Extention). Это приложения, которые подменяют определенные системные функции и делают что-то полезное. Хаки созданы по спецификации HackMaster API, это стандарт который облегчает создание таких приложений, а также делает более безопасным их присутствие в системе. Согласно этому стандарту за всеми хаками в системе следит Менеджер Хаков. Это обычное приложение (например X-Master) в котором можно посмотреть список всех хаков, настроить их, и активизировать.

Программирование хаков требует более глубокого знания системы.

Рассмотрим пример простого приложения - example1.prc(1,5кб) оно состоит из одной формы. На Форме расположена кнопка , надпись, и текстовое поле, к форме прикреплено меню . При нажатии на кнопку появляется сообщение. Проект приложения состоит из 4х файлов:

файл example1.c
#include <PalmOS.h> 
#include "hw.h" 
static FormPtr gpForm;

Boolean Form1_HandleEvent(EventPtr event) 
{   
  switch(event->eType)   { 
  case ctlSelectEvent:     
    if ( event->data.ctlEnter.controlID == Button1) 
        FrmCustomAlert(Alert1, "MessageBox !", "", "");    
    break;    
  case menuEvent: 
    if ( event->data.menu.itemID == IDM_about)
      FrmCustomAlert(Alert1, "This is Example", "", "");    
    break;    
  case frmOpenEvent: 
    gpForm=FrmGetActiveForm();
    FrmDrawForm(gpForm);    
    break;    
  case frmCloseEvent:     
    FrmEraseForm(gpForm); 
    FrmDeleteForm(gpForm);     
    break; 

  default:
    return false;   

  }     
  return true; 
} 

static Boolean ApplicationHandleEvent(EventPtr event) 
{ 
  FormPtr frm;   
  Boolean handled=false; 
  
  switch(event->eType)   { 
  case frmLoadEvent:        
    frm = FrmInitForm (event->data.frmLoad.formID);
    FrmSetActiveForm (frm);      
    FrmSetEventHandler(frm , Form1_HandleEvent);     
    handled = true; 
    break;
  } 
  return handled;  
} 
UInt32 PilotMain(UInt16 launchCode, void *cmdPBP, UInt16 launchFlags) 
{   
  EventType event; 
  UInt16 error; 
  
  if(launchCode==sysAppLaunchCmdNormalLaunch)  { 
    FrmGotoForm(Form1);     
    do {  
      EvtGetEvent(&event,evtWaitForever);       
      if(!SysHandleEvent(&event)) 
        if(!MenuHandleEvent(0,&event,&error)) 
          if(!ApplicationHandleEvent(&event)) 
            FrmDispatchEvent(&event);           
    } 
    while(event.eType!=appStopEvent);     
    FrmCloseAllForms();
  }        
  return 1; 
}

файл example1.rcp 

#include "hw.h" 

FORM ID Form1 AT (0 0 160 160) FRAME USABLE
MENUID MenuBar1 
    BEGIN 
     TITLE "Example 1"
     LABEL "This is an example" AUTOID AT (10 10+5) FONT 1
     LABEL "of small GUI programm" AUTOID AT (PREVLEFT PREVBOTTOM+5) FONT 2
     FIELD  ID IDB_Edit1 AT (PREVLEFT PREVBOTTOM+5 110 20) MAXCHARS 50 UNDERLINED FONT 2 
     BUTTON "Hello" ID Button1 AT (10 80 AUTO AUTO) 
   END 

MENU ID MenuBar1 
     BEGIN 
       PULLDOWN "Help" 
       BEGIN 
         MENUITEM "About" ID IDM_about "A" 
      END 
END 

ALERT ID Alert1
  INFORMATION 
BEGIN 
  TITLE "Example 1" 
  MESSAGE "^1 ^2 ^3" 
  BUTTONS "Ok" 
END

Файл example1.h 
#define Form1   1000 
#define Button1 1003 
#define Edit1   1006
#define MenuBar1 1000 
#define Alert1 1102

#define IDM_about  1001 
#define IDB_Edit1  1002   

makefile
CC=m68k-palmos-gcc.exe 
PILRC=pilrc.exe 
BUILDPRC=build-prc 
OBJRES=m68k-palmos-obj-res 
GRC=*.grc 
CFLAGS =  -O2

all: example1 

example1: example1.bin  resources 
  ls *.grc|$(BUILDPRC) example1.prc Test -v 1.0 *.bin *.grc 

example1.bin: example1.o 
   $(CC) -o $@ $< 
   $(OBJRES) $@ 

example1.o: example1.c  
   $(CC) $(CFLAGS) -c $<

resources: example1.rcp 
   $(PILRC) $< 

clean: 
  rm *.bin 
  rm *.o 
  rm *.grc 

Ссылки:

http://goanna.cs.rmit.edu.au/~winikoff/palm/dev.html

http://www.cyberport.com/~tangent/palm/faq/

http://www.palmopensource.com/ - много исходников по разным темам

http://www.massena.com/darrin/pilot/tanda.htm

http://www.pdaprogramming.com/old/palmos/sources.html

http://spider.macomnet.ru/docs/PalmOS/palm_developers_guide/

http://home.hetnet.nl/~tonicor/palm/tutorial/uk/index.htm

http://www.multimania.com/pbriol/palmos/gcc.html

http://oasis.palm.com/dev/kb/browse.cfm?type=1

http://www.kadak.com/html/kdkp1010.htm - ядро PALMOS

http://pdasecurity.chat.ru/main.html - взлом софта под палм

http://palm.x-a-o-c.ru

От Автора :
По мере того как я работаю с PalmOS и PocketPC я стараюсь обновлять эту работу . Самая свежая версия всегда лежит на http://www.dekart.com/publ/PalmOS%20referat_6.pdf .