Differences

This shows you the differences between two versions of the page.

--- etc:common_activities:maemo:maemo4_maemo5 [2009/11/09 15:25] – ivan_bezyazychnyy
+++ etc:common_activities:maemo:maemo4_maemo5 [2009/11/17 19:55] (current) – regina
@@ Line 10: / Line 10: @@
 Изменения на примере почтового клиента:
 http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Porting_Software/Redesigning_From_Maemo_4_to_Maemo_5#Re-design_of_Modest_email
 ====== Maemo 5 с точки зрения разработчика ======
+{{etc:common_activities:maemo:800px-top_level_architecture.png|}}
 Рассматривается интерфейс и модули определения географического положения
 ===== Основные компоненты графического интерфейса пользователя =====
-Сюда входят: C library, Xlib, Glib, GDK, GDK, Pango, ATK, GTK+, Hildon. Коротко о них.
-http://wiki.maemo.org/Legacy_Maemo_5_Documentation/Graphical_UI_Tutorial/Introduction
+The Fremantle UI Framework consists of the Clutter OpenGL-based canvas library, OpenGL drivers for the PowerVR SGX chip, Matchbox Window Manager 1 (for startup sequence) and Matchbox Window Manager 2 library, Hildon Welcome (“Nokia hands”) screen, Startup Wizard, application framework startup scripts, game startup system, Hildon Control Panel, some Control Panel applets, Restore original settings & Clear user data framework, Hildon Input Methods, internationalisation i.e. so-called POSIX data, Clipboard Manager, Hildon Desktop, notiﬁcation service, Hildon Home (applet loader), Hildon Status Menu/Area (plugin loader), and Status Menu USB plugin.
+Основные подсистемы пользовательского интерфейса:
+hildon-desktop	-        OpenGL graphics API
+hildon-home	-        Home widget API and loading, notification service and plugins,       background image and loading
+hildon-status-menu - X clipboard selection management
+Hildon Input Method - 	Localized text input UI
+Control Panel	    -    Control Panel applet and loading
+Startup Wizard	     -   first boot and system time setting
+Startup scripts	    -     AF startup scripts
+RFS and CUD framework - 	Reset factory settings and clear user data
@@ Line 23: / Line 59: @@
 ===== Hildon - изменения в Maemo5 =====
+Navigation architecture
+{{etc:common_activities:maemo:navigation.png|}}
+Task launcher - меню, с помощью которого пользователь может получить доступ к запуску нового приложения или выдвинуть запущенное приложение на вершину.
+Task switcher - это вид для переключения между запущенными приложениями.
+Вид рабочего стола при отображении окна приложений:
+{{etc:common_activities:maemo:desktop_overview.png|}}
+A-Кнопка переключения задач. Нажатие на нее приводит к переходу приложения в фоновый режим и отображению доступных для выбора других запущенных приложений.
+B- Кнопка статуса области. Предоставляет информацию о статусе устройства или приложения.
+C- Кнопка для закрытия приложений. При этом, если текущее окно приложения является подвидом, то вместо кнопки "закрыть" отображается кнопка "назад". И кнопка назад закрывает окно, не закрывая приложения, а возвращая к предыдущему виду.
+D- Название области. Показывает идентификатор текущей задачи, обычно имя текущей задачи.
+F- Область приложения.
+При работе приложения в полноэкранном режиме используется только область приложения. Если приложение имеет панель виджетов, то она она отображается в самой нижней части области приложения, как в нормальном, так и в полноэкранном режиме.
 Анализ на основе таблицы
 [[http://repository.maemo.org/stable/fremantle/4.1.2_vs_5.0_content_comparison.html]]
@@ Line 29: / Line 86: @@
 ===== GTK - изменения в Maemo5 =====
 На основе таблицы http://repository.maemo.org/stable/fremantle/4.1.2_vs_5.0_content_comparison.html
 ===== Qt =====
+Основные особенности выпущенной версии Qt для N900 (Maemo 5):
+    * Полная интеграция внешнего вида и поведения приложений в окружении Maemo, при помощи специально подготовленного стиля "Hildonized";
+    * Поддержка аппаратной акселерации выполнения графических операций, через задействование OpenGL ES 2;
+    * Поддержка методов ввода через экранную клавиатуру и встроенную миниатюрную физическую клавиатуру;
+    * Интеграция с глобальным меню, класс QMenuBar связан с глобальным меню Maemo;
+    * Поддержка режимов Online/offline в libQtNetwork;
+    * Поддержка стандартных диалогов интерфейса Maemo (например, диалог открытия файла);
+    * Поддержка виджетов Maemo;
+    * Возможность вывода мультимедиа данных через Phonon.
 {{etc:common_activities:maemo:qt.jpg|}}
 http://doc.trolltech.com/4.5/index.html
+http://labs.trolltech.com/blogs/2009/10/09/qt-on-the-n900/
 ==== Пакет qt4-x11 ====
@@ Line 75: / Line 159: @@
+==== Библиотеки нижнего уровня для определения геграфического положения в Maemo4 ====
+К библиотекам нижнего уровня для определения положения в Maemo Diablo относятся библиотеки: libgpsbt, libgpsmgr, gpsd daemon.
+=== GPS BT (libgpsbt) ===
+Application that needs GPS data can use this API to manage GPS daemon start and stop and to find out what serial port device (/dev/rfcommX) the GPS device is using. The API uses services provided by libgpsmgr that handles the GPS daemon start and stop.
+=== GPS Manager (libgpsmgr) ===
+Application that needs GPS data can use this API to manage GPS daemon start and stop. This is needed in small handhelds where it is not good to have gpsd running all the time (because of battery and memory constraints) and to guarantee that only one gpsd process is running simultaneously even if multiple processes need the GPS data.
+The idea of the API is to allow multiple applications to use gpsd services but only when there is at least one application that needs GPS data. If no application is running, the gpsd is not started at all or gpsd stops itself automatically (to save memory and battery life).
+==== Библиотеки нижнего уровня в Maemo 5.0 (Fremantle) ====
+В MAEMO5 отсутствуют библиотеки нижнего уровня libgbsbt, libgpsmgr, gpsd daemon. Вместо этих библиотек в MAEMO5 предполагается использование liblocation либо API для обращения к gypsy daemon и к location daemon.
+=== Gypsy daemon ===
+Gypsy — это многоканальный GPS демон, обеспечивающий нескольким клиентам доступ к GPS информации, полученной с нескольких GPS источников параллельно. Gypsy использует D-Bus для оповещения клиентов, расположенных на системной шине, путем формирования сигналов об изменении GPS информации. При этом клиенты получают только те сигналы, на которые они зарегистрировались и не получают сигналы, которые им неинтересны. Таким образом Gypsy отлично подходит для устройств с низким энергопотребелением, так как приложения просыпаются только при действительной необходимости, тем самым сберегая энергию.
+{{etc:common_activities:maemo:gypsy.png?400|}}
+Методы и сигналы клиентов Gypsy разделены на следующий интерфейсы:
+  * Gypsy.Server: методы для управления функциями сервера Gypsy демона;
+  * Gypsy.Device: методы и сигналы, связанные с функциями GPS устройства;
+  * Gypsy.Postion: методы и сигналы, связанные с текущим GPS положением;
+  * Gypsy.Course: методы и сигналы, связанные с текущим курсом GPS;
+  * Gypsy.Accuracy: методы и сигналы, связанные с точностью GPS;
+  * Gypsy.Satellite: методы и сигналы, связанные со спутниками, которые видит GPS устройство.
+Gypsy разделяет эти интерфейсы и не использует один большой для того, чтобы клиенты клиенты могли слушать только те сигналы, в которых они заинтересованы. Это позволяет клиентам оставаться в состоянии простоя более долгий период времени, а следовательно экономить энергию.
+Для взаимодействия с Gypsy демоном Gypsy содержит библиотеку libgypsy на языке С, основанную на Gobject и являющуюся оболочкой D-Bus API, библиотека упрощает написание клиентов Gypsy демона. В тоже время для написания клиентов можно использовать любой другой язык, имеющий поддержку D-Bus.
+[[http://gypsy.freedesktop.org/gypsy-tutorial.html | Gypsy tutorial (пример простого GPS-клиента)]]
+[[http://gypsy.freedesktop.org/reference/html/index.html | The libgypsy API documentation ]]
+=== Location daemon ===
+==== Liblocation ====
+Liblocation — библиотека, входящая в состав Location Framework и предназначенная для разработки приложений в Maemo, которые работают с географическим положением. Данная библиотека поддерживает внутреннее GPS устройство, bluetooth GPS устройсво, а также дополнительные методы определения географического положения, использующие сотовую связь.
+В Maemo5 liblocation основана на взаимодействии с Gypsy демоном с помощью D-Bus. Существует два способа взаимодействия с Gypsy демоном — это использование библиотеки libgypsy и прямое взаимодействие с демоном с помощью API D-Bus. Библиотека liblocation предлагает третий способ, обеспечивая собственный интерфейс взаимодейсвия с Gypsy демоном.
+=== Модули liblocation ===
+Для использования библиотеки liblocation необходимо включить в программу два заголовочный файла:
+<code>
+#include <location/location-gps-device.h>
+#include <location/location-gpsd-control.h>
+</code>
+=== Объект LocationGPSDControl ===
+LocationGPSDControl — объект типа GObject, позволяющий запускать и останавливать различные сервисы, устанавливать метод определения географического положения и интервал, а также получать информацию о различный ошибках.
+Для создания объекта в библиотеке определена  функция location_gpsd_control_get_default():
+<code>
+LocationGPSDControl *control = location_gpsd_control_get_default();
+</code>
+Для работы с объектом в библиотеке определены функции:
+  * location_gpsd_control_start () : Starts an active connection to Location server. In other words, by calling this function the application informs that it wants to use the location service.
+  * location_gpsd_control_stop () : Informs the location framework that the application is no longer interested about the current location. Location service is kept running as long as there is at least one application using it. Please note that LocationGPSDevice still sends data as long as the location framework is running.
+Объект обладает следующими свойствами:
+  * "maincontext-pointer" (тип gpointer, write): устанавливает main context address;
+  * "preferred-interval" (тип gint, Read / Write): принимает значения >= -1, определяет интервал, через который будет определяться положение, по умолчанию -1;
+  * "preferred-method" (тип  gint, Read / Write): принимает значения [0, 15], определяет метод, по которому будет определяться положение, по умолчанию 0.
+Объект может принимать следующие сигналы:
+  * Сигнал "error"
+  * Сигнал "error-verbose"
+  * Сигнал "gpsd-running"
+  * Сигнал "gpsd-stopped"
+Более подробно в [[http://maemo.org/api_refs/5.0/5.0-final/liblocation/LocationGPSDControl.html|liblocation Reference Manual]]
+=== Методы определения географического положения ===
+  * LOCATION_METHOD_USER_SELECTED: Liblocation выберет наилучший из возможных методов определения географического положения, опираясь на настройки в панели управления. Данный метод можно представлять как совокупность всех остальных: CWP+ACWP+GNSS+AGNSS. При отсутствии конкретных требований лучше всего выбирать этот метод.
+  * LOCATION_METHOD_CWP - Complementary Wireless Positioning: метод определяет координаты цента текущей страны с точностью по горизонтали равной радиусу страны (MCC fix (мобильный код страны)) или определяет координаты на основе используемой GSM станции. Позднее используется при наличии информации в кэше устройства, которая затем уточняется методом ACWP. Для метода CWP необходима SIM карта.
+  * LOCATION_METHOD_ACWP - Assisted Complementary Wireless Positioning: в определении географического положения участвует базовая сотовая станция, на которой зарегистрировано устройство. Для метода ACWP необходима SIM карта и сотовая сеть. Если сотовая сеть недоступна, то метод работает аналогично CWP. Приложение может определить MCC (мобильный код страны) прежде чем получит информацию о сотовой станции с внешнего сервера географического положения или если сеть недоступна.
+  * LOCATION_METHOD_GNSS - Global Navigation Satellite System: Метод использует GPS приемник. Как правило время первого определения положения значительно дольше, чем при использовании метода AGNSS. Ни SIM карта, ни сотовая сеть не нужны для этого метода. Данный метод может быть также использован в режиме «offline».
+  * LOCATION_METHOD_AGNSS - Assisted Global Navigation Satellite System Метод использует GPS приемник с вспомогательной информацией от внешнего сервера географического положения. Для данного метода необходимы SIM карта и сотовая сеть. Если сотовая сеть или SIM карта недоступны, то метод эквивалентен методу GNSSA.
+Пример выбора метода:
+<code>
+g_object_set(G_OBJECT(control), "preferred-method", LOCATION_METHOD_GNSS | LOCATION_METHOD_AGNSS, NULL);
+</code>
+=== Интервалы определения географического положения ===
+Интервал между последующими определениями координат может равняться 1, 2, 5, 10, 20, 30, 60 и 120 секундам. В реальности интервал может значительно отличаться для обеспечения производительности и в целях экономии энергии, он зависит от множества факторов (например частота проверки приложением изменения координат). Если несколько приложений установили различные интервалы, то выбирается наименьший.
+Пример задания интервала:
+<code>
+g_object_set(G_OBJECT(control), "preferred-interval", LOCATION_INTERVAL_60S, NULL);
+</code>
+===  Объект LocationGPSDevice ===
+LocaionGPSDevice — объект типа GObject, содержащий информацию о состоянии устройства и о текущем местоположении, если оно определено.
+Объект может принимать сигнал «changed», который производится каждый раз, когда приходит сообщение об изменении координат.
+Более подробно в [[http://maemo.org/api_refs/5.0/5.0-final/liblocation/LocationGPSDevice.html|liblocation Reference Manual]]
-==== Пример работы с liblocation в Maemo. ====
+=== Пример работы с liblocation в Maemo. ===
 Ниже приведен пример работы с liblocation в Maemo 5, который был взят с сайта maemo (http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Using_Connectivity_Components/Using_Location_API#Complete_example).
@@ Line 152: / Line 352: @@
  gcc -Wall `pkg-config --cflags glib-2.0, liblocation --libs glib-2.0, liblocation` -o test test.c
 </code>
-==== Библиотеки нижнего уровня для определения геграфического положения в Maemo4 ====
-К библиотекам нижнего уровня для определения положения в Maemo Diablo относятся библиотеки: libgpsbt, libgpsmgr, gpsd daemon.
-=== GPS BT (libgpsbt) ===
-Application that needs GPS data can use this API to manage GPS daemon start and stop and to find out what serial port device (/dev/rfcommX) the GPS device is using. The API uses services provided by libgpsmgr that handles the GPS daemon start and stop.
-=== GPS Manager (libgpsmgr) ===
-Application that needs GPS data can use this API to manage GPS daemon start and stop. This is needed in small handhelds where it is not good to have gpsd running all the time (because of battery and memory constraints) and to guarantee that only one gpsd process is running simultaneously even if multiple processes need the GPS data.
-The idea of the API is to allow multiple applications to use gpsd services but only when there is at least one application that needs GPS data. If no application is running, the gpsd is not started at all or gpsd stops itself automatically (to save memory and battery life).
-==== Библиотеки нижнего уровня в Maemo 5.0 (Fremantle) ====
-В MAEMO5 отсутствуют библиотеки нижнего уровня libgbsbt, libgpsmgr, gpsd daemon. Вместо этих библиотек в MAEMO5 предполагается использование liblocation либо API для обращения к gypsy daemon и к location daemon.
-=== Gypsy daemon ===
-Gypsy — это многоканальный GPS демон, обеспечивающий нескольким клиентам доступ к GPS информации, полученной с нескольких GPS источников параллельно. Gypsy использует D-Bus для оповещения клиентов, расположенных на системной шине, путем формирования сигналов об изменении GPS информации. При этом клиенты получают только те сигналы, на которые они зарегистрировались и не получают сигналы, которые им неинтересны. Таким образом Gypsy отлично подходит для устройств с низким энергопотребелением, так как приложения просыпаются только при действительной необходимости, тем самым сберегая энергию.
-{{etc:common_activities:maemo:gypsy.png?400|}}
-Методы и сигналы клиентов Gypsy разделены на следующий интерфейсы:
-  * Gypsy.Server: методы для управления функциями сервера Gypsy демона;
-  * Gypsy.Device: методы и сигналы, связанные с функциями GPS устройства;
-  * Gypsy.Postion: методы и сигналы, связанные с текущим GPS положением;
-  * Gypsy.Course: методы и сигналы, связанные с текущим курсом GPS;
-  * Gypsy.Accuracy: методы и сигналы, связанные с точностью GPS;
-  * Gypsy.Satellite: методы и сигналы, связанные со спутниками, которые видит GPS устройство.
-Gypsy разделяет эти интерфейсы и не использует один большой для того, чтобы клиенты клиенты могли слушать только те сигналы, в которых они заинтересованы. Это позволяет клиентам оставаться в состоянии простоя более долгий период времени, а следовательно экономить энергию.
-Для взаимодействия с Gypsy демоном Gypsy содержит библиотеку libgypsy на языке С, основанную на Gobject и являющуюся оболочкой D-Bus API, библиотека упрощает написание клиентов Gypsy демона. В тоже время для написания клиентов можно использовать любой другой язык, имеющий поддержку D-Bus.
-[[http://gypsy.freedesktop.org/gypsy-tutorial.html | Gypsy tutorial (пример простого GPS-клиента)]]
-[[http://gypsy.freedesktop.org/reference/html/index.html | The libgypsy API documentation ]]
-=== Location daemon ===