Автоматическая установка плагинов и языковых файлов

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

Данный файл представляет собой ini-файл следующего содержания:

description<альтернативный код языка>=<описание плагина>

<описание плагина> – строка описания на данном языке (если код языка не указан, то – желательно, на английском языке).

<код языка> – имя одного из lng-файлов в каталоге Languages программы (обычно из 2-х букв).

<альтернативный код языка> – это тот код, который указывается в lng-файле в параметре "Info=".

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

В строке можно выделять надписи цвет, стилем или размером шрифта. Для этого применяются конструкции форматирования [f…;…].

Строку описания можно записать в несколько строк. В качестве разделителей строк используется "\n". Соответственно отдельный символ "\" можно экранировать так "\\" (но не обязательно).

<строка версии> – сообщение для пользователя, показывается в отдельной строке.

<код типа> может содержать следующие значения:

acx или wcx	инсталляция плагина архиватора
oMegaLng	инсталляция языкового файла
Copy	простое копирование файлов в каталог, указанный в defaultdir
CopyAndLng	копирование файлов, со сменой языка. Язык указывается в file, каталог в defaultdir. Данный тип можно использовать для установки не только lng-, ini-файлов перевода, но и, например, перевода файлов помощи.

<номер сборки> – Номер сборки программы, для которой этот плагин или языковой файл предназначается. Для совместимости с последующими версиями программы, желательно указывать этот номер. Номер сборки все время увеличивается и служит идентификатором версии.

file=<имя файла плагина или код языка> (это обязательный параметр для языковых файлов)

<имя файла плагина или код языка> – для плагинов – это имя файла плагина, для языковых файлов – это код языка. Допустимо указать имя файла языка, тогда расширение будет отброшено.

Для установки из одного архива одновременно нескольких версий плагина (32-битного и 64-битного) необходимы следующие условия:

oИсполняемые файлы разных версий плагина должны находиться в одном каталоге.

oИмена исполняемых файлов плагинов должны быть одинаковыми (кроме расширений).

oРасширения плагинов должны быть стандартными (acx32, wcx – для 32-битных, acx64, wcx64 – для 64-битных).

Параметр используется при установке плагинов и для типов Copy, CopyAndLng.

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

Данный параметр только для архиваторного плагина. Расширения архивов перечисляются через запятую. Если запятая является частью расширения, то её можно экранировать символом "\".

Если устанавливается один плагин, то X – отсутствует, иначе X – это порядковый номер плагина начиная с 1.

Для плагинов архиваторов здесь записывается строка дополнительных настроек плагина и параметры внешнего архиватора, дополнительно подключаемого к плагину.

Строка здесь представляется точно в таком виде, как она хранится в ini-файле настройки плагина, исключая начальную часть с именем файла плагина. Пример:

Имейте ввиду, что в данной строке весьма вероятно могут содержаться юникод-символы. Поэтому файл pluginst.inf, при использовании данной строки, необходимо сохранить в формате Unicode little-endian, желательно с меткой BOM.