appstreamcli - Tangani format metadata AppStream dan kueri data AppStream
appstreamcli [COMMAND]
Halaman manual ini mendokumentasikan secara singkat perintah appstreamcli.
appstreamcli adalah alat pembantu kecil untuk bekerja dengan metadata AppStream dan mengakses indeks komponen AppStream dari baris perintah. Indeks komponen AppStream berisi daftar semua komponen perangkat lunak yang tersedia untuk distribusi Anda, dicocokkan dengan nama paketnya. Ini dihasilkan menggunakan data AppStream XML atau Debian DEP-11, yang disediakan oleh distributor Anda.
Untuk informasi selengkapnya tentang proyek AppStream dan komponen lain yang merupakan bagian darinya, lihat halaman AppStream di Freedesktop.org[1].
get ID
Dapatkan komponen dari kumpulan metadata dengan pengenalnya.
Telusuri kumpulan komponen AppStream untuk istilah penelusuran tertentu.
Mengembalikan komponen yang menyediakan item tertentu. Jenis item dapat ditentukan menggunakan parameter TYPE, nilai yang dicari harus diberikan menggunakan parameter TERM.
Contoh:
Dapatkan komponen yang menangani jenis media "text/xml".
appstreamcli what-provides mediatype "text/xml"
Dapatkan komponen yang menyediakan pustaka "libfoo.so.2".
appstreamcli what-provides lib libfoo.so.2
Picu penyegaran basis data, jika perlu. Jika Anda ingin memaksa database dibangun kembali, berikan tanda --force.
Perintah ini harus dijalankan dengan izin root.
Menampilkan berbagai informasi tentang metadata yang diinstal dan cache metadata.
Tampilkan informasi tentang sistem operasi saat ini dari indeks metadata. Ini membutuhkan sistem operasi untuk menyediakan komponen sistem operasi untuk dirinya sendiri.
Buang deskripsi XML lengkap komponen dengan ID tertentu yang ditemukan di kumpulan metadata.
Validasi metadata AppStream XML agar sesuai dengan spesifikasi.
Kedua tipe metadata XML, upstream dan distro XML, ditangani. Jenis format yang harus divalidasi ditentukan secara otomatis.
Tanda --pedantic memicu validasi file yang lebih rumit, termasuk masalah minor dan gaya dalam laporan.
Validasi metadata AppStream XML yang ditemukan di pohon file.
Ini melakukan validasi standar dari semua metadata yang ditemukan, tetapi juga memeriksa kesalahan tambahan, seperti keberadaan file .desktop dan validitas metadata tambahan lainnya.
Uji string lisensi atau ekspresi lisensi untuk validitas dan tampilkan detail tentangnya.
Ini akan memeriksa apakah string lisensi dianggap valid untuk AppStream, dan mengembalikan kode keluar bukan nol jika tidak. Perintah juga akan menampilkan informasi berguna seperti ID kanonis lisensi, apakah cocok sebagai lisensi untuk metadata AppStream, dan apakah lisensi tersebut dianggap untuk perangkat lunak Bebas dan Sumber Terbuka atau perangkat lunak berpemilik.
AppStream akan menganggap lisensi apa pun sebagai Gratis dan Sumber Terbuka yang ditandai sesuai oleh Free Software Foundation (FSF), Open Source Initiative (OSI) atau daftar lisensi eksplisit dari Panduan Perangkat Lunak Bebas Debian (DFSG).
Instal komponen perangkat lunak dengan ID-nya menggunakan manajer paket atau Flatpak.
Ini menyelesaikan ID komponen AppStream ke kandidat penginstalan dan kemudian memanggil manajer paket asli atau Flatpak (jika tersedia) untuk menginstal komponen.
Copot pemasangan komponen perangkat lunak dengan ID-nya menggunakan pengelola paket atau Flatpak.
Ini akan menghapus perangkat lunak yang cocok dengan ID yang dipilih menggunakan pengelola paket asli atau Flatpak (jika tersedia).
Instal file metadata ke direktori yang tepat di mesin saat ini.
Bandingkan dua nomor versi. Jika dua nomor versi diberikan sebagai parameter, versi akan dibandingkan dan hasil perbandingan akan dicetak ke stdout.
Jika nomor versi, operator perbandingan, dan nomor versi lain diteruskan sebagai parameter, hasil operasi perbandingan akan dicetak ke stdout, dan appstreamcli akan keluar dengan status keluar bukan nol untuk berjaga-jaga perbandingan gagal. Operator pembanding dapat berupa salah satu dari berikut ini:
Sama dengan
Tidak sama dengan
Kurang dari
Lebih besar dari
Kurang dari atau sama dengan
Lebih dari atau sama dengan
Buat templat file metainfo untuk digunakan oleh proyek perangkat lunak. Opsi --from-desktop dapat digunakan untuk menggunakan file .desktop sebagai template untuk membuat file contoh.
File yang dihasilkan berisi entri contoh yang perlu diisi dengan nilai sebenarnya yang diinginkan oleh penulis proyek.
Parameter TYPE pertama adalah nama jenis komponen AppStream. Untuk daftar lengkap, lihat dokumentasi[2] atau hasil bantuan appstreamcli untuk subperintah ini.
Buat file entri desktop XDG dari file metainfo. Jika file entri desktop yang ditentukan di DESKTOP_FILE sudah ada, file tersebut akan diperpanjang dengan informasi baru yang diekstraksi dari file metainfo. Jika tidak, file baru akan dibuat.
Perintah ini akan menggunakan biner pertama yang disebutkan dalam tag provide komponen untuk bidang Exec= dari file entri desktop baru. Jika ini bukan perilaku yang diinginkan, flag --exec dapat digunakan untuk secara eksplisit menentukan biner yang akan diluncurkan. Metode lain untuk meluncurkan aplikasi saat ini tidak didukung.
Untuk menghasilkan entri desktop yang tepat, perintah ini mengasumsikan bahwa tidak hanya tag minimal yang diperlukan untuk komponen AppStream yang ditetapkan, tetapi juga memiliki tag
Perintah ini mengonversi file NEWS seperti yang digunakan oleh banyak proyek sumber terbuka menjadi XML yang digunakan oleh AppStream. Karena file NEWS adalah teks bebas, banyak heuristik akan diterapkan untuk mendapatkan hasil yang masuk akal. Konverter juga dapat membaca versi YAML dari deskripsi rilis AppStream dan juga mengonversinya menjadi XML. Jika file metainfo MI_FILE sudah ada, itu akan ditambah dengan entri rilis baru, jika tidak, entri rilis akan ditulis tanpa komponen pembungkus. Jika [OUT_FILE] ditentukan, alih-alih bertindak pada MI_FILE, data yang diubah akan ditulis ke file tertentu. Jika salah satu nama file keluaran disetel ke "-", keluaran akan ditulis ke stdout.
Opsi --format dapat digunakan untuk memaksa pembacaan file masukan dalam format tertentu ("teks" atau "yaml") jika pendeteksian otomatis format gagal. Opsi --limit digunakan untuk membatasi jumlah entri rilis yang ditulis (entri terbaru akan selalu menjadi yang pertama).
Perintah ini membalikkan perintah news-to-metainfo dan menulis file NEWS sebagai teks atau YAML menggunakan XML yang terdapat dalam file metainfo. Jika NEWS_FILE disetel ke "-", data yang dihasilkan akan ditulis ke stdout, bukan ke file.
Opsi --format dapat digunakan untuk secara eksplisit menentukan format output ("yaml" atau "text"). Jika tidak disetel, appstreamcli akan menebak format mana yang paling cocok.
Mengonversi metadata AppStream XML menjadi representasi YAML dan sebaliknya.
Menyusun katalog metadata AppStream dari pohon direktori dengan file metainfo. Perintah ini hanya tersedia jika komponen org.freedesktop.appstream.compose diinstal. Lihat appstreamcli-compose(1) untuk informasi selengkapnya.
Cetak informasi lebih lanjut tentang komponen yang ditemukan.
Jangan mencetak keluaran berwarna.
Jangan mengakses jaringan saat memvalidasi metadata.
Efek yang sama dapat dicapai dengan menyetel variabel lingkungan AS_VALIDATE_NONET sebelum menjalankan appstreamcli.
Menampilkan nomor versi appstreamcli
pkcon(1).
Halaman manual ini ditulis oleh Matthias Klumpp
Hak Cipta © 2012-2022 Matthias Klumpp
1. Freedesktop.org: https://www.freedesktop.org/wiki/Distributions/AppStream/
2. Dokumentasi: https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html