appstreamcli - AppStream meta veri biçimlerini kullanın ve AppStream verilerini sorgulayın
appstreamcli [COMMAND]
Bu kılavuz sayfası kısaca appstreamcli komutunu belgelemektedir.
appstreamcli, AppStream meta verileriyle çalışmak ve AppStream bileşen dizinine komut satırından erişmek için küçük bir yardımcı araçtır. AppStream bileşen dizini, dağıtımınız için paket adlarıyla eşleşen tüm mevcut yazılım bileşenlerinin bir listesini içerir. Distribütörünüz tarafından sağlanan AppStream XML veya Debian DEP-11 verileri kullanılarak oluşturulur.
AppStream projesi ve onun parçası olan diğer bileşenler hakkında daha fazla bilgi için Freedesktop.org[1] adresindeki AppStream sayfalarına bakın.
get ID
Tanımlayıcısına göre meta veri havuzundan bir bileşen alın.
Belirli bir arama terimi için AppStream bileşen havuzunda arama yapın.
Belirli bir öğeyi sağlayan bileşenleri döndürür. TYPE parametresi kullanılarak bir öğe türü belirtilebilir, aranacak değerin TERM parametresi kullanılarak sağlanması gerekir.
Örnekler:
"text/xml" ortam türünü işleyen bileşenleri alın.
appstreamcli what-provides mediatype "text/xml"
"libfoo.so.2" kitaplığını sağlayan bileşeni edinin.
appstreamcli what-provides lib libfoo.so.2
Gerekirse bir veritabanı yenilemesini tetikleyin. Veritabanını yeniden oluşturmaya zorlamak isterseniz, --force bayrağını sağlayın.
Bu komut root izni ile çalıştırılmalıdır.
Yüklü meta veriler ve meta veri önbelleği hakkında çeşitli bilgileri görüntüleyin.
Geçerli işletim sistemi hakkındaki bilgileri meta veri dizininden gösterin. Bu, işletim sisteminin kendisi için bir işletim sistemi bileşeni sağlamasını gerektirir.
Meta veri havuzunda bulunan, verilen kimliğe sahip bileşenlerin eksiksiz XML açıklamalarını boşaltın.
Spesifikasyonla uyumluluk için AppStream XML meta verilerini doğrulayın.
Her iki XML meta veri türü, yukarı akış ve dağıtım XML'si işlenir. Doğrulanması gereken format tipi otomatik olarak belirlenir.
--pedantic bayrağı, rapordaki küçük sorunlar ve stil sorunları da dahil olmak üzere dosyanın daha bilgiççe doğrulanmasını tetikler.
Bir dosya ağacında bulunan AppStream XML meta verilerini doğrulayın.
Bu, bulunan tüm meta verilerin standart bir doğrulamasını gerçekleştirir, ancak .desktop dosyalarının varlığı ve diğer ek meta verilerin geçerliliği gibi ek hataları da kontrol eder.
Bir lisans dizisini veya lisans ifadesini geçerlilik açısından test edin ve bununla ilgili ayrıntıları görüntüleyin.
Bu, lisans dizisinin AppStream için geçerli olup olmadığını kontrol edecek ve geçerli değilse sıfır olmayan bir çıkış kodu döndürecektir. Komut ayrıca, bir lisansın standart kimliği, AppStream meta verileri için lisans olarak uygun olup olmadığı ve lisansın Özgür ve Açık Kaynak yazılım veya tescilli yazılım için kabul edilip edilmediği gibi yararlı bilgileri de görüntüler.
AppStream, Özgür Yazılım Vakfı (FSF), Açık Kaynak Girişimi (OSI) veya Debian Özgür Yazılım Yönergelerinin (DFSG) açık lisans listesi tarafından uygun olarak işaretlenen tüm lisansları Ücretsiz ve Açık Kaynak olarak kabul edecektir.
Paket yöneticisini veya Flatpak'ı kullanarak kimliğine göre bir yazılım bileşeni kurun.
Bu, AppStream bileşen kimliğini bir kurulum adayına çözümler ve ardından bileşeni yüklemek için yerel paket yöneticisini veya Flatpak'ı (varsa) çağırır.
Paket yöneticisini veya Flatpak'ı kullanarak bir yazılım bileşenini kimliğine göre kaldırın.
Bu, yerel paket yöneticisini veya Flatpak'ı (varsa) kullanarak seçilen kimlikle eşleşen yazılımı kaldıracaktır.
Geçerli makinede doğru dizine bir meta veri dosyası yükleyin.
İki sürüm numarasını karşılaştırın. Parametre olarak iki sürüm numarası verilirse sürümler karşılaştırılacak ve karşılaştırma sonucu stdout'a yazdırılacaktır.
Parametre olarak bir sürüm numarası, bir karşılaştırma işleci ve başka bir sürüm numarası geçirilirse, karşılaştırma işleminin sonucu stdout'a yazdırılır ve herhangi bir durumda appstreamcli sıfırdan farklı bir çıkış durumuyla çıkar. karşılaştırma başarısız oldu. Karşılaştırma operatörü aşağıdakilerden biri olabilir:
Eşittir
Eşit değil
Daha az
daha büyük
küçük veya eşit
büyük veya eşittir
Yazılım projeleri tarafından kullanılacak bir meta bilgi dosyası şablonu oluşturun. Örnek dosyayı oluşturmak için bir .desktop dosyasını şablon olarak kullanmak üzere --from-desktop seçeneği kullanılabilir.
Oluşturulan dosyalar, proje yazarı tarafından gerçek istenen değerlerle dosyalanması gereken örnek girişler içerir.
İlk TYPE parametresi, bir AppStream bileşen türünün adıdır. Eksiksiz bir liste için belgelere[2] veya bu alt komutun appstreamcli yardım çıktısına bakın.
Bir meta bilgi dosyasından bir XDG masaüstü giriş dosyası oluşturun. DESKTOP_FILE içinde belirtilen masaüstü giriş dosyası zaten varsa, metainfo dosyasından çıkarılan yeni bilgilerle genişletilecektir. Aksi takdirde yeni bir dosya oluşturulur.
Bu komut, yeni masaüstü giriş dosyasının Exec= alanı için bileşenin sağlama etiketinde belirtilen ilk ikiliyi kullanacaktır. İstenen davranış bu değilse, başlatılacak bir ikiliyi açıkça tanımlamak için --exec bayrağı kullanılabilir. Uygulamayı başlatmanın diğer yöntemleri şu anda desteklenmemektedir.
Uygun bir masaüstü girdisi oluşturmak için bu komut, yalnızca bir AppStream bileşeni için minimum düzeyde gerekli etiketlerin ayarlandığını değil, aynı zamanda, uygulamanın yerleştirilmesi gereken kategorileri içeren bir
Bu komut, birçok açık kaynak projesi tarafından kullanılan bir NEWS dosyasını AppStream tarafından kullanılan XML'e dönüştürür. HABER dosyaları serbest metin olduğundan, makul sonuçlar elde etmek için birçok buluşsal yöntem uygulanacaktır. Dönüştürücü, AppStream sürüm açıklamasının YAML sürümünü de okuyabilir ve XML'e de dönüştürebilir. MI_FILE meta bilgi dosyası zaten varsa, yeni sürüm girişleriyle artırılacaktır, aksi takdirde yayın girişleri herhangi bir kaydırma bileşeni olmadan yazılacaktır. [OUT_FILE] belirtilirse, MI_FILE üzerinde işlem yapmak yerine değiştirilen veriler ilgili dosyaya yazılır. Çıktı dosya adlarından herhangi biri "-" olarak ayarlanırsa, çıktı bunun yerine stdout'a yazılır.
--format seçeneği, biçim otomatik algılamanın başarısız olması durumunda girdi dosyasını belirli bir biçimde ("metin" veya "yaml") okumaya zorlamak için kullanılabilir. --limit seçeneği, yazılan sürüm girişlerinin miktarını sınırlamak için kullanılır (en yeni girişler her zaman ilk olacaktır).
Bu komut news-to-metainfo komutunu tersine çevirir ve bir NEWS dosyasını bir metainfo dosyasında bulunan XML'i kullanarak metin veya YAML olarak yazar. NEWS_FILE "-" olarak ayarlanırsa, elde edilen veriler bir dosya yerine stdout'a yazılır.
--format seçeneği, çıktı biçimini ("yaml" veya "metin") açıkça belirtmek için kullanılabilir. Ayarlanmamışsa, appstreamcli hangi biçimin en uygun olduğunu tahmin edecektir.
AppStream XML meta verilerini YAML temsiline dönüştürür ve bunun tersi de geçerlidir.
Meta bilgi dosyaları içeren bir dizin ağacından bir AppStream meta veri kataloğu oluşturur. Bu komut yalnızca org.freedesktop.appstream.compose bileşeni yüklüyse kullanılabilir. Daha fazla bilgi için appstreamcli-compose(1) konusuna bakın.
Bulunan bir bileşen hakkında daha fazla bilgi yazdırın.
Renkli çıktı yazdırmayın.
Meta verileri doğrularken ağa erişmeyin.
Aynı etki, appstreamcli çalıştırılmadan önce AS_VALIDATE_NONET ortam değişkeni ayarlanarak elde edilebilir.
Appstreamcli'nin sürüm numarasını göster
pkcon(1).
Bu kılavuz sayfası Matthias Klumpp
Telif Hakkı © 2012-2022 Matthias Klumpp
1. Freedesktop.org: https://www.freedesktop.org/wiki/Distributions/AppStream/
2. Belgeler: https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html