privacysandbox ui

  
TODO
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
20 Mayıs 2025 - - - 1.0.0-alpha16

Bağımlılıkları beyan etme

privacysandbox-ui bağımlılığı eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu inceleyin.

Uygulamanızın veya modülünüzün build.gradle dosyasına ihtiyacınız olan yapıların bağımlılıklarını ekleyin:

Groovy

dependencies {
    // Use to implement privacysandbox ui-client
    implementation "androidx.privacysandbox.ui:ui-client:1.0.0-alpha16"

    // Use to implement privacysandbox ui-core
    implementation "androidx.privacysandbox.ui:ui-core:1.0.0-alpha16"

    // Use to implement privacysandbox ui-core
    implementation "androidx.privacysandbox.ui:ui-provider:1.0.0-alpha16"
}

Kotlin

dependencies {
    // Use to implement privacysandbox ui-client
    implementation("androidx.privacysandbox.ui:ui-client:1.0.0-alpha16")

    // Use to implement privacysandbox ui-core
    implementation("androidx.privacysandbox.ui:ui-core:1.0.0-alpha16")

    // Use to implement privacysandbox ui-provider
    implementation("androidx.privacysandbox.ui:ui-provider:1.0.0-alpha16")

    
}

Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa lütfen bize bildirin. Yeni bir kitaplık oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oy verebilirsiniz.

Yeni bir sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerine bakın.

Sürüm 1.0

Sürüm 1.0.0-alpha16

20 Mayıs 2025

androidx.privacysandbox.ui:ui-*:1.0.0-alpha16 yayınlanır. 1.0.0-alpha16 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • SandboxedSdkView'teki engelleri ölçmek için mantık eklendi. Bu mantık, ilişkili SessionObserverFactory.signalOptions'a SandboxedUiAdapterSignalOptions.OBSTRUCTIONS dahil edilirse SessionObserver.onUiContainerChanged()'te gönderilir. Engeller, görüntüye göre raporlanır.

API Değişiklikleri

  • SandboxedSdkUi, ui-client'ten yeni bir ui-client-compose kitaplığına taşındı.
  • Kullanıcı arayüzü kapsayıcılarındaki engelleri ölçmek için mantık eklendi. (I34bea)

Hata Düzeltmeleri

  • SandboxedSdkView.setAlpha() düzeltildi. Artık içerik görünümünün alfa değerini güncelliyor.

Sürüm 1.0.0-alpha15

26 Mart 2025

androidx.privacysandbox.ui:ui-client:1.0.0-alpha15, androidx.privacysandbox.ui:ui-core:1.0.0-alpha15 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha15 yayınlandı. 1.0.0-alpha15 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • SandboxedSdkView ve SandboxedSdkUi'ün varsayılan Z sıralamasını "aşağıda" olarak ayarlayın. Bu, sağlayıcının yüzeyinin artık istemcinin penceresinin altına yerleştirildiğini gösterir. Kullanıcı arayüzü sağlayıcının, istemci penceresi tarafından alındıktan sonra bu modda MotionEvents alması için destek eklendi.
  • SessionObserverFactory arayüzüne bir signalOptions alanı eklendi. Bu, ilişkili SessionObserver için hangi sinyallerin toplanacağını belirlemek üzere kullanılacak bir dize seçenekleri grubu tanımlamak için kullanılabilir. İlk sinyal grubu SandboxedUiAdapterSignalOptions adresinde tanımlanır. Herhangi bir sinyal seçeneği ayarlanmazsa yalnızca SessionObserver.onSessionOpened() ve SessionObserver.onSessionClosed() çağrılır.

API Değişiklikleri

  • SandboxedUiAdapter.openSession()'de SessionConstants, SessionData olarak yeniden adlandırıldı.

Bilinen Sorunlar

  • SDK, SDK Çalışma Zamanı'na yüklendiğinde ve SandboxedSdkView veya SandboxedSdkUi'ın Z sırası "yukarıda" olduğunda, hareket yalnızca sağlayıcı penceresi tarafından alınır ve artık istemci penceresine aktarılmaz.

Sürüm 1.0.0-alpha14

26 Şubat 2025

androidx.privacysandbox.ui:ui-client:1.0.0-alpha14, androidx.privacysandbox.ui:ui-core:1.0.0-alpha14 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha14 yayınlandı. 1.0.0-alpha14 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Artık istemci ve sağlayıcıya ait öğeler içerebilen "paylaşılan kullanıcı arayüzü" oluşturabilirsiniz. Paylaşılan kullanıcı arayüzü, ViewGroup'ü genişleten SharedUiContainer kullanılarak barındırılabilir. Yeni API'ler, SandboxedSdkView ve SandboxedUiAdapter'ye benzer bir oturum yönetimi konseptini kullanır.
  • Bu sürüme eklenen tüm API'ler SharedUiPresentationApi @RequiresOptIn işaretinin arkasındadır.

API Değişiklikleri

  • SharedUiContainer'e oturum yönetimi ve öğe kaydı API'leri eklendi. Oturum yönetimi, aynı sürümde kullanıma sunulan SharedUiAdapter kullanılarak uygulanır. (Ic60b0)
  • İstemci ve sağlayıcıya ait kullanıcı arayüzlerini barındırabilen SharedUiContainer eklendi. Tüm alt görünümlerini sol üst köşeye yerleştirir. (Ia7310)
  • SharedUiAdapter için geriye dönük uyumluluk desteği eklendi. (I56d7a)
  • İstemci ve sağlayıcıya ait kullanıcı arayüzlerini barındırabilen görüntüleme kapsayıcılarının oturum yönetimi için SharedUiAdapter eklendi. Oturum yönetimi mantığı SandboxedUiAdapter'e benzer. (I501f6)

Hata Düzeltmeleri

  • onVisibilityAggregated çağrıldığında görüntülenebilirliği hesaplar. (I91c69)

Bilinen Sorunlar

  • PoolingContainer içine yerleştirildiğinde SharedUiContainer, pencere ayrıldığında oturumu kapatır.

Sürüm 1.0.0-alpha13

29 Ocak 2025

androidx.privacysandbox.ui:ui-client:1.0.0-alpha13, androidx.privacysandbox.ui:ui-core:1.0.0-alpha13 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha13 yayınlandı. 1.0.0-alpha13 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Bir Oluşturma kullanıcı arayüzünde uzaktan içerik görüntülemek için kullanılabilecek SandboxedSdkUi adlı bir Oluşturma nesnesi eklendi. Bu nesne, oturum yönetimi ve etkinlik dinleyicileri için mevcut SandboxedSdkView kavramlarını kullanır. (I009cf)
  • SandboxedUiAdapter.openSession imzası, önceki windowInputToken parametresinin yerini alacak yeni bir SessionConstants parametresi içerecek şekilde değiştirildi. Bu parametre, SandboxedUiAdapter.Session'ün yaşam boyu sabit kalacak değerleri iletmek için kullanılır. (Ibc0df, I28435)

Bilinen Sorunlar

  • Ekran kaydırıldığında SessionObserver etkinlikleri SandboxedSdkUi için gönderilmez.
  • SandboxedSdkUi, Z-üstü modundayken üst görünümler tarafından kırpılmaz.

API Değişiklikleri

  • Desteği sonlandırılan SDKActivityLauncher kodunu (I49a4f) kaldırma
  • Yeni bir SessionObserverFactoryRegistry arayüzü ekleyerek gözlemci fabrika kaydı mantığını SandboxedUiAdapter'ten ayırdık. (I245cc)

Sürüm 1.0.0-alpha12

11 Aralık 2024

androidx.privacysandbox.ui:ui-client:1.0.0-alpha12, androidx.privacysandbox.ui:ui-core:1.0.0-alpha12 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha12 yayınlandı. 1.0.0-alpha12 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • StateChangedListener öğesi SandboxedSdkViewEventListener ile değiştirildi. Bu etkinlik işleyici, kullanıcı arayüzü görüntülendi, oturum kapatıldı ve oturum hatası etkinliklerini dinlemek için kullanılabilir.

API Değişiklikleri

  • SandboxedSdkView içindeki kullanıcı arayüzü etkinliklerini dinlemek için SandboxedSdkViewEventListener ekler. Bu sürümde StateChangedListener de kaldırılır. (Id71ea)

Hata Düzeltmeleri

  • Kırpma sınırları mantığı SandboxedSdkView'ten kaldırıldı. SandboxedSdkView kaydırılabilir bir kapsayıcıya yerleştirilirse ve orderProviderUiAboveClientUi(false) çağrılmazsa (temel çerçeve hatası düzeltilene kadar) bu durum kullanıcı deneyimi sorunlarına neden olur. (Id420d)
  • DelegatingSandboxedUiAdapter kullanılırken uzaktan işlem sonlandırılırsa ortaya çıkabilecek RemoteException hatası düzeltildi.

Sürüm 1.0.0-alpha11

13 Kasım 2024

androidx.privacysandbox.ui:ui-client:1.0.0-alpha11, androidx.privacysandbox.ui:ui-core:1.0.0-alpha11 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha11 yayınlandı. 1.0.0-alpha11 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • SandboxedUiAdapter'u genişleten ve farklı SandboxedUiAdapters'ler arasında yetki vermek için kullanılabilen deneysel bir API olan DelegatingSandboxedUiAdapter kullanıma sunuldu. Bu adaptör SandboxedSdkView gibi bir istemci kapsayıcısında ayarlandığında, yetki veren adaptör updateDelegate'ü kullanarak yetki veren adaptörü değiştirebilir. Bu işlem, mevcut oturumu kapatır ve yeni temsilci için yeni bir SandboxedUiAdapter.Session oluşturur. Bu sayede, yetki verilmiş kullanıcılar arasında sorunsuz geçişler yapabilirsiniz. (I5f1c5, I9e3e7)
  • Dolgular için daha iyi SandboxedSdkView desteği eklendi. (Ic414f)

Hata Düzeltmeleri

  • Global düzen etkinliğinde ortaya çıkabilecek NullPointerException sorunu düzeltildi.

Sürüm 1.0.0-alpha10

18 Eylül 2024

androidx.privacysandbox.ui:ui-client:1.0.0-alpha10, androidx.privacysandbox.ui:ui-core:1.0.0-alpha10 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha10 yayınlandı. 1.0.0-alpha10 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Oturum açma mantığı, yalnızca SandboxedSdkView içeren pencere görünür durumdaysa SandboxedSdkView içinde oturum açacak şekilde güncellendi.
  • SessionObserver mantığı, SandboxedSdkView içeren pencerenin görünürlüğü değiştiğinde onUiContainerChanged gönderecek şekilde güncellendi.

Hata Düzeltmeleri

  • Pencere görünürlüğü değiştiğinde onUiContainerChanged işlevini çağırma (I541cf)
  • Yeni platform API'lerine erişim manuel olarak belirtilmemiştir. Bunun nedeni, AGP 7.3 veya sonraki sürümlerde R8 kullanıldığında (ör. R8 3.3 sürümü) ve AGP 8.1 veya sonraki sürümlerde tüm derlemelerde (ör. D8 8.1 sürümü) API modelleme aracılığıyla otomatik olarak gerçekleşmesidir. AGP kullanmayan müşterilerin D8 8.1 veya sonraki bir sürüme güncellemeleri önerilir. Daha fazla bilgi için bu makaleye göz atın. (If6b4c, b/345472586)

Sürüm 1.0.0-alpha09

26 Haziran 2024

androidx.privacysandbox.ui:ui-client:1.0.0-alpha09, androidx.privacysandbox.ui:ui-core:1.0.0-alpha09 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha09 yayınlandı. 1.0.0-alpha09 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • SandboxedUiAdapter veya Session arayüzlerinin tamamını uygulamamak için kullanıcı arayüzü sağlayıcıları tarafından kullanılabilecek AbstractSandboxedUiAdapter ve AbstractSandboxedUiAdapter.AbstractSession soyut sınıfları kullanıma sunduk. Kullanıcı arayüzü sağlayıcıların bu soyut sınıfları kullanması önerilir.
  • Bir SessionObserverFactory öğesinin SandboxedUiAdapter öğesine eklenmesine olanak tanıyan registerObserverFactory mantığı eklendi. Bir SessionObserverFactory bir adaptöre bağlandığında, söz konusu adaptör için oluşturulan her yeni kullanıcı arayüzü oturumu için bir SessionObserver oluşturulur. Oluşturulan SessionObserver, kullanıcı arayüzü oturumu açıldığında bir onSessionOpened geri çağırma alır. Session görünümünün kullanıcı arayüzü sunumu değiştiğinde SessionObserver.onUiContainerChanged çağrılır. onUiContainerChanged sınırlandırılır ve en fazla 200 ms'de bir çağrılır.
  • SessionObserver.onUiContainerChanged tarihinde gönderilen Bundle'den oluşturulabilen SandboxedSdkViewUiInfo eklendi. Bu nesne, kullanıcı arayüzü oturumunu barındıran SandboxedSdkView'nin kullanıcı arayüzü durumunu temsil eder. Yükseklik ve genişlik bilgilerini, ekranda görünen görünümün geometrisini temsil eden bir Rect ve görünümün opaklığını temsil eden bir opaklık ipucunu içerir.

API Değişiklikleri

  • SandboxedSdkViewUiInfo öğesine opaklık ipucu ekleyin. (I093ac)
  • SessionObserver.onUiContainerChanged ve SandboxedSdkViewUiInfo öğelerini ekleyin. (Ie98bc)
  • SessionObserver arayüzünü ve kayıt mantığını ekleyin. (I047dc)
  • AbstractSandboxedUiAdapter ve AbstractSession öğelerini ekleyin. (I3617a)

Bilinen Sorunlar

  • Kullanıcı arayüzü sağlayıcı, istemci uygulamasıyla aynı işlemde olduğunda kapsayıcı kaydırıldığında SessionObserver.onUiContainerChanged gönderilmez.

Sürüm 1.0.0-alpha08

14 Mayıs 2024

androidx.privacysandbox.ui:ui-client:1.0.0-alpha08, androidx.privacysandbox.ui:ui-core:1.0.0-alpha08 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha08 yayınlandı. 1.0.0-alpha08 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • SandboxedSdkView öğesinin PoolingContainer içinde (ör. RecyclerView) kullanılması için destek eklendi. Bir SandboxedSdkView'ün PoolingContainer olan bir üst öğesi varsa kullanıcı arayüzü oturumlarının yaşam döngüsü, oturumun pencerenin ayrılması sırasında devam edebilmesini sağlamak için PoolingContainer ile uyumlu hale getirilir.

API Değişiklikleri

  • Desteği sonlandırılan Özel Korumalı Alan Etkinliği API'leri. Bu API'ler artık özel Etkinlik kitaplığında androidx.privacysandbox.activity bulunabilir. (I68beb)

Hata Düzeltmeleri

  • Havuzlama kapsayıcılarında uzak içerik gösterilirken ortaya çıkan oluşturma hatası düzeltildi. (I804df)
  • Geriye dönük uyumluluk modunda ViewGroups için oluşturma sorunlarına neden olan bir hata düzeltildi. (I8de92)
  • SandboxedSdkView'nin ebeveynlerinden biri PoolingContainer olduğunda, kullanıcı arayüzü oturumunu pencerenin ayrılması yerine PoolingContainer'ın kaynakların serbest bırakılabileceğini belirttiği zaman kapatın. (I2046b)

Harici Katkı

  • GestureDetector, minSdk'den kullanıma sunulduğundan GestureDetectorCompat desteği sonlandırıldı. (Icc4cd)

Sürüm 1.0.0-alpha07

18 Ekim 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha07, androidx.privacysandbox.ui:ui-core:1.0.0-alpha07 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha07 yayınlandı. 1.0.0-alpha07 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Kitaplık için geriye dönük uyumluluk desteği eklendi. API 33 ve önceki sürümlerde sağlayıcının görünümü, uygulama işlemi içinde farklı bir sınıf yükleyicide oluşturulur. (If0b7a)
  • Görünür kullanıcı arayüzü takılmalarını önlemek için ana makine ve sağlayıcı kapsayıcılarının yeniden boyutlandırılmasının aynı karede yapılmasına olanak tanıyan mantık eklendi. (Ic2cd9)

API Değişiklikleri

  • Kitaplığın MinSdk değeri API 21'e yükseltildi. (I474b8)

Sürüm 1.0.0-alpha06

20 Eylül 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha06, androidx.privacysandbox.ui:ui-core:1.0.0-alpha06 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha06 yayınlandı. 1.0.0-alpha06 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • SandboxedSdkView öğesini, içinde kaydırabileceği "sınırlayıcı üst öğe" görünümüne kırpacak mantık eklendi. Bu sayede, SandboxedSdkView içeriği diğer görünümleri veya kök içerik görünümünün dışındaki kullanıcı arayüzü bileşenlerini gizlemez. (I9ea94)

API Değişiklikleri

  • SandboxedSdkView.setZOrderOnTopAndEnableUserInteraction'ü orderProviderUiAboveClientUi olarak yeniden adlandırın (Iecb7e)

Hata Düzeltmeleri

  • Ana makineye doğru Z-sıralama değerini gönderin. (Ib0ddf)
  • Dokunma odağını yalnızca dikey kaydırmalar/fırlatmalar için aktarın. (I0528c)

Sürüm 1.0.0-alpha05

9 Ağustos 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha05, androidx.privacysandbox.ui:ui-core:1.0.0-alpha05 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha05 yayınlandı. 1.0.0-alpha05 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • SandboxedSdkView kaynaklı kaydırma ve fırlatma hareketlerinde dokunma odağını ana makineye aktarmak için mantık eklendi. Bu sayede istemcinin kaydırılabilir kapsayıcı barındırma sağlayıcı kullanıcı arayüzü, kaydırma ve fırlatma işlemlerine doğru şekilde yanıt verebilir.

API Değişiklikleri

  • windowInputToken parametresi SandboxedUiAdapter'a eklendi (Ief578)

Hata Düzeltmeleri

  • İlk çekilişten sonra oturum durumunu Etkin olarak ayarlama (I36f3f)
  • SandboxedSdkView ile ilgili düzen sorununu düzeltin. (I09cb8)
  • Dokunma odağını ana makineye aktarmak için mantık eklendi. (I33b54)
  • SandboxedUiAdapter parametresini SandboxedUiAdapter'a ekleyin.windowInputToken Bu, SurfaceControlViewHost jetonunun yerleşik hiyerarşinin ana makinesiyle doğru şekilde ilişkilendirilmesini sağlamak için gereklidir. (Ief578)
  • notifyResized'ü ana iş parçacığında çalıştırın. (I62440)
  • Session.close() akışında yaşanan kilitlenmeyi düzeltin. (I5392e)

Sürüm 1.0.0-alpha04

21 Haziran 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha04, androidx.privacysandbox.ui:ui-core:1.0.0-alpha04 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • SdkActivityLauncher'ü tanıtın. Çalışma zamanı özellikli SDK'ların etkinlikleri başlatmasına izin veren bir arayüz. (I5b3dc)

Hata Düzeltmeleri

  • notifyZOrderChanged yarış durumunu düzeltin. Kullanıcı arayüzü sağlayıcının tüm Z sırası değişiklikleri hakkında bilgilendirilmesini sağlar. openSession çağrılmadan önce SandboxedSdkView öğesinin Z sırası değiştirilirse kullanıcı arayüzü sağlayıcıya açıkça bildirim gönderilmez.

Sürüm 1.0.0-alpha03

24 Mayıs 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha03, androidx.privacysandbox.ui:ui-core:1.0.0-alpha03 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha03 yayınlandı. 1.0.0-alpha03 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • StateChangedListener, kullanıcı arayüzü oturumunda değişikliklerin uygulandığını bildirir

API Değişiklikleri

  • ErrorConsumer (Icd5d3) yerine StateChangedListener eklendi

Hata Düzeltmeleri

  • notifyZOrderChanged yarış koşulu düzeltildi. Böylece kullanıcı arayüzü sağlayıcı, tüm Z sırası değişiklikleri hakkında bilgilendirilir.

Sürüm 1.0.0-alpha02

19 Nisan 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha02, androidx.privacysandbox.ui:ui-core:1.0.0-alpha02 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü bu taahhütleri içerir.

Hata Düzeltmeleri

  • Devre dışı bırakılan kararsız testChangingSandboxedSdkViewLayoutChangesChildLayout testi

Sürüm 1.0.0-alpha01

8 Mart 2023

androidx.privacysandbox.ui:ui-client:1.0.0-alpha01, androidx.privacysandbox.ui:ui-core:1.0.0-alpha01 ve androidx.privacysandbox.ui:ui-provider:1.0.0-alpha01 yayınlandı. 1.0.0-alpha01 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Bunlar, uygulamaların ve çalışma zamanında etkinleştirilen SDK'ların (Özel Korumalı Alan), uygulamanın (istemci) SDK (sağlayıcı) tarafından sağlanan herhangi bir kullanıcı arayüzünü barındırmasına izin vermek için kullanabileceği yeni Jetpack kitaplıklarıdır.