Dinamik bağlayıcı, Treble VNDK tasarımında iki zorlukla mücadele eder:
- VNDK-SP kitaplıkları da dahil olmak üzere SP-HAL paylaşılan kitaplıkları ve bağımlılıkları, çerçeve süreçlerine yüklenir. Sembol çakışmalarını önlemek için bazı mekanizmalar olmalıdır.
dlopen()veandroid_dlopen_ext(), derleme sırasında görünmeyen ve statik analiz kullanılarak tespit edilmesi zor olabilen bazı çalışma zamanı bağımlılıkları oluşturabilir.
Bu iki sorun, bağlayıcı ad alanı mekanizmasıyla çözülebilir. Bu mekanizma, dinamik bağlayıcı tarafından sağlanır. Aynı kitaplık adına ancak farklı sembollere sahip kitaplıkların çakışmaması için paylaşılan kitaplıkları farklı bağlayıcı ad alanlarında izole edebilir.
Öte yandan, bağlayıcı ad alanı mekanizması, bazı paylaşılan kitaplıkların bir bağlayıcı ad alanı tarafından dışa aktarılabilmesi ve başka bir bağlayıcı ad alanı tarafından kullanılabilmesi için esneklik sağlar. Bu dışa aktarılan paylaşılan kitaplıklar, bağlayıcı ad alanlarında uygulama ayrıntılarını gizlerken diğer programlara açık olan uygulama programlama arayüzleri haline gelebilir.
Örneğin, /system/lib[64]/libcutils.so ve /system/lib[64]/vndk-sp-${VER}/libcutils.so iki paylaşılan kitaplıktır. Bu iki kitaplıkta farklı semboller olabilir. Çerçeve modüllerinin /system/lib[64]/libcutils.so'ya, SP-HAL paylaşılan kitaplıklarının ise /system/lib[64]/vndk-sp-${VER}/libcutils.so'ye bağlı olabilmesi için farklı bağlayıcı ad alanlarına yüklenirler.
Diğer yandan, /system/lib[64]/libc.so, bağlayıcı ad alanı tarafından dışa aktarılan ve birçok bağlayıcı ad alanına içe aktarılan herkese açık bir kitaplık örneğidir. /system/lib[64]/libc.so öğesinin bağımlılıkları (ör. libnetd_client.so), /system/lib[64]/libc.so öğesinin bulunduğu ad alanına yüklenir. Diğer ad alanları bu bağımlılıklara erişemez. Bu mekanizma, herkese açık arayüzler sağlarken uygulama ayrıntılarını kapsar.
İşleyiş şekli
Dinamik bağlayıcı, DT_NEEDED girişlerinde belirtilen paylaşılan kitaplıkları veya dlopen() ya da android_dlopen_ext() bağımsız değişkeni tarafından belirtilen paylaşılan kitaplıkları yüklemekten sorumludur. Her iki durumda da dinamik bağlayıcı, arayanın bulunduğu bağlayıcı ad alanını bulur ve bağımlılıkları aynı bağlayıcı ad alanına yüklemeye çalışır. Dinamik bağlayıcı, paylaşılan kitaplığı belirtilen bağlayıcı ad alanına yükleyemezse dışa aktarılan paylaşılan kitaplıklar için bağlantılı bağlayıcı ad alanına sorar.
Yapılandırma dosyası biçimi
Yapılandırma dosyası biçimi, INI dosya biçimine dayanır. Tipik bir yapılandırma dosyası şu şekilde görünür:
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}
Yapılandırma dosyası şunları içerir:
- Dinamik bağlayıcının etkin bölümü seçmesi için başlangıçta birkaç dizin bölümü eşleme özelliği.
-
Çeşitli bağlayıcı ad alanı yapılandırma bölümleri:
- Her bölüm birkaç ad alanı (grafik köşeleri) ve ad alanları arasında birkaç yedek bağlantı (grafik yayları) içerir.
- Her ad alanının kendi izolasyonu, arama yolları, izin verilen yolları ve görünürlük ayarları vardır.
Aşağıdaki tablolarda her bir özelliğin anlamı ayrıntılı olarak açıklanmaktadır.
Dizin-bölüm eşleme özelliği
| Özellik | Açıklama | Örnek |
|---|---|---|
|
Her özellik, dizindeki yürütülebilir dosyaları bir bağlayıcı ad alanları yapılandırma bölümüyle eşler. Aynı |
Bu,
|
İlişki özellikleri
| Özellik | Açıklama | Örnek |
|---|---|---|
additional. |
Bölüm için |
Bu, |
namespace. |
Yedek ad alanlarının virgülle ayrılmış listesi. Paylaşılan kitaplık geçerli ad alanında bulunamazsa dinamik bağlayıcı, paylaşılan kitaplığı yedek ad alanlarından yüklemeye çalışır. Listenin başında belirtilen ad alanı daha yüksek önceliğe sahiptir. |
Bir paylaşılan kitaplık veya yürütülebilir dosya, Ardından, paylaşılan kitaplık Son olarak, tüm denemeler başarısız olursa dinamik bağlayıcı bir hata döndürür. |
namespace. |
Kitaplıklar Bu mülk |
Bu, yedek bağlantının istenen kitaplık adı olarak yalnızca |
namespace. |
Kitaplıklar Bu mülk |
Bu, tüm kitaplık adlarının |
Ad alanı özellikleri
| Özellik | Açıklama | Örnek |
|---|---|---|
namespace. |
Dinamik bağlayıcının, paylaşılan kitaplığın bulunduğu yeri kontrol edip etmeyeceğini belirten bir boole değeri.
|
Bu, yalnızca |
namespace. |
Paylaşılan kitaplıkların aranacağı iki nokta üst üste ile ayrılmış dizin listesi.
Örneğin, |
Bu, dinamik bağlayıcının paylaşılan kitaplıklar için |
namespace. |
AddressSanitizer (ASan) etkinleştirildiğinde paylaşılan kitaplıkların aranacağı iki nokta üst üste ile ayrılmış dizin listesi. ASan etkinleştirildiğinde |
Bu, ASan etkinleştirildiğinde dinamik bağlayıcının önce |
namespace. |
|
Bu, Örneğin, |
namespace. |
ASan etkinleştirildiğinde dinamik bağlayıcının paylaşılan kitaplıkları yükleyebileceği iki nokta üst üste ile ayrılmış dizin listesi. ASan etkinleştirildiğinde |
Bu, ASan etkinleştirildiğinde |
namespace. |
|
Bu, |
Bağlayıcı ad alanı oluşturma
Android 11'de bağlayıcı yapılandırması, ${android-src}/system/core/rootdir/etc içinde düz metin dosyaları kullanmak yerine çalışma zamanında /linkerconfig altında oluşturulur. Yapılandırma, aşağıdaki öğeleri içeren çalışma zamanı ortamına göre başlatma sırasında oluşturulur:
- Cihaz VNDK'yı destekliyorsa
- Tedarikçi bölümünün hedef VNDK sürümü
- Ürün bölümünün VNDK sürümü
- Yüklü APEX modülleri
Bağlayıcı yapılandırması, bağlayıcı ad alanları arasındaki bağımlılıklar çözülerek oluşturulur. Örneğin, bağımlılık güncellemelerini içeren APEX modüllerinde herhangi bir güncelleme varsa bu değişiklikleri yansıtan bağlayıcı yapılandırması oluşturulur. Bağlayıcı yapılandırması oluşturmayla ilgili daha fazla bilgiyi ${android-src}/system/linkerconfig bölümünde bulabilirsiniz.
Bağlayıcı ad alanı izolasyonu
Üç yapılandırma türü vardır. BoardConfig.mk içindeki PRODUCT_TREBLE_LINKER_NAMESPACES ve BOARD_VNDK_VERSION değerine bağlı olarak, önyükleme sırasında ilgili yapılandırma oluşturulur.
PRODUCT_TREBLE_LINKER_NAMESPACES |
BOARD_VNDK_VERSION |
Seçili yapılandırma | VTS şartı |
|---|---|---|---|
true |
current |
VNDK |
Android 9 veya sonraki sürümlerle kullanıma sunulan cihazlarda zorunludur. |
| Boş | VNDK Lite |
Android 8.x ile kullanıma sunulan cihazlarda zorunludur. | |
false |
Boş | Legacy |
Treble destekli olmayan cihazlar için |
VNDK Lite yapılandırması, SP-HAL ve VNDK-SP paylaşılan kitaplıklarını yalıtır. Android 8.0'da bu, PRODUCT_TREBLE_LINKER_NAMESPACES true olduğunda dinamik bağlayıcının yapılandırma dosyası olmalıdır.
VNDK yapılandırması, SP-HAL ve VNDK-SP paylaşılan kitaplıklarını da yalıtır. Ayrıca bu yapılandırma, tam dinamik bağlayıcı izolasyonu sağlar. Bu, sistem bölümündeki modüllerin tedarikçi bölümlerindeki paylaşılan kitaplıklara ve bunun tersi yönde bağımlı olmamasını sağlar.
Android 8.1 veya sonraki sürümlerde VNDK yapılandırması varsayılan yapılandırmadır.
BOARD_VNDK_VERSION değerini current olarak ayarlayarak tam dinamik bağlayıcı yalıtımını etkinleştirmeniz önemle tavsiye edilir.
VNDK yapılandırması
VNDK yapılandırması, sistem bölümü ile satıcı bölümleri arasındaki paylaşılan kitaplık bağımlılıklarını yalıtır. Önceki alt bölümde belirtilen yapılandırmalara kıyasla farklılıklar aşağıdaki gibi özetlenmiştir:
-
Çerçeve süreçleri
default,vndk,sphalversad alanları oluşturulur.- Tüm ad alanları izole edilir.
- Sistem tarafından paylaşılan kitaplıklar,
defaultad alanına yüklenir. - SP-HAL'ler
sphalad alanına yüklenir. - VNDK-SP paylaşılan kitaplıkları
vndkad alanına yüklenir.
-
Tedarikçi süreçleri
default,vndkvesystemad alanları oluşturulur.defaultad alanı yalıtılmıştır.- Tedarikçi tarafından paylaşılan kitaplıklar,
defaultad alanına yüklenir. - VNDK ve VNDK-SP paylaşılan kitaplıkları
vndkad alanına yüklenir. - LL-NDK ve bağımlılıkları
systemad alanına yüklenir.
Bağlayıcı ad alanları arasındaki ilişki aşağıda gösterilmiştir.
1. şekil. Bağlayıcı ad alanı izolasyonu (VNDK yapılandırması).
Yukarıdaki resimde LL-NDK ve VNDK-SP, aşağıdaki paylaşılan kitaplıkları ifade eder:
-
LL-NDK
libEGL.solibGLESv1_CM.solibGLESv2.solibGLESv3.solibandroid_net.solibc.solibdl.soliblog.solibm.solibnativewindow.solibneuralnetworks.solibsync.solibvndksupport.solibvulkan.so
-
VNDK-SP
android.hardware.graphics.common@1.0.soandroid.hardware.graphics.mapper@2.0.soandroid.hardware.renderscript@1.0.soandroid.hidl.memory@1.0.solibRSCpuRef.solibRSDriver.solibRS_internal.solibbase.solibbcinfo.solibc++.solibcutils.solibhardware.solibhidlbase.solibhidlmemory.solibhidltransport.solibhwbinder.solibion.solibutils.solibz.so
Daha fazla bilgiyi cihazdaki /linkerconfig/ld.config.txt bölümünde bulabilirsiniz.
VNDK Lite yapılandırması
Android 8.0'dan itibaren, dinamik bağlayıcı, SP-HAL ve VNDK-SP paylaşılan kitaplıklarını, sembollerinin diğer çerçeve paylaşılan kitaplıklarıyla çakışmayacak şekilde izole etmek üzere yapılandırılır. Bağlayıcı ad alanları arasındaki ilişki aşağıda gösterilmiştir.
LL-NDK ve VNDK-SP, aşağıdaki paylaşılan kitaplıkları ifade eder:
-
LL-NDK
libEGL.solibGLESv1_CM.solibGLESv2.solibc.solibdl.soliblog.solibm.solibnativewindow.solibstdc++.so(yapılandırmada değil)libsync.solibvndksupport.solibz.so(yapılandırmada VNDK-SP'ye taşındı)
-
VNDK-SP
android.hardware.graphics.common@1.0.soandroid.hardware.graphics.mapper@2.0.soandroid.hardware.renderscript@1.0.soandroid.hidl.memory@1.0.solibbase.solibc++.solibcutils.solibhardware.solibhidlbase.solibhidlmemory.solibhidltransport.solibhwbinder.solibion.solibutils.so
Aşağıdaki tabloda, VNDK Lite yapılandırmasındaki [system] bölümünden alıntılanan, çerçeve süreçleri için ad alanı yapılandırması listelenmiştir.
| Ad alanı | Özellik | Değer |
|---|---|---|
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 için) |
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 için) |
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 (derlenmiş RS çekirdeği için)
|
|
isolated |
true |
|
visible |
true |
|
links |
default,vndk |
|
link.default.shared_libs |
LL-NDKlibmediandk.solibft2.so
|
|
link.vndk.shared_libs |
VNDK-SP |
Aşağıdaki tabloda, VNDK Lite yapılandırmasındaki [vendor] bölümünden alınmış olan, satıcı süreçleri için ad alanı yapılandırması sunulmaktadır.
| Ad alanı | Özellik | Değer |
|---|---|---|
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} (kullanımdan kaldırıldı)/product/${LIB} (kullanımdan kaldırıldı)
|
isolated |
false |
Daha fazla bilgiyi /linkerconfig/ld.config.txt bölümünde bulabilirsiniz.
Belge geçmişi
Android 11'deki Değişiklikler
- Android 11'de statik
ld.config.*.txtdosyaları kod tabanından kaldırılır ve bunun yerine LinkerConfig tarafından çalışma zamanında oluşturulur.
Android 9'daki değişiklikler
- Android 9'da,
vndkbağlayıcı ad alanı satıcı işlemlerine eklenir ve VNDK paylaşılan kitaplıkları varsayılan bağlayıcı ad alanından yalıtılır. PRODUCT_FULL_TREBLEyerine daha spesifik birPRODUCT_TREBLE_LINKER_NAMESPACESkullanın.- Android 9, aşağıdaki dinamik bağlayıcı yapılandırma dosyalarının adlarını değiştirir.
Android 8.x Android 9 Açıklama ld.config.txt.inld.config.txtÇalışma zamanı bağlayıcı ad alanı izolasyonu olan cihazlar için ld.config.txtld.config.vndk_lite.txtVNDK-SP bağlayıcı ad alanı izolasyonu olan cihazlar için ld.config.legacy.txtld.config.legacy.txtAndroid 7.x veya daha eski sürümleri çalıştıran eski cihazlar için android.hardware.graphics.allocator@2.0.soöğesini kaldırın.productveodmbölümleri eklenir.