Агизм

Агизм¹ — программный интерфейс для Гномьего менеджера источников ввода². Агизм позволяет приложениям (например, переключателям клавиатурных раскладок или индикаторам текущей раскладки) получать список доступных источников ввода,³ активировать и моноторить их. Есть готовые пакет расширения⁴ и РПМ-пакеты для нескольких версий Федоры, Магеи, ОткрытойМандривы, открытойСуси, свежих версий Красной Шапки и её клонов. Кроме того, можно собрать Агизм из исходников, что должно работать для любого дистрибутива ГНУ/Линукса, включая Арч, Дебиан и Убунту⁵. Агизм — свободная (и бесплатная‌) программа.

Зачем?

Чтобы Таппер 0.6.0 (и последующие версии) мог работать в Гноме.

Таппер 0.5.0 использует метод Eval Гномьего шелла чтобы получить список источников ввода или активировать один из них. Этот метод позволяет исполнить произвольный код в контексте Гномьего шелла. Начиная с Гнома 41, этот метод признан небезопасным и удалён (точнее, метод присутствует, его можно вызвать, но он ничего не делает), поэтому Таппер 0.5.0 не может управлять источниками ввода в Гноме 41 (и последующих версиях).

Однако, расширения Гномьего шелла не являются отдельными приложениями — они работают в контексте Гномьего шелла, поэтому:

расширения имеют полный доступ ко всем внутренностям Гномьего шелла (включая источники ввода), и
расширения могут иметь интерфейс, доступный внешним приложениям.

Итого, стороннее приложение сможет управлять источниками ввода, если какое-либо расширение Гномьего шелла будет делать это по запросу приложения.

Агизм и есть такое расширение. Агизм предоставляет программный интерфейс на основе Д-Шины⁶ для получения списка источников ввода, активации и наблюдения⁷ за источниками. Агизм — агент Таппера в Гномьем шелле, который позволяет Тапперу 0.6.0 (и последующих) работать в Гноме.

Агизм был создан специально для нужд Таппера, но его может использовать любая программа, включая шелльные скрипты. Интерфейс Агизма описан в справочной странице agism(7).

Кстати, при установленном и включенном Агизме при вводе пароля для разблокировки экрана у вас будет автоматически включаться английская раскладка.⁸

Текущая версия

Текущая версия — 3-0.vdb.1, выпущена 2023-04-28. Смотрите список изменений, видимых пользователю, в NEWS.md.

Установка

Установка готового РПМ пакета

Это самый легкий способ получить Агизм. При установке из РПМ пакета Агизм устанавливается как системное расширение, доступное всем пользователям системы; он может быть обновлён и удалён штатным менеджером пакетов.

Федора

$ sudo dnf copr enable vandebugger/tapper
$ sudo dnf install gnome-shell-extension-agism

Магея

$ su -c "dnf copr enable vandebugger/tapper"
$ su -c "dnf install gnome-shell-extension-agism"

ОткрытаяМандрива

Замените $VER на версию вашей системы, например, cooker или rolling:

$ sudo wget -O /etc/yum.repos.d/vandebugger-tapper.repo https://copr.fedorainfracloud.org/coprs/vandebugger/tapper/repo/openmandriva-$VER
$ sudo dnf install gnome-shell-extension-agism

открытаяСуся

Замените $VER на версию вашей системы, например, leap-15.3, leap-15.4 или tumbleweed:

$ sudo zypper addrepo https://copr.fedorainfracloud.org/coprs/vandebugger/tapper/repo/opensuse-$VER/vandebugger-tapper-opensuse-$VER.repo
$ sudo zypper install gnome-shell-extension-agism

Установка готового пакета расширения

Если установка готового РПМ пакета по каким-либо причинам невозможна или нежелательна или для вашей системы нет готового РПМ пакета, вы можете поставить готовый пакет расширения. Пакет расширения — это независимый от дистрибутива зип-архив с файлами расширения. Пакет расширения устанавливается как пользовательское расширение, доступное только пользователю, установившему его. Скачать и установить готовый пакет расширения можно одной командой:

$ gnome-extensions install --force https://sourceforge.net/projects/agism/files/3/agism@agism.sourceforge.io.shell-extension.zip

Опция --force может быть опущена, если вы устанавливаете пакет расширения впервые. Попытка переписать уже установленное расширение (например, чтобы обновить его) будет проваливаться без опции --force.

Бывает, что gnome-extension не может скачать Агизм. В таком случае используйте другой инструмент для скачивания, а затем устанавливайте уже скачанный пакет, например:

$ wget https://sourceforge.net/projects/agism/files/3/agism@agism.sourceforge.io.shell-extension.zip
$ gnome-extensions install --force agism@agism.sourceforge.io.shell-extension.zip

Обратите внимание: Пакет расширения не устанавливает справочную страницу Агизма.

Построение и установка из исходников

Если по каким-либо причинам установка готового РПМ пакета или готового расширения невозможна или нежелательна, вы можете построить Агизм из исходников и установить его как системное или пользовательское расширение. Смотрите иструкции в INSTALL.md.

Включение

Чтобы Гномий шелл увидел установленное расширение, шелл надо перезапустить. Если вы работаете в Иксах, то нажмите Alt+F2, в появившемся диалоге «Выполнить команду» (англ. Run a Command) введите r и нажмите Enter. В случае Вайланда вам придётся завершить сессию и начать новую.

Установленный Агизм доступен для пользователей (или пользователя, в зависимости от типа установки: системное расширение видимо всем, пользовательское — только установившему его пользователю), но не активен. Чтобы активировать Агизм, включите его:

$ gnome-extensions enable agism@agism.sourceforge.io

Это нужно сделать только один раз — однажды включенное расширение автоматически запускается при каждом входе до его выключения или удаления.

То же самое можно сделать в графическом виде при помощи приложения «Расширения» (англ. Extensions).

Обратите внимание: Старые версии программы gnome-extensions (например, 3.36.9 в Убунте 20.04.1) могут обламываться молча, не выводя никаких сообщений об ошибках! Хорошей идеей будет убедиться что Агизм действительно включен:

$ gnome-extensions show agism@agism.sourceforge.io
Имя: Agism
...
Версия: 3
Состояние: ENABLED

Обратите внимание на последнюю строку вывода: она должна заканчиваться словом «ENABLED», как показано выше.

Ошибки и проблемы

Смотрите BUGS.md.

Копирайт и лицензия

Примечания

Агизм — калька с английского названия Agism, которое образовано из API for GNOME Input Source Manager.↩︎
Менеждер источников ввода (англ. input source manager) — часть Гнома, ответственная за источники ввода, в частности, за их активацию.↩︎
Источник ввода (англ. input source) — гномий термин для раскладки клавиатуры.↩︎
Пакет расширения — калька с английского extension pack. Гномий пакет расширения — это независимый от дистрибутива зип-архив с файлами расширения.↩︎
В графической сессии Убунты переменная окружения XDG_SESSION_DESKTOP имеет значение "ubuntu". Однако, рабочий стол Убунты в реальности является Гномьим шеллом с парой убунтовых расширений.↩︎
Д-Шина (англ. D-Bus) — система межпроцессного взаимодействия, которая позволяет приложениям общаться друг с другом.↩︎
Наблюдающее приложение получает извещения каждый раз, как пользователь переключает раскладки клавиатуры, а так же при изменении списка доступных источников, т. е. если пользователь через приложение «Параметры» (англ. Settings, команда gnome-control-center) добавляет или удаляет источники ввода или меняет их порядок.↩︎
Точнее не английская раскладка, а первая (которая обычно является английской). Это приятный побочный эффект Агизма: Гномий шелл при блокировке экрана выключает все расширения, а Агизм при выключении активирует первую раскладку.↩︎