appstreamcli - Obsługa formatów metadanych AppStream i wysyłanie zapytań do danych AppStream
appstreamcli [COMMAND]
Ta strona podręcznika opisuje pokrótce polecenie appstreamcli.
appstreamcli to małe narzędzie pomocnicze do pracy z metadanymi AppStream i uzyskiwania dostępu do indeksu komponentu AppStream z wiersza poleceń. Indeks składników AppStream zawiera listę wszystkich dostępnych składników oprogramowania dla Twojej dystrybucji, dopasowanych do ich nazw pakietów. Jest generowany przy użyciu danych AppStream XML lub Debian DEP-11, które są dostarczane przez dystrybutora.
Aby uzyskać więcej informacji na temat projektu AppStream i innych wchodzących w jego skład komponentów, zajrzyj na strony AppStream na Freedesktop.org[1].
get ID
Pobierz komponent z puli metadanych według jego identyfikatora.
Przeszukaj pulę składników AppStream dla danego wyszukiwanego hasła.
Zwróć komponenty, które dostarczają dany element. Typ elementu można określić za pomocą parametru TYPE, wartość do wyszukania należy podać za pomocą parametru TERM.
Przykłady:
Uzyskaj komponenty obsługujące typ nośnika „text/xml”.
appstreamcli what-provides mediatype "text/xml"
Pobierz komponent, który udostępnia bibliotekę „libfoo.so.2”.
appstreamcli what-provides lib libfoo.so.2
W razie potrzeby wyzwól odświeżenie bazy danych. Jeśli chcesz wymusić odbudowę bazy danych, podaj flagę --force.
To polecenie należy wykonać z uprawnieniami administratora.
Wyświetl różne informacje o zainstalowanych metadanych i pamięci podręcznej metadanych.
Pokaż informacje o bieżącym systemie operacyjnym z indeksu metadanych. Wymaga to od systemu operacyjnego dostarczenia dla siebie komponentu systemu operacyjnego.
Zrzuć kompletne opisy XML komponentów o podanym identyfikatorze, które zostały znalezione w puli metadanych.
Zweryfikuj metadane AppStream XML pod kątem zgodności ze specyfikacją.
Obsługiwane są oba typy metadanych XML, źródłowy i dystrybucyjny XML. Typ formatu, który powinien zostać poddany walidacji, jest określany automatycznie.
Flaga --pedantic uruchamia bardziej szczegółową weryfikację pliku, w tym drobnych problemów i problemów związanych ze stylem w raporcie.
Sprawdź poprawność metadanych XML AppStream znalezionych w drzewie plików.
Wykonuje to standardową weryfikację wszystkich znalezionych metadanych, ale także sprawdza dodatkowe błędy, takie jak obecność plików .desktop i poprawność innych dodatkowych metadanych.
Przetestuj ciąg licencji lub wyrażenie licencji pod kątem ważności i wyświetl szczegółowe informacje na jej temat.
Spowoduje to sprawdzenie, czy ciąg licencji jest uważany za ważny dla AppStream, i zwróci niezerowy kod wyjścia, jeśli tak nie jest. Polecenie wyświetli również przydatne informacje, takie jak kanoniczny identyfikator licencji, czy nadaje się jako licencja na metadane AppStream oraz czy licencja jest uważana za oprogramowanie bezpłatne i otwarte, czy oprogramowanie zastrzeżone.
AppStream uzna każdą licencję za wolną i otwartą, która zostanie oznaczona jako odpowiednia przez Free Software Foundation (FSF), Open Source Initiative (OSI) lub jawną listę licencji w Wytycznych Debiana dotyczących Wolnego Oprogramowania (DFSG).
Zainstaluj składnik oprogramowania według jego identyfikatora za pomocą menedżera pakietów lub Flatpak.
Spowoduje to rozpoznanie identyfikatora składnika AppStream jako kandydata do instalacji, a następnie wywołanie natywnego menedżera pakietów lub pakietu Flatpak (jeśli jest dostępny) w celu zainstalowania składnika.
Odinstaluj składnik oprogramowania według jego identyfikatora za pomocą menedżera pakietów lub Flatpak.
Spowoduje to odinstalowanie oprogramowania pasującego do wybranego identyfikatora przy użyciu natywnego menedżera pakietów lub Flatpak (jeśli jest dostępny).
Zainstaluj plik metadanych w odpowiednim katalogu na bieżącym komputerze.
Porównaj dwa numery wersji. Jeśli jako parametry zostaną podane dwa numery wersji, wersje zostaną porównane i wynik porównania zostanie wydrukowany na standardowe wyjście.
Jeśli numer wersji, operator porównania i inny numer wersji zostaną przekazane jako parametr, wynik operacji porównania zostanie wydrukowany na standardowe wyjście, a appstreamcli zakończy działanie z niezerowym kodem wyjścia w przypadku porównanie nieudane. Operator porównania może być jednym z następujących:
Równy
Nie równe
Mniej niż
Lepszy niż
Mniejszy lub równy
Większe bądź równe
Utwórz szablon pliku metainfo, który będzie używany w projektach oprogramowania. Opcji --from-desktop można użyć do użycia pliku .desktop jako szablonu do wygenerowania przykładowego pliku.
Wygenerowane pliki zawierają przykładowe wpisy, które autor projektu musi wprowadzić z rzeczywistymi żądanymi wartościami.
Pierwszy parametr TYPE to nazwa typu komponentu AppStream. Pełną listę znajdziesz w dokumentacji[2] lub danych wyjściowych pomocy appstreamcli dla tej komendy.
Utwórz plik wpisu na pulpicie XDG z pliku metainfo. Jeśli plik wpisu na pulpicie określony w DESKTOP_FILE już istnieje, zostanie rozszerzony o nowe informacje wyodrębnione z pliku metainfo. W przeciwnym razie zostanie utworzony nowy plik.
To polecenie użyje pierwszego pliku binarnego wymienionego w znaczniku dostarcza komponentu dla pola Exec= nowego pliku wpisu na pulpicie. Jeśli nie jest to pożądane zachowanie, można użyć flagi --exec do jawnego zdefiniowania pliku binarnego do uruchomienia. Inne metody uruchamiania aplikacji nie są obecnie obsługiwane.
W celu wygenerowania poprawnego wpisu na pulpicie to polecenie zakłada, że nie tylko ustawione są minimalne wymagane tagi dla komponentu AppStream, ale także że ma znacznik
To polecenie konwertuje plik NEWS używany przez wiele projektów open source na plik XML używany przez AppStream. Ponieważ pliki NEWS są wolnym tekstem, zostanie zastosowanych wiele heurystyk, aby uzyskać rozsądne wyniki. Konwerter może również odczytać wersję YAML opisu wydania AppStream i przekonwertować ją również na XML. Jeśli plik metainfo MI_FILE już istnieje, zostanie powiększony o nowe wpisy wydania, w przeciwnym razie wpisy wydania zostaną zapisane bez żadnego elementu opakowującego. Jeśli określono [PLIK_WY_WY], zamiast działać na MI_FILE zmienione dane zostaną zapisane w określonym pliku. Jeśli którakolwiek z nazw plików wyjściowych jest ustawiona na „-”, dane wyjściowe zostaną zamiast tego zapisane na stdout.
Opcji --format można użyć do wymuszenia odczytu pliku wejściowego w określonym formacie („text” lub „yaml”) w przypadku niepowodzenia automatycznego wykrywania formatu. Opcja --limit służy do ograniczenia liczby zapisywanych wpisów wydania (najnowsze wpisy będą zawsze pierwsze).
To polecenie odwraca polecenie news-to-metainfo i zapisuje plik NEWS jako tekst lub YAML przy użyciu XML zawartego w pliku metainfo. Jeśli NEWS_FILE jest ustawione na "-", wynikowe dane zostaną zapisane na standardowe wyjście zamiast do pliku.
Opcji --format można użyć do jawnego określenia formatu wyjściowego ("yaml" lub "text"). Jeśli nie jest ustawiony, appstreamcli zgadnie, który format jest najbardziej odpowiedni.
Konwertuje metadane XML AppStream na ich reprezentację YAML i odwrotnie.
Tworzy katalog metadanych AppStream z drzewa katalogów z plikami metainformacji. To polecenie jest dostępne tylko wtedy, gdy jest zainstalowany składnik org.freedesktop.appstream.compose. Zobacz appstreamcli-compose(1), aby uzyskać więcej informacji.
Wydrukuj więcej informacji o znalezionym komponencie.
Nie drukuj kolorowych wydruków.
Nie uzyskuj dostępu do sieci podczas sprawdzania poprawności metadanych.
Ten sam efekt można osiągnąć, ustawiając zmienną środowiskową AS_VALIDATE_NONET przed uruchomieniem appstreamcli.
Wyświetl numer wersji appstreamcli
pkcon(1).
Ta strona podręcznika została napisana przez Matthiasa Klumppa
Copyright © 2012-2022 Matthias Klumpp
1. Freedesktop.org: https://www.freedesktop.org/wiki/Distributions/AppStream/
2. Dokumentacja: https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html