Software-metadatuak

Softwareak aplikazioen xehetasun-orrietan erakusten ditu pantaila-argazkiak. Gehienetan aplikazioaren leiho eta elkarrizketa-koadroen pantaila-argazkiak dira, erabiltzaileak aplikazioaren eginbideen, itxuraren eta beste antzeko kontu batzuen ikuspegi azkarra eduki dezan.

Aplikazioaren metainformazio-fitxategian pantaila-argazki bat baino gehiago badago, Softwareak ikuspegi birakari gisa erakutsiko ditu.

Aplikazioaren metainformazio-fitxategiak ez duenean pantaila-argazkirk, leku-marka gisa funtzionatzen duen ikono bat bistaratuko da, Pantaila-argazkirik ezdioena:

Pantaila-argazkiak zaharkituta geratu daitezke aplikazioak interfazea aldatzen badu. Beraz, Softwareak aplikazio baten pantaila-argazkiak erakutsi arren, beti egiaztatu behar da pantaila-argazki horiek eguneratuta dauden.

Pantaila-argazkiaren informazioa hobetzeko:

Aplikazioen testuinguru-barra, Softwarean, aplikazio bakoitzaren xehetasun-orrian erakusten diren lauzen bilduma bat da. Honako xehetasunak erakusten ditu:

Honek Softwarea aplikazioaren testuinguru-barra erakusten du:

Lauzak goian zerrendatutako ordenan bistaratzen dira (ezkerretik hasita, lehenengo Tamaina).

Lauza bakoitza xeheago azaltzen da behean.

Softwareak tamaina erakusten du lauza batean, aplikazioen xehetasunen orrian. Aplikazioa ez badago instalatuta, hura instalatzeko gutxi gorabehera zein tamainako fitxategia deskargatu behar den erakusten du. Aplikazioa instalatuta badago, hurak erabiltzen duen biltegiratze-espazioa erakusten du.

Tamainak kalkulatzeko, Softwarea aplikazioaren motorrak (adibidez flatpak edo RPM) ematen dituen datuak erabiltzeko dira, eta ez daude zehaztuta aplikazioak eskainitako metadatuetan. Ezin da ezer egin lauza hori moldatzeko, ezta aplikazioaren metainformazio-fitxategia aldatu ere.

Softwareak segurtasuna erakusten du lauza batean, aplikazioen xehetasunen orrian. Aplikazioa instalatzeko eta exekutatzeko segurua den ala kontuz aritu behar den adierazten da lauza horretan.

Lauza horrek aplikazioak exekutatzeko eskatzen dituen baimenei buruzko informazioa ematen da (adibidez, fitxategiak irakurtzeko baimena). Horrez gain, aplikazioa nola garatu den ere adierazten da. Software libreko aplikazioak, iturburu-kodea irakurgarria izanik, jabedun aplikazioak baino seguruagoak izan daitezke.

Lauzan klik egitean agertzen den elkarrizketa-koadroan aplikazioak eskatu dituen baimenak zerrendatzen dira, gehi bere lizentziari eta exekuzio-denborari buruzko informazioa.

Segurtasun-informazioa hobetzeko:

Softwareak hardware-euskarriaren informazioa erakusten du lauza batean, aplikazioen xehetasunen orrian. Aplikazioak dituen hardware-eskakizunei buruzko informazioa eta ordenagailuaren hardware-kapazitateei buruzkoa ematen da bertan, horrela bateraezintasunak edo falta diren eskakizunak nabarmen geratu daitezen - edo aplikazioak bateraezintasunik gabe eta ongi funtzionatuko duela adierazteko.

Kodeak ondoren adierazitako hardwarea begiratzen du. Etorkizunean informazio gehiago emango da.

Ezin da joko-aginte bat badagoela modu fidagarrian detektatu, sarritan deskonektatuta uzten baita, normalean ez baita beharrezkoa ordenagailua erabiltzeko.

Lauzan klik egitean agertzen den elkarrizketa-koadroan aplikazioak dituen hardware-eskakizunak zerrendatzen dira, eta haietako guztiak betetzen diren ala ez.

Hardware-informazioa hobetzeko:

Softwareak adinaren araberako balorazioaren informazioa erakusten du lauza batean, aplikazioen xehetasunen orrian. Aplikazioa zein adinetarako den egokia adierazten du horrek, aplikazioak berak daukala adierazi duen edukiaren arabera. Informazio hori zure herrialdean jokoak edo filmak baloratzeko erabiltzen den modu berean ematen da.

Adibidez, joko batek indarkeria duen ala ez nabarmenduko da, edo iragarkiak dituen ala ez.

Lauzan klik egitean agertzen den elkarrizketa-koadroan aplikazioak dituen eduki mota desberdinak zerrendatzen dira eta zein gogortasun-mailakoak diren.

Adinaren araberako balorazioa hobetzeko:

Softwareak aplikazio bat software librea den ala jabeduna, berezia edo ezezaguna den adierazten duen izenburu bat erakusten du. Izenburu horrek proiektuaren lizentziari buruzko informazio xehea eskaintzen du. Software librearen onuretako batzuk ere zerrendatzen ditu. Ikasi gehiago

Batzuetan lizentziaren informazioa ez da zuzena aplikazio baterako, eta software librea den aplikazioa bat jabedun gisa agertzen da. Beste batzuetan, gerta daiteke lizentziaren informazioa ezezaguna izatea.

Softwarea aplikazioak lizentzia libre eta kode irekikoak berdez margotzen ditu, jabedunak eta bereziak horiz. Lizentzia ezezagunak grisez nabarmenduta agertzen dira.

Lizentzia-informazioa hobetzeko:

Softwareak aplikazioaren baliabideen esteken zerrenda bat erakusten du esteen lauzan. Honakoak dirasof:

Esteka horietako batzuk soilik edo den-denak agertu daitezke, aplikazioaren metainformazio-fitxategian adierazitakoaren arabera.

Aplikazioaren metainformazio-fitxategiak ez badu inolako estekarik, galdera-ikurra duen lauza bat bistaratuko da.

Estekak hobetzeko:

Applications which are featured by Software are displayed in a carousel at the top of the main window as shown here. Each carousel tile has a background color which is automatically extracted from the application’s icon. Sometimes this background color is not quite right for the application and needs to be specified explicitly by the application developer.

Nabarmenduta ageri diren aplikazioen multzoa Linux banaketa bakoitzaren garatzaileek erabakitzen dute.

Ikuspegi birakariaren lauza hobetzeko:

Software batek zein harware behar duen, zein adinetarako den egokia, eta zein segurua den zehazteko erabiltzen diren metadatuak software horren metainformazio-fitxategian daude.

Metainformazioa XML fitxategi bat da. Bere fitxategi-formatua AppStream espezifikazioan dago zehaztuta.

Ikusi GNOME Fitxategiak aplikazioaren metainformazio-fitxategia.

Aplikazio batek ez baditu metadatuetako batzuk, Softwareak horiek asmatzen saiatu daiteke, baina ezin izango du informazio askorik eman bere interfazeetan. Softwareak ulertuko du software gehiena mahaigaineko ordenagailuetarako sortu dela.

Aplikazio baten metadatuak hobetzen lagundu dezakezu.

Aplikazio baten orrian informazioa falta dela edo informazioa okerra dela ikusten baduzu, honela lagundu dezakezu:

Bi kasuetan, lehenengo aplikazioaren proiektu-orria aurkitu behar duzu. Proiektu-orriaren esteka normalean aplikazioaren orrian agertuko da, hemen erakusten den moduan. Ez badago, bilatzaile baten bidez bilatu beharko duzu interneten.

Aplikazioak normalean GitLab edo GitHub gune batean daude. Adibidez, GNOMEren aplikazioak gitlab.gnome.org gunean daude.

Aplikazioen pantaila-argazkiak <screenshots> elementuan gordetzen dira, aplikazioaren metainformazio-fitxategiko <component> osagaian.

Aplikazioek 5 eta 10 pantaila-argazki artean eduki ditzaten gomendatzen dugu. Hobe da PNG formatua erabiltzea, 16:9 aspektu-erlazioa eta gutxienez 620 pixeleko zabalera.

Adibidez, hona hemen Softwarea aplikazioaren beraren pantaila-argazkiak:

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

The safety and permissions information for an application comes from different sources depending on how the application is packaged. For traditionally packaged applications, for example in RPM or DEB format, there is no safety or permissions information available and nothing can be done to add it to an application.

For flatpak applications, the information comes from the application’s flatpak manifest, specifying what holes in the sandbox the application requires. Each of these holes typically contributes to lowering the displayed safety level of the application in Software — moving it from ‘safe’ to ‘potentially unsafe’ to ‘unsafe’.

In order to improve the safety level of an application, its sandboxing must be made as tight as possible, by removing sandbox permissions where they’re not needed, and using portals instead of sandbox permissions where possible. Use of portals does not lower the displayed safety level of an application in Software.

For example, if the application requests read/write access to the full file system (--filesystem=host), does it actually need that, or does it only need to access files in a few specific locations? If so, the file portal could be used, or more specific file system permissions could be specified.

Aplikazioak Wayland ingurunean funtzionatzen badu eta X11 solik arazoak daudenean behar badu, eta X11 eginbide bereziak behar ez baditu, --socket=fallback-x11 erabili al dezake, --socket=x11 erabili ordez?

Baimen bereziei edo beste paketatze-formatu batzuei buruzko gidalerroak eman daitezke hemen etorkizunean.

Informazio gehiago:

The hardware information for an application is stored in the <requires>, <recommends> and <supports> elements within the application’s <component> in its metainfo file.

Software understands the <control> and <display_length> elements.

See this blog post or this blog post for examples of metadata.

The content rating information for an application is stored in the <content_rating> element within the application’s <component> in its metainfo file.

Applications should use the OARS 1.1 standard to fill in this element. If the <content_rating> element is not specified, the application’s content rating is unknown. If it’s specified but empty, the application has no content which might be unsuitable for any audience.

Erabili OARS sortzailea aplikazioaren balorazio-informazio egokia sortzeko.

Aplikazioen lizentzia-informazioa <project_license> elementuan gordetzen da, aplikazioaren metainformazio-fitxategiko <component> elementuan.

The content in this element should be an SPDX expression which describes the ‘main’ license for the project. This should typically be the license of the code, and not include the license of the documentation or ancillary content.

If the SPDX expression is a single license, or an ‘or’ combination of multiple licenses, which are all FSF or OSI approved, the application is considered ‘free software’ and the license tile says so. Otherwise, it’s considered ‘proprietary’.

If an application is being displayed as ‘proprietary’ when you think it shouldn’t be, it’s likely that the <project_license> element includes the documentation license for the project. Remove it.

Adibidez, aldatu hemengo lizentzia-metadatuak:

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

-

<project_license>GPL-2.0+</project_license>

Informazio gehiago:

Aplikazioen estekak <url> elementuan gordetzen da, aplikazioaren metainformazio-fitxategiko <component> elementuan.

Add as many of the link types documented in the appstream specification as are available for the application. If no suitable page exists for a given link type, it doesn’t have to be included.

Adibidez, hona hemen Softwarea aplikazioaren baliabide-estekak:

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

The carousel tile background color is normally extracted automatically from the application’s icon. If that color is unsatisfactory, however, it can be overridden by using the appstream’s <branding/> element with declared colors (since 47.x series). The advantage is that more clients can use the colors.

Adibidez, hona hemen marka ezartzeko sarrera batzuk:

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

There is left, for backward compatibility, the possibility to add the following XML to the application’s metainfo <component> element:

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

baina <branding/> elementuak lehentasuna du.

The value of GnomeSoftware::key-colors is a text-format GVariant with type a(yyy), and represents an unordered set of key colors for the application. Each element of the set is a color in RGB form ranging from (0, 0, 0) to (255, 255, 255).

Koloreak hautatzeko, kontuan izan:

At least one color should be specified. More can be specified if one color can’t satisfy all the requirements above, and Software will choose the most appropriate to use in the carousel tile. If exactly one color is specified, its brightness and saturation may be modified to improve contrast with the foreground color. If more than one color is specified, the one with the best contrast with the foreground color will be chosen, and its brightness and saturation will not be modified.

Aldatu zure aplikazioaren metainformazio-fitxategia eta, ondoren, exekutatu Softwarea aplikazioa honela:

gnome-software --show-metainfo=/path/to/app.metainfo.xml,icon=/path/to/app/icon.png

Zure aplikazioaren xehetasun-orria erakutsiko da. Softwareko ikuspegi orokorreko orrira itzultzen bazara, zure aplikazioa ikuspegi birakariko aplikazio 'nabarmendu' bakarra izango da.