Μεταδεδομένα λογισμικού

Το Λογισμικό εμφανίζει τα στιγμιότυπα οθόνης στη σελίδα λεπτομερειών μιας εφαρμογής. Αυτά τυπικά θα πρέπει να περιλαμβάνουν στιγμιότυπα από διάφορα παράθυρα / διαλόγους της εφαρμογής, ώστε ο χρήστης να πάρει μια γρήγορη ιδέα για τις δυνατότητες, την εμφάνιση και την αίσθηση της εφαρμογής κ.λπ.

Όταν υπάρχουν περισσότερα από ένα στιγμιότυπα οθόνης στο αρχείο metainfo της εφαρμογής, το Λογισμικό θα εμφανίσει τα στιγμιότυπα σε μορφή καρουζέλ.

Σε περιπτώσεις που το αρχείο metainfo της εφαρμογής δεν περιέχει κανένα στιγμιότυπο οθόνης, τότε θα εμφανίζεται ένα εικονίδιο κράτησης θέσης όπως παρακάτω με την ένδειξη No Screenshots (Χωρίς στιγμιότυπα):

Τα στιγμιότυπα οθόνης μπορεί να γίνουν παρωχημένα καθώς αλλάζει η διεπαφή χρήστη (UI) της εφαρμογής. Επομένως, ακόμα κι αν το Λογισμικό εμφανίζει στιγμιότυπα για μια εφαρμογή, είναι σημαντικό να ελέγξετε αν αυτά είναι ενημερωμένα ή παλιά.

Μπορείτε να βελτιώσετε τις πληροφορίες στιγμιότυπων της εφαρμογής:

Η γραμμή πλαισίου εφαρμογής στο Λογισμικό είναι μια συλλογή από πλακίδια στη σελίδα λεπτομερειών μιας εφαρμογής, τα οποία εμφανίζουν τις ακόλουθες λεπτομέρειες.

Αυτό δείχνει τη γραμμή πλαισίου εφαρμογής για την εφαρμογή Λογισμικό:

Τα πλακίδια εμφανίζονται με τη σειρά που αναφέρεται παραπάνω (ξεκινώντας με το πλακίδιο Αποθήκευση στα αριστερά).

Κάθε πλακίδιο αναλύεται παρακάτω.

Το Λογισμικό εμφανίζει ένα πλακίδιο αποθήκευσης στη σελίδα λεπτομερειών για μια εφαρμογή. Εάν η εφαρμογή δεν είναι εγκατεστημένη, αυτό εμφανίζει το εκτιμώμενο μέγεθος λήψης που απαιτείται για την εγκατάστασή της. Εάν η εφαρμογή είναι εγκατεστημένη, εμφανίζει τον χώρο αποθήκευσης που χρησιμοποιείται από την εφαρμογή.

Τα μεγέθη υπολογίζονται από δεδομένα που παρέχονται από το σύστημα υποστήριξης του Λογισμικού (όπως το flatpak ή ένα RPM) και δεν καθορίζονται στα μεταδεδομένα που παρέχονται από την εφαρμογή. Δεν μπορείτε να κάνετε τίποτα για να επηρεάσετε αυτό το πλακίδιο επεξεργαζόμενοι το αρχείο metainfo μιας εφαρμογής. Αναφέρεται εδώ για λόγους πληρότητας.

Το Λογισμικό εμφανίζει ένα πλακίδιο ασφάλειας στη σελίδα λεπτομερειών για μια εφαρμογή. Αυτό συνοψίζει πληροφορίες σχετικά με το εάν η εφαρμογή μπορεί να θεωρηθεί ασφαλής για εγκατάσταση και εκτέλεση ή εάν ενδέχεται να απαιτείται προσοχή πριν την εμπιστευτείτε.

Αυτό το πλακίδιο συνδυάζει πληροφορίες σχετικά με τα δικαιώματα που ζητά η εφαρμογή όταν εκτελείται (όπως άδεια ανάγνωσης των αρχείων σας), με πληροφορίες σχετικά με τον τρόπο ανάπτυξης της εφαρμογής. Οι εφαρμογές ελεύθερου λογισμικού, όπου ο πηγαίος κώδικας είναι δημόσια αναγνώσιμος, μπορεί να είναι πιο ασφαλείς από τις ιδιόκτητες, καθώς μπορούν να ελεγχθούν.

Ο διάλογος που εμφανίζεται όταν κάνετε κλικ στο πλακίδιο παραθέτει τα διαφορετικά δικαιώματα που ζητά η εφαρμογή, καθώς και ορισμένες πληροφορίες σχετικά με την άδεια χρήσης και το περιβάλλον εκτέλεσής της.

Μπορείτε να βελτιώσετε τις πληροφορίες ασφάλειας:

Το Λογισμικό εμφανίζει ένα πλακίδιο υποστήριξης υλικού στη σελίδα λεπτομερειών για μια εφαρμογή. Αυτό συνδυάζει πληροφορίες σχετικά με τις απαιτήσεις υλικού της εφαρμογής και τις δυνατότητες υλικού του υπολογιστή, με στόχο την επισήμανση ασυμβατοτήτων ή ελλείψεων — ή για να υποδείξει ότι η εφαρμογή θα πρέπει να λειτουργεί σωστά χωρίς ασυμβατότητες.

Ο κώδικας εξετάζει το ακόλουθο υλικό. Περισσότερα ενδέχεται να υποστηριχθούν στο μέλλον.

Δεν είναι δυνατός ο αξιόπιστος εντοπισμός της παρουσίας ενός χειριστηρίου παιχνιδιών, καθώς συχνά παραμένουν αποσυνδεδεμένα λόγω του ότι δεν απαιτούνται για την κανονική χρήση του υπολογιστή.

Ο διάλογος που εμφανίζεται όταν κάνετε κλικ στο πλακίδιο παραθέτει τις διαφορετικές απαιτήσεις υλικού της εφαρμογής και εάν κάποια από αυτές δεν πληρούται.

Μπορείτε να βελτιώσετε τις πληροφορίες υλικού:

Το Λογισμικό εμφανίζει ένα πλακίδιο ηλικιακής αξιολόγησης στη σελίδα λεπτομερειών για μια εφαρμογή. Αυτό δείχνει για ποιο ηλικιακό εύρος πρέπει να είναι κατάλληλη η εφαρμογή, με βάση τα διαφορετικά είδη περιεχομένου που έχει δηλώσει η εφαρμογή ότι περιέχει. Αυτές οι πληροφορίες συνοψίζονται σε μια μορφή παρόμοια με τα πιστοποιητικά αξιολόγησης παιχνιδιών ή ταινιών για τη χώρα σας.

Για παράδειγμα, αυτό θα επισημάνει εάν ένα παιχνίδι περιέχει βία ή εάν μια εφαρμογή περιέχει διαφημίσεις εντός της εφαρμογής.

Ο διάλογος που εμφανίζεται όταν κάνετε κλικ στο πλακίδιο παραθέτει τους διαφορετικούς τύπους περιεχομένου στην εφαρμογή και πόσο σοβαρό είναι αυτό το περιεχόμενο.

Μπορείτε να βελτιώσετε τις πληροφορίες ηλικιακής αξιολόγησης:

Το Λογισμικό εμφανίζει ένα πλακίδιο που υποδεικνύει εάν μια εφαρμογή είναι ελεύθερο λογισμικό ή εάν η άδειά της είναι ιδιόκτητη, ειδική ή άγνωστη. Αυτό το πλακίδιο περιλαμβάνει πιο λεπτομερείς πληροφορίες σχετικά με την άδεια χρήσης του έργου. Επίσης, παραθέτει μερικά από τα οφέλη του ελεύθερου λογισμικού. Μάθετε περισσότερα

Μερικές φορές οι πληροφορίες άδειας χρήσης δεν είναι σωστές για μια εφαρμογή, και ως εκ τούτου μια εφαρμογή που είναι στην πραγματικότητα ελεύθερο λογισμικό θα εμφανίζεται ως «ιδιόκτητη». Ομοίως, μερικές φορές οι πληροφορίες άδειας χρήσης είναι άγνωστες.

Το Λογισμικό επισημαίνει τις άδειες ελεύθερου και ανοιχτού κώδικα με πράσινο χρώμα, τις ιδιόκτητες και ειδικές άδειες με κίτρινο χρώμα, όπως φαίνεται εδώ. Οι άγνωστες άδειες επισημαίνονται με γκρι χρώμα.

Μπορείτε να προσθέσετε ή να βελτιώσετε τις πληροφορίες άδειας χρήσης:

Το Λογισμικό εμφανίζει μια λίστα συνδέσμων πόρων της εφαρμογής στο πλακίδιο συνδέσμων. Είναι οι εξής:

Ορισμένοι ή όλοι αυτοί οι σύνδεσμοι ενδέχεται να υπάρχουν ανάλογα με το αν αναφέρονται στο αρχείο metainfo της εφαρμογής.

Σε περιπτώσεις που το αρχείο metainfo της εφαρμογής δεν περιέχει κανέναν σύνδεσμο, θα εμφανίζεται το ακόλουθο πλακίδιο με ένα ερωτηματικό.

Μπορείτε να βελτιώσετε τους συνδέσμους:

Οι εφαρμογές που προβάλλονται από το Λογισμικό εμφανίζονται σε ένα καρουζέλ στο επάνω μέρος του κύριου παραθύρου, όπως φαίνεται εδώ. Κάθε πλακίδιο καρουζέλ έχει ένα χρώμα παρασκηνίου που εξάγεται αυτόματα από το εικονίδιο της εφαρμογής. Μερικές φορές αυτό το χρώμα παρασκηνίου δεν είναι απολύτως σωστό για την εφαρμογή και πρέπει να καθοριστεί ρητά από τον προγραμματιστή της εφαρμογής.

Το σύνολο των εφαρμογών που προβάλλονται αποφασίζεται από τους συντηρητές της διανομής Linux.

Μπορείτε να βελτιώσετε το πλακίδιο καρουζέλ:

Τα μεταδεδομένα που χρησιμοποιούνται για να καθορίσουν τι υλικό απαιτεί ένα λογισμικό, για ποιες ηλικίες χρηστών είναι κατάλληλο και παράγοντες που συμβάλλουν στο πόσο ασφαλής μπορεί να είναι η εγκατάστασή του, προέρχονται όλα από το αρχείο metainfo για το συγκεκριμένο λογισμικό.

Το αρχείο metainfo είναι ένα αρχείο XML. Η μορφή του αρχείου καθορίζεται στην προδιαγραφή AppStream.

Δείτε το αρχείο metainfo για την εφαρμογή Αρχεία GNOME.

Εάν λείπουν ορισμένα μεταδεδομένα για μια εφαρμογή, το Λογισμικό μπορεί μόνο να υποθέσει ποια μπορεί να είναι, και ως εκ τούτου δεν μπορεί να παρουσιάσει πολλές πληροφορίες στις διεπαφές του. Οι εικασίες που κάνει το Λογισμικό βασίζονται στο γεγονός ότι το περισσότερο λογισμικό είναι σχεδιασμένο για επιτραπέζιους υπολογιστές.

Μπορείτε να βοηθήσετε στη βελτίωση των μεταδεδομένων για μια εφαρμογή!

Εάν διαπιστώσετε ότι από τη σελίδα μιας εφαρμογής λείπουν πληροφορίες ή έχει λανθασμένες πληροφορίες, μπορείτε να συνεισφέρετε με έναν από τους δύο τρόπους:

Και για τα δύο, πρέπει πρώτα να βρείτε τη σελίδα έργου της εφαρμογής. Ο σύνδεσμος προς τη σελίδα έργου θα πρέπει τυπικά να είναι διαθέσιμος στη σελίδα της εφαρμογής όπως φαίνεται εδώ. Εάν όχι, θα χρειαστεί να τον βρείτε με μια απλή αναζήτηση στο Google.

Οι εφαρμογές φιλοξενούνται συνήθως στο GitLab ή στο GitHub. Για παράδειγμα, οι εφαρμογές GNOME φιλοξενούνται στο gitlab.gnome.org.

Οι πληροφορίες στιγμιότυπων για μια εφαρμογή αποθηκεύονται στο στοιχείο <screenshots> εντός του <component> της εφαρμογής στο αρχείο metainfo της.

Ο προτεινόμενος αριθμός στιγμιότυπων οθόνης για μια εφαρμογή είναι μεταξύ 5 και 10. Τα στιγμιότυπα θα πρέπει ιδανικά να είναι σε μορφή PNG με αναλογία διαστάσεων 16:9 και ελάχιστο πλάτος 620 pixels.

Για παράδειγμα, εδώ είναι οι καταχωρήσεις στιγμιότυπων για την εφαρμογή Λογισμικό:

<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 της εφαρμογής, καθορίζοντας ποια κενά στην αμμοδόχο (sandbox) απαιτεί η εφαρμογή. Κάθε ένα από αυτά τα κενά συμβάλλει συνήθως στη μείωση του εμφανιζόμενου επιπέδου ασφάλειας της εφαρμογής στο Λογισμικό — μετακινώντας το από «ασφαλές» σε «δυνητικά μη ασφαλές» ή «μη ασφαλές».

Προκειμένου να βελτιωθεί το επίπεδο ασφάλειας μιας εφαρμογής, η αμμοδόχος (sandboxing) της πρέπει να γίνει όσο το δυνατόν πιο αυστηρή, αφαιρώντας δικαιώματα αμμοδόχου όπου δεν χρειάζονται, και χρησιμοποιώντας πύλες (portals) αντί για δικαιώματα αμμοδόχου όπου είναι δυνατόν. Η χρήση πυλών δεν μειώνει το εμφανιζόμενο επίπεδο ασφάλειας μιας εφαρμογής στο Λογισμικό.

Για παράδειγμα, εάν η εφαρμογή ζητά πρόσβαση ανάγνωσης/εγγραφής σε ολόκληρο το σύστημα αρχείων (--filesystem=host), το χρειάζεται πραγματικά αυτό ή χρειάζεται μόνο πρόσβαση σε αρχεία σε μερικές συγκεκριμένες τοποθεσίες; Εάν ναι, θα μπορούσε να χρησιμοποιηθεί η πύλη αρχείων ή να καθοριστούν πιο συγκεκριμένα δικαιώματα συστήματος αρχείων.

Εάν η εφαρμογή λειτουργεί σε Wayland και χρειάζεται να λειτουργήσει σε X11 μόνο ως εφεδρεία, χωρίς να χρησιμοποιεί ειδικές λειτουργίες του X11, θα μπορούσε να χρησιμοποιήσει το --socket=fallback-x11 αντί για το --socket=x11;

Οδηγίες σχετικά με συγκεκριμένα δικαιώματα ή άλλες μορφές πακεταρίσματος ενδέχεται να προστεθούν εδώ στο μέλλον.

Περαιτέρω ανάγνωση:

Οι πληροφορίες υλικού για μια εφαρμογή αποθηκεύονται στα στοιχεία <requires>, <recommends> και <supports> εντός του <component> της εφαρμογής στο αρχείο metainfo της.

Το Λογισμικό κατανοεί τα στοιχεία <control> και <display_length>.

Δείτε αυτή την ανάρτηση ιστολογίου ή αυτή την ανάρτηση ιστολογίου για παραδείγματα μεταδεδομένων.

Οι πληροφορίες αξιολόγησης περιεχομένου για μια εφαρμογή αποθηκεύονται στο στοιχείο <content_rating> εντός του <component> της εφαρμογής στο αρχείο metainfo της.

Οι εφαρμογές πρέπει να χρησιμοποιούν το πρότυπο OARS 1.1 για να συμπληρώσουν αυτό το στοιχείο. Εάν το στοιχείο <content_rating> δεν έχει καθοριστεί, η αξιολόγηση περιεχομένου της εφαρμογής είναι άγνωστη. Εάν έχει καθοριστεί αλλά είναι κενό, η εφαρμογή δεν έχει περιεχόμενο που μπορεί να είναι ακατάλληλο για οποιοδήποτε κοινό.

Χρησιμοποιήστε τη γεννήτρια OARS για να δημιουργήσετε κατάλληλες πληροφορίες αξιολόγησης περιεχομένου για μια εφαρμογή.

Οι πληροφορίες αδειοδότησης για μια εφαρμογή αποθηκεύονται στο στοιχείο <project_license> εντός του <component> της εφαρμογής στο αρχείο metainfo της.

Το περιεχόμενο σε αυτό το στοιχείο πρέπει να είναι μια έκφραση 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>

Περαιτέρω ανάγνωση:

Οι σύνδεσμοι για μια εφαρμογή αποθηκεύονται ως στοιχεία <url> εντός του <component> της εφαρμογής στο αρχείο metainfo της.

Προσθέστε όσους από τους τύπους συνδέσμων τεκμηριώνονται στην προδιαγραφή 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>

Το χρώμα παρασκηνίου του πλακιδίου καρουζέλ εξάγεται κανονικά αυτόματα από το εικονίδιο της εφαρμογής. Εάν αυτό το χρώμα δεν είναι ικανοποιητικό, ωστόσο, μπορεί να παρακαμφθεί χρησιμοποιώντας το στοιχείο <branding/> του appstream με δηλωμένα χρώματα (από τη σειρά 47.x). Το πλεονέκτημα είναι ότι περισσότεροι πελάτες μπορούν να χρησιμοποιήσουν τα χρώματα.

Για παράδειγμα, εδώ είναι μερικές καταχωρήσεις επωνυμίας:

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

Έχει απομείνει, για λόγους συμβατότητας προς τα πίσω, η δυνατότητα προσθήκης του ακόλουθου XML στο στοιχείο <component> του metainfo της εφαρμογής:

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

αλλά το στοιχείο <branding/> έχει προτεραιότητα.

Η τιμή του GnomeSoftware::key-colors είναι ένα GVariant μορφής κειμένου με τύπο a(yyy) και αντιπροσωπεύει ένα μη διατεταγμένο σύνολο βασικών χρωμάτων για την εφαρμογή. Κάθε στοιχείο του συνόλου είναι ένα χρώμα σε μορφή RGB που κυμαίνεται από (0, 0, 0) έως (255, 255, 255).

Τα χρώματα πρέπει να επιλέγονται έτσι ώστε:

Τουλάχιστον ένα χρώμα πρέπει να καθοριστεί. Μπορούν να καθοριστούν περισσότερα εάν ένα χρώμα δεν μπορεί να ικανοποιήσει όλες τις παραπάνω απαιτήσεις, και το Λογισμικό θα επιλέξει το πιο κατάλληλο για χρήση στο πλακίδιο καρουζέλ. Εάν καθοριστεί ακριβώς ένα χρώμα, η φωτεινότητα και ο κορεσμός του μπορεί να τροποποιηθούν για να βελτιωθεί η αντίθεση με το χρώμα προσκηνίου. Εάν καθοριστούν περισσότερα από ένα χρώματα, θα επιλεγεί αυτό με την καλύτερη αντίθεση με το χρώμα προσκηνίου και η φωτεινότητα και ο κορεσμός του δεν θα τροποποιηθούν.

Τροποποιήστε το αρχείο metainfo για την εφαρμογή σας και στη συνέχεια εκτελέστε το Λογισμικό με:

gnome-software --show-metainfo=/διαδρομή/προς/εφαρμογή.metainfo.xml,icon=/διαδρομή/προς/εφαρμογή/εικονίδιο.png

Θα εμφανιστεί η σελίδα λεπτομερειών για την εφαρμογή σας. Εάν επιστρέψετε στη σελίδα επισκόπησης του Λογισμικού, η εφαρμογή σας θα είναι η μοναδική στο καρουζέλ «προβεβλημένα».