מודול MediaProvider

מודול MediaProvider מבצע אופטימיזציה של מטא-נתונים שעברו אינדוקס (אודיו, סרטונים ותמונות מכרטיסי SD וממכשירי USB) ומאפשר לאפליקציות לגשת לנתונים האלה באמצעות ממשקי ה-API הציבוריים של MediaStore. כדי לשמור על פרטיות המשתמשים, מודול MediaProvider אוכף את מודל האבטחה של אחסון בהיקף מוגבל שהוצג ב-Android 10, שכולל צנזורה של מטא-נתונים רגישים של מיקום. אפשר לעדכן את המודול הזה, וכך מערכת Android יכולה להגיב מהר יותר לבעיות אבטחה (ולשמור על נתוני משתמשים רגישים), ולהוסיף מהר יותר פורמטים חדשים של מדיה (ולספק עקביות למשתמשים ולמפתחים).

שינויים ב-Android 10

ב-Android 10 הוספנו כמה שיפורים שקשורים לזיהוי ולחילוץ של נתונים מקובצי מדיה, ובמיוחד:

• קביעת סוג התוכן של הקובץ באמצעות החלק הראשון של סוג ה-MIME של הקובץ. לדוגמה, מערכת ההפעלה יודעת שגם image/png וגם image/x-newly-invented-format הם תמונות, ולכן היא יכולה לתאר בצורה מדויקת את ההרשאות הרלוונטיות למשתמש הקצה.

• קביעת סוג ה-MIME באמצעות סיומת הקובץ בלבד (ובלי להשתמש בזיהוי תוכן כדי למנוע בעיות אבטחה).

• קביעת סוג ה-MIME של קובץ שרירותי באמצעות שילוב של מיפויים של Debian Linux ו-Android במעלה הזרם.

• החזרת נתונים רלוונטיים מקובצי video/* ו-audio/* (דרך MediaMetadataRetriever) ומקובצי image/* (דרך ExifInterface).

שינויים ב-Android 11

ב-Android 11, מודול MediaProvider מבוסס על השינויים שבוצעו ב-Android 10, עם השיפורים הבאים:

• שיפורים בהוספה לאינדקס. מודול MediaProvider מבצע עכשיו אינדוקס של מטא-נתונים על ידי השוואה בין המטא-נתונים הזמינים לבין MediaStore APIs ציבוריים. השינויים כוללים:

  • עמודה חדשה is_favorite וארגומנט QUERY_ARG_MATCH_FAVORITE כדי לאפשר לאפליקציות בסגנון גלריה לסנן במהירות מדיה על סמך העמודה הזו.

  • יצירת אינדקס של מטא-נתונים של מרחב צבעים.

  • עמודה חדשה is_trashed וארגומנט QUERY_ARG_MATCH_TRASHED כדי לאפשר לאפליקציות בסגנון גלריה לסנן על סמך העמודה הזו.

  • ממשקי API חדשים שמאפשרים לבצע שינויים בכמה פריטים בבת אחת באמצעות הנחיה אחת לדיאלוג עם המשתמש, כולל createDeleteRequest(), createFavoriteRequest(), createTrashRequest() ו-createWriteRequest().

  • עמודות חדשות GENERATION_ADDED ו-GENERATION_MODIFIED לשימוש בזיהוי מהיר ואמין של שינויים שחלו מאז נקודת סנכרון קודמת.

  • GROUP BY API ציבורי חדש לשימוש בעמודות נוספות של מטא-נתונים שלא הוזכרו למעלה.

• שיפור ב-ExifInterface לחילוץ מטא-נתונים ממסמכי PNG ו-WebP.

• שיפורים ב-SystemUI לכתיבת מטא-נתונים של DateTimeOriginal בצילומי מסך.

בנוסף, עכשיו אפשר להתאים אישית את MediaProvider על ידי הוספה של פורמטים חדשים של מדיה, סימון של מכשירי אחסון שצריך ליצור להם אינדקס ואפילו החלפה של מחסנית MTP. פרטים נוספים מופיעים במאמר בנושא התאמה אישית.

גבולות המודול

ב-Android 11, כל הקוד ב-packages/providers/MediaProvider מועבר למיקום חדש, למעט לוגיקה שקשורה ל-MTP. בנוסף, frameworks/base/core/java/android/provider/MediaStore.java נמצא עכשיו בתוך גבול המודול ב-packages/providers/MediaProvider.

פורמט החבילה

המודול MediaProvider הוא בפורמט APK-in-APEX.

פניות קשורות

תלויות ב-MediaProvider קשורות להתאמות אישיות (כלומר, אם מבצעים התאמה אישית של MediaProvider, צריך לוודא שההטמעה עומדת בתלות שמשויכת להתאמה האישית).

• כשמשתמשים בפורמטים מותאמים אישית או לא סטנדרטיים של קובצי מדיה (לדוגמה, פורמט שנוצר על ידי אפליקציית מצלמה ספציפית לספק), צריך לרשום כל פורמט מותאם אישית ב-MimeUtils ובמודול Media Extractor כדי לאפשר יצירת אינדקס על ידי MediaProvider.

• כדי לוודא ש-MediaProvider מבצע אינדוקס של קבוצה מותאמת אישית של מכשירי אחסון (כמו חריצים לכרטיסי SD ויציאות USB) שמשמשים בהטמעה של StorageManagerService, צריך להגדיר את הדגל VolumeInfo.MOUNT_FLAG_INDEXABLE.

• כשמשתמשים בהטמעה מותאמת אישית של MTP (שאינה AOSP), צריך לוודא שההטמעה מסתמכת רק על ממשקי API ציבוריים ומערכתיים כדי לאפשר לה אינטראקציה עם MediaStore.

התאמה אישית

אפשר להוסיף פורמטים חדשים של מדיה, להשפיע על המכשירים לאחסון שמתווספים לאינדקס, להחליף את מחסנית MTP ולמנוע יצירה של תיקיות ברירת מחדל.

• פורמטים מותאמים אישית של מדיה. לכל פורמט מדיה מותאם אישית חדש, צריך לספק מיפוי מסיומת הקובץ הייחודית לסוג MIME. מומלץ מאוד לפעול בהתאם לתהליך הרישום של IANA.

  • אי אפשר להגדיר מחדש תוסף או סוג MIME שכבר הוגדרו ב-AOSP.

  • בקבצים video/* ו-audio/*, MediaProvider ממשיך להתייעץ עם MediaMetadataRetriever. אפשר להשתמש בכלי Media Extractors של Android 10 כדי להחזיר מטא-נתונים עבור פורמטים בהתאמה אישית.

  • בקבצים מסוג image/*, MediaProvider ממשיך להשתמש ב-Exif כמבנה הסטנדרטי למטא-נתונים. אפשר להרחיב את android.media.ExifInterface כדי לחלץ ולהחזיר מטא-נתונים של Exif לכל פורמט תמונה מותאם אישית.

• דגל לאינדוקס של התקני אחסון. ‫MediaProvider מאנדקס את כל הכרכים שמוחזרים על ידי StorageManager.getStorageVolumes() כאשר StorageVolume.getMediaStoreVolumeName() הוא לא null. אתם יכולים להתאים אישית את רשימת אמצעי האחסון שמוחזרים כדי להשפיע על מה שנוסף לאינדקס, אבל אנחנו ממליצים לא לכלול אמצעי אחסון זמניים (כמו כונני USB OTG).

• החלפת ערימת MTP. ב-Android 11, מחסנית MTP מוצבת כולה מחוץ לגבולות המודול, ופועלת מול ממשקי API ציבוריים.

• רשימת החרגות של תיקיות שמוגדרת כברירת מחדל. ‫MediaProvider יוצר את תיקיות ברירת המחדל Music/,‏ Podcasts/,‏ Ringtones/,‏ Alarms/,‏ Notifications/,‏ Pictures/,‏ Movies/,‏ Download/,‏ DCIM/,‏ Documents/,‏ Audiobooks/ ו-Recordings/ (הספרייה Recordings/ לא זמינה ב-Android 11 ובגרסאות קודמות) לנפחי אחסון חדשים שמוצמדים. ב-Android מגרסה 12 ואילך, יצרני ציוד מקורי (OEM) יכולים לספק רשימת החרגות לא תלוית-רישיות לתיקיות שספק המדיה צריך לדלג עליהן במהלך יצירת ברירת המחדל. יכול להיות שתיקיות כאלה, למשל התיקייה Download/, עדיין ייווצרו על ידי לוגיקה חיצונית.

כדי להוסיף רשימת החרגות, משתמשים בconfig_foldersToSkipInDefaultCreation runtime resource overlay (RRO). בדוגמה הבאה אפשר לראות איך להחריג את תיקיות ברירת המחדל Notifications/ ו-Ringtones/:

<string-array name="config_foldersToSkipInDefaultCreation" translatable="false">
    <item>"Notifications"</item>
    <item>"Ringtones"</item>
</string-array>

בדיקה

אפשר לאמת את הפונקציונליות של MediaProvider באמצעות הבדיקות הבאות:

• כדי לאמת את הפונקציונליות של ממשקי MediaStore ציבוריים, משתמשים בבדיקות בחבילה CtsProviderTestCases של Android Compatibility Test Suite (CTS).

• כדי לאמת את הפונקציונליות של MediaProvider internals, משתמשים בבדיקות ב-MediaProviderTests.

כדי להריץ את שתי סדרות הבדיקות יחד, משתמשים בפקודה הבאה של atest:

atest --test-mapping packages/providers/MediaProvider