Plugin:PackUpdater/ru: Difference between revisions

From Miranda NG
Plugin:PackUpdater/ru
Jump to navigation Jump to search
(Updating to match new version of source page)
(Imported translation using page migration)
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>{{PluginCard}}
<languages/>{{PluginCard}}
Simple updater for Miranda NG premodified packs. Plugin may be interesting for pack authors who want to automate the process of updating of their packs.
Простой плагин для обновлений сборок Miranda NG. Плагин рассчитан, в первую очередь, на создателей сборок, которые хотят автоматизировать процесс обновления своих сборок.


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


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"