appstreamcli - Xử lý các định dạng siêu dữ liệu AppStream và truy vấn dữ liệu AppStream
appstreamcli [COMMAND]
Trang hướng dẫn này ghi lại ngắn gọn lệnh appstreamcli.
appstreamcli là một công cụ trợ giúp nhỏ để làm việc với siêu dữ liệu AppStream và truy cập chỉ mục thành phần AppStream từ dòng lệnh. Chỉ mục thành phần AppStream chứa danh sách tất cả các thành phần phần mềm có sẵn cho bản phân phối của bạn, khớp với tên gói của chúng. Nó được tạo bằng cách sử dụng dữ liệu AppStream XML hoặc Debian DEP-11 do nhà phân phối của bạn cung cấp.
Để biết thêm thông tin về dự án AppStream và các thành phần khác là một phần của dự án, hãy xem các trang AppStream tại Freedesktop.org[1].
get ID
Nhận một thành phần từ nhóm siêu dữ liệu bằng mã định danh của nó.
Tìm kiếm nhóm thành phần AppStream cho một cụm từ tìm kiếm nhất định.
Trả về các thành phần cung cấp một mục nhất định. Bạn có thể chỉ định loại mục bằng tham số TYPE, giá trị để tìm kiếm phải được cung cấp bằng tham số TERM.
Ví dụ:
Nhận các thành phần xử lý loại phương tiện "text/xml".
appstreamcli what-provides mediatype "text/xml"
Nhận thành phần cung cấp thư viện "libfoo.so.2".
appstreamcli what-provides lib libfoo.so.2
Kích hoạt làm mới cơ sở dữ liệu, nếu cần. Trong trường hợp bạn muốn bắt buộc xây dựng lại cơ sở dữ liệu, hãy cung cấp cờ --buộc.
Lệnh này phải được thực thi với quyền root.
Hiển thị nhiều thông tin khác nhau về siêu dữ liệu đã cài đặt và bộ đệm ẩn siêu dữ liệu.
Hiển thị thông tin về hệ điều hành hiện tại từ chỉ mục siêu dữ liệu. Điều này yêu cầu hệ điều hành cung cấp một thành phần hệ điều hành cho chính nó.
Kết xuất các mô tả XML hoàn chỉnh của các thành phần có ID đã cho được tìm thấy trong nhóm siêu dữ liệu.
Xác thực siêu dữ liệu XML của AppStream để tuân thủ thông số kỹ thuật.
Cả hai loại siêu dữ liệu XML, ngược dòng và phân phối XML đều được xử lý. Loại định dạng cần được xác thực sẽ được xác định tự động.
Cờ --pedantic kích hoạt xác thực tệp theo kiểu mô phạm hơn, bao gồm các vấn đề nhỏ về kiểu dáng và vấn đề trong báo cáo.
Xác thực siêu dữ liệu XML của AppStream có trong cây tệp.
Thao tác này thực hiện xác thực tiêu chuẩn cho tất cả siêu dữ liệu đã tìm thấy, nhưng cũng kiểm tra các lỗi bổ sung, chẳng hạn như sự hiện diện của tệp .desktop và tính hợp lệ của siêu dữ liệu bổ sung khác.
Kiểm tra tính hợp lệ của chuỗi giấy phép hoặc biểu thức giấy phép và hiển thị thông tin chi tiết về nó.
Thao tác này sẽ kiểm tra xem chuỗi giấy phép có được coi là hợp lệ cho AppStream hay không và trả về mã thoát khác không nếu không. Lệnh này cũng sẽ hiển thị thông tin hữu ích như ID chính tắc của giấy phép, liệu giấy phép đó có phù hợp làm giấy phép cho siêu dữ liệu AppStream hay không và liệu giấy phép đó có được coi là dành cho phần mềm Nguồn mở và Miễn phí hay phần mềm độc quyền hay không.
AppStream sẽ coi bất kỳ giấy phép nào là Nguồn Mở và Miễn phí được đánh dấu là phù hợp bởi Tổ chức Phần mềm Tự do (FSF), Sáng kiến Nguồn Mở (OSI) hoặc danh sách giấy phép rõ ràng của Nguyên tắc Phần mềm Tự do Debian (DFSG).
Cài đặt một thành phần phần mềm theo ID của nó bằng trình quản lý gói hoặc Flatpak.
Thao tác này phân giải ID thành phần AppStream cho ứng viên cài đặt, sau đó gọi trình quản lý gói gốc hoặc Flatpak (nếu có) để cài đặt thành phần.
Gỡ cài đặt một thành phần phần mềm theo ID của nó bằng trình quản lý gói hoặc Flatpak.
Thao tác này sẽ gỡ cài đặt phần mềm khớp với ID đã chọn bằng trình quản lý gói gốc hoặc Flatpak (nếu có).
Cài đặt tệp siêu dữ liệu vào đúng thư mục trên máy hiện tại.
So sánh hai số phiên bản. Nếu hai số phiên bản được cung cấp dưới dạng tham số, các phiên bản sẽ được so sánh và kết quả so sánh sẽ được in ra thiết bị xuất chuẩn.
Nếu số phiên bản, toán tử so sánh và số phiên bản khác được chuyển vào dưới dạng tham số, thì kết quả của thao tác so sánh sẽ được in ra thiết bị xuất chuẩn và appstreamcli sẽ thoát với trạng thái thoát khác 0 trong trường hợp so sánh không thành công. Toán tử so sánh có thể là một trong các cách sau:
Tương đương với
không bằng
Ít hơn
Lớn hơn
Ít hơn hoặc bằng
Lớn hơn hoặc bằng
Tạo một mẫu tệp siêu thông tin để các dự án phần mềm sử dụng. Có thể sử dụng tùy chọn --từ máy tính để bàn để sử dụng tệp .desktop làm mẫu để tạo tệp mẫu.
Các tệp được tạo chứa các mục ví dụ cần được tác giả dự án điền vào với các giá trị mong muốn thực tế.
Tham số TYPE đầu tiên là tên của loại thành phần AppStream. Để có danh sách đầy đủ, hãy xem tài liệu[2] hoặc đầu ra trợ giúp của appstreamcli cho lệnh phụ này.
Tạo tệp mục nhập máy tính để bàn XDG từ tệp siêu thông tin. Nếu tệp mục nhập máy tính để bàn được chỉ định trong DESKTOP_FILE đã tồn tại, thì tệp đó sẽ được mở rộng với thông tin mới được trích xuất từ tệp siêu thông tin. Nếu không, một tệp mới sẽ được tạo.
Lệnh này sẽ sử dụng mã nhị phân đầu tiên được đề cập trong thẻ cung cấp của thành phần cho trường Exec= của tệp mục nhập máy tính để bàn mới. Nếu đây không phải là hành vi mong muốn, cờ --exec có thể được sử dụng để xác định rõ ràng tệp nhị phân cần khởi chạy. Các phương pháp khởi chạy ứng dụng khác hiện không được hỗ trợ.
Để tạo mục nhập phù hợp trên màn hình, lệnh này giả định rằng không chỉ các thẻ bắt buộc tối thiểu cho thành phần AppStream được thiết lập, mà nó còn có thẻ
Lệnh này chuyển đổi tệp TIN TỨC được nhiều dự án nguồn mở sử dụng thành XML được sử dụng bởi AppStream. Vì các tệp TIN TỨC là văn bản miễn phí nên sẽ áp dụng nhiều phương pháp phỏng đoán để có được kết quả hợp lý. Trình chuyển đổi cũng có thể đọc phiên bản YAML của mô tả bản phát hành AppStream và chuyển đổi nó thành XML. Nếu tệp siêu thông tin MI_FILE đã tồn tại, nó sẽ được bổ sung bằng các mục phát hành mới, nếu không, các mục phát hành sẽ được ghi mà không có bất kỳ thành phần gói nào. Nếu [OUT_FILE] được chỉ định, thay vì tác động lên MI_FILE, dữ liệu đã thay đổi sẽ được ghi vào tệp cụ thể. Nếu bất kỳ tên tệp đầu ra nào được đặt thành "-", thay vào đó, đầu ra sẽ được ghi vào thiết bị xuất chuẩn.
Tùy chọn --định dạng có thể được sử dụng để bắt buộc đọc tệp đầu vào ở định dạng cụ thể ("văn bản" hoặc "yaml") trong trường hợp tự động phát hiện định dạng không thành công. Tùy chọn --giới hạn được sử dụng để giới hạn số lượng mục phát hành được viết (các mục mới nhất sẽ luôn ở vị trí đầu tiên).
Lệnh này đảo ngược lệnh news-to-metainfo và ghi tệp TIN TỨC dưới dạng văn bản hoặc YAML bằng cách sử dụng XML có trong tệp siêu thông tin. Nếu NEWS_FILE được đặt thành "-", dữ liệu kết quả sẽ được ghi vào thiết bị xuất chuẩn thay vì vào một tệp.
Có thể sử dụng tùy chọn --format để chỉ định rõ ràng định dạng đầu ra ("yaml" hoặc "text"). Nếu nó không được đặt, appstreamcli sẽ đoán định dạng nào phù hợp nhất.
Chuyển đổi siêu dữ liệu XML của AppStream thành biểu diễn YAML của nó và ngược lại.
Soạn danh mục siêu dữ liệu AppStream từ cây thư mục có tệp siêu thông tin. Lệnh này chỉ khả dụng nếu thành phần org.freedesktop.appstream.compose được cài đặt. Xem appstreamcli-compose(1) để biết thêm thông tin.
In thêm thông tin về một thành phần được tìm thấy.
Không in đầu ra màu.
Không truy cập mạng khi xác thực siêu dữ liệu.
Có thể đạt được hiệu quả tương tự bằng cách đặt biến môi trường AS_VALIDATE_NONET trước khi chạy appstreamcli.
Hiển thị số phiên bản của appstreamcli
pkcon(1).
Trang hướng dẫn này được viết bởi Matthias Klumpp
Bản quyền © 2012-2022 Matthias Klumpp
1. Freedesktop.org: https://www.freedesktop.org/wiki/Distributions/AppStream/
2. Tài liệu: https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html