Документация / Устранение неполадок

Устранение неполадок

Столкнулись с проблемой? Ниже приведены решения самых распространённых неполадок. Каждая карточка описывает конкретный симптом и способ его устранить.

Разрешения

«BetterStage не может управлять моими окнами»

Чтобы считывать и перемещать окна, BetterStage нужно разрешение «Универсальный доступ». Откройте «Системные настройки» > «Конфиденциальность и безопасность» > «Универсальный доступ» и убедитесь, что BetterStage есть в списке и включён. Если он уже был включён, попробуйте выключить и снова включить его. После изменения разрешения перезапустите BetterStage. Если разрешение отзывается во время работы BetterStage, приложение предупредит вас и вернёт скрытые окна, а не оставит их за пределами экрана. Отзыв универсального доступа больше не приводит к тому, что BetterStage удерживает ввод с клавиатуры или мыши. Повторное предоставление разрешения не прерывает уже идущее восстановление сохранённой рабочей области, непрерывности или после выхода из сна.

«Сочетания клавиш не работают»

Для сочетаний клавиш BetterStage использует встроенный Carbon API горячих клавиш, поэтому разрешение «Мониторинг ввода» не нужно. Если сочетания не работают, сначала проверьте, что разрешение «Универсальный доступ» включено. Также убедитесь, что никакое другое приложение не использует те же сочетания клавиш, кнопки мыши или жесты трекпада: конфликтующие сочетания не дадут BetterStage получать события. Переназначить управление с клавиатуры, мыши и трекпада можно в разделе «Настройки» > «Сочетания».

«Окна не обнаруживаются»

Обнаружение окон использует Accessibility API macOS, доступ к которому даёт разрешение «Универсальный доступ». Убедитесь, что оно включено в разделе «Системные настройки» > «Конфиденциальность и безопасность» > «Универсальный доступ». Учтите, что некоторые приложения используют нестандартные типы окон (например, плавающие панели или нестандартные окна Chrome), которые Accessibility API может не обнаружить.

Поведение окон

«Стоит ли использовать BetterStage вместе с Планировщиком macOS?»

Нет. Отключите встроенный Планировщик Apple, прежде чем использовать BetterStage. Оба инструмента управляют видимостью окон, поэтому при совместной работе возможны непонятные переключения, скрытые окна или окна, появляющиеся не на своём месте. Откройте «Системные настройки» > «Рабочий стол и Dock» > «Планировщик» и отключите Планировщик, а затем, если рабочая область по-прежнему выглядит неправильно, перезапустите BetterStage.

«Окна Firefox/Chrome перемещаются с анимацией, а не мгновенно»

Некоторые браузеры (Firefox, Chrome и приложения на Electron) включают флаг универсального доступа AXEnhancedUserInterface, из-за которого окна перемещаются с анимацией, а не мгновенно. BetterStage автоматически обнаруживает и отключает этот флаг для таких приложений. Если анимация всё ещё есть, попробуйте закрыть и снова открыть браузер, чтобы BetterStage повторно применил исправление.

«Окна Firefox мерцают, плохо поддаются размещению или запаздывают при переключении сцен»

Firefox обрабатывает свои окна нестандартно, поэтому не всегда хорошо работает с управлением окнами: окна могут ненадолго мерцать, плохо поддаваться точному размещению или запаздывать при переключении сцен. Это известная проблема, и мы продолжаем улучшать совместимость с Firefox.

«При переключении на пустую сцену появляется Finder»

macOS может активировать Finder, когда у активного приложения нет видимых окон. BetterStage 2.2.0 скрывает отдельные окна в скрытом пространстве, а не всё приложение целиком. Если на пустой сцене неожиданно появляется окно, сообщите нам название приложения и последовательность переключений сцен или рабочих столов, после которых это произошло.

«После сна или заставки окна оказались не на той сцене»

Дождитесь, пока конфигурация дисплеев стабилизируется. Раскладка знакомого дисплея вернётся сама; если появится запрос на восстановление, выберите «Восстановить рабочую область» или «Оставить текущую раскладку». Для окон, которые остались скрытыми после удаления рабочего стола или оказались за пределами экрана после изменения дисплеев, используйте «Спасти окна» в строке меню. Если BetterStage сообщает, что пространства macOS недоступны, дождитесь завершения переключения рабочего стола и выберите «Повторить». Если проблема не исчезает, перезапустите BetterStage.

«Диалог или плавающее окно застряло за TabStack»

Откройте колесо привязки и выберите «Поднять плавающие» в меню «Другие действия». Плавающие и неотслеживаемые окна на этом мониторе окажутся на переднем плане без изменения раскладки и без показа скрытых вкладок. «Спасти окна» также возвращает окна, которые BetterStage скрыл в скрытых пространствах, включая окна, исходный рабочий стол которых был удалён.

«После сбоя пропали окна»

BetterStage записывает, какие окна перемещены в скрытые пространства, и запускает отдельный вспомогательный процесс восстановления. Если BetterStage неожиданно завершится, этот процесс по записям вернёт скрытые окна на их сохранённые рабочие столы. Если окон всё ещё нет, перезапустите BetterStage и используйте «Спасти окна». Для удалённого рабочего стола или отключённого дисплея может потребоваться доступное место назначения на замену.

Конфигурация приложения

«Запуск из терминала или из пакета .app»

Если запускать BetterStage через swift run в терминале, macOS привязывает разрешение универсального доступа к приложению терминала, а не к самому BetterStage. Чтобы разрешения работали правильно и BetterStage отображался под своим именем в Системных настройках, соберите и запустите пакет .app.

«Строка сцен не появляется»

Строку сцен можно вызвать через активный край (переместив указатель к верхней части экрана) или сочетанием клавиш Opt+Up Arrow. Убедитесь, что активный край включён в настройках. Если строка сцен всё равно не появляется, проверьте, что у BetterStage есть необходимое разрешение универсального доступа.

На встроенных дисплеях Mac с вырезом параметр «Настройки» > «Сцены» > «Строка сцен» > «Обходить вырез дисплея» позволяет исключить сам вырез, оставив активной остальную часть верхнего края.

«Монитор не распознаётся после повторного подключения»

BetterStage распознаёт мониторы по аппаратным данным, таким как модель и серийный номер, а не только по идентификатору дисплея, который назначает macOS. В редких случаях, например после обновления драйвера или при подключении через другой порт или адаптер, эти данные меняются. Попробуйте отключить и снова подключить монитор, затем перезапустите BetterStage. Если монитор по-прежнему не распознаётся, настройте его заново в разделе «Настройки» > «Дисплеи».

«⌘Tab по-прежнему показывает переключатель приложений macOS»

Переключатель ⌘Tab в BetterStage необязателен и по умолчанию выключен. Включите «Использовать ⌘Tab BetterStage» в разделе «Настройки» > «Переключатель ⌘Tab» и убедитесь, что активны Pro, пробный период или ежедневный пробный доступ к Pro. Без превью переключатель показывает значки приложений; для живых миниатюр разрешите запись экрана. См. руководство по переключателю ⌘Tab.

«Сцены не загружаются после возврата на 2.0.x»

Сцены, сохранённые в BetterStage 2.2, нельзя открыть в более ранних версиях. Если вы переустановили 2.0.x, сцены не загрузятся; вместо этого обновитесь до последней версии со страницы загрузки.

Как сообщить об ошибке

BetterStage ведёт циклический журнал диагностики размером не более 10 МБ, чтобы он никогда не заполнил диск. Чтобы приложить его к сообщению об ошибке, нажмите значок BetterStage в строке меню и выберите «Показать журнал диагностики…» — Finder откроет файл журнала, и его можно будет перетащить в сообщение Discord, issue на GitHub или письмо.

Релизные сборки не ведут подробный журнал, который мог бы записывать заголовки окон. Если вы воспроизводите проблему и хотите получить более подробную трассировку, запустите бета-версию или сборку-кандидат, сохраните журнал, а затем вернитесь на релизный канал.

Всё ещё нужна помощь?

Если вашей проблемы нет в списке выше, свяжитесь с нами — мы поможем всё наладить.