Επικυρωτής Web App Manifest

Μια Προοδευτική Εφαρμογή Ιστού (PWA) εγκαθίσταται σωστά μόνο όταν το manifest.json ικανοποιεί τα πεδία που ελέγχουν πραγματικά οι browsers και τα app stores. Αυτός ο επικυρωτής αναλύει το manifest που ανεβάσατε και διατρέχει πεδίο προς πεδίο την προδιαγραφή W3C Web App Manifest: επισημαίνει ελλείποντα name και short_name, κενό ή κακοσχηματισμένο πίνακα icons, εικονίδια χωρίς src, sizes ή type, μη αναγνώσιμο start_url, μη αναγνωρισμένη τιμή display και συμβολοσειρές theme_color ή background_color που δεν είναι έγκυρα χρώματα CSS. Κάθε εύρημα εμφανίζεται ως πρόταση σε απλή γλώσσα — όχι ως παράθεση προδιαγραφής — ώστε να ξέρετε ακριβώς τι να διορθώσετε και γιατί έχει σημασία για την εγκαταστασιμότητα.

Το χαρακτηριστικό-κλειδί είναι η προεπισκόπηση ζώνης ασφαλείας maskable εικονιδίων. Τα προσαρμοστικά εικονίδια του Android εφαρμόζουν μια μάσκα σχήματος επιλεγμένου από το ΛΣ — κύκλος, τετράγωνο με στρογγυλεμένες γωνίες, σταγόνα και άλλα — σε οποιοδήποτε εικονίδιο φέρει "purpose": "maskable". Οτιδήποτε βρίσκεται εκτός ενός κεντρικού κύκλου που καλύπτει το 40% του οπτικού πεδίου του εικονιδίου μπορεί να περικοπεί ανάλογα με τη μάσκα που εφαρμόζει η συσκευή. Ανεβάστε τα αρχεία εικόνων εικονιδίων που αναφέρονται στο manifest μαζί με το manifest.json και το εργαλείο τα αντιστοιχίζει βάσει ονόματος αρχείου, σχεδιάζει κάθε maskable εικονίδιο σε ένα canvas στο δηλωμένο μέγεθός του και υπερθέτει αυτόν ακριβώς τον κύκλο ασφαλούς ζώνης για να δείτε με τα μάτια σας αν το γραφικό σας επιβιώνει της περικοπής.

Η ένδειξη επιτυχίας/αποτυχίας κάτω από κάθε προεπισκόπηση δεν είναι ένα διακοσμητικό στοιχείο λίστας ελέγχου — προέρχεται από πραγματική ανάλυση ανά pixel των αποκωδικοποιημένων δεδομένων εικόνας. Το εργαλείο μετρά πόσο μη-φόντο περιεχόμενο βρίσκεται εκτός του κύκλου ασφαλούς ζώνης (περιεχόμενο που μια μάσκα θα έκοβε) και πόσο μέρος του εικονιδίου είναι διαφανές (τα maskable εικονίδια πρέπει να έχουν πλήρως αδιαφανές φόντο, αφού η διαφάνεια αφήνει το χρώμα της μάσκας να φαίνεται). Και οι δύο έλεγχοι εκτελούνται πάνω στην πραγματική εικόνα που ανεβάσατε, οπότε το αποτέλεσμα αντικατοπτρίζει το πραγματικό σας αρχείο εικονιδίου, όχι μια εικασία.

Όλα γίνονται τοπικά στον browser σας: το manifest.json διαβάζεται με το File API, τα εικονίδια αποκωδικοποιούνται με createImageBitmap ή με FileReader/Image ως εναλλακτική και τα pixel αναλύονται σε ένα in-memory canvas. Τίποτα δεν αποστέλλεται σε διακομιστή, κάτι που έχει σημασία αν το manifest σας αναφέρει όνομα εφαρμογής που δεν είναι ακόμα δημόσιο, εσωτερικές διαδρομές start_url ή εικονίδια υπό ανάπτυξη.