Бағдарламалық қамтама метадеректері

Бағдарламалық қамтама қосымша туралы мәліметтер бетінде скриншоттарды көрсетеді. Бұл әдетте пайдаланушы қосымшаның мүмкіндіктерін, сыртқы түрін және т.б. тез түсінуі үшін қосымшаның түрлі терезелерінің / сұхбат терезелерінің скриншоттарын қамтуы керек.

Қосымшаның метаақпарат файлында бірнеше скриншот болса, Бағдарламалық қамтама оларды карусель түрінде көрсетеді.

Қосымшаның метаақпарат файлында скриншоттар болмаған жағдайда, төмендегідей Скриншоттар жоқ деген жазуы бар толтырғыш таңбашасы көрсетіледі:

Қосымша интерфейсі өзгерген сайын скриншоттар ескіруі мүмкін. Сондықтан, Бағдарламалық қамтама қосымша үшін скриншоттарды көрсетсе де, бұл скриншоттардың жаңартылған немесе ескіргенін тексеру маңызды.

Сіз қосымшаның скриншоты туралы ақпаратты жақсарта аласыз:

Бағдарламалық қамтамадағы қосымшаның контексттік панелі — келесі мәліметтерді көрсететін қосымшаның мәліметтер бетіндегі плиткалар жиынтығы.

Мұнда Бағдарламалық қамтама қосымшасы үшін контексттік панель көрсетілген:

Плиткалар жоғарыда көрсетілген ретпен көрсетіледі (сол жақтан Сақтау орны плиткасынан бастап).

Әрбір плитка төменде егжей-тегжейлі сипатталған.

Бағдарламалық қамтама қосымша туралы мәліметтер бетінде сақтау орны плиткасын көрсетеді. Егер қосымша орнатылмаған болса, бұл оны орнату үшін қажетті болжалды жүктеп алу өлшемін көрсетеді. Егер қосымша орнатылған болса, ол қосымша алып жатқан орынды көрсетеді.

Өлшемдер Бағдарламалық қамтаманың артқы жағынан (мысалы, flatpak немесе RPM) алынған деректер негізінде есептеледі және қосымша берген метадеректерде көрсетілмейді. Қосымшаның метаақпарат файлын түзету арқылы бұл плиткаға әсер ету үшін ештеңе істей алмайсыз. Ол мұнда толықтық үшін тізімделген.

Бағдарламалық қамтама қосымша туралы мәліметтер бетінде қауіпсіздік плиткасын көрсетеді. Бұл қосымшаны орнату және іске қосу қауіпсіз деп санала ма, әлде оған сенбес бұрын сақ болу керек пе деген ақпаратты жинақтайды.

Бұл плитка қосымша іске қосылғанда сұрайтын рұқсаттар (мысалы, файлдарыңызды оқуға рұқсат) туралы ақпаратты және қосымшаның қалай әзірленгені туралы ақпаратты біріктіреді. Бастапқы коды көпшілікке қолжетімді еркін бағдарламалық қамтама қосымшалары меншікті қосымшаларға қарағанда қауіпсіз болуы мүмкін, өйткені оларды тексеруге болады.

Плитканы шерткенде пайда болатын сұхбат терезесінде қосымша сұрайтын түрлі рұқсаттар, сонымен қатар оның лицензиясы мен орындалу ортасы туралы кейбір ақпарат көрсетіледі.

Сіз қауіпсіздік туралы ақпаратты жақсарта аласыз:

Бағдарламалық қамтама қосымша туралы мәліметтер бетінде аппараттық қолдау плиткасын көрсетеді. Бұл сәйкессіздіктерді немесе жетіспейтін талаптарды көрсету немесе қосымшаның ешқандай сәйкессіздіксіз дұрыс жұмыс істейтінін білдіру мақсатында қосымшаның аппараттық талаптары мен компьютердің аппараттық мүмкіндіктері туралы ақпаратты біріктіреді.

Код келесі аппараттық құралдарды тексереді. Болашақта көбірек қолдау көрсетілуі мүмкін.

Геймпадтың бар-жоғын сенімді түрде анықтау мүмкін емес, өйткені олар әдетте компьютерді қалыпты пайдалану үшін қажет болмағандықтан ажыратылып тұрады.

Плитканы шерткенде пайда болатын сұхбат терезесінде қосымшаның түрлі аппараттық талаптары және олардың орындалған-орындалмағаны көрсетіледі.

Сіз аппараттық құралдар туралы ақпаратты жақсарта аласыз:

Бағдарламалық қамтама қосымша туралы мәліметтер бетінде жас рейтингі плиткасын көрсетеді. Бұл қосымшада мәлімделген мазмұн түрлеріне негізделген қосымшаның қай жас аралығына сәйкес келетінін көрсетеді. Бұл ақпарат сіздің еліңіздегі ойын немесе фильм рейтингі сертификаттарына ұқсас пішімде жинақталады.

Мысалы, бұл ойында зорлық-зомбылық бар ма, әлде қосымшада ішкі жарнама бар ма дегенді көрсетеді.

Плитканы шерткенде пайда болатын сұхбат терезесінде қосымшадағы мазмұнның түрлі түрлері және сол мазмұнның қаншалықты қатаң екендігі көрсетіледі.

Сіз жас рейтингі туралы ақпаратты жақсарта аласыз:

Бағдарламалық қамтама қосымшаның еркін бағдарламалық қамтама екенін немесе оның лицензиясы меншікті, арнайы немесе белгісіз екенін көрсететін плитканы көрсетеді. Бұл плитка жобаның лицензиясы туралы толығырақ ақпаратты қамтиды. Сондай-ақ, бұл плиткада еркін бағдарламалық қамтаманың кейбір артықшылықтары тізімделген. Көбірек білу

Кейде қосымша үшін лицензия туралы ақпарат дұрыс болмайды, сондықтан іс жүзінде еркін бағдарламалық қамтама болып табылатын қосымша «меншікті» ретінде көрсетіледі. Сол сияқты, кейде лицензия туралы ақпарат белгісіз болады.

Бағдарламалық қамтама еркін және ашық бастапқы кодты лицензияларды жасыл түспен, ал меншікті және арнайы лицензияларды мұнда көрсетілгендей сары түспен белгілейді. Белгісіз лицензиялар сұр түспен белгіленеді.

Сіз лицензия туралы ақпаратты қоса аласыз немесе жақсарта аласыз:

Бағдарламалық қамтама сілтемелер плиткасында қосымша ресурстарына сілтемелер тізімін көрсетеді. Олар келесідей:

Бұл сілтемелердің кейбіреулері немесе барлығы қосымшаның метаақпарат файлында тізімделгеніне байланысты болуы мүмкін.

Қосымшаның метаақпарат файлында ешқандай сілтеме болмаған жағдайда, сұрақ белгісі бар келесі плитка көрсетіледі.

Сіз сілтемелерді жақсарта аласыз:

Бағдарламалық қамтамада ұсынылған қосымшалар мұнда көрсетілгендей негізгі терезенің жоғарғы жағындағы карусельде көрсетіледі. Әрбір карусель плиткасының фондық түсі бар, ол қосымшаның таңбашасынан автоматты түрде алынады. Кейде бұл фон түсі қосымша үшін сәйкес келмейді және оны қосымша әзірлеушісі нақты көрсетуі керек.

Ұсынылатын қосымшалар жиынтығын Linux дистрибутивінің сүйемелдеушілері шешеді.

Сіз карусель плиткасын жақсарта аласыз:

Бағдарламалық қамтамаға қандай аппараттық құралдар қажет екенін, оның қай жастағы пайдаланушыларға сәйкес келетінін және оны орнатуның қаншалықты қауіпсіз екендігіне әсер ететін факторларды көрсету үшін пайдаланылатын метадеректердің барлығы сол бағдарламалық қамтаманың метаақпарат файлынан алынады.

Метаақпарат файлы — XML файлы. Оның файл пішімі AppStream спецификациясында көрсетілген.

GNOME Файлдар қосымшасының метаақпарат файлын қараңыз.

Егер қосымша үшін кейбір метадеректер жетіспесе, Бағдарламалық қамтама олардың қандай болуы мүмкін екенін ғана болжай алады, сондықтан өз интерфейстерінде көп ақпарат бере алмайды. Бағдарламалық қамтаманың жасаған болжамдары көптеген бағдарламалық қамтамалардың жұмыс үстелі компьютерлеріне арналғанына негізделген.

Сіз қосымшаның метадеректерін жақсартуға көмектесе аласыз!

Егер сіз қосымшаның бетінде ақпарат жетіспейтінін немесе қате ақпарат бар екенін байқасаңыз, екі жолдың бірімен үлес қоса аласыз:

Екі жағдайда да алдымен қосымшаның жоба бетін табу керек. Жоба бетіне сілтеме әдетте мұнда көрсетілгендей қосымшаның бетінде қолжетімді болуы керек. Олай болмаса, оны Google-да жай іздеу арқылы табу керек болады.

Қосымшалар әдетте GitLab немесе GitHub сервистерінде орналасады. Мысалы, GNOME қосымшалары gitlab.gnome.org сайтында орналасқан.

Қосымшаның скриншоттары туралы ақпарат оның метаақпарат файлындағы <component> ішіндегі <screenshots> элементінде сақталады.

Қосымша үшін скриншоттардың ұсынылатын саны — 5-тен 10-ға дейін. Скриншоттар 16:9 арақатынасы бар және минималды ені 620 пиксель болатын PNG пішімінде болғаны дұрыс.

Мысалы, мұнда Бағдарламалық қамтама қосымшасы үшін скриншот жазбалары берілген:

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

Қосымшаның қауіпсіздігі мен рұқсаттары туралы ақпарат қосымшаның қалай дестеленгеніне байланысты түрлі дереккөздерден алынады. Дәстүрлі түрде дестеленген қосымшалар үшін, мысалы RPM немесе DEB пішімінде, қауіпсіздік немесе рұқсаттар туралы ақпарат қолжетімді емес және оны қосымшаға қосу үшін ештеңе істеу мүмкін емес.

Flatpak қосымшалары үшін ақпарат қосымшаның flatpak манифестінен алынады, онда қосымшаға оқшауланған ортада қандай саңылаулар қажет екені көрсетіледі. Осы саңылаулардың әрқайсысы әдетте Бағдарламалық қамтамада көрсетілетін қосымшаның қауіпсіздік деңгейін төмендетуге ықпал етеді — оны «қауіпсізден» «ықтимал қауіптіге» немесе «қауіптіге» ауыстырады.

Қосымшаның қауіпсіздік деңгейін арттыру үшін оның оқшаулануын мүмкіндігінше қатаңдату керек, бұл үшін қажет емес оқшауланған орта рұқсаттарын алып тастау және мүмкін болған жағдайда оқшауланған орта рұқсаттарының орнына порталдарды пайдалану керек. Порталдарды пайдалану Бағдарламалық қамтамада көрсетілетін қосымшаның қауіпсіздік деңгейін төмендетпейді.

Мысалы, егер қосымша толық файлдық жүйеге (--filesystem=host) оқу/жазу үшін қол жеткізуді сұраса, оған бұл шынымен қажет пе, әлде оған тек бірнеше нақты орындардағы файлдарға қол жеткізу керек пе? Олай болса, файлдық порталды пайдалануға болады немесе нақтырақ файлдық жүйе рұқсаттарын көрсетуге болады.

Егер қосымша Wayland-да жұмыс істесе және X11-дің арнайы мүмкіндіктерін пайдаланбай, X11-ді тек резервтік нұсқа ретінде пайдалану қажет болса, --socket=x11 орнына --socket=fallback-x11 пайдалануға бола ма?

Нақты рұқсаттар немесе басқа дестелеу пішімдері туралы нұсқаулықтар болашақта осында қосылуы мүмкін.

Қосымша оқу үшін:

Қосымша үшін аппараттық ақпарат оның метаақпарат файлындағы <component> ішіндегі <requires>, <recommends> және <supports> элементтерінде сақталады.

Бағдарламалық қамтама <control> және <display_length> элементтерін түсінеді.

Метадеректердің мысалдарын осы блог жазбасынан немесе мына блог жазбасынан қараңыз.

Қосымшаның мазмұн рейтингі туралы ақпарат оның метаақпарат файлындағы <component> ішіндегі <content_rating> элементінде сақталады.

Қосымшалар осы элементті толтыру үшін OARS 1.1 стандартын пайдалануы керек. Егер <content_rating> элементі көрсетілмесе, қосымшаның мазмұн рейтингі белгісіз болады. Егер ол көрсетілген болса, бірақ бос болса, қосымшада кез келген аудитория үшін сәйкес келмейтін мазмұн жоқ.

Қосымша үшін қолайлы мазмұн рейтингі туралы ақпаратты жасау үшін OARS генераторын пайдаланыңыз.

Қосымшаның лицензиялау туралы ақпараты оның метаақпарат файлындағы <component> ішіндегі <project_license> элементінде сақталады.

Бұл элементтегі мазмұн жобаның «негізгі» лицензиясын сипаттайтын SPDX өрнегі болуы керек. Бұл әдетте кодтың лицензиясы болуы керек және құжаттаманың немесе қосымша мазмұнның лицензиясын қамтымауы керек.

Егер SPDX өрнегі бір лицензия немесе FSF немесе OSI мақұлдаған бірнеше лицензияның «немесе» комбинациясы болса, қосымша «еркін бағдарламалық қамтама» болып саналады және лицензия плиткасында солай көрсетіледі. Әйтпесе, ол «меншікті» болып саналады.

Егер қосымша сіздің ойыңызша «меншікті» болмаса да солай көрсетілсе, <project_license> элементі жобаның құжаттама лицензиясын қамтуы мүмкін. Оны алып тастаңыз.

Мысалы, лицензия метадеректерін мынадан өзгертіңіз:

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

мынаған

<project_license>GPL-2.0+</project_license>

Қосымша оқу үшін:

Қосымшаның сілтемелері оның метаақпарат файлындағы <component> ішіндегі <url> элементтері ретінде сақталады.

appstream спецификациясында құжатталған сілтеме түрлерінің қосымша үшін қолжетімділерін мүмкіндігінше көп қосыңыз. Егер берілген сілтеме түрі үшін сәйкес бет болмаса, оны қосудың қажеті жоқ.

Мысалы, мұнда Бағдарламалық қамтама қосымшасының ресурс сілтемелері берілген:

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

Карусель плиткасының фон түсі әдетте қосымшаның таңбашасынан автоматты түрде алынады. Алайда, егер бұл түс көңілден шықпаса, оны мәлімделген түстері бар (47.x сериясынан бастап) appstream-ның <branding/> элементін пайдалану арқылы қайта анықтауға болады. Артықшылығы — түстерді көбірек клиенттер пайдалана алады.

Мысалы, мұнда кейбір брендинг жазбалары берілген:

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

Кері үйлесімділік үшін қосымшаның метаақпарат <component> элементіне келесі XML-ді қосу мүмкіндігі қалды:

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

бірақ <branding/> элементі басымдыққа ие.

GnomeSoftware::key-colors мәні — a(yyy) түріндегі мәтіндік пішімдегі GVariant және ол қосымша үшін негізгі түстердің реттелмеген жиынтығын білдіреді. Жиынтықтың әрбір элементі (0, 0, 0) мен (255, 255, 255) аралығындағы RGB пішіміндегі түс болып табылады.

Түстер келесідей таңдалуы керек:

Кем дегенде бір түс көрсетілуі керек. Егер бір түс жоғарыдағы барлық талаптарды қанағаттандыра алмаса, көбірек түс көрсетуге болады және Бағдарламалық қамтама карусель плиткасында пайдалану үшін ең қолайлысын таңдайды. Егер дәл бір түс көрсетілсе, негізгі түспен контрастты жақсарту үшін оның жарықтығы мен қанықтылығы өзгертілуі мүмкін. Егер бірнеше түс көрсетілсе, негізгі түспен ең жақсы контрасты бар түс таңдалады және оның жарықтығы мен қанықтылығы өзгертілмейді.

Қосымшаңыздың метаақпарат файлын өзгертіп, Бағдарламалық қамтаманы келесі пәрменмен іске қосыңыз:

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

Қосымшаңыз туралы мәліметтер беті көрсетіледі. Егер Бағдарламалық қамтаманың шолу бетіне қайтсаңыз, сіздің қосымшаңыз «ұсынылатын» карусельдегі жалғыз қосымша болады.