Helgring XF Release Builder 1.1.1

Обновление до версии 1.1.1​

---

✦ Переход на SSH Key-авторизацию, доработка config.json и улучшение общей стабильности удалённой релизной сборки ✦​

---

Что было обновлено:
Версия 1.1.1 для Helgring XF Release Builder стала важным техническим продолжением версии 1.1.0. Если в 1.1.0 основной акцент был сделан на переходе к официальной удалённой сборке XenForo через SSH + PHP CLI + xf-addon:build-release, то в 1.1.1 внимание уже было сосредоточено на улучшении самой схемы подключения, доработке config.json и переводе рабочего сценария на более удобный и современный вариант через SSH Key.

Главная цель этого обновления заключалась в том, чтобы сделать саму утилиту более удобной в повседневном использовании, убрать лишнюю зависимость от постоянного ручного ввода пароля и довести новую архитектуру версии 1.1.0 до более стабильного и практичного состояния. В итоге версия 1.1.1 стала уже не просто продолжением прошлой сборки, а более правильной рабочей редакцией самого скрипта.

• Основной сценарий авторизации был переведён на SSH Key — если в предыдущем варианте упор делался на подключение через password, то в версии 1.1.1 основной рабочий сценарий был доработан под использование SSH Key. Это позволило сделать запуск утилиты заметно удобнее для постоянной работы и убрать лишнюю необходимость каждый раз вручную вводить SSH-пароль.
• Доработана логика подключения по SSH — в новой версии была улучшена сама схема соединения с сервером, чтобы авторизация через ключ работала стабильнее и корректнее. Благодаря этому утилита стала лучше подходить именно для регулярной серверной релизной сборки, а не только для разовых запусков.
• Переработан блок auth в config.json — теперь конфигурация работы через SSH Key оформлена более правильно и логично. В профиле используются параметры auth.method и key_filename, благодаря чему настройка подключения стала понятнее и лучше соответствует реальному сценарию удалённой SSH-авторизации.
• Исправлен и уточнён шаблон config.json — в версии 1.1.1 отдельное внимание было уделено самому конфигурационному шаблону. Теперь он лучше отражает актуальную схему работы утилиты и помогает пользователю правильно настроить host, username, forum_root, php_bin, addon_id, release_dir и параметры SSH-ключа без лишней путаницы.
• Сохранена вся основная серверная логика версии 1.1.0 — утилита по-прежнему подключается к серверу, выполняет preflight-проверки, проверяет cmd.php, src/config.php, доступность нужного PHP CLI, активность mbstring, а затем запускает официальный xf-addon:build-release. То есть версия 1.1.1 не ломает архитектуру 1.1.0, а делает её удобнее и надёжнее.
• Улучшена общая практичность повседневного использования — одна из главных задач обновления состояла в том, чтобы утилита ощущалась не как разовый технический скрипт, а как действительно удобный рабочий инструмент. Переход на SSH Key сделал процесс запуска релизной сборки заметно спокойнее и быстрее, особенно при регулярной работе с dev-копией форума.
• Сохранён привычный сценарий работы через config.json — несмотря на внутренние доработки, утилита по-прежнему остаётся понятной по своей общей схеме: пользователь редактирует профиль, указывает нужные серверные параметры и запускает релизную сборку без необходимости менять внутреннюю логику самого скрипта.
• Улучшена работа с путями и параметрами профиля — в версии 1.1.1 были доработаны детали, связанные с конфигурацией профиля и использованием рабочих путей. Это позволило сделать поведение утилиты более аккуратным и предсказуемым при использовании реальных серверных профилей.
• Версия 1.1.1 стала более правильной рабочей редакцией скрипта — по сути это обновление не меняет саму идею версии 1.1.0, а доводит её до более зрелого состояния. После доработок скрипт стал лучше соответствовать реальному рабочему процессу удалённой релизной сборки через SSH и XenForo CLI.
• Добавлена более современная схема использования для тех, кто работает с SSH регулярно — версия 1.1.1 особенно полезна для тех, кто не хочет каждый раз входить по паролю и предпочитает более взрослый подход через SSH Key. Такой сценарий удобнее, чище и лучше подходит для постоянной работы.
• Сохранена возможность остаться на версии 1.1.0 — если пользователь не хочет настраивать SSH Key и ему проще работать по старой схеме через password, он может без проблем продолжать использовать версию 1.1.0. Таким образом, версия 1.1.1 является не заменой любой ценой, а более удобной альтернативой для тех, кто хочет перейти на ключевую авторизацию.
• Проведена общая техническая доводка новой архитектуры — версия 1.1.1 стала именно тем обновлением, которое закрепляет и усиливает результаты большого перехода, выполненного в 1.1.0. В итоге утилита стала более цельной, более стабильной и лучше подготовленной для реального ежедневного использования.

---

В результате версия 1.1.1 стала для Helgring XF Release Builder логичным и очень полезным развитием версии 1.1.0. Основная архитектура удалённой релизной сборки через официальный CLI XenForo была сохранена, но сама схема работы стала заметно удобнее за счёт перехода на SSH Key, доработки config.json и общей технической шлифовки скрипта.

Иными словами, 1.1.1 — это не косметическое обновление, а практическая доводка уже созданной системы до более правильного рабочего состояния. Лично я сам перешёл на эту версию и решил поделиться ей со всеми. Если же вам не хочется заморачиваться с SSH Key, можно спокойно использовать версию 1.1.0, где применяется схема авторизации через password.

Скриншоты:

​

Обновление до версии 1.1.0​

---

✦ Полная переработка утилиты: переход на официальный механизм XenForo, удалённая SSH-сборка релизов и выпуск публичной EXE-версии ✦​

---

Что было обновлено:
В версии 1.1.0 утилита Helgring XF Release Builder была не просто немного доработана, а фактически полностью переведена на новый уровень. Если старая версия представляла собой локальный инструмент для ручной пересборки hashes.json и упаковки ZIP-архива, то теперь проект стал полноценной консольной системой для официальной серверной сборки релизов XenForo через SSH и CLI. Основной акцент обновления был сделан на отказе от ручной логики пересчёта релиза в пользу официальной сборки XenForo, создании профильной конфигурации, улучшении пользовательского интерфейса, автоматизации скачивания готового архива и подготовке отдельной EXE-версии для публичного распространения.

• Полностью изменена основная концепция работы утилиты — старая версия была ориентирована на локальную пересборку hashes.json, анализ структуры папки upload и упаковку ZIP вручную. В версии 1.1.0 утилита была переведена на официальный механизм XenForo и теперь работает через SSH + PHP CLI + xf-addon:build-release, что делает релизную сборку значительно более правильной, стабильной и профессиональной.
• Добавлена удалённая сборка релиза через SSH — теперь утилита подключается к серверу, проверяет рабочее окружение и запускает официальные команды XenForo прямо на dev-копии форума. Благодаря этому релиз собирается самим XenForo, а не вручную сторонней логикой, что повышает надёжность структуры архива и итогового результата.
• Введена профильная система через config.json — работа утилиты теперь строится на понятной конфигурации профилей, где указываются хост, порт, SSH-логин, корень форума, PHP CLI, add-on, release_dir и другие параметры. Это позволило сделать инструмент пригодным не только для одного жёстко вшитого сценария, но и для повторяемого использования под разные проекты и разные add-on-пакеты.
• Добавлены обязательные preflight-проверки перед сборкой — перед запуском релиза утилита теперь автоматически проверяет наличие cmd.php, src/config.php, каталога нужного add-on, доступность указанного PHP CLI, а также активность критически важного расширения mbstring. Это позволило превратить инструмент в более надёжный рабочий процесс, который сначала валидирует среду, а уже потом запускает релизную сборку.
• Добавлена официальная цепочка CLI-команд XenForo — утилита теперь использует xf-addon:validate-json и xf-addon:build-release как основные этапы релизной сборки. При необходимости поддерживается и xf-addon:sync-json, но его логика была отдельно доработана, чтобы корректно обрабатывались ситуации, когда JSON-изменений нет и сборка всё равно должна продолжаться без ложного падения.
• Реализовано автоматическое определение и скачивание свежего ZIP-архива — после завершения серверной сборки утилита сама находит последний релиз в _releases, определяет актуальный архив и скачивает его на локальный компьютер в папку downloads. Это избавляет от ручного поиска готового ZIP на сервере и завершает весь цикл релизной сборки в одном окне.
• Полностью переработан консольный интерфейс — утилита получила более аккуратный и уже действительно фирменный вид: заголовок, цветовую подачу, структурированные блоки, разделы проверки, сборки, скачивания и итога, а также локализованные статусы и более понятный вывод для пользователя. Визуально проект перестал выглядеть как обычный технический скрипт и стал восприниматься как полноценный рабочий инструмент.
• Добавлена локализация вывода официального XenForo CLI — типовые сообщения XenForo вроде проверки addon.json, экспорта данных и записи релиза теперь выводятся в более понятном и аккуратном русскоязычном формате. Это сделало процесс сборки заметно удобнее для повседневного использования и визуально более цельным.
• Добавлено удобное завершающее меню после выполнения — теперь после успешной или неуспешной работы утилита не просто завершает процесс, а предлагает пользователю либо повторить сборку, либо закрыть окно. Это небольшое, но очень полезное улучшение сделало работу с программой заметно комфортнее.
• Подготовлена отдельная EXE-система для публичного распространения — в рамках обновления был разработан специальный builder для выпуска EXE-версии утилиты. Это позволило скрыть основной исходный код из публичного пакета и перейти к более аккуратной схеме распространения, когда конечный пользователь получает готовый исполняемый файл, а не весь Python-исходник.
• Реализован публичный технический config.json для релизной раздачи — EXE-builder теперь автоматически готовит рядом с исполняемым файлом отдельный config.json с техническими шаблонными значениями, чтобы пользователь мог вписать собственные серверные данные, не получая чужую рабочую конфигурацию. Это улучшило как безопасность распространения, так и общее качество релизного пакета.
• Сборка EXE была усилена и стала заметно устойчивее — логика builder была переработана, добавлены проверки исходного файла, поддержка иконки, формирование публичного конфига, логирование, а также резервный переход к более надёжному механизму сборки в тех случаях, где старый путь давал сбои. Благодаря этому выпуск EXE-пакета стал гораздо стабильнее и пригоднее для реального использования.
• Разделены приватная и публичная части проекта — теперь структура стала более взрослой и профессиональной: исходники и вспомогательные builder-файлы используются только на стороне автора, а пользователям предназначается только итоговый публичный пакет с EXE и config.json. Это сделало релиз чище, безопаснее и логичнее для публикации на форуме.
• Проведена общая архитектурная и техническая переработка утилиты — версия 1.1.0 стала не точечным обновлением старого скрипта, а полноценным переходом от экспериментального локального решения к гораздо более серьёзному инструменту для релизной сборки XenForo add-on-проектов.

---

В результате версия 1.1.0 стала для Helgring XF Release Builder действительно важным этапом развития. Старая локальная логика пересборки hashes.json и ручной ZIP-упаковки была заменена на более правильный и взрослый подход: официальный CLI-механизм XenForo, удалённая SSH-сборка, профильная конфигурация, автоматическое скачивание готового архива и выпуск отдельной EXE-версии для публичного распространения.

Иными словами, утилита перестала быть просто вспомогательным скриптом и превратилась в гораздо более целостный, стабильный и профессионально оформленный инструмент для работы с релизами XenForo.

Скриншоты:

---