Philip Withnall
philip@tecnocode.co.uk
Will Thompson
wjt@endlessos.org
Milan Crha
mcrha@redhat.com
Бағдарламалық қамтама
метадеректерді қалай пайдаланады

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

# Скриншоттар

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

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

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

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

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

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

Жетіспейтін қосымша скриншоттарын қалай қосуға болады

# Қосымшаның контексттік панелі

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

Сақтау орны

Қауіпсіздік

Аппараттық қолдау

Жас рейтингі

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

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

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

# Сақтау орны

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

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

# Қауіпсіздік

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

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

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

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

Қате қауіпсіздік және рұқсаттар туралы ақпаратты қалай түзетуге болады

# Аппараттық қолдау

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

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

Тачпад, тышқан немесе пернетақтаның бар болуы/қажеттілігі

Геймпадтың қажеттілігі

Қосымша бейімделе алатын минималды және ұсынылатын экран өлшемі

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

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

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

Жетіспейтін аппараттық ақпаратты қалай қосуға болады

# Жас рейтингі

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

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

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

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

Жетіспейтін мазмұн рейтингі туралы ақпаратты қалай қосуға болады

# Лицензия

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

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

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

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

Қате лицензиялау ақпаратын қалай түзетуге болады

# Сілтемелер

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

| Веб-сайт сілтемесі
| Демеушілік ету сілтемесі
| Аудармаға үлес қосу сілтемесі
| Қателер туралы хабарлау сілтемесі
| Көмек сілтемесі
| Байланыс сілтемесі

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

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

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

Жетіспейтін сілтемелерді қалай қосуға болады

# Карусель плиткасы

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

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

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

Карусель плиткасының фон түсін қалай орнатуға болады

# Метадеректер қайдан алынады

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

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

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

appdata — metainfo терминінің ескірген атауы.

# Метадеректер жетіспесе не болады

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

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

# Жетіспейтін ақпаратты қалай қосуға болады

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

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

Жетіспейтін / қате метадеректерді өзіңіз түзете аласыз. Мұны қалай жасау керектігі туралы төмендегі Нұсқаулықты қараңыз.

Екі жағдайда да алдымен қосымшаның жоба бетін табу керек. Жоба бетіне сілтеме әдетте мұнда көрсетілгендей қосымшаның бетінде қолжетімді болуы керек. Олай болмаса, оны 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>

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

Құжаттама лицензиясын (әдетте) appdata ішіне қоймаңыз

# Жетіспейтін сілтемелерді қалай қосуға болады

Қосымшаның сілтемелері оның метаақпарат файлындағы `<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>

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

Кері үйлесімділік үшін қосымшаның метаақпарат `<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 пішіміндегі түс болып табылады.

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

Мүмкін болса, қосымшаның брендингіне белгілі бір түрде сәйкес келетін қосымша үшін танылатын болуы.

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

Adwaita темасындағы (`#2e3436`) және оның қараңғы нұсқасындағы (`#eeeeec`) негізгі мәтін түсімен контрастты болуы. Бұл әдетте орташа жарықтық деңгейі бар түсті таңдауды білдіреді.

Контрастты Contrast қосымшасының көмегімен тексеруге болады.

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

# Карусель плиткасының фон түсінің өзгерістерін қалай сынауға болады

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

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

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