Bağlayıcı ad alanı

Dinamik bağlayıcı, Treble VNDK tasarımındaki iki zorluğun üstesinden gelir:

• SP-HAL paylaşılan kitaplıkları ve VNDK-SP dahil bağımlılıklarını çerçeve işlemlerine yüklenir. Ekipmanlarda koruma mekanizmalarını nasıl kullanacağınızı öğreneceksiniz.
• dlopen() ve android_dlopen_ext() şunları yapabilir: veya çalışma zamanında görülmeyen bazı çalışma zamanı bağımlılıklarını tespit edilmesi zordur.

Bu iki zorluk, bağlayıcı ad alanı ile çözülebilir. mekanizmasıdır. Bu mekanizma dinamik bağlayıcı tarafından sağlanır. Google paylaşılan kitaplıkları farklı bağlayıcı ad alanlarında aynı kitaplık adına sahip ancak farklı simgelere sahip kitaplıklar çakışmaz.

Öte yandan bağlayıcı ad alanı mekanizması, Böylece bazı paylaşılan kitaplıklar bir bağlayıcı ad alanı tarafından dışa aktarılabilir ve başka bir bağlayıcı ad alanı içerir. Dışa aktarılan bu paylaşılan kitaplıklar diğer programlarda da herkesin kullanımına açık olan kendi uygulama ayrıntılarını bağlayıcı ad alanlarında saklayabilir.

Örneğin, /system/lib[64]/libcutils.so ve /system/lib[64]/vndk-sp-${VER}/libcutils.so iki tanesi ortak kitaplıklar. Bu iki kütüphanenin farklı sembolleri olabilir. Yüklendiler farklı bağlayıcı ad alanlarına ayırır. Böylece çerçeve modülleri, /system/lib[64]/libcutils.so ve SP-HAL paylaşılan kitaplıkları şuna bağlıdır: /system/lib[64]/vndk-sp-${VER}/libcutils.so.

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ı bulunur. Bağımlılıkların /system/lib[64]/libc.so; ör. libnetd_client.so, /system/lib[64]/libc.so ürününün yer alır. Diğer ad alanları bu bağımlılıklara erişemez. Bu mekanizma, uygulama ayrıntılarını içerirken bir yandan da kamu yararına kullanır.

İşleyiş şekli

Dinamik bağlayıcı, belirtilen paylaşılan kitaplıkları yüklemekten sorumludur DT_NEEDED girişlerinde veya bağımsız değişkeni dlopen() veya android_dlopen_ext() olur. İkisinde de durumlarda, dinamik bağlayıcı, çağrıyı yapanın söz konusu bulunur ve bağımlılıkları aynı bağlayıcı ad alanına yüklemeye çalışır. Eğer dinamik bağlayıcı, paylaşılan kitaplığı belirtilen bağlayıcıya yükleyemiyor bağlı bağlayıcı ad alanını, dışa aktarılan paylaşılan kitaplıklar.

Yapılandırma dosyası biçimi

Yapılandırma dosyasının biçimi INI dosya biçimini temel alır. Normal yapılandırma dosyası şöyle 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ğlantı aracını kullanın.
• Birkaç bağlayıcı ad alanı yapılandırma bölümü:
  • Her bölüm birkaç ad alanı (grafik köşeleri) ve birkaç ad alanı içerir. ad alanları arasındaki yedek bağlantılar (grafik yayları).
  • Her ad alanının kendine ait yalıtımı, arama yolları, izin verilen yolları ve ve görünürlük ayarlarınızı kontrol edin.

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
dir.name	[name] bölümünün bulunduğu bir dizine giden yol hakkında genel bilgi verir. Her özellik, dizin altındaki yürütülebilir dosyaları bir bağlayıcıyla eşler ad alanı yapılandırma bölümüne gidin. İki (veya daha fazla) mülk olabilir aynı name öğesine sahip ancak farklı dizin oluşturabilirsiniz.	dir.system = /system/bin dir.system = /system/xbin dir.vendor = /vendor/bin Bu, [system] bölümü, yüklenen yürütülebilir dosyalar için geçerlidir /system/bin veya /system/xbin arasından. [vendor] bölümünde belirtilen yapılandırma geçerlidir /vendor/bin dizininden yüklenen yürütülebilir dosyalara.

İlişki özellikleri

Özellik	Açıklama	Örnek
additional.namespaces	Ek ad alanlarının virgülle ayrılmış listesi ( default ad alanı) kaldırın.	additional.namespaces = sphal,vndk Bu, üç ad alanı (default, sphal ve vndk) sonra [system] yapılandırma.
namespace.name.links	Yedek ad alanlarının virgülle ayrılmış listesi. Paylaşılan bir kitaplık mevcut ad alanında bulunamazsa dinamik bağlayıcı, yedek ad alanlarından paylaşılan kitaplığı yüklemeye çalışır. İlgili içeriği oluşturmak için kullanılan listenin başında belirtilen ad alanının daha yüksek önceliğe sahip olduğunu gösterir. Not: Yedek ad alanları geçişli değildir. Örneğin, örnek, A ad alanı, B ad alanına ve ad alanına bağlantı verir. B, C ad alanına bağlanır. Dinamik bağlayıcı A ad alanında kitaplığı bulursa YALNIZCA ad alanında arama yapar B'ye dokunun. C ad alanını aramaz.	namespace.sphal.links = default,vndk Paylaşılan bir kitaplık veya yürütülebilir bir dosya, sphal ad alanına (dinamik bağlayıcı) yüklenemiyor paylaşılan kitaplığı default kaynağından yüklemeye çalışır tıklayın. Ayrıca, paylaşılan kitaplık default ad alanını seçerseniz dinamik bağlayıcı, vndk ad alanı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.name.link.other.shared_libs	Bu kitaplıklarother name ad alanı. Bu özellik kullanılamaz namespace.name.link.other.allow_all_shared_libs Not: Bu mülk, aynı temel bununla birlikte uygulama public.libraries.txt dosyası olarak da kaydedebilir. Her iki mekanizma da içe aktarılan paylaşılan kitaplıkları bir bağlantısını tıklayın. Aradaki fark, ld.config.txt tarayıcının, Dynamic linker ve tüm ad alanları, bir program başlatıldığında oluşturulur. İçinde ise libnativeloader, Zygot işlemi çatallanır ve uygulama için özelleştirilir. Ad alanı için yalnızca kitaplığa izin veren bir bağlantı var. public.libraries.txt içinde belirtilen adlar.	namespace.sphal.link.default.shared_libs = libc.so:libm.so Bu, yedek bağlantının yalnızca libc.so kabul ettiğini gösterir veya istenen kitaplık adı olarak libm.so. Dinamik bağlayıcı sphal alanındaki yedek bağlantıyı yoksayar İstenen kitaplık adı değilse default ad alanı libc.so veya libm.so.
namespace.name.link.other.allow_all_shared_libs	Tüm paylaşılan kitaplıkların bu kitaplıklar tarafından işlenemediğinde other ad alanında aranamaz name ad alanında bulunur. Bu özellik kullanılamaz namespace.name.link.other.shared_libs	namespace.vndk.link.sphal.allow_all_shared_libs = true Bu şekilde, tüm kitaplık adları yedek bağlantıda gezinebilir. vndk değerinden sphal ad alanına geçiş yapın.

Ad alanı özellikleri

Özellik	Açıklama	Örnek
namespace.name.isolated	Dinamik bağlayıcının kontrol edip etmeyeceğini gösteren boole değeri kitaplığın bulunduğu yer. isolated değeri true ise yalnızca paylaşılan kitaplıklar search.paths dizinlerinden birinde yer alan (alt dizinler hariç) veya permitted.paths dizin (alt dizinler dahil) yüklendi. isolated, false (varsayılan) ise dinamik bağlayıcı, paylaşılan kitaplıkların yolunu kontrol etmez.	namespace.sphal.isolated = true Bu, yalnızca search.paths veya permitted.paths yaşından küçük kullanıcılar sphal ad alanına yüklenir.
namespace.name.search.paths	Paylaşılan aranacak dizinlerin iki nokta üst üste ile ayrılmış listesi kitaplıklar. search.paths öğesinde belirtilen dizinler başa eklenmiş işlev dlopen() veya DT_NEEDED girişlerinde tam yolu belirtmiyor. Dizin listenin başında belirtilen daha yüksek önceliğe sahip. isolated true olduğunda, şu sayıda paylaşılan kitaplıklar: search.paths dizinden birinde yer alıyor ( alt dizinleri) sağlanan permitted.paths etiketinden bağımsız olarak yüklenebilir. Örneğin, search.paths /system/${LIB} ve permitted.paths boş, /system/${LIB}/libc.so yüklenebilir ancak /system/${LIB}/vndk/libutils.so yüklenemiyor. Not: ${LIB} yerleşik bir uygulamadır yer tutucusu içerir. 32 bit işlemler için lib ile değiştirilir ve 64 bit işlemler için lib64.	namespace.default.search.paths = /system/${LIB} Bu, dinamik bağlayıcının Paylaşılan kitaplıklar için /system/${LIB}.
namespace.name.asan.search.paths	Aşağıdaki durumlarda paylaşılan kitaplıkların aranacağı dizinlerin iki nokta üst üste ile ayrılmış listesi Adres Temizleyici (ASan) etkin olmalıdır. namespace.name.search.paths ASan olduğunda yoksayılır etkin.	namespace.default.asan.search.paths = /data/asan/system/${LIB}:/system/${LIB} Bu, ne zaman ASan etkinleştirildiğinde dinamik bağlayıcı önce /data/asan/system/${LIB} ve ardından /system/${LIB} araması yapar.
namespace.name.permitted.paths	İki nokta işaretiyle ayrılmış bir dizin listesi (alt dizinler dahil) dinamik bağlayıcı, paylaşılan kitaplıkları ( search.paths), isolated bu durumda true. Şu alt dizinlerin altındaki paylaşılan kitaplıklar: permitted.paths de yüklenebilir. Örneğin, permitted.paths /system/${LIB}, hem /system/${LIB}/libc.so hem de /system/${LIB}/vndk/libutils.so yüklenebilir. isolated değeri false ise permitted.paths yoksayılır ve bir uyarı gönderilir. Not: permitted.paths DEĞİLDİR dinamik bağlayıcı olduğunda istenen kitaplık adlarının başına paylaşılan bir kitaplık aranıyor. Asıl amacı, programcıların Tam yolu belirterek paylaşılan kitaplıkları izole bir ad alanına yükleyin yararlı olabilir.	namespace.default.permitted.paths = /system/${LIB}/hw Bu, /system/${LIB}/hw, izole edilmiş default ad alanı. Örneğin, permitted.paths olmadan, libaudiohal.so yüklenemiyor /system/${LIB}/hw/audio.a2dp.default.so default ad alanı.
namespace.name.asan.permitted.paths	Dinamik bağlayıcının yükleyebileceği dizinlerin, iki nokta üst üste ile ayrılmış listesi ASan etkinleştirildiğinde paylaşılan kitaplıklar için geçerlidir. namespace.name.permitted.paths ASan etkinleştirildiğinde yoksayılır.	namespace.default.asan.permitted.paths = /data/asan/system/${LIB}/hw:/system/${LIB}/hw Bu, ASan'ın etkinleştirildiğini gösterir /data/asan/system/${LIB}/hw altındaki paylaşılan kitaplıklar veya /system/${LIB}/hw, izole edilmiş default ad alanı.
namespace.name.visible	Programın ( libc) aşağıdakileri içeren bir bağlayıcı ad alanı işleyicisi elde edebilir: android_get_exported_namespace() ve paylaşılan bir kitaplığı şurada açın: tanıtıcı ad alanını android_dlopen_ext(). visible değeri true ise android_get_exported_namespace(), şu durumlarda her zaman herkese açık kullanıcı adını döndürür: ad alanının mevcut olduğundan emin olun. visible, false (varsayılan) ise android_get_exported_namespace() her zaman dönüyor NULL. Paylaşılan kitaplıklar Bu ad alanına, yalnızca (1) başka bir alan tarafından istenmesi durumunda yüklenebilir bu ad alanına yedek bir bağlantıya sahip bağlayıcı ad alanı veya (2) bu ad alanındaki diğer paylaşılan kitaplıklar veya yürütülebilir dosyalar tarafından istekte bulunuldu.	namespace.sphal.visible = true Bu, android_get_exported_namespace("sphal") geçerli bir bağlayıcı ad alanı işleyicisi döndürebilir.

Bağlayıcı ad alanı oluşturma

Android 11'de bağlayıcı yapılandırması, çalışma zamanında şunun altında oluşturulur: Bunun yerine /linkerconfig ${android-src}/system/core/rootdir/etc. Yapılandırma, başlatma sırasında oluşturulur süresi, aşağıdaki öğeleri de içeren çalışma zamanı ortamına göre değişir:

• Cihaz VNDK'yı destekliyorsa
• Tedarikçi firma bölümünün hedef VNDK sürümü
• Ürün bölümünün VNDK sürümü
• APEX modülleri yüklendi

Bağlayıcı yapılandırması, bağlayıcı ad alanları arasındaki bağımlılıkların çözümlenmesiyle oluşturulur. Örneğin, Örneğin, APEX modüllerinde bağımlılık güncellemelerini, bağlayıcıyı ve bu değişiklikleri yansıtan yapılandırma oluşturulur. Bağlayıcı yapılandırması oluşturma hakkında daha fazla bilgi şuradan bulunabilir: ${android-src}/system/linkerconfig.

Bağlayıcı ad alanı izolasyonu

Üç yapılandırma türü vardır. Projenin değerine bağlı olarak, PRODUCT_TREBLE_LINKER_NAMESPACES ve BoardConfig.mk içinde BOARD_VNDK_VERSION, başlatma sırasında oluşturulur.

PRODUCT_TREBLE_ LINKER_NAMESPACES	BOARD_VNDK_ VERSION	Seçili yapılandırma	VTS gereksinimi
true	current	VNDK	Android 9 veya sonraki sürümlerin yüklü olduğu cihazlar için zorunludur
	Boş	VNDK Lite	Android 8.x ile kullanıma sunulan cihazlar için zorunludur
false	Boş	Legacy	Treble olmayan cihazlar için

VNDK Lite yapılandırması, SP-HAL ve VNDK-SP paylaşılan kitaplıkları birbirinden ayırır. Android 8.0'da bu, şu durumda dinamik bağlayıcı için yapılandırma dosyası olmalıdır: PRODUCT_TREBLE_LINKER_NAMESPACES true.

VNDK yapılandırması, SP-HAL ve VNDK-SP paylaşılan kitaplıkları da izole eder. Ayrıca, bu yapılandırma, tam dinamik bağlayıcı izolasyonu sağlar. Sistem bölümündeki modüllerin, paylaşılan kitaplıklarında veya tam tersi geçerlidir.

Android 8.1 veya sonraki sürümlerde varsayılan yapılandırma VNDK yapılandırmasıdır ve BOARD_VNDK_VERSION - current.

VNDK yapılandırması

Dikkat: Bu bölümde RenderScript'e yönelik kitaplık referansları yer alır. Başlangıç Android 12, RenderScript API'leri kullanımdan kaldırılmıştır. çalışmaya devam etmesini sağlar ancak cihaz ve bileşen üreticilerinin desteğini zamanla durdurur. GPU'dan tam olarak yararlanmak için hızlandırılıyorsa AOSP, RenderScript'ten Taşıma yapmanızı önerir.

VNDK yapılandırması, paylaşılan kitaplık bağımlılıklarını izole eder ayırmalarını öneririz. Şuna kıyasla: önceki alt bölümde belirtilen yapılandırmaların şu şekilde özetlenmiştir:

• Çerçeve süreçleri

  • default, vndk, sphal ve rs ad alanları oluşturuldu.
  • Tüm ad alanları izole edilir.
  • Sistem tarafından paylaşılan kitaplıklar, default ad alanına yüklenir.
  • SP-HAL'ler, sphal ad alanına yüklenir.
  • vndk ad alanına yüklenen VNDK-SP paylaşılan kitaplıkları.

• Tedarikçi işlemleri

  • default, vndk ve system ad alanları oluşturuldu.
  • default ad alanı izole edildi.
  • Tedarikçi firma tarafından paylaşılan kitaplıklar, default ad alanına yüklenir.
  • VNDK ve VNDK-SP paylaşılan kitaplıkları, vndk ad alanına yüklenir.
  • LL-NDK ve bağımlılıkları, system ad alanına yüklenir.

Bağlayıcı ad alanları arasındaki ilişki aşağıda gösterilmektedir.

Şekil 1. Bağlayıcı ad alanı izolasyonu (VNDK yapılandırması).

Yukarıdaki resimde LL-NDK ve VNDK-SP açılımı paylaşılan kitaplıklar:

• 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
  • [e-mail]
  • [e-mail]
  • [e-mail]
  • [e-mail]
  • 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

Cihazdaki /linkerconfig/ld.config.txt bölümünde daha fazla bilgi bulabilirsiniz.

VNDK Lite yapılandırması

Android 8.0 sürümünden itibaren, dinamik bağlayıcı SP-HAL ve VNDK-SP, simgelerinin başkalarıyla çakışmayacağı şekilde paylaşılan çerçeve paylaşımlı kitaplıklar da dahildir. Bağlayıcı ad alanları arasındaki ilişki aşağıda gösterilmiştir.

.

Şekil 2. Bağlayıcı ad alanı izolasyonu (VNDK Lite yapılandırması)

ziyaret edin.

LL-NDK ve VNDK-SP, şu paylaşılan kitaplıklar anlamına gelir:

• LL-NDK
  • libEGL.so
  • libGLESv1_CM.so
  • libGLESv2.so
  • libc.so
  • libdl.so
  • liblog.so
  • libm.so
  • libnativewindow.so
  • libstdc++.so (yapılandırmada yok)
  • libsync.so
  • libvndksupport.so
  • libz.so (şurada VNDK-SP'ye taşındı: yapılandırma)
• VNDK-SP
  • [e-mail]
  • [e-mail]
  • [e-mail]
  • [e-mail]
  • libbase.so
  • libc++.so
  • libcutils.so
  • libhardware.so
  • libhidlbase.so
  • libhidlmemory.so
  • libhidltransport.so
  • libhwbinder.so
  • libion.so
  • libutils.so

Aşağıdaki tabloda çerçeve için ad alanı yapılandırması listelenmektedir (bu belgedeki [system] bölümünden alınmıştır) VNDK Lite yapılandırması.

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-NDK libmediandk.so libft2.so
	link.vndk.shared_libs	VNDK-SP

Aşağıdaki tabloda tedarikçi firma işlemleri için ad alanı yapılandırması gösterilmektedir. alınan metindir.[vendor] VNDK Lite yapılandırması.

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} (desteği sonlandırılmış) /product/${LIB} (kullanımdan kaldırıldı)
	isolated	false

Daha fazla ayrıntıyı cihazdaki /linkerconfig/ld.config.txt bölümünde bulabilirsiniz.

Doküman geçmişi

Android 11 Değişiklikleri

• Android 11'de statik ld.config.*.txt dosyaları kod tabanından kaldırılır ve LinkerConfig, bunları çalışma zamanında oluşturur.

Android 9 değişiklikleri

• Android 9'da vndk bağlayıcı ad alanı, tedarikçi firmaya eklenir. işlemler ve VNDK paylaşılan kitaplıkları, varsayılan bağlayıcıdan izole edilir tıklayın.
• PRODUCT_FULL_TREBLE yerine daha spesifik PRODUCT_TREBLE_LINKER_NAMESPACES.
• Android 9, aşağıdaki dinamik bağlayıcı yapılandırmasının adlarını değiştirir dosyası olarak da kaydedebilir.
  

  Android 8.x	Android 9	Açıklama
  ld.config.txt.in	ld.config.txt	Çalışma zamanı bağlayıcı ad alanı izolasyonuna sahip cihazlar için
  ld.config.txt	ld.config.vndk_lite.txt	VNDK-SP bağlayıcı ad alanı izolasyonuna sahip cihazlar için
  ld.config.legacy.txt	ld.config.legacy.txt	Android 7.x veya önceki sürümleri çalıştıran eski cihazlar için

• [e-mail] öğesini kaldır
• product ve odm bölümleri eklendi.