appstreamcli - AppStream 메타데이터 형식 처리 및 AppStream 데이터 쿼리
appstreamcli [COMMAND]
이 매뉴얼 페이지는 appstreamcli 명령을 간략하게 설명합니다.
appstreamcli는 AppStream 메타데이터로 작업하고 명령줄에서 AppStream 구성 요소 인덱스에 액세스하는 작은 도우미 도구입니다. AppStream 구성 요소 인덱스에는 패키지 이름과 일치하는 배포에 사용 가능한 모든 소프트웨어 구성 요소 목록이 포함되어 있습니다. 배포자가 제공하는 AppStream XML 또는 Debian DEP-11 데이터를 사용하여 생성됩니다.
AppStream 프로젝트 및 그 일부인 기타 구성 요소에 대한 자세한 내용은 Freedesktop.org[1]의 AppStream 페이지를 참조하십시오.
get ID
식별자로 메타데이터 풀에서 구성 요소를 가져옵니다.
지정된 검색어로 AppStream 구성 요소 풀을 검색합니다.
주어진 항목을 제공하는 구성 요소를 반환합니다. 항목 유형은 TYPE 매개변수를 사용하여 지정할 수 있으며 검색할 값은 TERM 매개변수를 사용하여 제공되어야 합니다.
예:
"text/xml" 미디어 유형을 처리하는 구성 요소를 가져옵니다.
appstreamcli what-provides mediatype "text/xml"
"libfoo.so.2" 라이브러리를 제공하는 구성 요소를 가져옵니다.
appstreamcli what-provides lib libfoo.so.2
필요한 경우 데이터베이스 새로 고침을 트리거합니다. 데이터베이스를 강제로 재구축하려면 --force 플래그를 제공하십시오.
이 명령은 루트 권한으로 실행해야 합니다.
설치된 메타데이터 및 메타데이터 캐시에 대한 다양한 정보를 표시합니다.
메타데이터 색인에서 현재 운영 체제에 대한 정보를 표시합니다. 이를 위해서는 운영 체제가 자체적으로 운영 체제 구성 요소를 제공해야 합니다.
메타데이터 풀에서 찾은 지정된 ID를 가진 구성 요소의 전체 XML 설명을 덤프합니다.
사양 준수를 위해 AppStream XML 메타데이터를 검증합니다.
XML 메타데이터 유형인 업스트림 및 배포 XML이 모두 처리됩니다. 유효성을 검사해야 하는 형식 유형은 자동으로 결정됩니다.
--pedantic 플래그는 보고서의 사소한 문제 및 스타일 문제를 포함하여 파일에 대한 보다 현명한 유효성 검사를 트리거합니다.
파일 트리에서 찾은 AppStream XML 메타데이터를 검증합니다.
이것은 발견된 모든 메타데이터의 표준 유효성 검사를 수행하지만 .desktop 파일의 존재 및 기타 추가 메타데이터의 유효성과 같은 추가 오류도 확인합니다.
라이센스 문자열 또는 라이센스 표현식의 유효성을 테스트하고 이에 대한 세부 정보를 표시합니다.
이것은 라이선스 문자열이 AppStream에 대해 유효한 것으로 간주되는지 여부를 확인하고 유효하지 않은 경우 0이 아닌 종료 코드를 반환합니다. 또한 이 명령은 라이선스의 정식 ID, AppStream 메타데이터에 대한 라이선스로 적합한지 여부, 라이선스가 무료 및 오픈 소스 소프트웨어용인지 독점 소프트웨어용인지 여부와 같은 유용한 정보를 표시합니다.
AppStream은 FSF(Free Software Foundation), OSI(Open Source Initiative) 또는 DFSG(Debian Free Software Guidelines)의 명시적 라이선스 목록에 적합한 것으로 표시된 모든 라이선스를 무료 및 오픈 소스로 간주합니다.
패키지 관리자 또는 Flatpak을 사용하여 해당 ID로 소프트웨어 구성 요소를 설치합니다.
이렇게 하면 AppStream 구성 요소 ID를 설치 후보로 확인한 다음 기본 패키지 관리자 또는 Flatpak(사용 가능한 경우)을 호출하여 구성 요소를 설치합니다.
패키지 관리자 또는 Flatpak을 사용하여 해당 ID로 소프트웨어 구성 요소를 제거합니다.
이렇게 하면 기본 패키지 관리자 또는 Flatpak(사용 가능한 경우)을 사용하여 선택한 ID와 일치하는 소프트웨어가 제거됩니다.
현재 머신의 올바른 디렉토리에 메타데이터 파일을 설치합니다.
두 버전 번호를 비교합니다. 두 개의 버전 번호가 매개변수로 주어지면 버전을 비교하고 비교 결과를 stdout에 출력합니다.
버전 번호, 비교 연산자 및 다른 버전 번호가 매개변수로 전달되면 비교 작업의 결과가 stdout에 인쇄되고 appstreamcli는 다음과 같은 경우 0이 아닌 종료 상태로 종료됩니다. 비교에 실패했습니다. 비교 연산자는 다음 중 하나일 수 있습니다.
동일
같지 않음
미만
보다 큰
보다 작거나 같음
보다 크거나 같음
소프트웨어 프로젝트에서 사용할 metainfo 파일 템플릿을 만듭니다. --from-desktop 옵션은 예제 파일을 생성하기 위한 템플릿으로 .desktop 파일을 사용하는 데 사용할 수 있습니다.
생성된 파일에는 프로젝트 작성자가 원하는 실제 값으로 제출해야 하는 예제 항목이 포함되어 있습니다.
첫 번째 TYPE 매개변수는 AppStream 구성 요소 유형의 이름입니다. 전체 목록은 문서[2] 또는 이 하위 명령에 대한 appstreamcli의 도움말 출력을 확인하세요.
metainfo 파일에서 XDG 데스크탑 항목 파일을 만듭니다. DESKTOP_FILE에 지정된 desktop-entry 파일이 이미 존재하는 경우 metainfo 파일에서 추출된 새 정보로 확장됩니다. 그렇지 않으면 새 파일이 생성됩니다.
이 명령은 새 desktop-entry 파일의 Exec= 필드에 대한 구성 요소의 제공 태그에 언급된 첫 번째 바이너리를 사용합니다. 이것이 원하는 동작이 아닌 경우 --exec 플래그를 사용하여 실행할 바이너리를 명시적으로 정의할 수 있습니다. 응용 프로그램을 시작하는 다른 방법은 현재 지원되지 않습니다.
적절한 desktop-entry를 생성하기 위해 이 명령은 AppStream 구성 요소에 대해 최소한으로 필요한 태그가 설정되었을 뿐만 아니라 "stock" 유형의
이 명령은 많은 오픈 소스 프로젝트에서 사용되는 NEWS 파일을 AppStream에서 사용되는 XML로 변환합니다. NEWS 파일은 자유 텍스트이므로 합리적인 결과를 얻기 위해 많은 휴리스틱이 적용됩니다. 변환기는 또한 AppStream 릴리스 설명의 YAML 버전을 읽고 이를 XML로 변환할 수도 있습니다. 메타 정보 파일 MI_FILE이 이미 존재하는 경우 새 릴리스 항목으로 보강되고, 그렇지 않으면 릴리스 항목이 래핑 구성 요소 없이 작성됩니다. [OUT_FILE]이 지정된 경우 MI_FILE에 작용하는 대신 변경된 데이터가 특정 파일에 기록됩니다. 출력 파일 이름이 "-"로 설정된 경우 출력이 대신 stdout에 기록됩니다.
--format 옵션은 형식 자동 감지가 실패하는 경우 특정 형식("text" 또는 "yaml")의 입력 파일 읽기를 강제하는 데 사용할 수 있습니다. --limit 옵션은 작성되는 릴리스 항목의 양을 제한하는 데 사용됩니다(최신 항목이 항상 첫 번째 항목임).
이 명령은 news-to-metainfo 명령을 뒤집고 metainfo 파일에 포함된 XML을 사용하여 NEWS 파일을 텍스트 또는 YAML로 작성합니다. NEWS_FILE이 "-"로 설정되면 결과 데이터가 파일 대신 stdout에 기록됩니다.
--format 옵션을 사용하여 출력 형식("yaml" 또는 "text")을 명시적으로 지정할 수 있습니다. 설정되지 않은 경우 appstreamcli는 가장 적합한 형식을 추측합니다.
AppStream XML 메타데이터를 YAML 표현으로 또는 그 반대로 변환합니다.
metainfo 파일이 있는 디렉터리 트리에서 AppStream 메타데이터 카탈로그를 구성합니다. 이 명령은 org.freedesktop.appstream.compose 구성 요소가 설치된 경우에만 사용할 수 있습니다. 자세한 내용은 appstreamcli-compose(1)를 참조하세요.
찾은 구성 요소에 대한 자세한 정보를 인쇄합니다.
컬러 출력물을 인쇄하지 마십시오.
메타데이터를 검증할 때 네트워크에 액세스하지 마십시오.
appstreamcli를 실행하기 전에 AS_VALIDATE_NONET 환경 변수를 설정하여 동일한 효과를 얻을 수 있습니다.
appstreamcli의 버전 번호 표시
pkcon(1).
이 매뉴얼 페이지는 Matthias Klumpp matthias@tenstral.net이 작성했습니다.
저작권 © 2012-2022 Matthias Klumpp
1. Freedesktop.org: https://www.freedesktop.org/wiki/Distributions/AppStream/
2. 문서: https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html