Запуск и отладка приложений GTK

Эта переменная может быть установлена в список опций отладки, которые заставляют GTK выводить различные типы отладочной информации. Некоторые из этих опций доступны только тогда, когда GTK был сконфигурирован с -Ddebug=true.

Ряд ключей влияют на поведение, а не только на протоколирование:

Специальное значение all может быть использовано для включения всех опций отладки. Специальное значение help может быть использовано для получения списка всех поддерживаемых опций отладки.

Указывает список каталогов для поиска, когда GTK ищет динамически загружаемые объекты, такие как модули методов ввода и бэкэнды печати. Если путь к динамически загружаемому объекту указан как абсолютный путь, GTK загружает его напрямую. В противном случае GTK по очереди проходит через каталоги в GTK_PATH, затем каталог .gtk-4.0 в домашнем каталоге пользователя, затем системный каталог по умолчанию, который является libdir/gtk-4.0/modules. (Если GTK_EXE_PREFIX определён, libdir равен $GTK_EXE_PREFIX/lib. В противном случае это libdir, указанный при конфигурации GTK, обычно /usr/lib, или /usr/local/lib. )

Для каждого каталога в этом списке GTK фактически ищет подкаталог directory/version/host/type. Где version происходит от версии GTK (используйте pkg-config --variable=gtk_binary_version gtk4 для определения этого из скрипта), host — архитектура, на которой был построен GTK (используйте pkg-config --variable=gtk_host gtk4 для определения этого из скрипта), а type — каталог, специфичный для типа модулей; в настоящее время он может быть modules, immodules или printbackends, соответствующие типам модулей, упомянутым выше. version, host, или оба могут быть опущены. GTK сначала ищет в самом специфичном каталоге, а затем в каталогах с меньшим количеством компонентов. Компоненты GTK_PATH разделены символом “:” в Linux и Unix, и символом “;” в Windows.

Обратите внимание, что эта переменная среды читается как GTK 2.x, так и GTK 3.x, что делает её непригодной для системной (или сессионной) установки, так как это приведёт к тому, что приложения, использующие разные версии GTK, будут видеть несовместимые модули.

Указывает модуль метода ввода для использования вместо того, который определяется по локали. Если это не установлено, и вы работаете на системе, которая поддерживает XSETTINGS и имеет значение в Gtk/IMModule, это значение будет использоваться для модуля метода ввода по умолчанию. Это также может быть список методов ввода, разделённых двоеточием, которые GTK будет пробовать по очереди, пока не найдёт доступный в системе.

Указывает, какой бэкэнд загрузить для GtkMediaFile. Возможные значения зависят от того, с какими опциями был собран GTK, и могут включать “gstreamer”, “ffmpeg” и “none”. Если установлено “none”, воспроизведение мультимедиа будет недоступно. Специальное значение “help” может быть использовано для получения списка всех поддерживаемых бэкэндов мультимедиа.

Если установлено, GTK использует $GTK_EXE_PREFIX/lib вместо libdir, сконфигурированного при компиляции GTK.

Если установлено, GTK использует $GTK_DATA_PREFIX вместо префикса, сконфигурированного при компиляции GTK.

Если установлено, заставляет GTK использовать указанную тему вместо темы, заданной параметром gtk-theme-name. Это в основном предназначено для удобной отладки проблем с темой.

Также возможно указать вариант темы для загрузки, добавив имя варианта с двоеточием, например: GTK_THEME=Adwaita:dark.

Следующие переменные среды используются GdkPixbuf, GDK или Pango, а не самим GTK, но мы всё же перечисляем их для полноты.

Указывает файл, содержащий список модулей загрузчика GdkPixbuf, которые нужно загрузить. Эта переменная среды переопределяет значение по умолчанию libdir/gtk-4.0/4.0.0/loaders.cache (libdir — sysconfdir, указанный при конфигурации GTK, обычно /usr/lib.)

Файл loaders.cache генерируется утилитой gdk-pixbuf-query-loaders.

Эта переменная может быть установлена в список опций отладки, которые заставляют GDK выводить различные типы отладочной информации. Некоторые из этих опций доступны только тогда, когда GTK был сконфигурирован с -Ddebug=true.

Ряд опций влияют на поведение, а не только на протоколирование:

Специальное значение all может быть использовано для включения всех опций отладки. Специальное значение help может быть использовано для получения списка всех поддерживаемых опций отладки.

Эта переменная может быть установлена в список параметров отладки, которые заставляют GSK выводить различную информацию об отладке. Некоторые из этих параметров доступны только при конфигурации GTK с -Ddebug=true.

Ряд параметров влияют на поведение, а не на протоколирование:

Специальное значение all может быть использовано для включения всех параметров отладки. Специальное значение help может быть использовано для получения списка всех поддерживаемых параметров отладки.

При установке выбирает используемый GDK-бэкенд. Выбор бэкенда требует, чтобы GTK был скомпилирован с поддержкой этого бэкенда. Следующие бэкенды могут быть выбраны, при условии, что они включены в используемые GDK-библиотеки:

Эта переменная окружения может содержать список имён бэкэндов, разделённых запятыми, которые будут перепробованы в указанном порядке. Список также может содержать *, что означает: попробовать все оставшиеся бэкэнды. Специальное значение help может быть использовано для вывода списка всех доступных бэкэндов. Более подробную информацию о выборе бэкэндов см. в функции gdk_display_manager_get().

Эта переменная может быть установлена в индекс Vulkan-устройства, чтобы переопределить выбор по умолчанию устройства, используемого для Vulkan-рендеринга. Специальное значение list может быть использовано для получения списка всех Vulkan-устройств.

При установке выбирает используемый GSK-рендерер. Следующие рендеры могут быть выбраны, при условии, что они включены в используемую GTK-библиотеку и GDK-бэкенд их поддерживает:

Значение этой переменной окружения по умолчанию равно 1. Если изменить на 0, это отключит стандартное использование декорирования на стороне клиента для GTK-окон, тем самым возложив на диспетчер окон ответственность за рисование декорейций для окон, у которых нет настраиваемого виджета панели заголовков.

CSD всегда используется для окон с настраиваемым виджетом панели заголовков, так как диспетчер окон не должен рисовать другую панель заголовков или другие декорации вокруг настраиваемой.

При установке выбирает используемый бэкенд для доступности. Следующие бэкэнды могут быть выбраны, при условии, что они включены в используемую GTK-библиотеку:

Бэкенд доступности test рекомендуется для наборов тестов и удалённых конвейеров непрерывной интеграции.

GTK использует эти переменные окружения для поиска тем иконок и информации MIME. Более подробную информацию см. в Спецификации темы иконок, Базе данных общих MIME-информаций и Спецификации базовых директорий.

GTK использует эту переменную окружения для предоставления уведомлений о запуске в соответствии со Спецификацией уведомлений о запуске. Согласно спецификации, GTK сбрасывает значение этой переменной после её прочтения (чтобы предотвратить её утечку в дочерние процессы). Таким образом, если вам нужно её значение для своих собственных целей, необходимо прочитать его до вызова gtk_init().