appstreamcli-compose - справочное руководство, опции, примеры команд


ИМЯ

appstreamcli-compose - Составление каталога метаданных AppStream из деревьев каталогов.

СИНТАКСИС

appstreamcli compose [COMMAND]

ОПИСАНИЕ

На этой странице руководства кратко описана команда appstreamcli compose.

Инструмент appstreamcli compose используется для создания каталогов метаданных AppStream из деревьев каталогов. Инструмент также будет выполнять множество связанных действий по созданию метаданных, таких как изменение размера значков и снимков экрана и объединение данных из указанных файлов записей на рабочем столе, а также информации о статусе перевода. Таким образом, инструмент предоставляет быстрый способ проверить, как могут выглядеть окончательно обработанные метаданные для приложения, отправляемого пользователям. Он также позволяет легко генерировать данные AppStream для проектов, которым не нужен более сложный генератор данных, такой как appstream-generator.

Чтобы команда appstreamcli compose была доступна, вам может потребоваться сначала установить необязательный модуль compose для appstreamcli.

Дополнительные сведения о проекте AppStream и других его компонентах см. на страницах AppStream по адресу Freedesktop.org[1].

ПАРАМЕТРЫ

ИСТОЧНИКИ

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

--origin NAME

Установите идентификатор источника данных AppStream. Это может быть значение вроде «debian-unstable-main» или «flathub».

--result-root DIR

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

Если заданы оба --data-dir и --icons-dir, --result-root не нужен, и никакие данные не будут записывается в этот каталог.

--data-dir DIR

Переопределите каталог, в который будет записан сгенерированный каталог метаданных AppStream. Данные будут записываться непосредственно в этот каталог, а вспомогательные каталоги создаваться не будут (в отличие от использования --result-root для установки выходного местоположения).

--icons-dir DIR

Переопределить каталог, в который экспортируются кэшированные значки.

--hints-dir DIR

Установите каталог, в котором сохраняются подсказки, созданные во время обработки метаданных. Если этот параметр не установлен, отчеты-подсказки HTML/YAML сохраняться не будут.

--media-dir DIR

Если установлено, создает каталог с медиа-контентом (иконки, снимки экрана и т. д.), который можно обслуживать через веб-сервер. Метаданные будут расширены за счет включения информации об этих удаленных носителях.

--media-baseurl URL

URL-адрес, по которому будет обслуживаться содержимое каталога, заданного с помощью --media-dir. Это значение должно быть установлено, если создается каталог мультимедиа.

--prefix DIR

Установите префикс по умолчанию, который используется в обрабатываемых каталогах. Если ни один из них не задан явно, предполагается /usr.

--print-report MODE

Распечатайте отчет с подсказками о проблемах (который экспортируется как документ HTML и YAML, если был установлен --hints-dir) на консоль в текстовом виде.

Поддерживаются различные режимы печати: on-error печатает краткий отчет только в случае сбоя запуска (по умолчанию), short создает сокращенный отчет, который всегда печатается и полный приводит к печати подробного отчета.

--components COMPONENT-IDs

Задайте разделенный запятыми список идентификаторов компонентов AppStream, которые следует учитывать при создании метаданных. Все компоненты, существующие во входных данных, но не упомянутые в этом списке, будут игнорироваться для генерируемого вывода.

--no-color

Не печатать цветной отпечаток.

--verbose

Показать дополнительную отладочную информацию

--version

Показать номер версии appstreamcli compose

СМОТРИТЕ ТАКЖЕ

appstreamcli(1), appstream-generator(1).

АВТОР

Эта страница руководства была написана Matthias Klumpp matthias@tenstral.net.

АВТОРСКИЕ ПРАВА

Copyright © 2020-2022 Матиас Клумпп

ПРИМЕЧАНИЯ

1. Freedesktop.org: https://www.freedesktop.org/wiki/Distributions/AppStream/