RuScenery - библиотека аэродромной техники, строений, самолетов СССР-СНГ

Для разработчиков библиотеки RuScenery

На главную


Описание формата файла текущей версии библиотеки RuScenery

05 июля 2009 г.


Файл текущей версии библиотеки RuScenery состоит из последовательных строчек, с разделителем «0D 0A». Файл используется для управления программой установки и обновления библиотеки RuScenery. Имя файла фиксированное — «ruscenery.ver»


Комментарии

Строка, начинающаяся с символа «#» является комментарием и при обработке игнорируется.

Пример:
# сборка от 03.07.2009 19:55:03


Управляющие команды

Строка, начинающаяся с символа «;» является управляющей командой.

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

Доступны следующие виды команд:


Url

;u (или ;U)

Указывает папку, в которой следует искать файл текущей версии при следующей закачке. Значение должно сохраняться на стороне клиента и использоваться при следующем подключении. Может применяться при планировании смены хост-провайдера или структуры сайта.

Пример:
;u http://ruscenery.x-air.ru/ver/

При отсутствии команды используется значение:
http://ruscenery.x-air.ru/ver/


Download url

;d (или ;D)

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

Пример:
;d http://ruscenery.x-air.ru/update/

При отсутствии команды используется значение: http://ruscenery.x-air.ru/update/


Version

;v (или ;V)

Указывает текущую версию программы обновления, хранимую на сайте обновлений. В том случае, если версия программы у клиента ниже, чем последняя — пользователю должно выводиться сообщение с предложением обновить программу. При этом запущенная в этом сеансе закачка обновлений не должна блокироваться.

Пример:
;v 1.0.1

При отсутствии команды сравнение версий не производится.


Status string

;s (или ;S)

Указывает текстовую строчку в кодировке Win-1251, которая выводится у пользователя в течение всего обновления. Использование управляющих символов в строчке не допускается.

Пример:
;s Бета версия - работает в тестовом режиме

При отсутствии команды сообщение у клиента не выводится.


Top message

;t (или ;T)

Указывает текстовую строчку в кодировке Win-1251, которая выводится у пользователя перед началом обновления. Использование управляющих символов в строчке не допускается.

Пример:
;t Вы начинаете устанавливать библиотеку RuScenery

При отсутствии команды сообщение у клиента не выводится.


Bottom message

;b (или ;B)

Указывает текстовую строчку в кодировке Win-1251, которая выводится у пользователя после завершения обновления. Использование управляющих символов в строчке не допускается.

Пример:
;b Спасибо за установку библиотеки RuScenery

При отсутствии команды сообщение у клиента не выводится.


Строчки описания файлов

Строчки содержат разделенные одним пробелом поля. В полях категорически не допускается использование управляющих символов и символов пробела.

Пример:
aircrafts\an-74-3.obj 351999 03.07.2009 01:00:08

Этот файл лежит на сервере по адресу «http://ruscenery.x-air.ru/update/aircrafts/an-74-3.obj» и должен быть размещен у клиента как «\X-Plane 9\Custom Scenery\ruscenery\aircrafts\an-74-3.obj».

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

Пример:
aircrafts\an-74-3.obj 351999 03.07.2009 01:00:08 789543123


Пример файла текущей версии

#
# Файл описания версии библиотеки RuScenery
# Версия библиотеки 1.0.8
# сборка от 03.07.2009 19:55:03
#
;u http://ruscenery.x-air.ru/ver/
;d http://ruscenery.x-air.ru/update/
;v 1.0.1
;s Бета версия - работает в тестовом режиме
#
copyrights.txt 9936 03.07.2009 01:00:08
dirinfo.txt 4383 03.07.2009 01:00:08
install.txt 187 03.07.2009 01:00:08
library.txt 37558 03.07.2009 01:00:08
aircrafts\a-50.obj 485812 03.07.2009 01:00:08
aircrafts\a-50.png 1422830 03.07.2009 01:00:08
aircrafts\a-50_lit.png 286949 03.07.2009 01:00:08
aircrafts\an-10.obj 241334 03.07.2009 01:00:08
aircrafts\an-10.png 1028434 03.07.2009 01:00:08
aircrafts\an-10_lit.png 451958 03.07.2009 01:00:08
...
tech\uaz.obj 77988 03.07.2009 01:00:08
tech\ural-mil.obj 119712 03.07.2009 01:00:08
tech\zil-mil.obj 83812 03.07.2009 01:00:08
#


Ссылки