Philip Withnall
philip@tecnocode.co.uk
Will Thompson
wjt@endlessos.org
Milan Crha
mcrha@redhat.com
Com utilitza el Programari les metadades

# Metadades del Programari

# Captures de pantalla

El Programari mostra les captures de pantalla a la pàgina de detalls d'una aplicació. Això normalment hauria d'incloure captures de pantalla de diverses finestres i diàlegs de l'aplicació, de manera que l'usuari tingui una comprensió ràpida de les característiques de l'aplicació, l'aspecte i el comportament, etc.

Quan hi hagi més d'una captura de pantalla al fitxer metainfo de l'aplicació, el Programari mostrarà les captures de pantalla en un carrusel.

En els casos en què el fitxer metainfo de l'aplicació no contingui cap captura de pantalla, es mostrarà una icona de marcador de posició com el següent amb el missatge `Sense captures de pantalla`:

La icona de marcador de posició podria ser diferent si utilitzeu un tema d'icones personalitzat.

Les captures de pantalla poden quedar obsoletes a mesura que canvia la interfície d'usuari de l'aplicació. Per tant, fins i tot si el Programari mostra captures de pantalla per a una aplicació, és important comprovar si aquestes captures de pantalla estan actualitzades o obsoletes.

Podeu millorar la informació de les captures de pantalla de l'aplicació:

Com afegir captures de pantalla de l'aplicació que falten

# Barra de context de l'aplicació

La barra de context de l'aplicació Programari és una col·lecció de fitxes a la pàgina de detalls d'una aplicació, que mostra els següents detalls.

Emmagatzematge

Seguretat

Suport per al maquinari

Valoració de l'edat

Això mostra la barra de context de l'aplicació Programari:

Les fitxes es mostren en l'ordre que s'indica a dalt (començant amb `Emmagatzematge` fitxa a l'esquerra).

A continuació, es cobreix amb detall cada fitxa.

# Emmagatzematge

El Programari mostra una fitxa d'emmagatzematge a la pàgina de detalls d'una aplicació. Si l'aplicació no està instal·lada, es mostrarà la mida de baixada estimada necessària per instal·lar-la. Si l'aplicació està instal·lada, mostra l'espai d'emmagatzematge utilitzat per l'aplicació.

Les mides es calculen a partir de les dades proporcionades pel rerefons del Programari (com flatpak o un RPM), i no s'especifiquen a les metadades proporcionades per l'aplicació. No hi ha res que pugueu fer per afectar aquesta fitxa editant el fitxer «metainfo» d'una aplicació. S'enumera aquí per a la seva integritat.

# Seguretat

El Programari mostra una fitxa de seguretat a la pàgina de detalls d'una aplicació. Això resumeix la informació sobre si l'aplicació es pot considerar segura per instal·lar i executar, o si es pot requerir precaució abans de confiar en ella.

Aquesta fitxa combina informació sobre els permisos que demana l'aplicació quan s'executa (com ara permís per llegir els vostres fitxers), amb informació sobre com s'ha desenvolupat l'aplicació. Les aplicacions de programari lliure, on el codi font és llegible públicament, poden ser més segures que les privatives, ja que poden ser auditades.

El diàleg que apareix quan es fa clic a la fitxa llista els diferents permisos que sol·licita l'aplicació, a més d'alguna informació sobre la seva llicència i temps d'execució.

Podeu millorar la informació de seguretat:

Com corregir la informació incorrecta de seguretat i permisos

# Suport per al maquinari

El Programari mostra una fitxa de suport de maquinari a la pàgina de detalls d'una aplicació. Això combina informació sobre els requisits de maquinari de l'aplicació, i les capacitats de maquinari de l'ordinador, amb l'objectiu de ressaltar les incompatibilitats o els requisits que falten; o per indicar que l'aplicació ha de funcionar correctament sense incompatibilitats.

El codi mira el maquinari següent. En el futur es podrà donar més suport.

Si requereix de ratolí tàctil, ratolí o teclat

Si es necessita un teclat de joc

La mida mínima i recomanada de visualització a la que l'aplicació pot escalar

No és possible detectar de manera fiable si un comandament de joc és present, ja que sovint es deixen desconnectats a causa de no ser necessaris per a l'ús normal de l'ordinador.

El diàleg que apareix quan es fa clic a la fitxa llista els diferents requisits de maquinari de l'aplicació, i si no es compleix algun d'ells.

Podeu millorar la informació del maquinari:

Com afegir la informació que falta del maquinari

# Valoració de l'edat

El Programari mostra una fitxa de qualificació d'edat a la pàgina de detalls d'una aplicació. Això mostra per a quin rang d'edat ha de ser adequada l'aplicació, en funció de diferents tipus de contingut que l'aplicació ha declarat que conté. Aquesta informació es resumeix en un format similar als certificats de qualificació de jocs o pel·lícules al vostre país.

Per exemple, això ressaltarà si un joc conté violència, o si una aplicació conté publicitat a l'aplicació.

El diàleg que apareix quan es fa clic a la fitxa llista els diferents tipus de contingut de l'aplicació i el nivell d'aquest contingut.

Podeu millorar la informació de la qualificació d'edat:

Com afegir la informació de valoració de l'edat del contingut que manca

# Llicència

El Programari mostra una fitxa que indica si una aplicació és programari lliure o si la seva llicència és privativa, especial o desconeguda. Aquesta fitxa inclou informació més detallada sobre la llicència del projecte. Aquesta fitxa també enumera alguns dels beneficis del programari lliure. Més informació

De vegades la informació de la llicència no és correcta per a una aplicació, i per tant una aplicació que és en realitat programari lliure es mostrarà com a «privativa». De la mateixa manera, de vegades la informació de la llicència és desconeguda.

El Programari destaca les llicències lliures i de codi obert en verd, les llicències privatives i especials en groc, com es mostra aquí. Les llicències desconegudes es destaquen en gris.

Podeu afegir o millorar la informació de la llicència:

Com corregir la informació incorrecta de les llicències

# Enllaços

El Programari mostra una llista d'enllaços de recursos d'aplicacions a la fitxa d'enllaços. Són les següents:

| Enllaç al lloc web
| Enllaç de donació
| Enllaç de contribucions de traducció
| Enllaç d'informe d'error
| Enllaç d'ajuda
| Enllaç de contacte

Alguns o tots aquests enllaços poden estar presents en funció de si estan llistats en el fitxer metainfo de l'aplicació.

En els casos en què el fitxer metainfo de l'aplicació no contingui cap enllaç, es mostrarà la següent fitxa amb un signe d'interrogació.

Podeu millorar els enllaços:

Com afegir enllaços que falten

# Tessel·la de carrusel

Les aplicacions que apareixen destacades al Programari es mostren en un carrusel a la part superior de la finestra principal, com es mostra aquí. Cada tessel·la del carrusel té un color de fons que s'extreu automàticament de la icona de l'aplicació. De vegades aquest color de fons no és del tot correcte per a l'aplicació i ha de ser especificat explícitament pel desenvolupador de l'aplicació.

El conjunt d'aplicacions que apareixen és decidit pels mantenidors de la distribució Linux.

Podeu millorar la tessel·la de carrusel:

Com establir el color de fons de la tessel·la del carrusel

# D'on venen les metadades

Les metadades utilitzades per especificar quin maquinari requereix una peça de programari, per a quines edats d'usuari és adequat, i els factors que contribueixen a la seguretat en la instal·lació, tots provenen del fitxer metainfo per a aquest programari.

El fitxer metainfo és un fitxer XML. El seu format de fitxer s'explica a l'especificació de l'AppStream.

Vegeu el fitxer metainfo per a l'aplicació Fitxers del GNOME.

appdata és el terme antic per a metainfo.

# Què passa si falten les metadades

Si falten algunes metadades per a una aplicació, el Programari només pot endevinar el que podria ser, i per tant no pot presentar molta informació a les seves interfícies. Les suposicions del Programari es basen en el fet que la majoria del programari està dissenyat per a ordinadors d'escriptori.

Podeu ajudar a millorar les metadades d'una aplicació.

# Com aportar la informació que falta

Si trobeu que a la pàgina d'una aplicació hi falta informació o hi ha informació incorrecta, podeu contribuir d'una de les dues maneres següents:

Podeu informar de les metadades que falten o son incorrectes al gestor d'errors de la respectiva l'aplicació, de manera que el desenvolupador de l'aplicació ho pugui resoldre.

Podeu corregir les metadades que falten o son incorrectes. Vegeu la guia sobre com fer-ho a continuació.

Per a ambdues opcions, primer heu de trobar la pàgina del projecte de l'aplicació. L'enllaç a la pàgina del projecte normalment hauria d'estar disponible a la pàgina de l'aplicació com es mostra aquí. Si no, haureu de trobar-la amb una simple cerca a Google.

Les aplicacions s'allotgen normalment al GitLab o al GitHub. Per exemple, les aplicacions del GNOME estan allotjades a gitlab.gnome.org.

# Com afegir captures de pantalla de l'aplicació que falten

La informació de les captures de pantalla d'una aplicació s'emmagatzema en l'element `<screenshots>` dins de l'element`<component>`en el seu fitxer metainfo.

El nombre recomanat de captures de pantalla per a una aplicació és d'entre 5 i 10. Les captures de pantalla haurien d'estar en el format PNG amb una relació d'aspecte 16:9 i una amplada mínima de 620 píxels.

Per exemple, aquí teniu les entrades de captura de pantalla de l'aplicació Programari:

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

# Com corregir la informació incorrecta de seguretat i permisos

La informació de seguretat i permisos d'una aplicació prové de diferents fonts depenent de com s'empaqueta l'aplicació. Per a aplicacions empaquetades de la forma tradicional, per exemple en format RPM o DEB, no hi ha informació de seguretat o permisos disponible i no es pot fer res per afegir-la a una aplicació.

Per a les aplicacions flatpak, la informació prové del manifest de flatpak, especificant quins forats en l'aïllament requereix l'aplicació. Cadascun d'aquests forats normalment contribueix a baixar el nivell de seguretat mostrat de l'aplicació en el Programari, canviant-lo de «segur» a «potencialment insegur» o «insegur».

Per tal de millorar el nivell de seguretat d'una aplicació, el seu aïllament s'ha de fer el més ajustat possible, eliminant permisos de l'aïllament que no són necessaris, i utilitzant portals en lloc de permisos d'aïllament quan sigui possible. L'ús de portals no redueix el nivell de seguretat mostrat d'una aplicació al Programari.

Per exemple, si l'aplicació sol·licita accés de lectura/escriptura al sistema de fitxers complet (`--filesystem=host`), realment necessita això, o només necessita accedir als fitxers en algunes ubicacions específiques? Si és així, es podria utilitzar el portal de fitxers, o es podrien especificar més permisos del sistema de fitxers .

Si l'aplicació funciona al Wayland, i només necessita treballar en X11 com a alternativa, sense utilitzar funcions especials de X11, podria utilitzar `--socket=fallback-x11` en lloc de `--socket=x11`?

La guia sobre permisos específics, o altres formats de paquets, es pot afegir aquí en el futur.

Lectura addicional:

# Com afegir la informació del maquinari que falta

La informació del maquinari d'una aplicació s'emmagatzema en els elements `<requires>`,`<recommends>`i`<supports>` dins dels`<component>`en el seu fitxer metainfo.

El Programari entén els elements `<control>` i `<display_length>`.

Vegeu aquesta entrada del blog o aquesta entrada del blog per a exemples de metadades.

# Com afegir la informació de valoració de l'edat del contingut que manca

La informació de qualificació de contingut d'una aplicació s'emmagatzema en l'element `<content_rating>` dins de l'element`<component>` de l'aplicació en el seu fitxer metainfo.

Les aplicacions han d'utilitzar l'estàndard OARS 1.1 per omplir aquest element. Si no s'especifica l'element `<content_rating>`, es desconeix la qualificació del contingut de l'aplicació. Si s'especifica però està buit, l'aplicació no té contingut que pugui ser inadequat per a qualsevol audiència.

Utilitzeu el generador OARS per produir informació adequada de qualificació de contingut per a una aplicació.

# Com corregir la informació incorrecta de les llicències

La informació de llicència d'una aplicació s'emmagatzema en l'element `<project_license>` dins de l'element`<component>`de l'aplicació en el seu fitxer metainfo.

El contingut d'aquest element hauria de ser una expressió SPDX que descriu la llicència «principal» per al projecte. Això hauria de ser normalment la llicència del codi, i no incloure la llicència de la documentació o del contingut auxiliar.

Si l'expressió SPDX és una única llicència, o una combinació de múltiples llicències, que són totes aprovades per la FSF o l'OSI, l'aplicació es considera «programari lliure» i la fitxa de llicència ho diu. En cas contrari, es considera «privativa».

Si una aplicació es mostra com a «privativa» quan creieu que no ho hauria de ser, és probable que l'element `<project_license>` inclogui la llicència de documentació per al projecte. Elimineu-lo.

Per exemple, canvieu les metadades de la llicència de:

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

a

<project_license>GPL-2.0+</project_license>

Lectura addicional:

No afegiu (generalment) la llicència de documentació a les dades de l'aplicació

# Com afegir enllaços que falten

Els enllaços per a una aplicació s'emmagatzemen com a elements `<url>` dins del `<component>` de l'aplicació en el seu fitxer metainfo.

Afegiu tants dels tipus d'enllaç documentats a l'especificació de l'appstream com estiguin disponibles per a l'aplicació. Si no hi ha cap pàgina adequada per a un tipus d'enllaç donat, no s'ha d'incloure.

Per exemple, aquí teniu els enllaços de recursos per a l'aplicació Programari:

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

# Com establir el color de fons de la tessel·la de carrusel

El color de fons de la tessel·la de carrusel normalment s'extreu automàticament de la icona de l'aplicació. Si aquest color és insatisfactori, però, es pot anul·lar utilitzant l'element `<branding/>` de l'appstream amb colors declarats (des de la sèrie 47.x). L'avantatge és que més clients poden utilitzar els colors.

Per exemple, aquí teniu algunes entrades de marca:

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

Tingueu en compte que l'atribut `scheme_preference` és ignorat, el Programari tria el millor color per al tema pel seu compte.

Queda, per a la compatibilitat amb versions anteriors, la possibilitat d'afegir el següent XML a l'element de metainfo `<component >` de l'aplicació:

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

però l'element `<branding/>` té prioritat.

El valor de `GnomeSoftware::key-colors` és un GVariant de format text amb el tipus `a(yyy)`, i representa un conjunt de colors clau no ordenats per a l'aplicació. Cada element del conjunt és un color en forma RGB que va des de `(0, 0, 0)` fins a `(255, 255, 255)`.

Els colors s'han d'escollir de manera que:

Siguin identificables amb l'aplicació, que coincideixin d'alguna manera amb la marca de l'aplicació, si és possible.

Contrastin amb la vora de la icona de l'aplicació, de manera que quan s'utilitzen com a fons darrere d'ella, es pugui distingir la icona.

Contrast amb el color del text de primer pla en el tema Adwaita (`#2e3436`) i en la seva variant fosca (`#eeeeec`). Això generalment significa triar un color amb un nivell mitjà de brillantor.

Es pot comprovar el contrast utilitzant l'aplicació Contrast.

S'ha d'especificar almenys un color. Es pot especificar més si un color no pot satisfer tots els requisits anteriors, i el Programari triarà el més adequat per utilitzar en la tessel·la de carrusel. Si s'especifica exactament un color, la seva brillantor i saturació es poden modificar per millorar el contrast amb el color de primer pla. Si s'especifica més d'un color, s'escollirà el que tingui millor contrast amb el color de primer pla, i no es modificarà la seva brillantor i saturació.

# Com provar els canvis de color de fons de les tessel·les de carrusel

Modifiqueu el fitxer de metadades per a la vostra aplicació i executeu el Programari amb:

gnome-software --show-metainfo=/camí/a/app.metainfo.xml,icon=/camí/a/l'aplicació/icona.png

Es mostrarà la pàgina de detalls de l'aplicació. Si torneu a navegar a la pàgina general del Programari, la vostra aplicació serà l'única en el carrusel «destacat».