Philip Withnall
philip@tecnocode.co.uk
Will Thompson
wjt@endlessos.org
Milan Crha
mcrha@redhat.com
Ako Softvér používa metadáta

# Metadáta softvéru

# Snímky obrazovky

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`:

Náhradná ikona sa môže líšiť, ak používate vlastnú tému ikon.

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:

Ako pridať chýbajúce snímky obrazovky aplikácie

# Kontextová lišta 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.

Úložisko

Bezpečnosť

Podpora hardvéru

Vekové hodnotenie

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.

# Úložisko

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ť.

# Bezpečnosť

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:

Ako opraviť nesprávne informácie o bezpečnosti a oprávneniach

# Podpora hardvéru

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ší.

Či je prítomný alebo potrebný touchpad, myš alebo klávesnica

Či je potrebný herný ovládač

Minimálna a odporúčaná veľkosť displeja, na ktorú sa aplikácia dokáže škálovať

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:

Ako pridať chýbajúce informácie o hardvéri

# Vekové hodnotenie

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í:

Ako pridať chýbajúce informácie o hodnotení obsahu

# Licencia

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:

Ako opraviť nesprávne informácie o licenciách

# Odkazy

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

| Odkaz na webovú stránku
| Odkaz na darovanie
| Odkaz na príspevok do prekladu
| Odkaz na hlásenie chýb
| Odkaz na pomoc
| Odkaz na kontakt

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:

Ako pridať chýbajúce odkazy

# Pole odporúčaných aplikácií

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í:

Ako nastaviť farbu pozadia v poli odporúčaných aplikácií

# Odkiaľ pochádzajú metadáta

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.

appdata je starší výraz pre metainfo.

# Čo sa stane, ak chýbajú metadáta

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!

# Ako prispieť chýbajúce informácie

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:

Môžete nahlásiť chýbajúce / nesprávne metadáta do príslušného sledovača chýb aplikácie, aby ich vývojár aplikácie mohol opraviť.

Môžete opraviť chýbajúce / nesprávne metadáta sami. Pozrite si sprievodcu Ako na to nižšie, ako to urobiť.

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.

# Ako pridať chýbajúce snímky obrazovky aplikácie

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>

# Ako opraviť nesprávne informácie o bezpečnosti a oprávneniach

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:

# Ako pridať chýbajúce informácie o hardvéri

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.

# Ako pridať chýbajúce informácie o hodnotení obsahu

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.

# Ako opraviť nesprávne informácie o licenciách

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:

Neumiestňujte (všeobecne) licenciu dokumentácie do appdata

# Ako pridať chýbajúce odkazy

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>

# Ako nastaviť farbu pozadia v poli odporúčaných aplikácií

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>

Poznámka: atribút `scheme_preference` sa ignoruje, Softvér si vyberie lepšiu farbu pre tému sám.

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:

nejakým spôsobom identifikovali aplikáciu a, ak je to možné, zodpovedali jej brandingu.

boli v kontraste s okrajom ikony aplikácie, aby sa pri použití ako pozadia za ňou dala ikona ľahko rozoznať.

kontrastovala s farbou textu popredia v téme Adwaita (`#2e3436`) a v jej tmavej verzii (`#eeeeec`). Toto zvyčajne znamená výber farby so strednou úrovňou jasu.

Kontrast sa môže skontrolovať pomocou aplikácie Contrast.

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ť.

# Ako otestovať zmeny farby v poli odporúčaných aplikácií

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“.