Это старая версия документа!
Файл представляет собой тег addon со следующими атрибутами:
addonSize — размер дополнения в байтах (0, если размещается у нас).address1, address2, … — адрес региона, карты которого содержатся в дополнении, в соответствии с административно-территориальным делением. Например, если дополнение содержит карты какого-то региона России, значения атрибутов могут быть следующими: address1 — название страны, address2 — название федерального округа, address3 — название региона. Атрибуты address используются для создания структуры каталога карт в разделе «Дополнения».date — дата последнего обновления данных в дополнении в формате YYYY-MM-DDThh:mm:ss или YYYY-MM-DD.descFiles — список имён файлов, которые используются в описании дополнения (картинки, звуковой файл).description — описание содержимого дополнения и ключевые слова для поиска.feedbackURL — URL для отправки отзыва от пользователя дополнения.os — список ОС, на которых доступно дополнение. Названия ОС: Android, CE, iOS, LINUX, NT, RT. Если атрибут не указан, дополнение доступно на всех ОС.programVer — версия программы, для которой было сделано дополнение, в виде x.y.provider — наименование поставщика дополнения.title — наименование дополнения.type — список типов ресурсов, содержащихся в дополнении. Возможные типы: language, map, skin, sound, speedcam.url — URL для загрузки дополнения. Альтернативные адреса могут быть заданы в атрибутах url0, url1, …, url9, но имя файла должно быть везде одно и то же.zipSize — размер zip-архива с дополнением в байтах (0, если размещается у нас).У платных дополнений есть дополнительные атрибуты:
expiredKeyMsg — текст, который выводится в окне активации, если у пользователя есть ключ, но его срок действия закончился.keyId — идентификатор ключа, которым зашифровано дополнение.keyRequestURL — URL, используемый для загрузки ключа пользователя.keySoftExpireMsg — текст, который выводится в окне активации, если у пользователя есть ключ, но его срок действия заканчивается.noKeyMsg — текст, который выводится в окне активации, если у пользователя нет ключа.productIds — список названий продуктов, покупка одного из которых открывает доступ к дополнению.providerId — идентификатор поставщика.purchaseCodeFileName — имя файла, в котором программе следует искать код покупки.requestFileMsg — текст, который выводится после создания файла запроса.requestFileName — имя файла запроса (без расширения).
Атрибуты title, type и url являются обязательными.
Атрибуты address, description, expiredKeyMsg, keySoftExpireMsg, noKeyMsg, provider, requestFileMsg, title являются мультиязычными, т.е. можно указать несколько атрибутов с одним названием, добавив к названию :xx, где xx — код языка по стандарту ISO 639-1. При этом обязательно должен быть указан атрибут без суффикса — его значение будет использоваться, когда нет атрибута с подходящим языковым суффиксом.
В атрибутах, содержащих список, элементы разделяются точкой с запятой.
<addon title="All Russia" title:ru="Вся Россия" description="Russian Federation map based on OSM sources.\n[picture=test_screen1]\n Cites: Moscow" description:ru="Территория Российской Федерации на основе карт OSM.\n[picture=test_screen1]\n Города: " descFiles="test_screen1.png" type="map" date="2014-03-24T08:56:18" zipSize="26312104" addonSize="37073123" address1="Russia" address1:ru="Россия" provider="megamaps.org" url="192.168.100.1/russia_all/russia.zip" feedbackURL="192.168.100.1/russia/feedback.php" productIds="embedded001y;embedded001m" requestFileName="file-request" providerId="11111" keyId="65520" keyRequestURL="sibreg.org/activate.php" />