flatpak - Создание, установка и запуск приложений и сред выполнения
СИНТАКСИС
flatpak [ОПЦИЯ...] {КОМАНДА}
ОПИСАНИЕ
Flatpak — это инструмент для управления приложениями и средами выполнения, которые они используют. В модели Flatpak приложения могут быть созданы и распространены независимо от хост-системы, на которой они используются, и в некоторой степени изолированы от хост-системы («в песочнице») во время выполнения.
Flatpak может работать в системном или пользовательском режиме. Системные данные (среды выполнения, приложения и конфигурация) находятся в $prefix/var/lib/flatpak/, а пользовательские данные — в $HOME/.local/share/flatpak/. Ниже этих расположений находится локальный репозиторий в подкаталоге repo/ и установленные среды выполнения и приложения — в соответствующих подкаталогах runtime/ и app/.
Системные удаленные репозитории могут быть статически предварительно настроены путем размещения файлов flatpakrepo(5) в /usr/share/flatpak/remotes.d/ и /etc/flatpak/remotes.d/. Если файл с одним и тем же именем существует в обоих, файл в /etc имеет приоритет.
В дополнение к системной установке в $prefix/var/lib/flatpak/, которая всегда считается установкой по умолчанию, если не указано иное, дополнительные системные установки могут быть определены с помощью файлов конфигурации в /etc/flatpak/installations.d/, которые должны определять как минимум идентификатор установки и абсолютный путь к ней. Также поддерживаются другие необязательные параметры, такие как DisplayName, Priority или StorageType.
Flatpak использует OSTree для распространения и развертывания данных. Репозитории, которые он использует, являются репозиториями OSTree и могут быть изменены с помощью утилиты ostree. Установленные среды выполнения и приложения являются копиями OSTree.
Основные команды для создания flatpak, такие как build-init, build и build-finish, включены в утилиту flatpak. Для более продвинутой поддержки сборки см. отдельную утилиту flatpak-builder(1).
Flatpak поддерживает установку из сторонних репозиториев. Это частичные копии репозитория (созданные с помощью flatpak create-usb), которые используются в качестве источника установки в автономном режиме (и в онлайн-режиме для повышения производительности). Такие репозитории настраиваются путем создания символических ссылок на источники в подкаталоге sideload-repos каталога установки (т. е. обычно /var/lib/flatpak/sideload-repos или ~/.local/share/flatpak/sideload-repos). Кроме того, символические ссылки могут быть созданы в /run/flatpak/sideload-repos, что является лучшим местом для непостоянных источников (поскольку он очищается при перезагрузке). Эти символические ссылки могут указывать либо на каталог, указанный в flatpak create-usb, который по умолчанию записывает данные в подкаталог .ostree/repo, либо непосредственно на репозиторий ostree.
ОПЦИИ
Следующие глобальные опции поддерживаются. Отдельные команды имеют свои собственные опции.
-h, --help
Показать справку и выйти.
-v, --verbose
Показывать отладочную информацию во время обработки команд. Используйте -vv для большей детализации.
--ostree-verbose
Показывать отладочную информацию OSTree во время обработки команд.
--version
Вывести информацию о версии и выйти.
--default-arch
Вывести архитектуру по умолчанию и выйти.
--supported-arches
Вывести список поддерживаемых архитектур в порядке приоритета и выйти.
--gl-drivers
Вывести список активных драйверов GL и выйти.
--installations
Вывести пути системных установок и выйти.
--print-system-only
При запуске команды `flatpak --print-updated-env` выводить только окружение для системных установок Flatpak, не включая домашнюю установку пользователя.
--print-updated-env
Вывести набор переменных окружения, необходимых для использования Flatpak, изменяя текущий набор переменных окружения. Это предназначено для использования в генераторе окружения systemd и не должно запускаться вручную.
КОМАНДЫ
Команды для управления установленными приложениями и средами выполнения:
flatpak-install(1)
Установить приложение или среду выполнения из удаленного репозитория или пакета.
flatpak-update(1)
Обновить установленное приложение или среду выполнения.
flatpak-uninstall(1)
Удалить установленное приложение или среду выполнения.
flatpak-mask(1)
Отключить обновления и автоматическую установку.
flatpak-pin(1)
Зафиксировать среды выполнения, чтобы предотвратить их автоматическое удаление.
flatpak-list(1)
Вывести список установленных приложений и/или сред выполнения.
flatpak-info(1)
Показать информацию об установленном приложении или среде выполнения.
flatpak-history(1)
Показать историю.
flatpak-config(1)
Управлять конфигурацией Flatpak.
flatpak-repair(1)
Восстановить установку Flatpak.
flatpak-create-usb(1)
Скопировать приложения и/или среды выполнения на съемный носитель.
Команды для поиска приложений и сред выполнения:
flatpak-search(1)
Выполнить поиск приложений и сред выполнения.
Команды для управления запущенными приложениями:
flatpak-run(1)
Запустить приложение.
flatpak-kill(1)
Остановить запущенное приложение.
flatpak-override(1)
Изменить разрешения для приложения.
flatpak-make-current(1)
Указать версию по умолчанию для запуска.
flatpak-enter(1)
Войти в пространство имен запущенного приложения.
Команды для управления доступом к файлам:
flatpak-document-export(1)
Предоставить приложению доступ к определенному файлу.
flatpak-document-unexport(1)
Отменить доступ к определенному файлу.
flatpak-document-info(1)
Показать информацию об определенном файле.
flatpak-documents(1)
Вывести список экспортированных файлов.
Команды для управления динамическим хранилищем разрешений:
flatpak-permission-remove(1)
Удалить элемент из хранилища разрешений.
flatpak-permissions(1)
Вывести список разрешений.
flatpak-permission-show(1)
Показать разрешения приложения.
flatpak-permission-reset(1)
Сбросить разрешения приложения.
flatpak-permission-set(1)
Установить разрешения приложения.
Команды для управления удаленными репозиториями:
flatpak-remotes(1)
Вывести список всех настроенных удаленных репозиториев.
flatpak-remote-add(1)
Добавить новый удаленный репозиторий.
flatpak-remote-modify(1)
Изменить свойства настроенного удаленного репозитория.
flatpak-remote-delete(1)
Удалить настроенный удаленный репозиторий.
flatpak-remote-ls(1)
Отобразить содержимое настроенного удаленного репозитория.
flatpak-remote-info(1)
Показать информацию о ссылке в настроенном удаленном репозитории.
Команды для сборки приложений:
flatpak-build-init(1)
Инициализировать каталог сборки.
flatpak-build(1)
Выполнить команду сборки в каталоге сборки.
flatpak-build-finish(1)
Завершить подготовку каталога сборки для экспорта.
flatpak-build-export(1)
Экспортировать каталог сборки в репозиторий.
flatpak-build-bundle(1)
Создать файл пакета из ссылки в локальном репозитории.
flatpak-build-import-bundle(1)
Импортировать файл пакета в локальный репозиторий.
flatpak-build-sign(1)
Подписать приложение или среду выполнения после его экспорта.
flatpak-build-update-repo(1)
Обновить файл summary в репозитории.
flatpak-build-commit-from(1)
Создать новую фиксацию на основе существующей ссылки.
flatpak-repo(1)
Вывести информацию о репозитории.
Команды, доступные внутри песочницы:
flatpak-spawn(1)
Выполнить команду в другой песочнице.
ФОРМАТЫ ФАЙЛОВ
Форматы файлов, используемые командами Flatpak:
flatpakref(5)
Ссылка на удаленный репозиторий для приложения или среды выполнения.
flatpakrepo(5)
Ссылка на удаленный репозиторий.
flatpak-remote(5)
Конфигурация удаленного репозитория.
flatpak-installation(5)
Конфигурация расположения установки.
flatpak-metadata(5)
Информация о приложении или среде выполнения.
ОКРУЖАЮЩАЯ СРЕДА
Помимо стандартных переменных окружения, таких как XDG_DATA_DIRS и XDG_DATA_HOME, Flatpak использует и некоторые из своих собственных.
FLATPAK_BINARY
Путь к исполняемому файлу flatpak, который будет записан в экспортируемые файлы .desktop и скрипты при установке приложения. По умолчанию — /usr/bin/flatpak, если не переопределено во время сборки с помощью --bindir.
FLATPAK_BWRAP
Путь к исполняемому файлу bwrap(1), который будет использоваться для создания песочницы. В зависимости от того, как Flatpak был настроен во время сборки, по умолчанию либо выполняется поиск в PATH, либо используется предоставленная копия, которая обычно устанавливается как /usr/libexec/flatpak-bwrap.
FLATPAK_CONFIG_DIR
Расположение конфигурации Flatpak для всей системы. Если это не задано, используется /etc/flatpak (если не переопределено во время сборки с помощью --sysconfdir).
FLATPAK_DATA_DIR
Расположение системных значений по умолчанию и интеграционных хуков Flatpak. Если это не задано, используется /usr/share/flatpak, если не переопределено во время сборки с помощью --datadir.
FLATPAK_DBUSPROXY
Путь к исполняемому файлу xdg-dbus-proxy(1), который будет использоваться для фильтрации трафика D-Bus между песочницей и хост-системой. В зависимости от того, как Flatpak был настроен во время сборки, по умолчанию либо выполняется поиск в PATH, либо используется предоставленная копия, которая обычно устанавливается как /usr/libexec/flatpak-dbus-proxy.
FLATPAK_DOWNLOAD_TMPDIR
Путь к каталогу, который будет использоваться временно при загрузке слоев OCI и, возможно, для других загрузок в будущем. Стандартный TMPDIR для этого не используется, потому что приложения Flatpak обычно слишком велики, чтобы поместиться в tmpfs.
FLATPAK_FANCY_OUTPUT
Может быть установлено в 0, чтобы отключить расширенное форматирование при выводе в терминал. Эта функция также автоматически отключается, если стандартный вывод не является терминалом или если G_MESSAGES_DEBUG установлен.
FLATPAK_FORCE_TEXT_AUTH
Может быть установлено в 1, чтобы принудительно использовать простой встроенный агент polkit(8) при запросе аутентификации для изменения системной установки. По умолчанию используется агент polkit среды рабочего стола, если он доступен, что обычно приводит к графическому запросу.
FLATPAK_GL_DRIVERS
Список расширений графических драйверов, разделенных двоеточием, которые следует использовать для OpenGL, Vulkan и аналогичных API, начиная с наиболее предпочтительного. По умолчанию графический драйвер выбирается автоматически. Значения в этом списке соответствуют последней точке, разделяющей компоненты имен расширений с условием active-gl-driver. Типичные значения: default, mesa-git или nvidia-550-120 (замените номер версии на основную и дополнительную версии модуля ядра nvidia).
FLATPAK_RUN_DIR
Расположение глобальных файлов среды выполнения Flatpak. Если это не задано, используется /run/flatpak.
FLATPAK_SYSTEM_CACHE_DIR
Расположение, в котором будут создаваться временные дочерние репозитории при извлечении в системную установку. Если это не задано, используется каталог в /var/tmp/. Это полезно, поскольку это с большей вероятностью будет находиться в той же файловой системе, что и системный репозиторий (что увеличивает вероятность, например, копирования с помощью reflink), и мы можем избежать заполнения домашнего каталога пользователя временными данными.
FLATPAK_SYSTEM_DIR
Расположение каталога для системной установки по умолчанию. Если это не задано, используется /var/lib/flatpak (если не переопределено во время сборки с помощью --localstatedir или -Dsystem_install_dir).
FLATPAK_TTY_PROGRESS
Может быть установлено в 1, чтобы включить отправку машиночитаемой информации о ходе выполнения в терминал. В настоящее время эта функция не включена по умолчанию, поскольку она использует последовательность OSC 9;4, которую некоторые эмуляторы терминалов интерпретируют как всплывающее уведомление.
FLATPAK_USER_DIR
Расположение установки для каждого пользователя. Если это не задано, используется $XDG_DATA_HOME/flatpak.
ССЫЛКИ
ostree(1), ostree.repo(5), flatpak-remote(5), flatpak-installation(5), https://www.flatpak.org