appstreamcli-compose - Componha o catálogo de metadados do AppStream a partir de árvores de diretório
appstreamcli compose [COMMAND]
Esta página de manual documenta brevemente o comando appstreamcli compose.
A ferramenta appstreamcli compose é usada para construir catálogos de metadados AppStream a partir de árvores de diretório. A ferramenta também executará muitas ações de geração de metadados relacionadas, como redimensionar ícones e capturas de tela e mesclar dados de arquivos de entrada de área de trabalho referenciados, bem como informações de status de tradução. Portanto, a ferramenta fornece uma maneira rápida de testar a aparência dos metadados processados finais de um aplicativo enviado aos usuários. Ele também fornece uma maneira de gerar facilmente dados AppStream para projetos que não precisam de um gerador de dados mais complexo como appstream-generator.
Para que o comando appstreamcli compose esteja disponível, pode ser necessário instalar primeiro o módulo de composição opcional para appstreamcli.
Para mais informações sobre o projeto AppStream e os outros componentes que fazem parte dele, dê uma olhada nas páginas do AppStream em Freedesktop.org[1].
DIRETÓRIOS DE FONTE
Uma lista de diretórios para processar precisa ser fornecida como parâmetros posicionais. Os dados de todos os diretórios serão combinados em um namespace de saída.
Defina o identificador de origem de dados do AppStream. Pode ser um valor como "debian-unstable-main" ou "flathub".
Define o diretório para o qual todas as saídas geradas implantadas na máquina de um usuário são exportadas. Se este parâmetro não estiver definido e tivermos apenas um diretório para processar, usaremos esse diretório como caminho de saída padrão.
Se --data-dir e --icons-dir estiverem definidos, --result-root não será necessário e nenhum dado será escrito nesse diretório.
Substitua o diretório no qual o catálogo de metadados do AppStream gerado será gravado. Os dados serão gravados diretamente neste diretório e nenhum subdiretório será criado (ao contrário do uso de --result-root para definir um local de saída).
Substitua o diretório para o qual os ícones armazenados em cache são exportados.
Defina um diretório onde as dicas relatadas geradas durante o processamento de metadados são salvas. Se esse parâmetro não for definido, nenhum relatório de dica HTML/YAML será salvo.
Se definido, cria um diretório com conteúdo de mídia (ícones, capturas de tela, ...) que pode ser servido por meio de um servidor da web. Os metadados serão estendidos para incluir informações sobre essas mídias remotas.
A URL sob a qual o conteúdo de um diretório definido por meio de --media-dir será exibido. Esse valor deve ser definido se um diretório de mídia for criado.
Defina o prefixo padrão usado nos diretórios processados. Se nenhum for definido explicitamente, /usr será assumido.
Imprima o relatório de dicas de problemas (que é exportado como documento HTML e YAML quando --hints-dir foi definido) no console em formato de texto.
Vários modos de impressão são suportados: on-error apenas imprime um relatório curto se a execução falhou (padrão), short gera um relatório resumido que é sempre impresso e completo resulta em um relatório detalhado a ser impresso.
Defina uma lista separada por vírgulas de IDs de componentes do AppStream que devem ser considerados para os metadados gerados. Todos os componentes que existem nos dados de entrada, mas não são mencionados nesta lista, serão ignorados para a saída gerada.
Não imprima saída colorida.
Exibir informações extras de depuração
Exibir o número da versão do appstreamcli compose
appstreamcli(1), appstream-generator(1).
Esta página de manual foi escrita por Matthias Klumpp matthias@tenstral.net.
Copyright © 2020-2022 Matthias Klumpp
1. Freedesktop.org: https://www.freedesktop.org/wiki/Distributions/AppStream/