Установка и обновление Sally

Sally не требует установщика. Выпуск — файл .zip для вашей платформы (x64, x86 или ARM64); распакуйте его в доступную для записи папку, например C:\Tools\Sally, и запустите sally.exe. Сохраняйте папки plugins, toolbars и utils рядом с sally.exe. Настройки хранятся отдельно для каждого пользователя вне этой папки, поэтому обновление их не затрагивает.

Программа обновления Sally, utils\salupdate.exe, находит новые выпуски на GitHub и устанавливает их. Сам Sally не подключается к сети для обновлений: он запускает программу обновления.

Начиная с Sally 1.0.38, программа обновления использует язык, выбранный в Sally, в том числе английский, когда в Windows выбран другой язык. Если допустимый язык Sally не настроен, выбирается доступный язык Windows, а при его отсутствии — английский. Окна и запросы подтверждения используют шрифт диалогов и значок приложения Sally. Начиная с 1.0.40, программа обновления использует пользовательский шрифт панелей, если он настроен, иначе шрифт диалогов Windows, и учитывает сохраненный цвет значка приложения.

Чтобы обновить из Sally:

Выберите «Справка/Проверить обновления». Откроется окно обновления, запросит последний выпуск у GitHub и покажет установленную и последнюю версии с заметками о выпуске.
Когда показан новый выпуск, нажмите «Установить и перезапустить».
Программа обновления загружает выпуск, проверяет его по опубликованной с ним контрольной сумме SHA-256, распаковывает и запрашивает подтверждение.
Все окна Sally, запущенные из той же папки, закрываются, файлы заменяются и Sally запускается снова. Затем окно обновления сообщает результат.

«Открыть страницу выпуска» показывает выпуск на GitHub. Установка начинается только после нажатия «Установить и перезапустить».

Заметки о выпуске и добровольная поддержка

Начиная с Sally 1.0.39, окно обновления разделяет «Что нового» и «От разработчика». Подписанное содержимое может предоставлять заметки на выбранном языке; английские заметки остаются доступны, если дополнительное содержимое загрузить не удается. Сообщения разработчика видны всем. Отсутствие содержимого не препятствует бесплатному обновлению.

«Справка/Что нового» открывает заметки установленного выпуска полностью без сети. Это действие не проверяет новые версии и ничего не устанавливает. Для явной сетевой проверки используйте там «Проверить обновления».

«Поддержать Sally» открывает страницу финансовой поддержки. В версии 1.0.40 необязательные действия поддержки доступны во время проверки обновлений и в компактном подтверждении успешного обновления. Добровольный ключ поддержки включает ваш знак поддержки: выбранное имя в окне «О программе» и, при желании, в заголовке Sally. Пока срок поддержки действует или еще не начался, программа обновления скрывает кнопки поддержки и ввода ключа. Имя, даты и управление ключом остаются доступны в окне «О программе»; сообщения разработчика остаются видны. Все функции и обновления остаются бесплатными. Кнопка «Закрыть» просто закрывает окно обновления, не изменяя настройки поддержки.

«Ввести ключ поддержки» позволяет вставить ключ или импортировать его файл. Проверка выполняется автоматически и без сети; проверьте имя и даты, затем нажмите «Сохранить ключ». В окне «О программе» раздел «Сведения о поддержке» показывает сохраненное имя и сроки поддержки. Необязательный флажок показа имени в заголовке сохраняется сразу. Небольшая стрелка рядом с «Закрыть» открывает замену, экспорт или удаление локального ключа с подтверждением. Имя отображается локально на вашем компьютере.

После взноса через PayPal или Buy Me a Coffee воспользуйтесь ссылкой запроса на странице поддержки, чтобы отправить на badges [at] get-sally [dot] app письмо с желаемым именем, адресом электронной почты для получения ключа, платежным сервисом и именем плательщика либо идентификатором транзакции. Ключи выдаются вручную, обычно в течение недели. Все функции и обновления остаются бесплатными.

Ссылки в любой из двух областей чтения можно открывать мышью или через контекстное меню: установите фокус на область и нажмите Shift+F10 или клавишу контекстного меню.

Расписание автоматических обновлений

Sally также самостоятельно проверяет новые выпуски: еженедельно, если не задана другая частота параметром «Проверять обновления» в разделе «Настройка/Общие» (от ежедневной до одного раза в шесть месяцев или никогда). Если новой версии нет, ничего не показывается. При ее наличии окно обновления открывается, не перехватывая ввод с клавиатуры, а его кнопка на панели задач мигает. Если GitHub недоступен, Sally повторяет попытку на следующий день.

До Sally 1.0.36 эту задачу выполнял плагин Check Version. Sally 1.0.37 перенимает его расписание и удаляет плагин.

Чтобы установить самостоятельно загруженный выпуск (в том числе без сети):

Загрузите .zip выпуска для своей платформы и, по возможности, файл Sally-v<version>-SHA256SUMS.txt в ту же папку.
Перетащите .zip на utils\salupdate.exe в папке Sally или выполните utils\salupdate.exe <path to the .zip>.
Программа обновления показывает установленную и новую версии (и спрашивает перед установкой более старой), сообщает, запущен ли Sally, и запрашивает подтверждение один раз. Sally закрывается, файлы заменяются и Sally запускается снова.

Командная строка программы обновления

<file>.zip	Устанавливает загруженный выпуск (см. выше).
--yes	Отвечает «Да» на все вопросы и работает без сообщений; ошибки по-прежнему показываются. Результат записывается в журнал (см. ниже).
--install <folder>	Обновляет Sally в указанной папке вместо папки самой программы обновления.
--check	Открывает окно обновления, как команда «Справка/Проверить обновления».
--whats-new	Показывает заметки установленного выпуска без сети, как команда «Справка/Что нового». Можно сочетать с --install для выбора папки Sally; параметры сетевой проверки и действий установки в этом режиме не принимаются.
--auto	С --check: ничего не показывает, если новой версии нет, как собственная проверка Sally. Код выхода — 0, если Sally актуален, 1, если окно было показано, и 2, если не удалось связаться с GitHub.
--feed <address>	С --check: обращается к другому адресу HTTPS, отвечающему так же, как лента выпусков GitHub (зеркало).
--report --result <file>	Показывает результат обновления, оставившего указанный файл результата. Sally запускает этот режим после обновления.

Запустите salupdate.exe без файла, чтобы отменить обновление, прерванное, например, отключением питания. Для установки выпуска Sally запускает программу обновления с дополнительными служебными параметрами (--prepare, --apply и их аргументами); они не предназначены для ручного ввода.

Что изменяет обновление

Заменяются только файлы выпуска. Остальные файлы, например экспортированные настройки или добавленные вами файлы, остаются без изменений.
Файл, установленный старой версией и отсутствующий в новой (например, удаленный плагин Check Version в 1.0.37), удаляется. Такие файлы перечислены в sally-update.obsolete в папке Sally.
Пока новые файлы не готовы, ничего не меняется. Если какой-либо файл заменить невозможно, все файлы возвращаются точно в прежнее состояние.
Проводник Windows держит загруженным расширение оболочки Sally (utils\salextx64.dll, salextx86.dll или salextARM64.dll). Программа обновления переименовывает загруженный файл, например в salextx64.dll.sally-old, и помещает новый на его место. Sally удаляет старую копию при одном из последующих запусков, когда Проводник перестает ее использовать. Перезапуск Windows не требуется.
Для папки Sally внутри Program Files один раз запрашиваются права администратора — только для замены файлов.

Перед установкой программа обновления проверяет, что пакет является выпуском Sally для вашего процессора, и отклоняет пакет, записывающий за пределы папки Sally. Пакет с несовпадающей опубликованной контрольной суммой SHA-256 отклоняется; пакет без доступной для сравнения суммы устанавливается только после подтверждения.

Где искать сведения при неполадках

Журнал программы обновления и последний результат: %LOCALAPPDATA%\Sally\Update\salupdate.log и result.txt. Загрузки остаются в той же папке до завершения обновления.
Всегда можно обновить вручную: закройте Sally и распакуйте новый выпуск поверх папки Sally. Если Windows сообщает, что salextx64.dll используется, переименуйте этот файл и повторите копирование.
В Sally 1.0.35 и более ранних версиях нет программы обновления; обновите их вручную один раз.

См. также

Настройка/Общие
Новое в этой версии
Запуск Sally с параметрами

Чтобы написать нам, замените [at] на @, а [dot] на точку. Укажите желаемое имя для знака поддержки, адрес электронной почты для получения ключа, платежную систему и имя плательщика или идентификатор операции.

контактный адрес для знака поддержки: badges [at] get-sally [dot] app