appstreamcli-compose - ディレクトリ ツリーから AppStream メタデータ カタログを作成する
appstreamcli compose [COMMAND]
このマニュアル ページでは、appstreamcli compose コマンドについて簡単に説明します。
appstreamcli compose ツールは、ディレクトリ ツリーから AppStream メタデータ カタログを構築するために使用されます。このツールは、アイコンやスクリーンショットのサイズ変更、参照されたデスクトップ エントリ ファイルからのデータの結合、翻訳ステータス情報など、関連する多くのメタデータ生成アクションも実行します。したがって、このツールは、ユーザーに配布されるアプリケーションの最終的に処理されたメタデータがどのように見えるかをテストする迅速な方法を提供します。また、appstream-generator のような複雑なデータ ジェネレーターを必要としないプロジェクトの AppStream データを簡単に生成する方法も提供します。
appstreamcli compose コマンドを使用できるようにするには、最初に appstreamcli のオプションの compose モジュールをインストールする必要がある場合があります。
AppStream プロジェクトとその一部である他のコンポーネントの詳細については、Freedesktop.org[1] の AppStream ページを参照してください。
ソース ディレクトリ
処理するディレクトリのリストは、位置パラメータとして指定する必要があります。すべてのディレクトリのデータは 1 つの出力名前空間に結合されます。
AppStream データオリジン識別子を設定します。これは、「debian-unstable-main」または「flathub」のような値にすることができます。
ユーザーのマシンにデプロイされるすべての生成された出力がエクスポートされるディレクトリを設定します。このパラメータが設定されておらず、処理するディレクトリが 1 つだけの場合は、そのディレクトリがデフォルトの出力パスとして使用されます。
--data-dir と --icons-dir の両方が設定されている場合、--result-root は必要なく、データは保存されません。そのディレクトリに書き込まれます。
生成された AppStream メタデータ カタログが書き込まれるディレクトリをオーバーライドします。データはこのディレクトリに直接書き込まれ、サブディレクトリは作成されません (--result-root を使用して出力場所を設定する場合とは異なります)。
キャッシュされたアイコンのエクスポート先のディレクトリをオーバーライドします。
メタデータ処理中に生成されたレポートのヒントが保存されるディレクトリを設定します。このパラメータが設定されていない場合、HTML/YAML ヒント レポートは保存されません。
設定すると、Web サーバー経由で提供できるメディア コンテンツ (アイコン、スクリーンショットなど) を含むディレクトリが作成されます。メタデータは、これらのリモート メディアに関する情報を含むように拡張されます。
--media-dir で設定されたディレクトリのコンテンツが提供される URL。メディア ディレクトリを作成する場合は、この値を設定する必要があります。
処理されるディレクトリで使用されるデフォルトのプレフィックスを設定します。何も明示的に設定されていない場合は、/usr が想定されます。
問題のヒント レポート (--hints-dir が設定されている場合、HTML および YAML ドキュメントとしてエクスポートされます) をテキスト形式でコンソールに出力します。
さまざまな印刷モードがサポートされています。エラー時 は実行が失敗した場合にのみ短いレポートを印刷します (デフォルト)。短い は常に印刷され、完全なレポートを生成します。 結果、詳細なレポートが印刷されます。
生成されたメタデータに対して考慮される AppStream コンポーネント ID のカンマ区切りのリストを設定します。入力データに存在するが、このリストに記載されていないすべてのコンポーネントは、生成される出力では無視されます。
カラー出力を印刷しないでください。
追加のデバッグ情報を表示する
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/