המנגנון לקישור דינמי מתמודד עם שני אתגרים בעיצוב Treble VNDK:
- ספריות משותפות של SP-HAL וקשרי התלות שלהן, כולל VNDK-SP של הספריות נטענות לתהליכי framework. צריכות להיות כמה מנגנונים למניעת התנגשויות בין סמלים.
dlopen()
ו-android_dlopen_ext()
יכולים להציג יחסי תלות מסוימים של סביבת זמן הריצה שלא ניתן לראות בזמן ה-build, והם עלולים שקשה לזהות באמצעות ניתוח סטטי.
אפשר לפתור את שני האתגרים האלה באמצעות מרחב השמות של המקשר על מנגנוני תשומת לב. המנגנון הזה מסופק על-ידי המקשר הדינמי. הוא הוא יכול לבודד את הספריות המשותפות במרחבי שמות של מקשרים שונים, ספריות שהשם שלהן זהה אבל עם סמלים שונים לא יתנגשו.
מצד שני, מנגנון מרחב השמות המקשר מספק את הגמישות כדי שאפשר יהיה לייצא חלק מהספריות המשותפות באמצעות מרחב שמות של מקשר ולהשתמש בהן מרחב שמות אחר של מקשר. הספריות המשותפות המיוצאות יכולות להפוך ממשקי תכנות יישומים שגלויים לכולם לתוכנות אחרות בזמן להסתיר את פרטי ההטמעה במרחבי השמות המקשרים.
לדוגמה, /system/lib[64]/libcutils.so
וגם
/system/lib[64]/vndk-sp-${VER}/libcutils.so
הם שני סוגים משותפים
של הספריות. לשתי הספריות האלה יכולים להיות סמלים שונים. הם נטענו
במרחבי שמות שונים לקישור, כך שמודולים של framework יוכלו להיות תלויים
ספריות משותפות של /system/lib[64]/libcutils.so
ו-SP-HAL יכולות
תלויות ב-/system/lib[64]/vndk-sp-${VER}/libcutils.so
.
לעומת זאת, /system/lib[64]/libc.so
הוא דוגמה ל
ספרייה ציבורית שמיוצאת על ידי מרחב שמות של מקשר ומיובאת אל
מרחבי שמות רבים של מקשרים. יחסי התלות של
/system/lib[64]/libc.so
, כמו libnetd_client.so
,
נטענות למרחב השמות שבו /system/lib[64]/libc.so
גרים ב-Google. למרחבי שמות אחרים לא תהיה גישה ליחסי התלות האלה. הזה
כולל את פרטי ההטמעה וגם מספק לציבור
ממשקים.
איך זה עובד
המנגנון לקישור דינמי אחראי לטעון את הספריות המשותפות שצוינו
ב-DT_NEEDED
רשומות או בספריות המשותפות שצוינו על ידי
ארגומנט dlopen()
או android_dlopen_ext()
. בשניהם
במקרים מסוימים, המקשר הדינמי מוצא את מרחב השמות המקשר שבו מבצע הקריאה החוזרת (caller)
נמצא ומנסה לטעון את יחסי התלות לאותו מרחב שמות של מקשר. אם המיקום
המקשר הדינמי לא יכול לטעון את הספרייה המשותפת למנגנון לקישור שצוין
הוא מציג בקשה למרחב השמות של המקשר המקושרים לייצוא הנתונים המשותפים
של הספריות.
הפורמט של קובץ התצורה
הפורמט של קובץ התצורה מבוסס על פורמט הקובץ INI. טיפוסית קובץ תצורה נראה כך:
dir.system = /system/bin dir.system = /system/xbin dir.vendor = /vendor/bin [system] additional.namespaces = sphal,vndk namespace.default.isolated = true namespace.default.search.paths = /system/${LIB} namespace.default.permitted.paths = /system/${LIB}/hw namespace.default.asan.search.paths = /data/asan/system/${LIB}:/system/${LIB} namespace.default.asan.permitted.paths = /data/asan/system/${LIB}/hw:/system/${LIB}/hw namespace.sphal.isolated = true namespace.sphal.visible = true namespace.sphal.search.paths = /odm/${LIB}:/vendor/${LIB} namespace.sphal.permitted.paths = /odm/${LIB}:/vendor/${LIB} namespace.sphal.asan.search.paths = /data/asan/odm/${LIB}:/odm/${LIB} namespace.sphal.asan.search.paths += /data/asan/vendor/${LIB}:/vendor/${LIB} namespace.sphal.asan.permitted.paths = /data/asan/odm/${LIB}:/odm/${LIB} namespace.sphal.asan.permitted.paths += /data/asan/vendor/${LIB}:/vendor/${LIB} namespace.sphal.links = default,vndk namespace.sphal.link.default.shared_libs = libc.so:libm.so namespace.sphal.link.vndk.shared_libs = libbase.so:libcutils.so namespace.vndk.isolated = true namespace.vndk.search.paths = /system/${LIB}/vndk-sp-29 namespace.vndk.permitted.paths = /system/${LIB}/vndk-sp-29 namespace.vndk.links = default namespace.vndk.link.default.shared_libs = libc.so:libm.so [vendor] namespace.default.isolated = false namespace.default.search.paths = /vendor/${LIB}:/system/${LIB}
קובץ התצורה כולל את:
- יש בהתחלה כמה מאפיינים של מיפוי של קטעי ספריות עבור הרכיב מקשר דינמי כדי לבחור את הקטע בפועל.
-
כמה קטעי הגדרה של מרחבי שמות של מקשרים:
- כל קטע מכיל מספר מרחבי שמות (קודקודים של גרף) קישורים חלופיים בין מרחבי שמות (הקשתות בתרשים).
- לכל מרחב שמות יש בידוד, נתיבי חיפוש, נתיבים מותרים, והגדרות החשיפה.
בטבלאות שבהמשך מתוארת המשמעות של כל מאפיין בפירוט.
מאפיין למיפוי קטעים של ספרייה
נכס | תיאור | דוגמה |
---|---|---|
|
נתיב לספרייה שהקטע כל מאפיין ממפה את קובצי ההפעלה בספרייה למקשרים
הגדרות של מרחבי שמות. יכולים להיות שני נכסים (או יותר)
יש להם את אותו |
דבר זה מציין שהתצורה שצוינה
הקטע ההגדרות האישיות שצוינו בקטע |
מאפייני קשר
נכס | תיאור | דוגמה |
---|---|---|
additional. |
רשימה מופרדת בפסיקים של מרחבי שמות נוספים (בנוסף
|
הדבר מציין שיש שלושה מרחבי שמות ( |
namespace. |
רשימה של מרחבי שמות חלופיים שמופרדים בפסיקים. אם לא ניתן למצוא ספרייה משותפת במרחב השמות הנוכחי, מקשר מנסה לטעון את הספרייה המשותפת ממרחבי השמות החלופיים. למרחב השמות שצוין בתחילת הרשימה יש עדיפות גבוהה יותר. |
אם ספרייה משותפת או קובץ הפעלה מבקשים ספרייה משותפת
לא ניתן לטעון אותו למרחב השמות ואז, אם לא ניתן לטעון את הספרייה המשותפת
גם מרחב השמות לבסוף, אם כל הניסיונות ייכשלו, המנגנון לקישור הדינמי יחזיר שגיאה. |
namespace. |
רשימה מופרדת בנקודתיים של ספריות משותפות, שניתן לחפש ב
לא ניתן להשתמש בנכס הזה יחד עם
|
האפשרות הזו מציינת שהקישור החלופי מקבל רק |
namespace. |
ערך בוליאני שמציין אם כל הספריות המשותפות יכולות
לבצע חיפוש במרחב השמות של לא ניתן להשתמש בנכס הזה יחד עם
|
האפשרות הזו מציינת שאפשר לעבור על הקישור החלופי לכל שמות הספריות
מ- |
מאפיינים של מרחב שמות
נכס | תיאור | דוגמה |
---|---|---|
namespace. |
ערך בוליאני שמציין אם על המקשר הדינמי לבדוק שבה נמצאת הספרייה המשותפת. אם הערך של אם הערך של |
מציין שרק הספריות המשותפות ב-
|
namespace. |
רשימת ספריות המופרדות בנקודתיים לחיפוש משותפות של הספריות. הספריות שצוינו ב- כשהערך בשדה לדוגמה, אם |
זה מצביע על כך שהחיפוש המקשר הדינמי
|
namespace. |
רשימת ספריות המופרדות בנקודתיים, לחיפוש ספריות משותפות AddressSanitizer (ASan) מופעלת.
|
המשמעות היא שכאשר
ב-ASan מפעילים את
מקשר דינמי מחפש קודם |
namespace. |
רשימת ספריות המופרדות בנקודתיים (כולל ספריות משנה) כאשר
המקשר הדינמי יכול לטעון את הספריות המשותפות (בנוסף
הספריות המשותפות שנמצאות בספריות המשנה של
ניתן גם לטעון את אם הערך של |
מציין שהספריות המשותפות
אפשר לטעון את לדוגמה, בלי |
namespace. |
רשימת ספריות המופרדות בנקודתיים שבהן ניתן לטעון את ה-Linker הדינמי הספריות המשותפות כאשר ASan מופעל.
|
מציין כי כאשר ASan מופעל
ספריות משותפות בדומיין |
namespace. |
ערך בוליאני שמציין אם התוכנית (מלבד
אם הערך של אם הערך של |
זה מציין ש |
יצירת מרחב שמות של מקשר
ב-Android 11, הגדרת המקשר נוצרת בזמן ריצה בקטע
/linkerconfig
במקום להשתמש בקובצי טקסט פשוט ב-
${android-src}/system/core/rootdir/etc
. ההגדרה נוצרת בזמן האתחול
מבוסס על סביבת זמן הריצה, שכוללת את הפריטים הבאים:
- אם המכשיר תומך ב-VNDK
- גרסת היעד של VNDK למחיצת הספק
- גרסת VNDK של קטגוריית המוצרים
- מודולים של APEX הותקנו
הגדרת מקשר נוצרת על ידי פתרון יחסי התלות בין מרחבי שמות של מקשרים. עבור
לדוגמה, אם יש עדכונים במודולים של APEX שכוללים עדכונים של תלות, מקשר
נוצרת שמשקפת את השינויים האלה. פרטים נוספים ליצירת הגדרת מקשר
ניתן למצוא ב
${android-src}/system/linkerconfig
בידוד של מרחב השמות של מקשר
יש שלושה סוגי הגדרות. בהתאם לערך של
PRODUCT_TREBLE_LINKER_NAMESPACES
והקבוצה
BOARD_VNDK_VERSION
ב-BoardConfig.mk
,
ההגדרה המתאימה נוצרת בזמן האתחול.
PRODUCT_TREBLE_ LINKER_NAMESPACES |
BOARD_VNDK_ VERSION |
ההגדרות האישיות שנבחרו | דרישה ל-VTS |
---|---|---|---|
true |
current |
VNDK |
חובה למכשירים עם Android מגרסה 9 ואילך |
ריק | VNDK Lite |
חובה למכשירים עם Android 8.x | |
false |
ריק | Legacy |
למכשירים שאינם טרבל |
הגדרת VNDK Lite מבודדת ספריות משותפות של SP-HAL ו-VNDK-SP. ב-Android 8.0,
חייב להיות קובץ התצורה לקישור דינמי כאשר
PRODUCT_TREBLE_LINKER_NAMESPACES
היא true
.
הגדרת VNDK גם מבודדת ספריות משותפות מסוג SP-HAL ו-VNDK-SP. In addition, ההגדרה הזו מספקת את הבידוד המלא של המקשר הדינמי. היא מבטיחה שהמודולים במחיצה של המערכת לא יהיו תלויים ספריות במחיצות הספקים ולהפך.
ב-Android מגרסה 8.1 ואילך, הגדרת ברירת המחדל היא VNDK
ומומלץ מאוד להפעיל בידוד דינמי מלא באמצעות
BOARD_VNDK_VERSION
עד current
.
הגדרת VNDK
הגדרת VNDK מבודדת את יחסי התלות של הספרייה המשותפת בין מחיצת המערכת למחיצות של הספק. בהשוואה ל וההגדרות האישיות שהוזכרו בקטע המשנה הקודם, מפורטות כך:
-
תהליכי מסגרת
default
,vndk
נוצרים מרחבי שמותsphal
ו-rs
.- כל מרחבי השמות מבודדים.
- ספריות משותפות של המערכת נטענות למרחב השמות
default
. - דפי SP-HAL נטענים למרחב השמות של
sphal
. - ספריות משותפות של VNDK-SP נטענות במרחב השמות
vndk
.
-
תהליכי ספקים
- נוצרים מרחבי השמות
default
,vndk
ו-system
. - מרחב השמות
default
מבודד. - ספריות משותפות של ספקים נטענות למרחב השמות
default
. - ספריות משותפות של VNDK ו-VNDK-SP נטענות למרחב השמות
vndk
. - LL-NDK ויחסי התלות שלו נטענים למרחב השמות של
system
.
- נוצרים מרחבי השמות
הקשר בין מרחבי השמות של המקשר מתוארים בהמשך.
איור 1. בידוד של מרחב השמות של המקשר (הגדרת VNDK).
בתמונה שלמעלה, LL-NDK ו-VNDK-SP מסמנים את התיבה הבאה ספריות משותפות:
-
LL-NDK
libEGL.so
libGLESv1_CM.so
libGLESv2.so
libGLESv3.so
libandroid_net.so
libc.so
libdl.so
liblog.so
libm.so
libnativewindow.so
libneuralnetworks.so
libsync.so
libvndksupport.so
libvulkan.so
-
VNDK-SP
android.hardware.graphics.common@1.0.so
android.hardware.graphics.mapper@2.0.so
android.hardware.renderscript@1.0.so
android.hidl.memory@1.0.so
libRSCpuRef.so
libRSDriver.so
libRS_internal.so
libbase.so
libbcinfo.so
libc++.so
libcutils.so
libhardware.so
libhidlbase.so
libhidlmemory.so
libhidltransport.so
libhwbinder.so
libion.so
libutils.so
libz.so
אפשר למצוא פרטים נוספים ב/linkerconfig/ld.config.txt
במכשיר.
הגדרת VNDK Lite
החל מ-Android 8.0, המקשר הדינמי מוגדר לבודד את ה-SP-HAL ספריות משותפות של VNDK-SP, כך שהסמלים שלהן לא יתנגשו עם של ספריות משותפות. הקשר בין מרחבי השמות של המקשר הוא שמוצגת בהמשך.
LL-NDK ו-VNDK-SP הם ראשי התיבות של הספריות המשותפות הבאות:
-
LL-NDK
libEGL.so
libGLESv1_CM.so
libGLESv2.so
libc.so
libdl.so
liblog.so
libm.so
libnativewindow.so
libstdc++.so
(לא בהגדרה)libsync.so
libvndksupport.so
libz.so
(עבר אל VNDK-SP בעוד התצורה)
-
VNDK-SP
android.hardware.graphics.common@1.0.so
android.hardware.graphics.mapper@2.0.so
android.hardware.renderscript@1.0.so
android.hidl.memory@1.0.so
libbase.so
libc++.so
libcutils.so
libhardware.so
libhidlbase.so
libhidlmemory.so
libhidltransport.so
libhwbinder.so
libion.so
libutils.so
בטבלה הבאה מפורטות ההגדרות של מרחבי השמות ל-framework.
מתוך הקטע [system]
ב-
את התצורה של VNDK Lite.
מרחב שמות | נכס | ערך |
---|---|---|
default |
search.paths |
/system/${LIB} /odm/${LIB} /vendor/${LIB} /product/${LIB}
|
isolated |
false |
|
sphal |
search.paths |
/odm/${LIB} /vendor/${LIB}
|
permitted.paths |
/odm/${LIB} /vendor/${LIB}
|
|
isolated |
true |
|
visible |
true |
|
links |
default,vndk,rs |
|
link.default.shared_libs |
LL-NDK | |
link.vndk.shared_libs |
VNDK-SP | |
link.rs.shared_libs |
libRS_internal.so |
|
vndk (ל-VNDK-SP) |
search.paths |
/odm/${LIB}/vndk-sp /vendor/${LIB}/vndk-sp /system/${LIB}/vndk-sp-${VER}
|
permitted.paths |
/odm/${LIB}/hw /odm/${LIB}/egl /vendor/${LIB}/hw /vendor/${LIB}/egl /system/${LIB}/vndk-sp-${VER}/hw |
|
isolated |
true |
|
visible |
true |
|
links |
default |
|
link.default.shared_libs |
LL-NDK | |
rs (ל-RenderScript) |
search.paths |
/odm/${LIB}/vndk-sp /vendor/${LIB}/vndk-sp /system/${LIB}/vndk-sp-${VER} /odm/${LIB} /vendor/${LIB}
|
permitted.paths |
/odm/${LIB} /vendor/${LIB} /data (לליבת RS שעבר הידור)
|
|
isolated |
true |
|
visible |
true |
|
links |
default,vndk |
|
link.default.shared_libs |
LL-NDKlibmediandk.so libft2.so
|
|
link.vndk.shared_libs |
VNDK-SP |
בטבלה הבאה מוצגות ההגדרות של מרחבי השמות בשביל תהליכי ספקים,
מתוך הקטע [vendor]
את התצורה של VNDK Lite.
מרחב שמות | נכס | ערך |
---|---|---|
default |
search.paths |
/odm/${LIB} /odm/${LIB}/vndk /odm/${LIB}/vndk-sp
/vendor/${LIB} /vendor/${LIB}/vndk
/vendor/${LIB}/vndk-sp /system/${LIB}/vndk-${VER} /system/${LIB}/vndk-sp-${VER} /system/${LIB} (הוצאה משימוש)/product/${LIB} (הוצא משימוש)
|
isolated |
false |
אפשר למצוא פרטים נוספים ב/linkerconfig/ld.config.txt
מהמכשיר.
היסטוריית מסמכים
שינויים ב-Android 11
- ב-Android 11, קובצי
ld.config.*.txt
הסטטיים שהוסרו מ-codebase ו-LinkerConfig יוצר אותן בזמן הריצה במקום זאת.
שינויים ב-Android 9
- ב-Android 9, מרחב השמות של המנגנון לקישור בין
vndk
מתווסף לספק של תהליכים וספריות משותפות של VNDK מבודדות ממנגנון הקישור המוגדר כברירת מחדל מרחב שמות. - החלפה של
PRODUCT_FULL_TREBLE
במילים ספציפיות יותרPRODUCT_TREBLE_LINKER_NAMESPACES
. - ב-Android 9 השמות של ההגדרות האישיות לקישור דינמי מחדש השתנו
.
Android מגרסה 8.x 9 Android תיאור ld.config.txt.in
ld.config.txt
במכשירים שבהם יש בידוד של מרחב השמות שמקשר לזמן ריצה ld.config.txt
ld.config.vndk_lite.txt
במכשירים עם בידוד של מרחב השמות לקישור VNDK-SP ld.config.legacy.txt
ld.config.legacy.txt
במכשירים מדור קודם עם Android 7.x ומטה - הסרה של
android.hardware.graphics.allocator@2.0.so
. product
ו-odm
נוספו.