Файл представляет собой тег 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="navikey.ru/russia_all/russia.zip" feedbackURL="navikey.ru/russia/feedback.php" programVer="1.04" productIds="embedded001y;embedded001m" requestFileName="file-request" providerId="11111" keyId="65520" keyRequestURL="sibreg.org/activate.php" noKeyMsg="" keySoftExpireMsg="" expiredKeyMsg="" requestFileMsg="" />