Plugin:PackUpdater/ru: Difference between revisions

From Miranda NG
Plugin:PackUpdater/ru
Jump to navigation Jump to search
(Imported translation using page migration)
(Imported translation using page migration)
 
(4 intermediate revisions by the same user not shown)
Line 4: Line 4:
== Использование ==
== Использование ==


You can find sample configuration files [https://github.com/miranda-ng/miranda-ng/tree/master/plugins/PackUpdater/Docs/Templates here].
Шаблоны всех файлов лежат в папке [https://github.com/miranda-ng/miranda-ng/tree/master/plugins/PackUpdater/Docs/Templates Templates].


# Import settings from <tt>Autoexec_PackUpdater.ini</tt> to profile. Add strings needed for plugin (e.g. descriptions of update components) to your <tt>langpack_*.txt</tt>.
# Импортируйте настройки из <tt>Autoexec_PackUpdater.ini</tt> в профиль и добавьте в {{GlossLink|Языковой пакет|лангпак}} блок с переводом (например, описания компонентов обновления).
#; Variables in <tt>Autoexec_PackUpdater.ini</tt>
#; Опции <tt>Autoexec_PackUpdater.ini</tt>
#* <tt>AutoUpdate</tt> – check updates automatically on Miranda startup. Can be configured in {{Menu|Events|Pack updates}}.
#* <tt>AutoUpdate</tt> — проверять обновления при запуске Миранды. Настраивается в опциях, в разделе {{Menu|События|Обновление сборки}}.
#* <tt>File_VersionURL</tt> – URL where file with information about versions for all files (<tt>File1.ini</tt>) is stored.
#* <tt>File_VersionURL</tt> — URL, по которому лежит файл <tt>File1.ini</tt> с информацией о версиях для всех файлов.
#* <tt>FileCount</tt> – number of files to check updates for. Plugin supports checking for several files, but in most cases it is enough to check only pack setup file.
#* <tt>FileCount</tt> — количество файлов, для которых нужно проверять обновления. Плагин поддерживает проверку нескольких файлов, однако чаще всего бывает достаточно одного (установщика сборки).
#* <tt>File_x_CurrentVersion</tt> and <tt>File_x_LastVersion</tt> where
#* <tt>File_x_CurrentVersion</tt> и <tt>File_x_LastVersion</tt>, где
#** <tt>x</tt> is a serial number of file beginning with <tt>1</tt>
#** <tt>x</tt> — порядковый номер файла, начиная с <tt>1</tt>
#** <tt>CurrentVersion</tt> – set it to 1.0.0 (or any other you like) and don't change it any more
#** <tt>CurrentVersion</tt> — выставьте 1.0.0 (или любое другое значение) и больше не меняйте
#** <tt>LastVersion</tt> – the same.
#** <tt>LastVersion</tt> — то же самое.
# Create file with information about versions (<tt>File1.ini</tt>), one for all files to check.
# Создайте файл с информацией о версиях (<tt>File1.ini</tt>), один для всех проверяемых файлов.
#; Options of <tt>File1.ini</tt>
#; Опции <tt>File1.ini</tt>
#* Handle <tt>[FileInfo_х]</tt> where <tt>х</tt> is a serial number of file beginning with <tt>1</tt>. Must match the number in profile.
#* Заголовок <tt>[FileInfo_х]</tt>, где <tt>х</tt> — номер файла, начиная с <tt>1</tt>. Должен совпадать с номером, импортированным в профиль.
#* <tt>FileVersion</tt> – current version of file (i.e. version of file in new pack).
#* <tt>FileVersion</tt> — текущая версия файла (т. е. та, на которую обновляемся).
#* <tt>Message</tt> – the message that user will see when plugin finds new version.
#* <tt>Message</tt> — сообщение, которое выводит плагин при нахождении этого обновления.
#* <tt>DownloadURL</tt> – URL of update file (pack setup).
#* <tt>DownloadURL</tt> — URL, по которому лежит файл обновления (установщик сборки).
#* <tt>DiskFileName</tt> – name of file saved on user's PC.
#* <tt>DiskFileName</tt> — имя файла на диске.
#* <tt>FileType</tt> – type of file. Defines final destination of file:
#* <tt>FileType</tt> — тип файла. Определяет конечное его расположение:
#** 1 – pack
#** 1 — сборка
#** 2 – plugin (will be installed into <tt>Plugins</tt> folder)
#** 2 — плагин (будет установлен в папку <tt>Plugins</tt>)
#** 3 – icon set (will be installed into <tt>Icons</tt> folder)
#** 3 — набор значков (будет установлен в папку <tt>Icons</tt>)
#** 4 – files in Miranda root folder
#** 4 — файлы в корне Миранды
#* <tt>Descr</tt> – description to show in update list.
#* <tt>Descr</tt> — описание, которое будет выводиться в окне обновления.
#* <tt>InfoURL</tt> (optional) – sets the URL to be opened by click on ''See information'' button in update message box.
#* <tt>InfoURL</tt> (опционально) — в окошке уведомления появляется кнопка {{Button|Смотреть инфо}}, при нажатии на которую в новом окне откроется указанная страница.
#* <tt>AdvFolder</tt> (optional) – sets subfolder in the folder defined by <tt>FileType</tt>.
#* <tt>AdvFolder</tt> (опционально) — задает подпапку в папке, определяемой типом файла <tt>FileType</tt>.
#* <tt>Force</tt> (optional) – to update a non-existent file, i.e. add file which is not present in current Miranda installation.
#* <tt>Force</tt> (опционально) — файл будет предложен для обновления, даже если он отсутствует.
# Upload your updates and file with information on server.
# Загрузите обновления и файл с информацией о версиях на сервер.




== How it works ==
== Как это работает ==


Plugin has two modes: silent and normal. Silent mode is used to check for updates on startup, normal mode is used when menu item is clicked.
У плагина есть два режима работы: тихий и обычный. Тихий используется при проверке обновлений при запуске, обычный — при выборе пункта меню.


First, plugin downloads the version information file and compares the "local" version (<tt>File_x_CurrentVersion</tt> from profile) with the "remote" one (<tt>FileVersion</tt>). If they differ, then:
<div class="mw-translate-fuzzy">
* in silent mode plugin checks the value of <tt>LastVersion</tt> and if it differs from <tt>FileVersion</tt>, shows the message about the update. If not, there are no messages.
Сначала плагин скачивает файл с информацией о версиях и сравнивает «локальную» версию (<tt>File_x_CurrentVersion</tt> from profile) с «удалённой» (<tt>FileVersion</tt>). Если они отличаются, то:
* in normal mode plugin shows the message in any case. If a user downloaded an update but decided not to install it, the update is still considered to be installed.
* a) в тихом режиме плагин проверяет значение <tt>LastVersion</tt> и, если оно отличается от <tt>FileVersion</tt>, выдаёт сообщение об обновлении, если нет — сообщений об отсутствии обновлений не будет.
* b) в обычном режиме плагин выдаёт сообщение в любом случае. Если пользователь скачал обновление, но решил сразу его не устанавливать, обновление всё равно считается установленным.
</div>


{{PluginGroups}}
{{PluginGroups}}

Latest revision as of 14:10, 31 December 2017

Other languages:
Pack updater
Нет изображения
Имя файла PackUpdater.dll
Авторы Mataes, ZERO_BiT
Скачать
Стабильная версия: 32-bit, 64-bit
Версия в разработке: 32-bit, 64-bit

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

Использование

Шаблоны всех файлов лежат в папке Templates.

  1. Импортируйте настройки из Autoexec_PackUpdater.ini в профиль и добавьте в лангпак блок с переводом (например, описания компонентов обновления).
    Опции Autoexec_PackUpdater.ini
    • AutoUpdate — проверять обновления при запуске Миранды. Настраивается в опциях, в разделе События → Обновление сборки.
    • File_VersionURL — URL, по которому лежит файл File1.ini с информацией о версиях для всех файлов.
    • FileCount — количество файлов, для которых нужно проверять обновления. Плагин поддерживает проверку нескольких файлов, однако чаще всего бывает достаточно одного (установщика сборки).
    • File_x_CurrentVersion и File_x_LastVersion, где
      • x — порядковый номер файла, начиная с 1
      • CurrentVersion — выставьте 1.0.0 (или любое другое значение) и больше не меняйте
      • LastVersion — то же самое.
  2. Создайте файл с информацией о версиях (File1.ini), один для всех проверяемых файлов.
    Опции File1.ini
    • Заголовок [FileInfo_х], где х — номер файла, начиная с 1. Должен совпадать с номером, импортированным в профиль.
    • FileVersion — текущая версия файла (т. е. та, на которую обновляемся).
    • Message — сообщение, которое выводит плагин при нахождении этого обновления.
    • DownloadURL — URL, по которому лежит файл обновления (установщик сборки).
    • DiskFileName — имя файла на диске.
    • FileType — тип файла. Определяет конечное его расположение:
      • 1 — сборка
      • 2 — плагин (будет установлен в папку Plugins)
      • 3 — набор значков (будет установлен в папку Icons)
      • 4 — файлы в корне Миранды
    • Descr — описание, которое будет выводиться в окне обновления.
    • InfoURL (опционально) — в окошке уведомления появляется кнопка Смотреть инфо, при нажатии на которую в новом окне откроется указанная страница.
    • AdvFolder (опционально) — задает подпапку в папке, определяемой типом файла FileType.
    • Force (опционально) — файл будет предложен для обновления, даже если он отсутствует.
  3. Загрузите обновления и файл с информацией о версиях на сервер.


Как это работает

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

Сначала плагин скачивает файл с информацией о версиях и сравнивает «локальную» версию (File_x_CurrentVersion from profile) с «удалённой» (FileVersion). Если они отличаются, то:

  • a) в тихом режиме плагин проверяет значение LastVersion и, если оно отличается от FileVersion, выдаёт сообщение об обновлении, если нет — сообщений об отсутствии обновлений не будет.
  • b) в обычном режиме плагин выдаёт сообщение в любом случае. Если пользователь скачал обновление, но решил сразу его не устанавливать, обновление всё равно считается установленным.


Retrieved from "https://wiki.miranda-ng.org/index.php?title=Plugin:PackUpdater/ru&oldid=24375"