appstreamcli - Lidar com formatos de metadados do AppStream e consultar dados do AppStream
appstreamcli [COMMAND]
Esta página de manual documenta brevemente o comando appstreamcli.
appstreamcli é uma pequena ferramenta auxiliar para trabalhar com metadados do AppStream e acessar o índice do componente AppStream na linha de comando. O índice de componentes do AppStream contém uma lista de todos os componentes de software disponíveis para sua distribuição, correspondentes aos nomes dos pacotes. Ele é gerado usando dados AppStream XML ou Debian DEP-11, que são fornecidos pelo seu distribuidor.
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].
get ID
Obtenha um componente do pool de metadados por seu identificador.
Pesquise o pool de componentes do AppStream para um determinado termo de pesquisa.
Componentes de retorno que fornecem um determinado item. Um tipo de item pode ser especificado usando o parâmetro TYPE, um valor a ser pesquisado deve ser fornecido usando o parâmetro TERM.
Exemplos:
Obtenha componentes que lidam com o tipo de mídia "text/xml".
appstreamcli what-provides mediatype "text/xml"
Obtenha o componente que fornece a biblioteca "libfoo.so.2".
appstreamcli what-provides lib libfoo.so.2
Acione uma atualização do banco de dados, se necessário. Caso você queira forçar a reconstrução do banco de dados, forneça o sinalizador --force.
Este comando deve ser executado com permissão de root.
Exiba várias informações sobre os metadados instalados e o cache de metadados.
Mostra informações sobre o sistema operacional atual do índice de metadados. Isso requer que o sistema operacional forneça um componente do sistema operacional para si mesmo.
Despeje as descrições XML completas dos componentes com o ID fornecido que foram encontrados no pool de metadados.
Valide os metadados XML do AppStream para conformidade com a especificação.
Ambos os tipos de metadados XML, upstream e distro XML, são tratados. O tipo de formato que deve ser validado é determinado automaticamente.
O sinalizador --pedantic aciona uma validação mais pedante do arquivo, incluindo problemas menores e de estilo no relatório.
Valide os metadados XML do AppStream encontrados em uma árvore de arquivos.
Isso executa uma validação padrão de todos os metadados encontrados, mas também verifica erros adicionais, como a presença de arquivos .desktop e a validade de outros metadados adicionais.
Teste uma sequência de licença ou expressão de licença quanto à validade e exiba detalhes sobre ela.
Isso verificará se a string de licença é considerada válida para AppStream e retornará um código de saída diferente de zero se não for. O comando também exibirá informações úteis, como o ID canônico de uma licença, se ela é adequada como licença para metadados do AppStream e se a licença é considerada para software gratuito e de código aberto ou software proprietário.
A AppStream considerará qualquer licença como Livre e de código aberto marcada como adequada pela Free Software Foundation (FSF), Open Source Initiative (OSI) ou lista de licenças explícitas das Debian Free Software Guidelines (DFSG).
Instale um componente de software por seu ID usando o gerenciador de pacotes ou Flatpak.
Isso resolve o ID do componente AppStream para um candidato à instalação e, em seguida, chama o gerenciador de pacotes nativo ou o Flatpak (se disponível) para instalar o componente.
Desinstale um componente de software por seu ID usando o gerenciador de pacotes ou Flatpak.
Isso desinstalará o software correspondente ao ID selecionado usando o gerenciador de pacotes nativo ou Flatpak (se disponível).
Instale um arquivo de metadados no diretório correto da máquina atual.
Compare dois números de versão. Se dois números de versão forem fornecidos como parâmetros, as versões serão comparadas e o resultado da comparação será impresso em stdout.
Se um número de versão, um operador de comparação e outro número de versão forem passados como parâmetro, o resultado da operação de comparação será impresso em stdout e appstreamcli sairá com um status de saída diferente de zero no caso a comparação falhou. O operador de comparação pode ser um dos seguintes:
Igual a
Não igual a
Menor que
Maior que
Menos que ou igual a
Melhor que ou igual a
Crie um modelo de arquivo metainfo para ser usado por projetos de software. A opção --from-desktop pode ser usada para usar um arquivo .desktop como modelo para gerar o arquivo de exemplo.
Os arquivos gerados contêm entradas de exemplo que precisam ser preenchidas com os valores reais desejados pelo autor do projeto.
O primeiro parâmetro TYPE é o nome de um tipo de componente AppStream. Para obter uma lista completa, verifique a documentação[2] ou a saída de ajuda de appstreamcli para este subcomando.
Crie um arquivo de entrada de área de trabalho XDG a partir de um arquivo metainfo. Se o arquivo de entrada da área de trabalho especificado em DESKTOP_FILE já existir, ele será estendido com as novas informações extraídas do arquivo metainfo. Caso contrário, um novo arquivo será criado.
Este comando usará o primeiro binário mencionado em uma tag de fornecimento do componente para o campo Exec= do novo arquivo de entrada da área de trabalho. Se este não for o comportamento desejado, o sinalizador --exec pode ser usado para definir explicitamente um binário a ser iniciado. Outros métodos de inicialização do aplicativo não são suportados no momento.
Para gerar uma entrada de área de trabalho adequada, esse comando pressupõe que não apenas as tags minimamente necessárias para um componente AppStream estejam definidas, mas também que ele tenha uma tag
Este comando converte um arquivo NEWS usado por muitos projetos de código aberto no XML usado pelo AppStream. Como os arquivos NEWS são de texto livre, muitas heurísticas serão aplicadas para obter resultados razoáveis. O conversor também pode ler uma versão YAML da descrição da versão do AppStream e convertê-la em XML. Se o arquivo metainfo MI_FILE já existir, ele será aumentado com as novas entradas de liberação, caso contrário, as entradas de liberação serão gravadas sem nenhum componente de encapsulamento. Se [OUT_FILE] for especificado, em vez de agir em MI_FILE, os dados alterados serão gravados no arquivo específico. Se algum dos nomes de arquivo de saída for definido como "-", a saída será gravada em stdout.
A opção --format pode ser usada para impor a leitura do arquivo de entrada em um formato específico ("texto" ou "yaml") caso a detecção automática do formato falhe. A opção --limit é usada para limitar a quantidade de lançamentos gravados (os lançamentos mais recentes sempre serão os primeiros).
Este comando reverte o comando news-to-metainfo e grava um arquivo NEWS como texto ou YAML usando o XML contido em um arquivo metainfo. Se NEWS_FILE for definido como "-", os dados resultantes serão gravados em stdout em vez de em um arquivo.
A opção --format pode ser usada para especificar explicitamente o formato de saída ("yaml" ou "texto"). Se não estiver definido, appstreamcli adivinhará qual formato é mais adequado.
Converte metadados AppStream XML em sua representação YAML e vice-versa.
Compõe um catálogo de metadados do AppStream a partir de uma árvore de diretórios com arquivos metainfo. Este comando só estará disponível se o componente org.freedesktop.appstream.compose estiver instalado. Consulte appstreamcli-compose(1) para obter mais informações.
Imprima mais informações sobre um componente encontrado.
Não imprima saída colorida.
Não acesse a rede ao validar metadados.
O mesmo efeito pode ser alcançado definindo a variável de ambiente AS_VALIDATE_NONET antes de executar appstreamcli.
Exibir o número da versão do appstreamcli
pkcon(1).
Esta página de manual foi escrita por Matthias Klumpp matthias@tenstral.net.
Copyright © 2012-2022 Matthias Klumpp
1. Freedesktop.org: https://www.freedesktop.org/wiki/Distributions/AppStream/
2. A documentação: https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html