Programara Metadatenoj
Ekrankopioj
Programaro montras ekrankopiojn en la detalpaĝo de aplikaĵo. Tio kutime devus inkluzivi ekrankopiojn de diversaj fenestroj/dialogoj de la aplikaĵo, por ke la uzanto rapide ekkomprenu ĝiajn funkciojn, aspekton kaj konduton.
Kiam en la metainformdosiero de aplikaĵo estas pli ol unu ekrankopio, Programaro montras ilin en karuselo.
Se la metainformdosiero de aplikaĵo ne enhavas ekrankopion, montriĝos anstataŭiga piktogramo kun Neniuj ekrankopioj kiel sube:
Anstataŭila piktogramo povus aspekti malsama se vi uzas propra piktogramo-temo.
Ekrankopioj povas malaktualiĝi kiam ŝanĝiĝas la uzantinterfaco de aplikaĵo. Do, eĉ se Programaro montras ekrankopiojn, gravas kontroli ĉu ili estas aktualaj aŭ malaktualaj.
Vi povas plibonigi aplikaĵan ekrankopjan informon:
Aplikaĵa Konteksta Strio
La aplikaĵa konteksta strio en Programaro estas kolekto de ŝancoj sur la detalos-paĝo por aplikaĵo, kiu montras la sekvajn detalojn.
Ĉi tio montras la aplikaĵan kontekstan strio por la Programaro-aplikaĵo:
La ŝancoj estas montrita en la ordo listigita ĉi-supe (komencante kun Stokado-ŝanco maldekstre).
Ĉiu ŝanco estas kovrita detale ĉi-sube.
Stokado
Programaro montras stokadan ŝancon sur la detalos-paĝo por aplikaĵo. Se la aplikaĵo ne estas instalita, ĉi tio montras la taksitan elŝutgrandon bezonan por instali ĝin. Se la aplikaĵo estas instalita, ĝi montras la stokad-spacon uzita de la aplikaĵo.
La grandoj estas kalkulataj laŭ datumoj liveritaj de la malantaŭaĵo de Programaro (kiel Flatpak aŭ RPM), kaj ne estas specifitaj en la metadatumoj de la aplikaĵo. Redaktante la metainformdosieron de aplikaĵo, oni povas neniel influi ĉi tiun kahelon. Ĝi estas listigita ĉi tie por kompleteco.
Sekureco
Programaro montras sekurec-ŝancon sur la detalos-paĝo por aplikaĵo. Ĉi tio resumadas informon pri ĉu la aplikaĵo povas esti konsiderata sekura por instali kaj flegi, aŭ ĉu zorgo povus esti postulita antaŭ fidi ĝin.
Ĉi tiu ŝanco kombinas informon pri la permesoj, kiujn la aplikaĵo petas kiam ĝi flegi (kiel permeso legi viajn dosierojn), kun informon pri kiel la aplikaĵo estis evoluata. Libera-programaraj aplikaĵoj, kie la fontkodo estas publika-legopova, povas esti pli sekura ol proprietoj, ĉar ĝi povas esti auditita.
La dialogo kiu aperas kiam la ŝanco estas klakita listasas la malsamajn permesojn petetajn de la aplikaĵo, plus iaj informoj pri ĝia permeso kaj rultempo.
Vi povas plibonigi la sekurec-informon:
Makinara Subteno
Programaro montras makinaran subtenen-ŝancon sur la detalos-paĝo por aplikaĵo. Ĉi tio kombinas informon pri la makinara postuloj de la aplikaĵo, kaj la makinara kapablecoj de la komputilo, ĉe la celo de emfazado de nekonformecoj aŭ mankantataj postuloj — aŭ por indiki, ke la aplikaĵo devus labori ĝuste sen nekonformecoj.
La kodo rigardas la sekvantan makinaron. Pli povus esti subtenita en la estonteco.
Ĉu tuŝ-pado, muso aŭ klavaro estas ĉeesta/bezonata
Ĉu lud-kontrolilo estas bezonata
La minimuma kaj rekomendita ekran-grandeco al kiu la aplikaĵo povas skalumi
Ne eblas fidinde detekti ĉu ludplato estas ĉeesta, ĉar ĝi ofte restas malkonektita pro tio, ke ĝi ne estas bezonata por ordinara komputila uzo.
La dialogo kiu aperas kiam la ŝanco estas klakita listasas la malsamajn makinara postulojn de la aplikaĵo, kaj ĉu iuj el ili ne estas plenumita.
Vi povas plibonigi la makinaran informon:
Aĝa Raitingo
Programaro montras aĝan-raitingan ŝancon sur la detalos-paĝo por aplikaĵo. Ĉi tio montras kiun aĝ-amplekson la aplikaĵo devus esti konvena por, bazita sur malsamaj specoj de enhavo kiujn la aplikaĵo deklaris ke ĝi enhavas. Ĉi tiu informo estas resumada en formato simila al la lud aŭ filma raitinga sertifikoj por via lando.
Ekzemple, ĉi tio emfazos ĉu ludo enhavas perforton, aŭ ĉu aplikaĵo enhavas en-aplikaĵan reklamojn.
La dialogo kiu aperas kiam la ŝanco estas klakita listasas la malsamajn specojn de enhavo en la aplikaĵo kaj kiom severoj estas tiu enhavo.
Vi povas plibonigi la aĝ-raitingan informon:
Permeso
Programaro montras kahelon indikantan ĉu aplikaĵo estas libera programaro, aŭ ĉu ĝia permesilo estas proprieta, speciala aŭ nekonata. La kahelo enhavas pli detalajn informojn pri la permesilo de la projekto kaj listigas kelkajn avantaĝojn de libera programaro. Lerni pli
Foje la permesilaj informoj de aplikaĵo estas malĝustaj, kaj tial aplikaĵo, kiu fakte estas libera programaro, aperas kiel ‘proprieta’. Simile, foje la permesilaj informoj estas nekonataj.
Programaro emfazas libera kaj malfermita-fonta permesojn en verdo, proprietaj kaj specialaj permesoj en flava kiel montrite ĉi tie. Nekonataj permesoj estas emfazitaj en grizo.
Vi povas aldoni aŭ plibonigi la permeso-informon:
Ligiloj
Programaro montras liston de aplikaĵan risorcan ligilojn en la ligila ŝanco. Ili estas jenaj:
|
Reteja ligilo |
|
Donaco-ligilo |
|
Traduko-kontribuo-ligilo |
|
Cim-raporto-ligilo |
|
Helpo-ligilo |
|
Kontakto-ligilo |
Iuj aŭ ĉiuj el ĉi tiuj ligiloj povas ekzisti depende de tio, ĉu ili estas listigitaj en la metainformdosiero de la aplikaĵo.
Se la metainformdosiero de aplikaĵo ne enhavas ekrankopion, montriĝos anstataŭiga piktogramo kun Neniuj ekrankopioj kiel sube:
Vi povas plibonigi la ligilojn:
Ĉarĉela ŝanco
Aplikaĵoj prezentataj de Programaro aperas en karuselo ĉe la supro de la ĉefa fenestro, kiel montrite ĉi tie. Ĉiu karusela kahelo havas fonkoloron aŭtomate ĉerpitan el la piktogramo de la aplikaĵo. Foje tiu koloro ne taŭgas por la aplikaĵo kaj devas esti eksplicite specifita de ĝia programisto.
La aro de aplikaĵoj kiuj estas menciitaj estas decidita de la Linux-distribuo-prizorgantoj.
Vi povas plibonigi la ĉarĉelan ŝancon:
De kie metadatenoj venas
La metadatenoj uzitaj por specifi kiun makinaron peco de programaro postulas, kiujn aĝojn de uzanto ĝi estas konvena por, kaj faktoroj kiu kontribuas al kiom sekura ĝi povus esti por instali, ĉiuj venas de la metainfo-dosiero por tiu programaro.
La metainfo-dosiero estas XML-dosiero. Ĝia dosiero-formato estas specifita en la AppStream-specifilo.
Vidu la metainfo-dosieron por GNOME-Dosieroj-aplikaĵo.
appdata estas la malpli nova termo por metainfo.
Kio okazas se metadatenoj mankas
Se mankas metadatumoj por aplikaĵo, Programaro povas nur diveni, kiaj ili eble estas, kaj tial ne povas prezenti multajn informojn en siaj interfacoj. La divenoj baziĝas sur tio, ke plej multe da programaro estas destinita al labortablaj komputiloj.
Vi povas helpi plibonigi la metadatenojn por aplikaĵo!
Kiel kontribui mankantan informon
Se vi trovas ke mankas informoj en la paĝo de aplikaĵo aŭ ke ili estas malĝustaj, vi povas kontribui per unu el du manieroj:
Vi povas raporti la mankantajn aŭ malĝustajn metadatumojn al la cimspurilo de la koncerna aplikaĵo, por ke ĝia programisto povu ripari ilin.
Vi povas ĝustigi la mankantan / malĝustan metadatenojn mem. Vidu la Kiel gvidi ĉi-sube pri kiel fari ĉi tion.
Por ambaŭ manieroj, vi unue devas trovi la projektpaĝon de la aplikaĵo. La ligilo al ĝi kutime estas disponebla en la paĝo de la aplikaĵo kiel montrite ĉi tie. Alie, vi devos trovi ĝin per simpla serĉo en Google.
Aplikaĵoj estas tipe gastita en GitLab aŭ GitHub. Ekzemple, GNOME-aplikaĵoj estas gastita en gitlab.gnome.org.
Kiel aldoni mankantajn aplikaĵajn ekrankopiojn
La ekrankopiaj informoj de aplikaĵo estas konservataj en la elemento <screenshots> ene de la <component> de la aplikaĵo en ĝia metainformdosiero.
Rekomendita nombro de ekrankopioj por aplikaĵo estas inter 5 ĝis 10. Ekrankopioj devus ideale esti en PNG-formato kun 16:9 aspekto-raporto kaj minimuma larĝo de 620 pikseloj.
Ekzemple, jen estas la ekrankopjaj enigoj por la Programaro-aplikaĵo:
<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>Kiel ĝustigi malĝustan sekurecon kaj permesojn
La sekurec- kaj permeso-informo por aplikaĵo venas de malsamaj fontoj depende ĉu kiel la aplikaĵo estas pakita. Por tradice pakitaj aplikaĵoj, ekzemple en RPM aŭ DEB-formato, estas neniuj sekurec- aŭ permeso-informo disponebla kaj nenio povas esti farita por aldoni ĝin al aplikaĵo.
Ĉe Flatpak-aplikaĵoj, la informoj venas el la Flatpak-manifesto de la aplikaĵo, kiu specifas kiujn truojn en la sablokesto ĝi bezonas. Ĉiu tia truo kutime malaltigas la montratan sekurecnivelon en Programaro, movante ĝin de ‘sekura’ al ‘eble nesekura’ kaj al ‘nesekura’.
Por plibonigi la sekurecnivelon de aplikaĵo, ĝia sablokesto devas esti kiel eble plej strikta: forigu sablokestajn permesojn kie ili ne necesas, kaj uzu portalojn anstataŭ ili kie eblas. Portalo-uzo ne malaltigas la montratan sekurecnivelon en Programaro.
Ekzemple, se la aplikaĵo petas leg/skribaĵo-aliron al la plena dosiero-sistemo (--filesystem=host), ĉu ĝi fakte postulas ĉi tion, aŭ ĉu ĝi bezonas akiri dosierojn en malmultaj specifaj lokaj? Se jes, la dosiero-pordego povus esti uzita, aŭ pli specifaj dosiero-sistemo-permesoj povus esti specifita.
Se la aplikaĵo funkcias sur Wayland, kaj nur devas labori sur X11 kiel falbacko, sen uzado de specialaj X11-funkcioj, ĉu ĝi povus uzi --socket=fallback-x11 anstataŭ --socket=x11?
Gvidoj pri specifaj permesoj, aŭ aliaj pakaj formatoj, povus esti aldonitaj ĉi tie en la estonteco.
Pli da legado:
Kiel aldoni mankantan makinaran informon
La aparataraj informoj de aplikaĵo estas konservataj en la elementoj <requires>, <recommends> kaj <supports> ene de la <component> de la aplikaĵo en ĝia metainformdosiero.
Programaro komprenas la <control> kaj <display_length> elementoj.
Vidu ĉi tiun blogo-postion aŭ ĉi tiun blogo-postion por ekzemploj de metadatenoj.
Kiel aldoni mankantan enhavan raitingan informon
La enhavtaksa informo de aplikaĵo estas konservata en la elemento <content_rating> ene de la <component> de la aplikaĵo en ĝia metainformdosiero.
Aplikaĵoj uzu la normon OARS 1.1 por plenigi ĉi tiun elementon. Se <content_rating> ne estas specifita, la enhavtakso de la aplikaĵo estas nekonata. Se ĝi estas specifita sed malplena, la aplikaĵo ne enhavas ion netaŭgan por iu ajn publiko.
Uzu la OARS-generatoron por produkti konvenan enhavan-raitingan informon por aplikaĵo.
Kiel ĝustigi malĝustan permesajn informojn
La permesilaj informoj de aplikaĵo estas konservataj en la elemento <project_license> ene de la <component> de la aplikaĵo en ĝia metainformdosiero.
La enhavo de ĉi tiu elemento estu SPDX-esprimo priskribanta la ‘ĉefan’ permesilon de la projekto. Tipe ĝi estu la permesilo de la kodo, ne tiu de la dokumentaro aŭ aldona enhavo.
Se la SPDX-esprimo estas unu permesilo aŭ kombinaĵo per ‘aŭ’ de pluraj permesiloj, kaj ĉiuj estas aprobita de FSF aŭ OSI, la aplikaĵo estas konsiderata ‘libera programaro’ kaj la permesila kahelo tion indikas. Alie ĝi estas konsiderata ‘proprieta’.
Se aplikaĵo aperas kiel ‘proprieta’ kvankam laŭ vi ĝi ne devus, verŝajne la elemento <project_license> enhavas la dokumentaran permesilon de la projekto. Forigu ĝin.
Ekzemple, ŝanĝi la permeso-metadatenojn de:
<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>al
<project_license>GPL-2.0+</project_license>Pli da legado:
Kiel aldoni mankantajn ligilojn
La ligiloj de aplikaĵo estas konservataj kiel <url>-elementoj ene de la <component> de la aplikaĵo en ĝia metainformdosiero.
Aldonu kiel eble plej multajn el la ligiltipoj dokumentitaj en la AppStream-specifo, kiuj disponeblas por la aplikaĵo. Se ne ekzistas taŭga paĝo por iu ligiltipo, ĝi ne devas esti inkluzivita.
Ekzemple, jen estas la risorcaj ligiloj por la Programaro-aplikaĵo:
<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>Kiel fiksadi la fonkoloran de ĉarĉela ŝanco
La fonkoloro de karusela kahelo estas kutime aŭtomate ĉerpata el la piktogramo de la aplikaĵo. Se tiu koloro ne taŭgas, ĝi povas esti anstataŭigita per la AppStream-<branding/>-elemento kun deklaritaj koloroj (ekde la serio 47.x). Tiel pli da klientoj povas uzi la kolorojn.
Ekzemple, jen estas iaj marca-enigoj:
<branding>
<color type="primary" scheme_preference="light">#ff00ff</color>
<color type="primary" scheme_preference="dark">#993d3d</color>
</branding>Notu ke la scheme_preference-atributo estas ignora, Programaro elektas la pli bonan koloron por la temo mem.
Por malantaŭen kongruo restas la ebleco aldoni la jenan XML-on al la <component>-elemento de la metainformdosiero de la aplikaĵo:
<custom>
<value key="GnomeSoftware::key-colors">[(124, 53, 77), (99, 16, 0)]</value>
</custom>sed la <branding/> elemento havas precencecon.
La valoro de GnomeSoftware::key-colors estas teksta-formato GVariant kun tipo a(yyy), kaj reprezentas neordigitan aron de ĉefaj koloroj por la aplikaĵo. Ĉiu elemento de la aro estas koloro en RGB-formo varianta de (0, 0, 0) al (255, 255, 255).
Koloroj devus esti elektitaj por ke ĝi:
Ili estu identigeblaj por la aplikaĵo, laŭeble iel kongruante kun ĝia markostilo.
Ili kontrastu kun la rando de la piktogramo de la aplikaĵo, por ke la piktogramo estu distingebla kiam ili estas uzataj kiel fono malantaŭ ĝi.
Kontrastas kun la antaŭa-teksta koloro en la Adwaita-temo (#2e3436) kaj en ĝia malhelaj variano (#eeeeec). Ĉi tio ĝenerale signifas elekti koloron kun meza nivelo de lumeco.
Kontrastas povas esti kontrolita uzante la Kontrasta aplikaĵo.
Oni specifu almenaŭ unu koloron. Oni povas specifi pli, se unu koloro ne povas plenumi ĉiujn suprajn postulojn; Programaro elektos la plej taŭgan por la karusela kahelo. Se estas specifita ekzakte unu koloro, ĝia heleco kaj satureco povas esti modifitaj por plibonigi kontraston kun la malfonkoloro. Se estas specifitaj pluraj koloroj, elektiĝos tiu kun la plej bona kontrasto kun la malfonkoloro, kaj ĝia heleco kaj satureco ne estos modifitaj.
Kiel testi ĉarĉelaj ŝancaj fonkoloraj ŝanĝoj
Modifi la metainfo-dosieron por via aplikaĵo, kaj tiam flegi Programaro kun:
gnome-software --show-metainfo=/path/to/app.metainfo.xml,icon=/path/to/app/icon.png
Montriĝos la detalpaĝo de via aplikaĵo. Se vi reiras al la superrigarda paĝo de Programaro, via aplikaĵo estos la sola en la ‘prezentata’ karuselo.