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

Начало  Предыдущая  Следующая

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

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

[plugininstall]

description=<описание плагина>

description.<код языка>=<описание плагина>

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

version=<строка версии>

type=<код типа>

build=<номер сборки>

file=<имя файла плагина или код языка>

defaultdir=<имя папки плагина>

defaultextension=<расширения файлов>

parameters=<строка параметров>

 

 

Ключи:

description=<описание плагина>

description.<код языка>=<описание плагина>

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

 

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

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

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

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

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

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

 

Ключ:

version=<строка версии>

 

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

 

Ключ:

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

 

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

acx или wcx

инсталляция плагина архиватора

oMegaLng

инсталляция языкового файла

Copy

простое копирование файлов в каталог, указанный в defaultdir

CopyAndLng

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

 

 

Ключ:

build=<номер сборки>

 

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

 

Ключ:

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

 

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

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

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

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

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

 

Ключ:

defaultdir=<имя папки>

 

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

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

 

Ключ:

defaultextension=<расширения файлов>

 

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

 

Ключ:

parametersX=<строка параметров>

 

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

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

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

В main.ini в секции [PackerPlugins] есть строка:

rar=%aRun%\Plugins\Standard\acx\rar\pylRar.acx64|xxx

где xxx – это описание внешнего архиватора.

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