Metadáta softvéru

Softvér zobrazuje snímky obrazovky na podrobnej stránke aplikácie. Toto by typicky malo zahŕňať snímky rôznych okien / dialógových okien aplikácie, aby si používateľ rýchlo osvojil funkcie, vzhľad a správanie aplikácie atď.

Keď je v súbore metainfo aplikácie prítomných viac ako jedna snímka obrazovky, Softvér zobrazí snímky sériu snímok.

V prípadoch, keď súbor metainfo aplikácie neobsahuje žiadnu snímku obrazovky, zobrazí sa náhradná ikona ako nižšie s Žiadne snímky obrazovky:

Snímky obrazovky môžu zastarať v dôsledku zmien používateľského rozhrania aplikácie. Preto, aj keď Softvér zobrazuje snímky aplikácie, je dôležité skontrolovať, či tieto snímky obrazovky ešte platia alebo sú už neaktuálne.

Môžete vylepšiť informácie o snímkach obrazovky aplikácie:

Kontextová lišta aplikácie v Softvéri je zbierka dlaždíc na podrobnej stránke aplikácie, ktoré zobrazujú nasledujúce podrobnosti.

Toto zobrazuje kontextovú lištu aplikácie pre aplikáciu Softvér:

Dlaždice sa zobrazujú v poradí uvedenom vyššie (začínajúc dlaždicou Úložisko zľava).

Každá dlaždica je podrobne popísaná nižšie.

Softvér zobrazuje dlaždicu úložiska na podrobnej stránke aplikácie. Ak nie je aplikácia nainštalovaná, zobrazí sa odhadovaná veľkosť sťahovania potrebná na jej inštaláciu. Ak je aplikácia nainštalovaná, zobrazuje sa úložný priestor používaný aplikáciou.

Veľkosti sa vypočítavajú z údajov poskytnutých backendom Softvéru (napr. flatpak alebo RPM) a nie sú špecifikované v metadátach poskytnutých aplikáciou. Nie je možné ovplyvniť túto dlaždicu úpravou súboru metainfo aplikácie. Je tu uvedená pre úplnosť.

Softvér zobrazuje dlaždicu bezpečnosti na podrobnej stránke aplikácie. Toto zhrňuje informácie o tom, či je aplikácia považovaná za bezpečnú na inštaláciu a spustenie, alebo či môže byť potrebná opatrnosť pred tým, než jej začnete dôverovať.

Táto dlaždica kombinuje informácie o oprávneniach, ktoré aplikácia vyžaduje pri svojom spustení (napr. povolenie na čítanie vašich súborov), s informáciami o tom, ako bola aplikácia vyvinutá. Aplikácie slobodného softvéru, kde je zdrojový kód verejne čitateľný, môžu byť bezpečnejšie než proprietárne, pretože ich možno auditovať.

Dialógové okno, ktoré sa objaví po kliknutí na dlaždicu, uvádza rôzne oprávnenia, ktoré aplikácia vyžaduje, spolu s niektorými informáciami o jej licencii a runtime.

Môžete vylepšiť informácie o bezpečnosti:

Softvér zobrazuje dlaždicu podpory hardvéru na podrobnej stránke aplikácie. Toto kombinuje informácie o hardvérových požiadavkách aplikácie a hardvérových možnostiach počítača s cieľom zvýrazniť nekompatibility alebo chýbajúce požiadavky — alebo naznačiť, že by mala aplikácia fungovať správne bez akýchkoľvek nekompatibilít.

Kód sa pozerá na nasledujúci hardvér. V budúcnosti môže byť podporovaný aj ďalší.

Nemožno spoľahlivo zistiť, či je herný ovládač prítomný, pretože sa často nechávajú odpojené, keďže nie sú potrebné pre bežné používanie počítača.

Dialógové okno, ktoré sa objaví po kliknutí na dlaždicu, uvádza rôzne hardvérové požiadavky aplikácie a či sú niektoré z nich nesplnené.

Môžete vylepšiť informácie o hardvéri:

Softvér zobrazuje dlaždicu vekového hodnotenia na podrobnej stránke aplikácie. Toto ukazuje, pre akú vekovú kategóriu by mala byť aplikácia vhodná, na základe rôznych druhov obsahu, ktoré aplikácia vyhlásila, že obsahuje. Tieto informácie sú zhrnuté vo formáte podobnom certifikátom hodnotenia hier alebo filmov vo vašej krajine.

Napríklad to zdôrazní, či hra obsahuje násilie alebo či zobrazuje reklamu priamo v aplikácii.

Dialógové okno, ktoré sa objaví po kliknutí na dlaždicu, uvádza rôzne typy obsahu v aplikácii a ako závažný je tento obsah.

Môžete vylepšiť informácie o vekovom hodnotení:

Softvér zobrazuje dlaždicu, ktorá naznačuje, či je aplikácia slobodným softvérom, alebo či je jej licencia proprietárna, špeciálna alebo neznáma. Táto dlaždica obsahuje podrobnejšie informácie o licencii projektu. Táto dlaždica tiež uvádza niektoré výhody slobodného softvéru. Zistiť viac

Niekedy nie sú informácie o licencii pre aplikáciu správne, a preto sa aplikácia, ktorá je v skutočnosti slobodným softvérom, zobrazí ako „proprietárna“. Podobne niekedy sú informácie o licenciách neznáme.

Softvér zvýrazňuje slobodné a otvorené licencie zelenou farbou, proprietárne a špeciálne licencie žltou farbou, ako je znázornené tu. Neznáme licencie sú zvýraznené sivou farbou.

Môžete pridať alebo vylepšiť informácie o licenciách:

Softvér zobrazuje zoznam odkazov na zdroje aplikácie v dlaždici odkazov. Sú nasledujúce:

Niektoré alebo všetky tieto odkazy môžu byť prítomné v závislosti od toho, či sú uvedené v súbore metainfo aplikácie.

V prípadoch, keď súbor metainfo aplikácie neobsahuje žiadny odkaz, zobrazí sa nasledujúca dlaždica s otáznikom.

Môžete vylepšiť odkazy:

Aplikácie, ktoré sú odporúčané Softvérom, sú zobrazené v slede polí na vrchu hlavného okna, ako je znázornené tu. Každé pole používa farbu pozadia, ktorá je automaticky extrahované z ikony aplikácie. Niekedy toto farebné pozadie nie je pre aplikáciu úplne vhodné a musí byť explicitne špecifikované vývojárom aplikácie.

O sade aplikácii, ktoré sú prezentované, rozhodujú správci Linuxovej distribúcie.

Môžete vylepšiť pole odporúčaných aplikácií:

Metadáta používané na špecifikáciu hardvéru, ktorý softvér vyžaduje, vekových kategórií používateľov, pre ktoré je vhodný, a faktorov prispievajúcich k tomu, ako bezpečné môže byť jeho inštalovanie, všetky pochádzajú zo súboru metainfo pre tento softvér.

Súbor metainfo je súbor XML. Jeho formát súboru je špecifikovaný v špecifikácii AppStream.

Pozri súbor metainfo pre aplikáciu Súbory GNOME.

Ak pre aplikáciu chýbajú niektoré metadáta, Softvér môže len hádať, čo to môže byť, a preto nemôže v svojich rozhraniach prezentovať veľa informácií. Odhady, ktoré Softvér robí, sú založené na skutočnosti, že väčšina softvéru je navrhnutá pre stolné počítače.

Môžete pomôcť vylepšiť metadáta pre aplikáciu!

Ak zistíte, že stránka aplikácie obsahuje chýbajúce informácie alebo má nesprávne informácie, môžete prispieť jedným z týchto dvoch spôsobov:

Pre oboje musíte najprv nájsť stránku projektu aplikácie. Odkaz na stránku projektu by mal byť typicky dostupný na stránke aplikácie ako je znázornené tu. Ak nie, budete ho musieť nájsť pomocou jednoduchého hľadania na Google.

Aplikácie sú typicky hostované v GitLabe alebo GitHube. Napríklad aplikácie GNOME sú hostované na gitlab.gnome.org.

Informácie o snímkach obrazovky pre aplikáciu sú uložené v prvku <screenshots> v rámci <component> aplikácie v jej súbore metainfo.

Odporúčaný počet snímok obrazovky pre aplikáciu je medzi 5 až 10. Snímky obrazovky by mali byť ideálne vo formáte PNG s pomerom strán 16:9 a minimálnou šírkou 620 pixelov.

Napríklad tu sú záznamy snímok obrazovky pre aplikáciu Softvér:

<screenshots>
  <screenshot type="default">
    <image>https://gitlab.gnome.org/GNOME/gnome-software/raw/HEAD/data/metainfo/ss-overview.png</image>
    <caption>Overview panel</caption>
  </screenshot>
  <screenshot>
    <image>https://gitlab.gnome.org/GNOME/gnome-software/raw/HEAD/data/metainfo/ss-details.png</image>
    <caption>Details panel</caption>
  </screenshot>
</screenshots>

Informácie o bezpečnosti a oprávneniach pre aplikáciu pochádzajú z rôznych zdrojov v závislosti od toho, ako je aplikácia zabalená. Pre tradične balené aplikácie, napríklad vo formáte RPM alebo DEB, nie sú k dispozícii žiadne informácie o bezpečnosti ani oprávneniach a nič sa nedá urobiť na ich pridanie k aplikácii.

Pre aplikácie flatpak pochádzajú informácie z manifestu flatpak aplikácie, ktorý špecifikuje, aké diery v pieskovisku aplikácia vyžaduje. Každá z týchto dier typicky prispieva k zníženiu zobrazovanej úrovne bezpečnosti aplikácie v Softvéri — posúvaním od „bezpečnej“ na „potenciálne nebezpečnú“ až po „nebezpečnú“.

Aby sa zlepšila úroveň bezpečnosti aplikácie, jej izolácia musí byť čo najprísnejšia odstránením oprávnení sandboxu, kde nie sú potrebné a použitím portálov namiesto oprávnení sandboxu, kde je to možné. Používanie portálov neznižuje zobrazovanú úroveň bezpečnosti aplikácie v Softvéri.

Napríklad, ak aplikácia vyžaduje prístup na čítanie/zápis k celému súborovému systému (--filesystem=host), potrebuje to naozaj, alebo stačí prístup k súborom v niekoľkých konkrétnych lokalitách? Ak áno, mohol by sa použiť súborový portál, alebo by mohli byť špecifikované konkrétnejšie oprávnenia súborového systému.

Ak aplikácia funguje na Waylande a potrebuje iba pracovať na X11 ako náhrada bez použitia špeciálnych funkcií X11, mohla by použiť --socket=fallback-x11 namiesto --socket=x11?

Sprievodné informácie o konkrétnych oprávneniach alebo iných formátoch balenia sem môžu v budúcnosti pribudnúť.

Ďalšie čítanie:

Informácie o hardvéri pre aplikáciu sú uložené v prvkoch <requires>, <recommends> a <supports> v rámci <component> aplikácie v jej súbore metainfo.

Softvér rozumie prvkom <control> a <display_length>.

Pozri tento blogový príspevok alebo tento blogový príspevok s príkladmi metadát.

Informácie o hodnotení obsahu pre aplikáciu sú uložené v prvku <content_rating> v rámci <component> aplikácie v jej súbore metainfo.

Aplikácie by mali použiť štandard OARS 1.1 na vyplnenie tohto prvku. Ak nie je špecifikovaný prvok <content_rating>, hodnotenie obsahu aplikácie je neznáme. Ak je špecifikované, ale prázdne, aplikácia nemá žiadny obsah, ktorý by mohol byť nevhodný pre akúkoľvek cieľovú skupinu.

Použite generátor OARS na vytvorenie vhodných informácií o hodnotení obsahu pre aplikáciu.

Informácie o licenciách pre aplikáciu sú uložené v prvku <project_license> v rámci <component> aplikácie v jej súbore metainfo.

Obsah tohto prvku by malo byť výrazom SPDX, ktorý opisuje „hlavnú“ licenciu projektu. Toto by typicky mal byť licenciou kódu a nemalo by zahŕňať licenciu dokumentácie alebo vedľajšieho obsahu.

Ak je výraz SPDX jednou licenciou alebo kombináciou viacerých licencií „alebo“, ktoré sú všetky schválené FSF alebo OSI, aplikácia sa považuje za „slobodný softvér“ a dlaždica licencie to hovorí. Inak sa považuje za „proprietárny“.

Ak sa aplikácia zobrazuje ako „proprietárna“, keď si myslíte, že by nemala byť, je pravdepodobné, že prvok <project_license> zahŕňa licenciu dokumentácie projektu. Odstráňte ju.

Napríklad zmeňte metadáta licencie z:

<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>

na

<project_license>GPL-2.0+</project_license>

Ďalšie čítanie:

Odkazy pre aplikáciu sú uložené ako prvky <url> v rámci <component> aplikácie v jej súbore metainfo.

Pridajte toľko typov odkazov dokumentovaných v špecifikácii appstream, koľko je pre aplikáciu dostupných. Ak pre daný typ odkazu neexistuje vhodná stránka, nemusí byť zahrnutá.

Napríklad tu sú odkazy na zdroje pre aplikáciu Softvér:

<url type="bugtracker">https://gitlab.gnome.org/GNOME/gnome-software/-/issues</url>
<url type="contact">https://discourse.gnome.org/tag/gnome-software</url>
<url type="contribute">https://welcome.gnome.org/app/Software/</url>
<url type="donation">https://www.gnome.org/donate/</url>
<url type="homepage">https://apps.gnome.org/Software</url>
<url type="translate">https://l10n.gnome.org/module/gnome-software/</url>
<url type="vcs-browser">https://gitlab.gnome.org/GNOME/gnome-software/</url>

Farba pozadia v poli odporúčaných aplikácií sa zvyčajne automaticky extrahuje z ikony aplikácie. Ak je však táto farba nevyhovujúca, môžete ju prepísať použitím prvku appstream <branding/> s vyhlásenými farbami (od verzie 47.x). Výhodou je, že toeto farby môže použiť viac klientov.

Napríklad tu sú niektoré záznamy značenia:

<branding>
  <color type="primary" scheme_preference="light">#ff00ff</color>
  <color type="primary" scheme_preference="dark">#993d3d</color>
</branding>

Pre spätnú kompatibilitu zostáva možnosť pridať nasledujúci XML do prvku <component> metainfo aplikácie:

<custom>
  <value key="GnomeSoftware::key-colors">[(124, 53, 77), (99, 16, 0)]</value>
</custom>

ale prvok <branding/> má prednosť.

Hodnota GnomeSoftware::key-colors je textový formát GVariant s typom a(yyy) a predstavuje neusporiadanú sadu kľúčových farieb pre aplikáciu. Každý prvok sady je farba v tvare RGB od (0, 0, 0) až po (255, 255, 255).

Farby by mali byť vybrané tak, aby:

Mala by byť špecifikovaná aspoň jedna farba. Ak jedna farba nemôže spĺňať všetky vyššie uvedené požiadavky, môže byť špecifikovaných viac a Softvér si vyberie tú najvhodnejšiu na použitie v dlaždici karuselu. Ak je špecifikovaná presne jedna farba, jej jas a sýtosť sa môžu upraviť pre zlepšenie kontrastu s farbou popredia. Ak je špecifikovaných viac ako jedna farba, vyberie sa tá s najlepším kontrastom s farbou popredia a jej jas a sýtosť sa nebudú upravovať.

Upravte súbor metainfo pre vašu aplikáciu a potom spustite Softvér pomocou:

gnome-software --show-metainfo=/cesta/k/aplikácii.metainfo.xml,icon=/cesta/k/ikone/aplikácie.png

Zobrazí sa podrobná stránka vašej aplikácie. Ak sa vrátite na prehľadovú stránku Softvéru, vaša aplikácia bude jedinou v „odporúčaných aplikáciach“.