appstreamcli-compose - instrukcja obsługi, opcje, przykłady poleceń


NAZWA

appstreamcli-compose - Skomponuj katalog metadanych AppStream z drzew katalogów

STRESZCZENIE

appstreamcli compose [COMMAND]

OPIS

Ta strona podręcznika dokumentuje pokrótce polecenie appstreamcli compose.

Narzędzie appstreamcli Compose służy do konstruowania katalogów metadanych AppStream z drzew katalogów. Narzędzie wykona również wiele powiązanych działań związanych z generowaniem metadanych, takich jak zmiana rozmiaru ikon i zrzutów ekranu oraz scalanie danych z przywoływanych plików wpisów na pulpicie, a także informacji o stanie tłumaczenia. Dzięki temu narzędzie pozwala w szybki sposób przetestować, jak mogą wyglądać finalnie przetworzone metadane aplikacji wysyłanej do użytkowników. Zapewnia również sposób na łatwe generowanie danych AppStream dla projektów, które nie potrzebują bardziej złożonego generatora danych, takiego jak appstream-generator.

Aby polecenie appstreamcli compose było dostępne, może być konieczne uprzednie zainstalowanie opcjonalnego modułu redagowania dla appstreamcli.

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].

OPCJE

KATALOGI ŹRÓDŁOWE

Lista katalogów do przetworzenia musi być podana jako parametry pozycyjne. Dane ze wszystkich katalogów zostaną połączone w jedną wyjściową przestrzeń nazw.

--origin NAME

Ustaw identyfikator pochodzenia danych AppStream. Może to być wartość taka jak „debian-unstable-main” lub „flathub”.

--result-root DIR

Ustawia katalog, do którego eksportowane są wszystkie wygenerowane dane wyjściowe wdrożone na komputerze użytkownika. Jeśli ten parametr nie jest ustawiony i mamy tylko jeden katalog do przetworzenia, używamy tego katalogu jako domyślnej ścieżki wyjściowej.

Jeśli ustawione są zarówno --data-dir, jak i --icons-dir, --result-root nie jest konieczne i żadne dane nie będą zapisane w tym katalogu.

--data-dir DIR

Zastąp katalog, w którym zostanie zapisany wygenerowany katalog metadanych AppStream. Dane zostaną zapisane bezpośrednio w tym katalogu i nie zostaną utworzone żadne podkatalogi (w przeciwieństwie do użycia --result-root do ustawienia lokalizacji wyjściowej).

--icons-dir DIR

Zastąp katalog, do którego eksportowane są ikony z pamięci podręcznej.

--hints-dir DIR

Ustaw katalog, w którym zapisywane są wskazówki zgłaszane podczas przetwarzania metadanych. Jeśli ten parametr nie zostanie ustawiony, żadne raporty ze wskazówkami HTML/YAML nie zostaną zapisane.

--media-dir DIR

Jeśli jest ustawiona, tworzy katalog z zawartością multimedialną (ikony, zrzuty ekranu, ...), która może być obsługiwana przez serwer WWW. Metadane zostaną rozszerzone o informacje o tych zdalnych nośnikach.

--media-baseurl URL

Adres URL, pod którym będzie wyświetlana zawartość katalogu ustawionego za pomocą --media-dir. Tę wartość należy ustawić, jeśli tworzony jest katalog multimediów.

--prefix DIR

Ustaw domyślny prefiks używany w przetwarzanych katalogach. Jeśli żadna nie jest ustawiona jawnie, przyjmuje się /usr.

--print-report MODE

Wydrukuj raport ze wskazówkami dotyczącymi problemów (który zostanie wyeksportowany jako dokument HTML i YAML po ustawieniu --hints-dir) na konsoli w formie tekstowej.

Obsługiwane są różne tryby drukowania: w przypadku błędu drukuje krótki raport tylko w przypadku niepowodzenia (domyślnie), krótki generuje skrócony raport, który jest zawsze drukowany i pełny powoduje wydruk szczegółowego raportu.

--components COMPONENT-IDs

Ustaw rozdzielaną przecinkami listę identyfikatorów komponentów AppStream, które mają być brane pod uwagę przy generowaniu metadanych. Wszystkie komponenty, które istnieją w danych wejściowych, ale nie są wymienione na tej liście, zostaną zignorowane w generowanych danych wyjściowych.

--no-color

Nie drukuj kolorowych wydruków.

--verbose

Wyświetl dodatkowe informacje debugowania

--version

Wyświetl numer wersji aplikacji appstreamcli compose

ZOBACZ TEŻ

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

AUTOR

Ta strona podręcznika została napisana przez Matthiasa Klumppa .

PRAWA AUTORSKIE

Copyright © 2020-2022 Matthias Klumpp

UWAGI

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