Использование UID в среде Symbian OS

Дмитрий Аксёнкин, dmaxy.tagan.ru

В Symbian OS, объекты идентифицируются с помощью составных идентификаторов, которые называют UID.

Для успешного программирования, разработчику необходимо знать как и для чего использовать UID-ы в своих программах. UID состоит из трех 32-битных отдельных чисел. Эти числа, называются компонетами UID и обычно когда о них заходит речь на них ссылаются как на UID1-, UID2- и UID3-компоненты.

Symbian OS использует UID-ы в самых различных случаях:

• UID-ы используются для идентификации типов различных объектов как во время исполнения так и во время загрузки. Например исполняемые файлы, DLL, файловые хранилица и многое другое имеет свои собственные UID.
• UID-ы используютя для проверки, что объект, который предполается загрузить обеспечит совместимый и ожидаемый от него интерфейс.Таким образом можно проверить, что DLL относится к ожидаемому типу или что используемое файловое хранилище имеет строго определнный тип.
• UID-ы это значения которые однозначно связывают документы и приложения для их обработки. Например, графические приложения с определенной программой их просмотра.

В Symbian OS UID-ы используются повсеместно для разнообразных идентификаций типов файлов и увязки файлов с теми или иными приложениями. Конечно пользователю более понятны обычные имена файлов и Symbian OS гибко поддерживает имена файлов различной длинны. Но с точки зрения системы, 32-битные номера обеспечивают большую однозначность, систематичность и более легкую идентификацию. Поэтому UID-ы являются фундаметальной характеристикой ОС.

По определению, UID-тип объекта состоит из трех отдельных UID-ов используемых в комбинациях. Составные компоненты UID-ов называются UID1, UID2 и UID3 имеют следующие основные характеристики:

• UID1- может быть рассмотрен как идентификатор на уровне системы; например, исполняемые файлы, DLL, файловые хранилища все различаются по UID1.
• UID2-различия между объектами имеющими один и тот же UID1 и могут быть рассмотрены как идентификатор интерфейса; например, статический интерфейс (разделяемая библиотека) и полиморфический интерфейс (приложение или встраеваемая программная оболочка) DLL-ки отличаются по UID2
• UID3-идентифицирует объекты, имеющие конкретный UID2 и может рассматриваться как идентификатор проекта; например, UID3 может быть разделен между всеми объектами, принадлежащими данной программе, включая библиотеки, если имеются, DLL-ки каркасов,и все документы.

UID-тип это объект типаTUidType, которой можно создать из комбинаций всех или некоторых из трех возможных UID-ов. Если переменная имеет прелставляет собой UID, т о можно выяснить и значения составляющих её компонентов UID1, UID2 и UID3.

Если объект не имеет UID, то все три компонента UID возвращаются как KUidNull.

UID1, UID2, UID3, и отсутсвие UID-ов

Объект в Symbian OS и, особенно, многие файлы в Symbian OS могут иметь все, несколько, или вообще не иметь не одного из трех возможных UID-ов.

Вариант с отсутсвием UID-ов необходим для того, чтобы можно было взаимодействовать с другими системами, позволяя легко и свободно использовать по назначению в Symbian OS не родные файлы данных. Symbian OS позволяет создавать настраиваемые файловые ассоциации и идентификации даже когда UID-ы отсутсвуют. Это делается по расширениям имен файлов.

Тем не менее, для конкретных программ Symbian OS, UID-ы применяются как первичные средства идентификации типа файлов. По возможности, все-таки лучше использовать UID-ы, чем зависеть от расширений имен файлов.

В заголовочных (.h) файлах Symbian OS описаны все возможные UID1 и UID2. Разработчики смогут ссылаться на них по именам констант, которые их определяют. Но в файле проекта (.mmp) используются шестнадцатизначные номера.

• для UID1 - правильными считаются значения констант KExecutableImageUid, KDynamicLibraryUid и KDirectFileStoreLayoutUid
• UID2 включает в себя KSharedLibraryUid для статического интерфейса DLL и KUidApp для UIKON приложения (приложение с графическим интерфейсом пользователя)
• UID3 должен определить разработчик.

В файлах проектов(.mmp), значения UID2 и UID3 могут быть определены, а значения UID1 - нет; Значение UID1 вытекает из типа сбоки, определяемого в проекте (TARGETTYPE).

Создание EXE-файлов и UID-ы

Все исполняемый файлы имеют UID1, равный KExecutableImageUid. Он определен системой Symbian OS и автоматически встраивается в любой проект, ориентированный на создание exe-файла.

Поскольку проект создания exe-файла предполагает отсутсвие интерфейса и не использует каких либо каркасов и шаблоннов, то проекты создающие exe-файлы не нуждаются в определении UID-ов.

UID для DLL

Все DLL, со статическим или полиморфическим интерфейсом, имеют UID1 равный KDynamicLibraryUid. Это определено системой Symbian OS и автоматически встраивается в любые проекты, целью которых является создание dll.

Статические и полиморфические DLL различаются интерфейсами, которые они предоставляют. Эта их особенность и определена значениями их UID2.

Для интерфейса статических DLL, UID2 равен KSharedLibraryUid. UID3 должен быть назначен разработчиком и используется для идентификации уникальности интерфейса .

Для полиморфических DLL, UID2 определяется внешним каркасом (framework). Некоторые каркасы требуют, чтобы UID3 был определен, некоторые нет. Например, графическое приложение должно определить UID2 равный KuidApp, что показывает что в этой DLL используется интерфейс каркаса приложения, а UID3 назначается разработчиком. В качестве другого примера, драйвер принтера требует UID2, но не требует UID3.

Когда один проект использует несколько DLL, то обычно они разделяют один и тот же UID3. Например графическое приложение построенное на базе каркаса приложения, поставляется вместе с "движком", который выполнен как статическая dll. Иногда сложные проекты разделяют одну и туже общую DLL. В этом случае имеет смысл присвоить этой DLL свой UID3.

UID-ы для DLL позволяют загрузчику проверить будет ли загружен правильный тип dll. Это помогает избежать загрузки файлов, которые случайно имею такое же имя.

UID для документов

В Symbian OS, документы являются настоящими файловыми хранилищами - хранилищами, которые могут быть закрыты и открыты вновь. Под хранилищем понимается файл, который имеет определенную внутренную структуру. Существует два различных типа файловых хранилищ, непосредственные хранилища файлов (direct file stores), которые работают по принципу "считывать много раз, записывать файл один раз полностью", и долговременные файловые хранилища (permanent file stores), которые работают по принципу "записывать много раз - считывать много раз".

Это значит, что у документов UID1 должен быть равен или KDirectFileStoreLayoutUid, или KPermanentFileStoreLayoutUid. Значения UID2 и/или UID3 будут зависеть от приложения.

Каждый "родной" документ должен иметь соотвествующий UID1. его значение задается приложением, создавщим этот документ.

Необходимым является только UID1, но в большинстве случаев разработчики захотят определить второй и третий UID-ы для документов, которые создает и использует их приложение. Значения этих UID используются каркасом архитектуры приложения, чтобы управлять связями между приложениями и их документами. Например, это позволяет при открытии файла определить и запустить связанное с ним приложение, а также правильно отображать икону этого приложения, возле файла документа. И наоборот это позволяет приложению, отсортировывать свои файлы среди прочих.

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

Приложения могут также хотеть открыть "неродные" документы, которые не имеют UID, а также могут пожелать стать для таких документов приложением по умолчанию.

Как назначать и получить UID

Поскольку для Symbian OS значения UID имеют огромное значение, разработчику важно правильно их назначать, а также обеспечить уникальность выбранных для приложения UID.

Выделение значений UID осуществляется компанией Symbian и высылается по запросу разработчику. Обычно выделяется по 10 UID. В процессе разработки можно использовать любые UID из диапазона, который описан ниже, но при выпуске коммерческой версии лучше позаботиться об их уникальности и получить от Symbian свои.

Во время разработки можно брать UID из диапазона 0x01000000 до 0x0fffffff. Если вы работаете в команде не используйте для разных приложений одинаковые UID. Это может привести к тому, что приложение не будет найдено и его икона не появится в меню запуска. Разработчики могут запросить отдельный UID или группу написав по адресу uid@symbiandevnet.com. Больше информации о выделении UID может быть предоставлено на вебсайте Symbian.