appstreamcli - Обрабатывать форматы метаданных AppStream и запрашивать данные AppStream.
appstreamcli [COMMAND]
На этой странице руководства кратко описана команда appstreamcli.
appstreamcli – это небольшой вспомогательный инструмент для работы с метаданными AppStream и доступа к индексу компонента AppStream из командной строки. Указатель компонентов AppStream содержит список всех доступных программных компонентов для вашего дистрибутива, соответствующих именам их пакетов. Он создается с использованием данных AppStream XML или Debian DEP-11, которые предоставляются вашим дистрибьютором.
Дополнительные сведения о проекте AppStream и других его компонентах см. на страницах AppStream по адресу Freedesktop.org[1].
get ID
Получить компонент из пула метаданных по его идентификатору.
Найдите в пуле компонентов AppStream заданный поисковый запрос.
Возврат компонентов, которые предоставляют данный элемент. Тип элемента можно указать с помощью параметра TYPE, значение для поиска необходимо указать с помощью параметра TERM.
Примеры:
Получите компоненты, которые обрабатывают медиатип text/xml.
appstreamcli what-provides mediatype "text/xml"
Получить компонент, который предоставляет библиотеку "libfoo.so.2".
appstreamcli what-provides lib libfoo.so.2
Запустите обновление базы данных, если это необходимо. Если вы хотите принудительно перестроить базу данных, укажите флаг --force.
Эта команда должна выполняться с правами root.
Отображение различной информации об установленных метаданных и кэше метаданных.
Показать информацию о текущей операционной системе из индекса метаданных. Это требует, чтобы операционная система предоставила себе компонент операционной системы.
Сделайте дамп полных XML-описаний компонентов с заданным идентификатором, которые были найдены в пуле метаданных.
Проверьте метаданные AppStream XML на соответствие спецификации.
Обрабатываются оба типа метаданных XML, upstream и distro XML. Тип формата, который необходимо проверить, определяется автоматически.
Флаг --pedantic запускает более педантичную проверку файла, включая незначительные проблемы и проблемы со стилем в отчете.
Проверка метаданных AppStream XML, найденных в дереве файлов.
Это выполняет стандартную проверку всех найденных метаданных, а также проверяет наличие дополнительных ошибок, таких как наличие файлов .desktop и достоверность других дополнительных метаданных.
Проверьте строку лицензии или выражение лицензии на действительность и отобразите сведения о ней.
Это проверит, считается ли строка лицензии действительной для AppStream, и вернет ненулевой код выхода, если это не так. Команда также отобразит полезную информацию, такую как канонический идентификатор лицензии, подходит ли она в качестве лицензии для метаданных AppStream и считается ли лицензия для бесплатного программного обеспечения с открытым исходным кодом или проприетарного программного обеспечения.
AppStream будет рассматривать любую лицензию как бесплатную и с открытым исходным кодом, которая помечена как подходящая либо Фондом свободного программного обеспечения (FSF), Инициативой открытого исходного кода (OSI), либо явным списком лицензий Руководства по свободному программному обеспечению Debian (DFSG).
Установите программный компонент по его ID с помощью менеджера пакетов или Flatpak.
Это преобразует идентификатор компонента AppStream в кандидата на установку, а затем вызывает собственный диспетчер пакетов или Flatpak (если доступен) для установки компонента.
Удалите программный компонент по его идентификатору с помощью менеджера пакетов или Flatpak.
Это приведет к удалению программного обеспечения, соответствующего выбранному идентификатору, с помощью собственного диспетчера пакетов или Flatpak (если доступно).
Установите файл метаданных в правильный каталог на текущем компьютере.
Сравните два номера версии. Если в качестве параметров заданы два номера версии, версии будут сравниваться, и результат сравнения будет выведен на стандартный вывод.
Если номер версии, оператор сравнения и другой номер версии передаются в качестве параметра, результат операции сравнения будет напечатан на стандартный вывод, а appstreamcli завершится с ненулевым статусом выхода в случае сравнение не удалось. Оператор сравнения может быть одним из следующих:
Равно
Не равно
Меньше, чем
Больше чем
Меньше или равно
Больше или равно
Создайте шаблон файла метаинформации, который будет использоваться программными проектами. Параметр --from-desktop позволяет использовать файл .desktop в качестве шаблона для создания файла примера.
Сгенерированные файлы содержат примеры записей, которые необходимо заполнить автором проекта с фактическими требуемыми значениями.
Первый параметр TYPE — это имя типа компонента AppStream. Полный список см. в документации[2] или в справке appstreamcli для этой подкоманды.
Создайте файл входа рабочего стола XDG из файла метаинформации. Если файл записи рабочего стола, указанный в DESKTOP_FILE, уже существует, он будет расширен новой информацией, извлеченной из файла метаинформации. В противном случае будет создан новый файл.
Эта команда будет использовать первый двоичный файл, упомянутый в теге обеспечить компонента для поля Exec= нового файла записи рабочего стола. Если это нежелательное поведение, можно использовать флаг --exec для явного определения запускаемого двоичного файла. Другие способы запуска приложения в настоящее время не поддерживаются.
Чтобы сгенерировать правильную запись на рабочем столе, эта команда предполагает, что установлены не только минимально необходимые теги для компонента AppStream, но и что у него есть тег
Эта команда преобразует файл NEWS, который используется во многих проектах с открытым исходным кодом, в XML, используемый AppStream. Поскольку файлы NEWS представляют собой свободный текст, для получения приемлемых результатов будет применяться множество эвристик. Преобразователь также может считывать YAML-версию описания выпуска AppStream и также преобразовывать ее в XML. Если метаинформационный файл MI_FILE уже существует, он будет дополнен новыми записями о выпуске, в противном случае записи о выпуске будут записаны без какого-либо компонента-обертки. Если указан [OUT_FILE], вместо действия с MI_FILE измененные данные будут записаны в конкретный файл. Если для любого из имен выходных файлов установлено значение «-», вместо этого выходные данные будут записаны в стандартный вывод.
Опцию --format можно использовать для принудительного чтения входного файла в определенном формате ("текст" или "yaml") в случае сбоя автоматического определения формата. Параметр --limit используется для ограничения количества записываемых записей о выпуске (самые новые записи всегда будут первыми).
Эта команда отменяет команду news-to-metainfo и записывает файл NEWS в виде текста или YAML, используя XML, содержащийся в файле метаинформации. Если для параметра NEWS_FILE задано значение "-", результирующие данные будут записываться в стандартный вывод, а не в файл.
Опцию --format можно использовать для явного указания выходного формата ("yaml" или "text"). Если он не установлен, appstreamcli угадывает, какой формат наиболее подходит.
Преобразует метаданные AppStream XML в его представление YAML и наоборот.
Создает каталог метаданных AppStream из дерева каталогов с файлами метаинформации. Эта команда доступна, только если установлен компонент org.freedesktop.appstream.compose. Дополнительные сведения см. в разделе appstreamcli-compose(1).
Распечатайте дополнительную информацию о найденном компоненте.
Не печатать цветной отпечаток.
Не подключайтесь к сети при проверке метаданных.
Того же эффекта можно добиться, установив переменную среды AS_VALIDATE_NONET перед запуском appstreamcli.
Показать номер версии appstreamcli
pkcon(1).
Эта страница руководства была написана Matthias Klumpp matthias@tenstral.net.
Copyright © 2012-2022 Матиас Клумпп
1. Freedesktop.org: https://www.freedesktop.org/wiki/Distributions/AppStream/
2. Документация: https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html.