wear protolayout

wear protolayout

  

API Referansı
androidx.wear.protolayout

Bu kitaplık, uzak yüzeylerde oluşturulacak/değerlendirilecek bir dizi kullanıcı arayüzü düzeninin ve kullanıcı arayüzü dışı ifadelerin tanımlanmasına olanak tanır.

Son Güncelleme	Kararlı Sürüm	Sürüm Adayı	Beta sürümü	Alfa Sürümü
1 Temmuz 2026	1.4.1	-	-	-

Bağımlılıkları bildirme

wear-protolayout'a bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.

Uygulamanız veya modülünüz için build.gradle dosyasına ihtiyacınız olan yapılarla ilgili bağımlılıkları ekleyin:

Eski

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation "androidx.wear.protolayout:protolayout-expression:1.4.1"

    // Use to implement support for Wear ProtoLayout
    implementation "androidx.wear.protolayout:protolayout:1.4.1"

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation "androidx.wear.protolayout:protolayout-material:1.4.1"
}

Kotlin

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation("androidx.wear.protolayout:protolayout-expression:1.4.1")

    // Use to implement support for Wear ProtoLayout
    implementation("androidx.wear.protolayout:protolayout:1.4.1")

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation("androidx.wear.protolayout:protolayout-material:1.4.1")
}

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ştirmeye yönelik fikirleriniz varsa lütfen bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.

Yeni sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerini inceleyin.

Sürüm 1.4

Sürüm 1.4.1

1 Temmuz 2026

androidx.wear.protolayout:protolayout-*:1.4.1 iptal edilir. 1.4.1 sürümü bu commit'leri içerir.

Güvenlik Açığı ve Güvenlik Düzeltmeleri

• Bellek tükenmesini önlemek için resimlerde 2048px boyut sınırı ve 20MB ham boyut sınırı uygulandı.
• Derin düzenlerin parmak izi optimizasyonları sırasında derinlik zorlamasını atlamasına izin veren bir hata düzeltilerek düzen derinliği kontrolleri zorunlu kılındı.
• DashedArcLine içinde sınırsız boşluk parametrelerinin neden olduğu dizi sınırları istisnası/kilitlenmesi önlendi.
• Yakalanmamış IllegalArgumentExceptions, ifade işlem hattında daha güvenli hata günlüğü kaydı ve düğüm geçersiz kılma ile değiştirildi.
• Hatalı biçimlendirilmiş resim URI'leri işlenirken yakalanmayan bir NullPointerException düzeltildi.

Sürüm 1.4.0

25 Mart 2026

androidx.wear.protolayout:protolayout-*:1.4.0 iptal edilir. 1.4.0 sürümü bu commit'leri içerir.

1.3.0 sürümünden beri yapılan önemli değişiklikler:

• 1.3.0 sürümünden bu yana yapılan değişikliklerin tüm ayrıntıları için 1.4.0-beta01 sürüm notlarına bakın.

Yeni özellikler

• Wear ProtoLayout'un 1.4.0-beta01 sürümü, kitaplığın bu sürümünün özelliklerinin tamamlandığını ve API'nin (deneysel olarak işaretlenen yerler hariç) kilitlendiğini gösterir. Wear ProtoLayout 1.4 aşağıdaki yeni işlevleri ve API'leri içerir:
  • Satır içi resim kaynakları ve performans iyileştirmeleri: ImageResource öğesinin doğrudan düzenin içine yerleştirilebileceği geliştirilmiş bir kaynak işleme konsepti kullanıma sunuldu.
  • Material3TileService: Parça oluşturmak için Kotlin dostu yeni bir hizmet kullanıma sunuldu. Hem döşeme düzenini hem de kaynakları döndürmek için tek bir askıya alma işlevi sağlayarak geliştirmeyi basitleştirir. Daha iyi kaynak işleme ve daha hızlı kutu yükleme ile performans iyileştirmeleri için MaterialScope ve ProtoLayoutScope öğelerini otomatik olarak yönetir.
  • Döşeme önizlemeleri güncellemesi: Döşeme önizlemeleri için kullanılan araçlar, yeni ProtoLayoutScope otomatik kaynak işleme özelliğini destekleyecek şekilde güncellendi. Böylece önizlemeler, ek yapılandırma gerektirmeden satır içi kaynakları doğru şekilde yansıtacak.
  • Birçok Kotlin DSL iyileştirmesi: Kotlin kullanıcılarının geliştirici deneyimini iyileştirmek için Tile ve kutu oluşturmak için gereken diğer tüm API'ler (ör. Timeline) için özel Kotlin yardımcıları eklendi.
  • Dinamik Hizmet Değiştirme: Geliştiricilerin manifestte birden fazla TileService örneğini gruplandırmasına olanak tanıyan METADATA_GROUP_KEY özelliği kullanıma sunuldu. Bu sayede, yeni işletim sistemi sürümlerinde aynı kutuyu temsil eden farklı hizmetler arasında dinamik olarak geçiş yapılabilir.
  • Güncellemelerde karo kimliği: Geliştiriciler artık güncelleme isteklerinde belirli bir tileId belirtebilir. Bu sayede, hangi karo örneklerinin yenileneceği üzerinde daha ayrıntılı kontrol sağlanır.
  • Derleme SDK'sı yükseltildi: Yeni Material3TileService ve gelişmiş kaynak işleme özelliğini desteklemek için compileSdk sürüm şartı 35'e yükseltildi.
  • ANR Önleme: "Uygulama Yanıt Vermiyor" (ANR) hatalarını önlemek için, Tile güncelleme istekleri sırasında bağlamı kaldırma mantığını arka plan iş parçacığına taşıdık.
  • Kalp atış hızı verileri için uygun RequiresPermission ek açıklaması: API 36'dan itibaren, PlatformHealthSources.heartRateBpm veya PlatformHealthSources.heartRateAccuracy işlevlerinin çağrılması için çağıran uygulamaya android.health.connect.HealthPermissions.READ_HEART_RATE izninin verilmesi gerekir.

Sürüm 1.4.0-rc02

11 Mart 2026

androidx.wear.protolayout:protolayout-*:1.4.0-rc02 iptal edilir. 1.4.0-rc02 sürümü bu commit'leri içerir.

API değişiklikleri

• API 36'dan itibaren, ProtoLayout Expressions kitaplığı ile PlatformHealthSources.heartRateBpm ve PlatformHealthSources.heartRateAccuracy gibi yöntemlerle nabız verilerine erişmek için çağıran uygulamaya android.health.connect.HealthPermissions.READ_HEART_RATE izninin verilmesi gerekir.

Sürüm 1.4.0-rc01

25 Şubat 2026

androidx.wear.protolayout:protolayout-*:1.4.0-rc01, önceki sürümde herhangi bir değişiklik yapılmadan yayınlanır. 1.4.0-rc01 sürümü bu commit'leri içerir.

Sürüm 1.4.0-beta01

11 Şubat 2026

androidx.wear.protolayout:protolayout-*:1.4.0-beta01 iptal edilir. 1.4.0-beta01 sürümü bu commit'leri içerir.

Yeni Özellikler

Wear ProtoLayout'un 1.4.0-beta01 sürümü, kitaplığın bu sürümünün özelliklerinin tamamlandığını ve API'nin (deneysel olarak işaretlenen yerler hariç) kilitlendiğini gösterir. Wear ProtoLayout 1.4 aşağıdaki yeni işlevleri ve API'leri içerir:

• Satır içi resim kaynakları ve performans iyileştirmeleri: ImageResource öğesinin doğrudan düzenin içine yerleştirilebileceği geliştirilmiş bir kaynak işleme konsepti kullanıma sunuldu.
  • Bu, onTileResourcesRequest içinde manuel kaynak eşleme ihtiyacını ortadan kaldırarak ve bu yöntemi geçersiz kılarak geliştirmeyi önemli ölçüde basitleştirir.
  • Bu işlem, yalnızca onTileResourcesRequest yöntemi uygulanabildiğinden iki bağlayıcı çağrısı yapma ihtiyacını ortadan kaldırarak Döşemeler'in yüklenme süresini önemli ölçüde iyileştirir.
  • Tüm Image API'leri, bu kavramı desteklemek için artık bu işlemden sorumlu ProtoLayoutScope kabul eden yeni yöntemler sunuyor.

• Material3 Kapsamı ve Kaynakların Otomatik Kaydı: Satır İçi Resim Kaynakları ile Material3 MaterialScope kavramını desteklemek için materialScopeWithResources eklendi. Bu kapsam, otomatik kaynak kaydını işler ve bileşen kullanımını kolaylaştırmak için resimlerle ilgili yeni yardımcı yöntemler (backgroundImage, avatarImage ve icon) içerir.

  • Basitleştirilmiş kod snippet'i:

    materialScopeWithResources(
    context = context,
    deviceConfiguration = deviceParameters,
        protoLayoutScope = protoLayoutScope) {
      primaryLayout(
      // layout setup here
    iconContent = { **icon**(
    **imageResource**(
    **androidImageResource**(R.drawable.myIcon)))})
    //…
    }
    

• PendingIntent desteği: Döşemeler için PendingIntent desteği eklendi. PendingIntent tıklanabilir öğeleri, yedek işlemleri (LoadAction veya LaunchAction) kabul eder. Bu, ProtoLayout oluşturucunun PendingIntent'yı desteklemeyen eski bir sürüm olması durumunda geçerli bir yedek işlemin otomatik olarak kullanılmasını sağlar.

• Kotlin DSL'de birçok iyileştirme:

  • Kotlin kullanıcılarının geliştirici deneyimini iyileştirmek için Image ve tüm ImageResources türleri için özel Kotlin yardımcıları eklendi.
  • Box, Row, Column gibi kapsayıcı türleri için modern Android geliştirmeye daha fazla uyum sağlamak amacıyla yardımcılar eklendi.
  • Yeni bir Kotlin Transformation değiştiricisi ve fade in animasyonu için yardımcı yöntemler eklendi.

• Lottie animasyonunu özelleştirme: AndroidLottieResourceByResId içinde, Lottie animasyonunun özellikler aracılığıyla özelleştirilmesine olanak tanıyan API eklendi. Ayrıca, belirtilen renkteki yuva kimliğine göre bir yuvayı temalandırmak için özellik oluşturmaya yönelik somut destek ve API eklendi.

• Ortam Modu Farkındalığı: isInAmbientMode adlı yeni bir Platform etkinlik kaynağı eklendi. Bu kaynak, düzenlerin cihazın ortam modunda olup olmadığına göre tepki vermesini ve ifadeleri güncellemesini sağlar.

API Değişiklikleri

• Material3 Image Helpers: ProtoLayoutScope ve yeni satır içi kaynak işleme özelliğini kullanan yeni aşırı yüklemeler lehine mevcut Material3 Image Helpers'ın desteği sonlandırıldı.
• MaterialScope Güncellemeleri: MaterialScope içindeki protoLayoutScope alanı, materialScopeWithResources üzerinden oluşturulduğunda daha kolay kullanım için NonNull. Bu durumun varlığını kontrol etmek için yeni bir hasProtoLayoutScope işlevi eklendi. MaterialScope ayrıca Context için herkese açık alanı da gösterir.
• Semantics heading, LayoutModifier'da API olarak kullanılabilir.
• Yay yönü desteği: ARC_DIRECTION_* sabitleri artık Arc/ArcLine/ArcText/DashedArcLine öğelerinde kullanılmak üzere herkese açık olarak sunuluyor.

Hata Düzeltmeleri

• Kaynak Karşılaştırması: Kaynak türlerini karşılaştırmak için geliştirilmiş hash ve equals yöntemleri uygulanarak performans optimize edildi.
• Tek yuvalı textButton'a varsayılan içerik açıklamasını uygulayın.
• Maksimum satır sayısını ayarlamak için oluşturucu tarafındaki hesaplamalar düzeltildi.

Sürüm 1.4.0-alpha05

28 Ocak 2026

androidx.wear.protolayout:protolayout-*:1.4.0-alpha05 iptal edilir. 1.4.0-alpha05 sürümü bu commit'leri içerir.

API Değişiklikleri

• Yeni bir Kotlin Transformation değiştiricisi eklendi. (I195a7, b/397169191)

Hata Düzeltmeleri

• Durumlu ProtoLayoutScope öğesini TileService öğesinden kaldırarak daha iyi kaynak işleme özelliğiyle ilgili sorunu düzelttik. (I5dc0a, b/474614772)

Sürüm 1.4.0-alpha04

14 Ocak 2026

androidx.wear.protolayout:protolayout-*:1.4.0-alpha04 iptal edilir. 1.4.0-alpha04 sürümü bu commit'leri içerir.

API Değişiklikleri

• ProtoLayoutScope kullanan yeni aşırı yüklemeler ve ImageResource'nin doğrudan düzende satır içi olarak kullanılabildiği, kaynak eşlemeleri için onTileResourcesRequest yöntemine olan ihtiyacı ortadan kaldıran daha iyi kaynak işleme konsepti lehine Material3 resim yardımcılarının desteğini sonlandırdık. En iyi deneyim için Wear Tiles 1.6-alpha04 sürümünde eklenen androidx.wear.tiles.Material3TileService ile birlikte kullanın. (I8198c, b/440376391)

Sürüm 1.4.0-alpha03

17 Aralık 2025

androidx.wear.protolayout:protolayout-*:1.4.0-alpha03 iptal edilir. 1.4.0-alpha03 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

• Daha iyi kaynak işleme ve performans iyileştirmeleri için iki kaynak türünü karşılaştırma işlemi artık optimize edilmiş karma ve eşittir yöntemleri kullanılarak yapılıyor. (82f21b2f)

Sürüm 1.4.0-alpha02

22 Ekim 2025

androidx.wear.protolayout:protolayout-*:1.4.0-alpha02 iptal edilir. 1.4.0-alpha02 sürümü bu commit'leri içerir.

Yeni Özellikler

• Cihazın ambiyans modunda olup olmadığını açıklayan yeni bir Platform etkinliği kaynağı (isInAmbientMode) eklendi (Ief832).

API Değişiklikleri

• PendingIntent clickable artık PendingIntent, ProtoLayout oluşturucu tarafından desteklenmediğinde kullanılacak bir yedek işlem (LoadAction/LaunchAction) kabul ediyor. Oluşturucunun sürümü PendingIntent'yı destekleyen sürümden düşük olduğunda yedek işlem otomatik olarak alınır ve düzene yerleştirilir. (I6eee2, b/450259727)
• MaterialScope içindeki protoLayoutScope alanı, MaterialScope, materialScopeWithResources üzerinden oluşturulduğunda daha kolay kullanılabilmesi için NonNull olarak ayarlandı. Ayrıca, bu özelliğin varlığını kontrol etmek için hasProtoLayoutScope işlevi de bulunur. (I1858f, b/450067019)

Sürüm 1.4.0-alpha01

24 Eylül 2025

androidx.wear.protolayout:protolayout-*:1.4.0-alpha01 iptal edilir. 1.4.0-alpha01 sürümü şu commit'leri içerir.

Yeni Özellikler

• LayoutModifier için, öğenin kutucuk görünür hale gelirken solarak görünmesini sağlayan yardımcı yöntem eklendi. (I38531, b/390345969)
• Otomatik kaynak kaydını da sağlayan M3 MaterialScope kavramını desteklemek için materialScopeWithResources eklendi. Bu kitaplıkta, kullanıldığında kaynakların onTileResourceRequest'ye manuel olarak kaydedilmesini gerektirmeyen resimler (backgroundImage avatarImage ve simge) için yeni yardımcı yöntemler eklendi. (I525bd, b/428692714)
• ProtoLayout Image ve ImageResources için ProtoLayoutScope ile kullanım ve otomatik kaynak kaydı için Kotlin yardımcıları. (Iada82, b/430584304)
• Bir Lottie animasyonunun özelleştirilmesinde kaç Lottie özelliğine izin verildiğiyle ilgili getter eklendi. (I73733, b/436532706)
• AndroidLottieResourceByResId içine API ekleyerek Lottie animasyonunun özellikler aracılığıyla özelleştirilmesine izin verin ve tema yuvası için yuva kimliğiyle belirtilen renkte özellik oluşturmaya yönelik API ekleyin. (I301b3, b/423581481)
• Tıklama işlemi olarak PendingIntent'yı kabul etmek için sağlayıcı API'leri ekleyin (I01978, b/433802488)
• Kaynak nesnesini doğrudan onTileRequest içindeki resme ayarlamak için Image.Builder - setImageResource bölümüne yeni API ekleyin. Bu API'yi onTileResourcesRequest içindeki eşlemeye kaydetmeniz gerekmez. (Ifa69a, b/428693523)
• Döşemelerde daha iyi kaynak işleme için hazırlık olarak ProtoLayoutScope kavramı eklendi. (I132ce, b/428692423)
• ProtoLayout Material3 MaterialScope artık Context alanını herkese açık olarak sunuyor. Bu alan, kapsam içindeki yöntemlerde kullanılmak üzere, etrafta dolaştırılmasına gerek kalmadan kullanılabiliyor. (I0e5cc, b/414559956)
• Başlık semantik API'lerini herkese açık hale getirme (I75299, b/413653475)
• ARC_DIRECTION_* sabitlerini Arc/ArcLine/ArcText/DashedArcLine içinde kullanılmak üzere herkese açık olarak kullanıma sunun. (I83959, b/427556439)

API Değişiklikleri

• Image.Builder() ve Image.Builder.setResourceId yöntemlerinin desteğini sonlandırdık. Bunun yerine, Image.Builder(ProtoLayoutScope) ve Image.Builder.setImageResource API'lerinde kullanılabilen yeni otomatik kaynak kaydı API'sini kullanabilirsiniz. Bu API, onTileResourcesRequest'nin geçersiz kılınması ihtiyacını ortadan kaldırır. (I7bfe6, b/432758526)
• ProtoLayoutScope oluşturmaya yönelik API'leri kısıtlıdan herkese açık duruma taşıyın. Ancak sistem bu çağrıları zaten işlediği için bu işlevler kullanılmamalıdır. (I1d8e8, b/432758251)

Hata Düzeltmeleri

• ProtoTiles içinde PendingIntent desteği için uygulama ekleyin (I38167, b/430610429)
• invalidateLayout yöntemini ekleyin. (Ief898)
• Varsayılan minSdk'nın API 21'den API 23'e taşınması (Ibdfca, b/380448311, b/435705964, b/435705223)
• ImageResource artık hashCode ve equals yöntemlerini içeriyor. (I650ee, b/428692423, b/428693523)
• Yeni proto mesaj PendingIntentAction ve sarmalayıcı oluşturucusunu (Ie2aca, b/427643502) ekleyin.
• ZoneId örneğinin oluşturulma sıklığını azaltın. (I284d3)
• Varsayılan içerik açıklamasını tek yuvaya textButton uygulayın. (I0dc8a, b/415001534)
• Maksimum satır sayısını ayarlamak için oluşturucu tarafındaki hesaplamalar düzeltildi. (I933bc, b/414353620)

Sürüm 1.3

Sürüm 1.3.0

4 Haziran 2025

androidx.wear.protolayout:protolayout-*:1.3.0 iptal edilir. 1.3.0 sürümü bu commit'leri içerir.

1.2.0 sürümünden beri yapılan önemli değişiklikler

• Yuvarlak ekran için optimize edilmiş ve küçükten büyüğe ekran boyutlarına uygun şekilde ölçeklenen bileşenler ve düzenlerle Material 3 tasarımı kol saatine geliyor.
  • Bu kapsamda, yalnızca Kotlin'e özel, protolayout-material3 kitaplığı da yer alır. Bu kitaplık, aşağıdaki bileşenler ve özellikler için Compose'a benzer API'ler içerir:
  • Renkler, şekiller ve tipografi için en yeni Material 3 temasıyla sistemden ve kadranından gelen dinamik renk teması
  • MaterialScope tüm varsayılan değerleri yönetmek ve daha kolay özelleştirme için
  • iconEdgeButton, textEdgeButton
  • iconButton, textButton, button, imageButton, avatarButton, compactButton
  • titleCard, appCard, graphicDataCard, iconDataCard, textDataCard
  • circularProgressIndicator, segmentedCircularProgressIndicator
  • primaryLayout, buttonGroup
  • Tüm bileşenler, geçerli olduğu durumlarda mantıklı geri dönüşler sağlayarak tüm SDK düzeylerinde ve ProtoLayout oluşturucu sürümünde çalışır.
• Temel ProtoLayout öğeleri için Compose'a benzer, Kotlin ile daha uyumlu API'ler
  • Mevcut Modifiers nesnesine dönüştürülebilen, zincirleme işlevler (padding, contentDescription (clearSemantics dahil), background, clip, opacity vb.) olarak değiştiricilerin çoğunu ekleme özelliğiyle LayoutModifier
  • Dinamik alanların ve kısıtlamaların kullanımını daha kolay destekleyen türler olarak LayoutColors ve LayoutString
  • text ve fontStyle
  • StateBuilder nesnelerinin daha kolay oluşturulması için DynamicDataMap ve intAppDataKey gibi fabrika yöntemleri de dahil olmak üzere StateBuilder için daha iyi harita desteğiAppDataKey
• Lottie animasyonları, animasyonun ne zaman başlayacağına dair farklı tetikleyiciler ayarlama seçeneğini destekler. Örneğin, düzen yüklendiğinde veya düzen görünür hale geldiğinde
  • Geliştirilmiş gradyan desteği:
  • Brush kapsamında yer alan ve Box, Spacer gibi öğeler için Background değiştiricilerinde kullanılabilen doğrusal renk geçişi API'si.
  • Doğrusal ve süpürme renk geçişi için kullanılan ColorStop içinde dinamik renk değerlerine izin verin
  • Yay nesnelerindeki mevcut renk geçişi artık dinamik renkleri, başlangıç ve bitiş açılarını destekliyor
• protolayout-expression içinde platform veri bağlama: Düzenin görünürlüğü her değiştiğinde bilgi almak için kullanılır. Örneğin, döşeme kaydırılırken düzenin belirli kısımlarını gizlemek için kullanılabilir.
• protolayout-testing - Test kitaplığı, tüm ProtoLayout öğeleri için daha kolay birim testi kapsamı sağlamak üzere eklendi.
• Mevcut ArcLine yerine çizginin tireli olmasını sağlayan, geliştirilmiş özelliklere sahip yeni öğe DashedArcLine
• Uzunluğunu derece yerine DP boyutunda ayarlama desteği ArcSpacer
• Bazı yazı tipleri için geçerli olan yuvarlaklık FontSetting ekseni eklendi.

Sürüm 1.3.0-rc01

20 Mayıs 2025

androidx.wear.protolayout:protolayout-*:1.3.0-rc01, önceki sürümde herhangi bir değişiklik yapılmadan yayınlanır. 1.3.0-rc01 sürümü bu commit'leri içerir.

Sürüm 1.3.0-beta02

7 Mayıs 2025

androidx.wear.protolayout:protolayout-*:1.3.0-beta02 iptal edilir. 1.3.0-beta02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

• API 36 ve sonraki sürümlerde uygulanan Tipografi tasarım değerlerinde önemli bir iyileştirme yaptık. Bunun nedeni, API 36'dan itibaren tüm kutucukların sistem yazı tipinde olmasıdır. Bu nedenle, bu değişiklik kutucuklar döngüsünde daha iyi bir tutarlılık sağlar. (If316f)
• Text,Spacer, ArcLine ve DashedArcLine oluşturucuları, dinamik değerler için layoutConstraints ayarlanmamışsa hata vermez. Daha eski oluşturucuların layoutConstraints ayarlanmasını gerektirdiğini ve ayarlanmamış dinamik değerleri yoksayacağını unutmayın. (Ic52e8)
• Bir düzen öğesinin erişilebilirlik amacıyla içerik bölümünün başlığı olduğunu belirtmek için başlık semantiği değiştiricisi ekleyin ve primaryLayout öğesinin başlık yuvasındaki metni varsayılan olarak erişilebilirlik başlığı olacak şekilde işaretleyin. (Iae1fb)
• Başlık yuvası ile ana yuva arasındaki boşluğun daha küçük ekranlarda 6 dp yerine 4 dp'ye düşürüldüğü primaryLayout için son kullanıcı deneyimi düzenlemesi. (I0e056)
• textEdgeButton için varsayılan içerik açıklamasını uygula. (Ifaf8b)
• avatarButton iç dolgusunda küçük güncelleme. (I0910b)

Sürüm 1.3.0-beta01

9 Nisan 2025

androidx.wear.protolayout:protolayout-*:1.3.0-beta01 iptal edilir. 1.3.0-beta01 sürümü bu commit'leri içerir.

Yeni Özellikler

Wear ProtoLayout'un 1.3.0-beta01 sürümü, kitaplığın bu sürümünün özelliklerinin tamamlandığını ve API'nin (deneysel olarak işaretlenen yerler hariç) kilitlendiğini gösterir. Wear ProtoLayout 1.3 aşağıdaki yeni işlevleri ve API'leri içerir:

• Yuvarlak ekran için optimize edilmiş ve küçükten büyüğe ekran boyutlarına uygun şekilde ölçeklendirilmiş bileşenler ve düzenlerle Material 3 tasarımı kol saatine geliyor.
  • Bu kapsamda, yalnızca Kotlin'e özel, protolayout-material3 kitaplığı da yer alır. Bu kitaplık, aşağıdaki bileşenler ve özellikler için Compose'a benzer API'ler içerir:
  • Renkler, şekiller ve tipografi için en yeni Material 3 temasıyla sistemden ve kadranından gelen dinamik renk teması
  • MaterialScope tüm varsayılan değerleri yönetmek ve daha kolay özelleştirme için
  • iconEdgeButton, textEdgeButton
  • iconButton, textButton, button, imageButton, avatarButton, compactButton
  • titleCard, appCard, graphicDataCard, iconDataCard, textDataCard
  • circularProgressIndicator, segmentedCircularProgressIndicator
  • primaryLayout, buttonGroup
  • Tüm bileşenler, geçerli olduğu durumlarda mantıklı geri dönüşler sağlayarak tüm SDK düzeylerinde ve ProtoLayout Renderer sürümünde çalışır.
• Temel ProtoLayout öğeleri için Compose'a benzer, Kotlin ile daha uyumlu API'ler
  • Mevcut Modifiers nesnesine dönüştürülebilen, zincirleme işlevler (padding, contentDescription (clearSemantics dahil), background, clip, opacity vb.) olarak değiştiricilerin çoğunu ekleme özelliğiyle LayoutModifier
  • Dinamik alanların ve kısıtlamaların kullanımını daha kolay destekleyen türler olarak LayoutColors ve LayoutString
  • text ve fontStyle
  • StateBuilder nesnelerinin daha kolay oluşturulması için DynamicDataMap ve intAppDataKey gibi fabrika yöntemleri de dahil olmak üzere StateBuilder için daha iyi harita desteğiAppDataKey
• Lottie animasyonları, animasyonun ne zaman başlayacağına dair farklı tetikleyiciler ayarlama seçeneğini destekler. Örneğin, düzen yüklendiğinde veya düzen görünür hale geldiğinde
  • Geliştirilmiş gradyan desteği:
  • Brush kapsamında yer alan ve Box, Spacer gibi öğeler için Background değiştiricilerinde kullanılabilen doğrusal renk geçişi API'si.
  • Doğrusal ve süpürme renk geçişi için kullanılan ColorStop içinde dinamik renk değerlerine izin verin
  • Yay nesnelerindeki mevcut renk geçişi artık dinamik renkleri, başlangıç ve bitiş açılarını destekliyor
• protolayout-expression içinde platform veri bağlama: Düzenin görünürlüğü her değiştiğinde bilgi almak için kullanılır. Örneğin, döşeme kaydırılırken düzenin belirli kısımlarını gizlemek için kullanılabilir.
• protolayout-testing - Test kitaplığı, tüm ProtoLayout öğeleri için daha kolay birim testi kapsamı sağlamak üzere eklendi.
• Mevcut ArcLine yerine çizginin tireli olmasını sağlayan, geliştirilmiş özelliklere sahip yeni öğe DashedArcLine
• Uzunluğunu derece yerine DP boyutunda ayarlama desteği ArcSpacer
• Bazı yazı tipleri için geçerli olan yuvarlaklık FontSetting ekseni eklendi.

Sürüm 1.3.0-alpha10

12 Mart 2025

androidx.wear.protolayout:protolayout-*:1.3.0-alpha10 iptal edilir. 1.3.0-alpha10 sürümü bu commit'leri içerir.

Yeni Özellikler

• Kotlin Background Modifier'da Brush için yardımcı ekleyin. (I995de)
• MaterialScope içinde zorunlu Android Context alanı herkese açık hale getirildi. Böylece, geliştiricilerin Material3 kutuları için bileşen oluşturan işlevlerinde daha kolay kullanım sağlanacak. (I7df73)

API Değişiklikleri

• platformVisibilityStatus API'sinin adını PlatformEventSources.isLayoutVisible olarak değiştirin ve yeni bir deneysel API PlatformEventSources.isLayoutUpdatePending ekleyin. (Ie1e04)

Hata Düzeltmeleri

• primaryLayout için kenar boşlukları artık düzgün şekilde yukarı yuvarlanıyor. Bu durum, ana yer için 2 dp'ye kadar daha az alanla bazı düzenleri etkileyebilir. (I8f5d3)
• ProtoLayout Material 3 bileşenlerindeki varsayılan dinamik renk temasıyla ilgili açıklama. (Iff5f3)
• Typography.NUMERAL_* yazı tipleri artık varsayılan olarak tabüler/tek aralıklı değil. Metin animasyonluysa FontSetting.tabularNum() ayarını eklemeniz önemle tavsiye edilir. Diğer tüm durumlarda bu tek aralıklı yazı tipi seçeneği gerekli değildir ve kullanılmadığında daha fazla karakter kullanılabilir. (Id3cd9)
• ProtoLayout Material 3 bileşenlerindeki varsayılan dinamik renk temasıyla ilgili açıklama. (I9d831)

Sürüm 1.3.0-alpha09

26 Şubat 2025

androidx.wear.protolayout:protolayout-*:1.3.0-alpha09 iptal edilir. 1.3.0-alpha09 sürümü bu commit'leri içerir.

Yeni Özellikler

• enterTransition ve exitTransition için deneysel değiştiriciler eklendi (I4a4d6)
• Tam düzenin görünürlük durumu her değiştiğinde bu durumu almak için ek platform bağlama özelliği ekledik. (I250c3)
• Dinamik değerleri değerlendirmek için LayoutElementAssertionsProvider'ya test uygulaması durumu ve platform verilerinin yerleştirilmesine izin verin. (Ib5fcb)
• Protolayout test kitaplığına köşe filtreleri ekleyin (Ie2361)
• ButtonColors, CardColors ve ProgressIndicatorColors artık kopyalama yöntemini destekliyor. Bazı parametreler isteğe bağlı olarak geçersiz kılınabilir. (Ie2054)

API Değişiklikleri

• Test kitaplığına (Ib98de) dinamik veri bağlama desteği ekleme
• Yer paylaşımı kaldırarak backgroundImage işleviyle kullanıldığında imageButton sorununu düzeltir. Ayrıca, backgroundImage işlevinin, yer paylaşımı rengi için null değerinin belirtilmesine izin vermesini sağlayın. Bu, yer paylaşımının uygulanmayacağı anlamına gelir. (Ibec3c)

Hata Düzeltmeleri

• Varsayılan hasValueOfType yöntemi, IllegalArgumentException yerine UnsupportedOperationException atacak şekilde değiştirildi. (Ia36c3)
• Varsayılan renk jetonu değerleri, en son spesifikasyonu yansıtacak şekilde güncellendi. (I75d44)
• AndroidX kutu oluşturucuda yay çizgilerinde görünen aliasing sorunu düzeltildi. (I88190)

Sürüm 1.3.0-alpha08

12 Şubat 2025

androidx.wear.protolayout:protolayout-*:1.3.0-alpha08 iptal edilir. 1.3.0-alpha08 sürümü bu commit'leri içerir.

Yeni Özellikler

• Material3 metni için FontSetting liste parametresini ekleyin. (Ic102d)
• Uygulama durumları için daha iyi tür güvenli Kotlin API'sini (I012ba) destekleyen DynamicDataMap sınıfı eklendi.StateBuilder
• intAppDataKey gibi fabrika yöntemleri eklenerek AppDataKey nesnelerinin (Icea2a) daha kolay oluşturulması sağlandı.
• DynamicDataValue artık hasInt/hasColor/.... yöntemine ek olarak hasValueOfType(Class<?>) yöntemini de destekliyor (I4f7a6)
• Yüksek öncelikli hatalar veya güvenlik uyarıları gibi acil durum işlemleri için Material3 ProtoLayout'a errorDim ekledik. ColorScheme (Ia17bb)
• Bu ayarın sağlanmadığı bazı platformlarda tetiklenen, global reducemotion ayarına erişirken kilitlenmeyi önleyecek bir koruma eklendi. (I01e2c)

API Değişiklikleri

• addKeyToValueMapping, addToStateMap olarak yeniden adlandırıldı ve DynamicDataMap.put yöntemleri gereksiz oldukları için kaldırıldı. (Ibe9dd)
• Material3 Typography artık bu ekseni destekleyen sistem yazı tipleri için yuvarlaklık değişken eksenini destekliyor. ProtoLayout FontSetting, bu ekseni destekleyen yazı tiplerinde yuvarlaklık eksenini destekler. (I33eb5)
• Material3 metin yönteminde multilineAlignment, hizalama olarak yeniden adlandırıldı. (I2b66b)
• Dairesel ilerleme durumu göstergesini kutu türü olarak güncelleyin ve mainContent öğesini constructGraphic içinde kutu türü olarak belirtin (I5a3dc).
• Grafikte dairesel ilerleme durumu göstergesinin kullanılması için daha iyi destek (I039db)

Hata Düzeltmeleri

• ColorStop içinde ve SweepGradient içinde başlangıç/bitiş açıları için dinamik değerlere izin verin. (I0146d)
• Dokümanlar'daki düzeltmeler. (I4a63a)
• weight genişletme boyutu desteklenmediğinde (ör. API 33'ün altında) geri dönüşüm sağlamak için Material 3 bileşenleri (graphicCard ve avatarButton) güncellendi. TEXT_OVERFLOW_ELLIPSIZE oluşturucu tarafından desteklenmediğinde TEXT_OVERFLOW_ELLIPSIZE_END'ya geri dönmek için metin bileşeni güncellendi. (I19e2c)
• PrimaryLayoutMargins ile ilgili doküman güncellemesi. (Ibaf7b)

Sürüm 1.3.0-alpha07

29 Ocak 2025

androidx.wear.protolayout:protolayout-*:1.3.0-alpha07 iptal edilir. 1.3.0-alpha07 sürümü bu commit'leri içerir.

Yeni Özellikler

• Lottie animasyonları için farklı tetikleyiciler ayarlama API seçeneği eklendi. Ayrıca, düzen görünür olduğunda tetiklenen tetikleyiciler için API eklendi (I8272d).
• border, visibility ve opacity değiştiricileri eklendi. (I6d3dd)
• ProtoLayout Material3 bileşenine avatar düğmesi eklendi. (Idb5ae)
• Artık Material3'te kenar boşluklarının (yan ve bazı durumlarda alt) özelleştirilmesine izin veriyoruz primaryLayout. (Ib22f6)
• Dairesel ilerleme durumu göstergesinin segmentlere ayrılmış varyantını ekleyin. (I6a648)
• ProtoLayout Material3'e kompakt düğme bileşeni eklendi. (Ia3c5c)
• ProtoLayout Material3'e hap şekilli düğme ve resim düğmesi bileşenleri eklendi. (Ifb88a)

API Değişiklikleri

• LayoutModfier.foldIn, beklenen davranışını daha iyi yansıtması için foldRight olarak adlandırıldı (Idf242)
• VisibleOnce tetikleyicisi artık deneyseldir. (Ib2d26)
• Grafik kitaplığı alternatifi olduğundan withOpacity, herkese açık API'den kaldırıldı. (I030c2)
• LayoutString.kt ve LayoutColor.kt'deki üst düzey yöntemlerin adları, Java ile uyumlu olacak şekilde değiştirildi. (I7aff0)
• Material3'te ProtoLayout olmayan tipografiler kaldırıldı. (Idd9ae)
• Material3'teki *Colors sınıflarındaki alanlara Color sonekini ekleyin. (I2d114)

Hata Düzeltmeleri

• Asimetrik köşe desteği olmayan eski oluşturucu için EdgeButton yedek uygulaması ekleyin. (I63364)
• Daha eski oluşturucuyla dairesel ilerleme durumu göstergesinin yedek uygulamasını ekleyin. (I0f134)

Sürüm 1.3.0-alpha06

15 Ocak 2025

androidx.wear.protolayout:protolayout-*:1.3.0-alpha06 iptal edilir. 1.3.0-alpha06 sürümü bu commit'leri içerir.

Yeni Özellikler

• Hem statik hem de dinamik renk türlerini desteklemek için LayoutColor (I4c89b)
• ProtoLayout Material3 textButton bileşeni eklendi. (Id680d)
• iconButton ProtoLayout Material3 bileşenini ekleyin. (Ica3f0)
• ProtoLayout Material3 düğme kapsayıcı bileşeni eklendi. (I17a38)
• protolayout-material3'e zincirlenebilir semantik değiştiriciler için destek eklendi (I4af62)
• ProtoLayout Material3 tek segmenti CircularProgressIndicator eklendi (I2c8a2)
• padding,metadata değiştiricileri eklendi (I8720a)
• background,clip ve clickable değiştiricileri eklendi (I35478)
• Fırça'ya LinearGradient ekleyin ve arka plan değiştiricide kullanılmasına izin verin. (Ic4dea)
• appCard ve titleCard için küçük boyut ekleyin. (I91f98)
• ProtoLayout Material3 graphicDataCard bileşeni eklendi. (I92be7)
• ProtoLayout Material3 iconDataCard ve textDataCard bileşenleri eklendi. (I4e1e4)
• ProtoLayout Material3 appCard bileşeni eklendi. (Id4c57)
• EdgeButtonColors ile ButtonColors arasındaki farkı özetle. (I83624)
• ProtoLayout Material3 titleCard bileşeni eklendi. (I2dc72)

API Değişiklikleri

• ProtoLayout Material3 API, hem statik hem de dinamik metinleri desteklemek için artık LayoutString kabul ediyor. (I9c24a)

Hata Düzeltmeleri

• DashedArcLine öğesini genişletmek için oluşturucu uygulaması ekleyin (I0c700)
• ArcSpacer öğesinin dp uzunluğu almasına izin vermek için oluşturucu değişikliği. (I1437b)

Sürüm 1.3.0-alpha05

11 Aralık 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha05 iptal edilir. 1.3.0-alpha05 sürümü bu commit'leri içerir.

Yeni Özellikler

• Bağlanabilir düzen dizesi alanlarını desteklemek için LayoutString eklendi. (Ida650)
• ProtoLayout Material3 kartı kapsayıcı bileşeni eklendi. (Ic985a)

Hata Düzeltmeleri

• Bu kitaplık artık tür kullanımı olan JSpecify nullness ek açıklamalarını kullanıyor. Kotlin geliştiricileri, doğru kullanımı zorunlu kılmak için şu derleyici bağımsız değişkenini kullanmalıdır: -Xjspecify-annotations=strict (Bu, Kotlin derleyicisinin 2.1.0 sürümünden itibaren varsayılan değerdir). (Id1f9b, b/326456246)

Sürüm 1.3.0-alpha04

13 Kasım 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha04 iptal edilir. 1.3.0-alpha04 sürümü bu commit'leri içerir.

Yeni Özellikler

• Material3 şekli, Wear Compose'daki gibi gerçek köşe değerini tutan alanlara sahip bir sınıf olacak şekilde güncellendi. (Ied8cd)
• Material3 renkleri, Wear Compose'da olduğu gibi ColorScheme kavramını içerecek şekilde güncellendi. (If645e)
• Sık kullanılan birden fazla eşleştiriciyi test kitaplığına ekleyin. (Ie5cec)

Sürüm 1.3.0-alpha03

30 Ekim 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha03 iptal edilir. 1.3.0-alpha03 sürümü bu commit'leri içerir.

Yeni Özellikler

• LayoutElementAssertionsProvider, LayoutElementAssertion ve LayoutElementMatcher öğelerini test kitaplığına (Id1110) ekleyin.

Sürüm 1.3.0-alpha02

16 Ekim 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha02 iptal edilir. 1.3.0-alpha02 sürümü bu commit'leri içerir.

Yeni Özellikler

• Material 3 kitaplığının ilk sürümü. text, edgeButton, buttonGroup ve primaryLayout bileşenlerini içerir.

Güvenlik Düzeltmeleri

• Bu değişiklik itibarıyla androidx, CVE-2024-7254'ü ele almak için protobuf 4.28.2'ye karşı derlenir. Güvenlik açığı riskini gidermek için androidx.wear.protolayout:protolayout-proto ve androidx.wear.protolayout:protolayout-external-protobuf sürüm 1.3.0-alpha01'e olan bağımlılığınızı 1.3.0-alpha02'ye yükseltin.

Harici Katkı (External Contribution)

Sürüm 1.3.0-alpha01

2 Ekim 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha01 iptal edilir. 1.3.0-alpha01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

• Roboto ve Roboto Flex yazı tipi ailesi adlarının kullanılabilirliğinin cihaza bağlı olduğu netleştirildi. (I193be)
• AndroidX Tile oluşturucuda Roboto Flex yazı tipi ailesi etkinleştirildi. (I08e94)

Sürüm 1.2

Sürüm 1.2.1

16 Ekim 2024

androidx.wear.protolayout:protolayout-*:1.2.1 iptal edilir. 1.2.1 sürümü bu commit'leri içerir.

Güvenlik Düzeltmeleri

• Bu değişiklik itibarıyla androidx, CVE-2024-7254'ü ele almak için protobuf 4.28.2'ye karşı derlenir. Güvenlik açığı riskini gidermek için androidx.wear.protolayout:protolayout-proto ve androidx.wear.protolayout:protolayout-external-protobuf sürüm 1.2.0'a olan bağımlılığınızı 1.2.1'e yükseltin.

Sürüm 1.2.0

7 Ağustos 2024

androidx.wear.protolayout:protolayout-*:1.2.0 iptal edilir. 1.2.0 sürümü bu commit'leri içerir.

1.1.0 sürümünden beri yapılan önemli değişiklikler

• FontStyle, değişken eksenler için ek yazı tipi desteği ve yaklaşan Flex yazı tiplerini desteklemek üzere daha iyi yazı tipi seçimi API'si içerecek şekilde güncellendi.
• Ek değiştiriciler desteği:
  • Animasyonlu veya animasyonsuz çeviri, döndürme ve ölçeklendirme sunan dönüştürme değiştiricisi.
  • Her köşe yarıçapı için farklı değerler (yatay ve dikey) belirtme.
• Tıklanabilir değiştiriciyi kullanan tüm öğelerin dokunulabilir alanını en az 48dp x 48dp olacak şekilde genişleterek tüm dokunma hedeflerinin erişilebilirliğini iyileştirir.
• Farklı ekran boyutlarında bu düzenlerin duyarlı davranışını daha iyi desteklemek ve kutucukların tutarlılığını artırmak için PrimaryLayout ve EdgeContentLayout düzenlerine setResponsiveContentInsetEnabled eklendi.
• Android 14'ün doğrusal olmayan yazı tipi ölçeklendirmesi için Material Text'in ölçeklendirilmesi/ölçeklendirilmemesi iyileştirildi.
• Tüm arc öğelerinde sağdan sola düzen yönü için destek iyileştirildi.

Ek değişiklikler

• 1.1.0 sürümünde yapılan değişikliklerin daha kapsamlı bir listesi için beta01 sürüm notlarına bakın.

Sürüm 1.2.0-rc01

24 Temmuz 2024

androidx.wear.protolayout:protolayout-*:1.2.0-rc01 iptal edilir. 1.2.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

• Birincil veya ikincil etiketlerden hiçbiri iletilmediğinde yalnızca simge olarak kullanılabilmesi için standart Material Chip düzeltildi. (Iceef9)
• Materyal düzenleriyle ilgili dokümanlar, düzenlerin daha kolay anlaşılması için ilgili sayfadaki görselleri içerecek şekilde güncellendi. (I0256a)

Sürüm 1.2.0-beta01

10 Temmuz 2024

androidx.wear.protolayout:protolayout-*:1.2.0-beta01 iptal edilir. 1.2.0-beta01 sürümü bu commit'leri içerir.

Yeni Özellikler

Wear ProtoLayout'un 1.2.0-beta01 sürümü, kitaplığın bu sürümünün özelliklerinin tamamlandığını ve API'nin (deneysel olarak işaretlenen yerler hariç) kilitlendiğini gösterir. Wear ProtoLayout 1.2 aşağıdaki yeni işlevleri ve API'leri içerir:

• FontStyle, aşağıdaki gibi ek yazı tipi desteğiyle güncellendi:
  • FontSetting.weight ve FontSetting.width gibi farklı yazı tipi varyasyonu ayarları belirleme
  • Tüm sayısal karakterler için aynı genişliği ayarlama - tablosal rakamlar (FontSetting.tnum yazı tipi özelliği ayarı)
  • Kullanılacak tercih edilen yazı tipi ailesi adlarını belirterek, yakında kullanıma sunulacak esnek yazı tiplerini desteklemek için yazı tipi seçimi API'leri iyileştirildi.
• Asimetrik köşeli öğeler oluşturmaya olanak tanımak için her bir CornerRadius'nin ayrı yatay ve dikey değerlerle belirtilmesini destekleyecek şekilde Corner değiştiricisi genişletildi.
• Transformation öğesinin çevrilmesini, döndürülmesini ve ölçeklendirilmesini sağlayan yeni bir Transformation değiştirici eklendi.LayoutElement Bu dönüşümler, dinamik değerler kullanılarak animasyon haline getirilebilir.
• Farklı düzen yönlerinde (ör. soldan sağa ve sağdan sola) daha iyi destek sağlamak için tüm yay öğelerine (Arc, ArcLine ve ArcText) setArcDirection ile Clockwise, CounterClockwise ve Normal seçenekleri eklendi.
• Clickable değiştiricisini kullanan tüm öğelerin dokunulabilir alanını 48dp genişleterek tüm dokunma hedeflerinin erişilebilirliğini iyileştirin.48dp
• Farklı ekran boyutlarında bu düzenlerin duyarlı davranışını daha iyi desteklemek ve kutucukların tutarlılığını artırmak için PrimaryLayout ve EdgeContentLayout düzenlerine setResponsiveContentInsetEnabled eklendi. Bu API'lerin hızlı düzeltmeyle kullanılmasını önermek için linter uyarısı eklendi.
• Android 14'ün doğrusal olmayan yazı tipi ölçeklendirmesi için Material Text öğesinin ölçeklendirilmesi/ölçeklendirilmemesi iyileştirildi.

API Değişiklikleri

• preferredFontFamilies API'si kullanılmadığı için varsayılan yazı tipi ailesi adı (DEFAULT_SYSTEM_FONT) kaldırıldı. (I39dab)
• FontSetting.width işlevine iletilen parametre pozitif olmalıdır. (I1266f)

Sürüm 1.2.0-alpha05

26 Haziran 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha05 iptal edilir. 1.2.0-alpha05 sürümü bu commit'leri içerir.

Yeni Özellikler

• Metin içeriğinin ayarlanıp ayarlanmadığını kontrol etmek için hasText yöntemini Material.CompactChip öğesine ekleyin. (I6e8fc)

API Değişiklikleri

• FontFamily const'ları, Builder sınıfı yerine FontStyle içine taşınır. (I06ced)
• Aralık ek açıklamalarını içerecek şekilde FontSetting.weight ve FontSetting.width API'sini güncelleyin ve ağırlık parametresini int olarak değiştirin. (Ia726c)

Hata Düzeltmeleri

• Material kitaplığındaki ölçeklendirilemeyen metinler artık Android 14'ün doğrusal olmayan yazı tipi ölçeklendirmesiyle doğru şekilde çalışıyor. (I6601e)

Sürüm 1.2.0-alpha04

29 Mayıs 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha04 iptal edilir. 1.2.0-alpha04 sürümü bu commit'leri içerir.

API Değişiklikleri

• Her köşenin yarıçapını 2 değerle ayrı ayrı belirtebilmek için asimetrik köşeler API'si eklendi. (Icbd69)
• FontSetting API'si aşağıdaki öğeleri içerecek şekilde genişletildi:
  • Yazı tipini tablo şeklinde ayarlama gibi yazı tipi özelliği ayarı. (If12b7)
  • Değişken yazı tipleri için özel genişlik ayarlama gibi yazı tipi varyasyonu ayarları. (I2b36d)
• Hangi yazı tipi ailelerinin kullanılacağını belirten bir sıralı liste belirtmeye olanak tanımak için FontStyle'ya yazı tipi ailesi API'si eklendi. (Iba9f5)
• Başlangıçta "Edge content" önekiyle başlayan ve hem PrimaryLayout hem de EdgeContentLayout için geçerli olabileceğinden daha genel hale getirmek amacıyla Material'ın LayoutDefaults bölümündeki içerik ile ikincil etiket arasındaki boşluk yüksekliği için sabitler yeniden adlandırıldı. (I4dc32)

Hata Düzeltmeleri

• Değişken yazı tipi eksenlerinin adlandırması axisName olarak değiştirildi.axisTag (I02ba3)

Sürüm 1.2.0-alpha03

14 Mayıs 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha03 iptal edilir. 1.2.0-alpha03 sürümü bu commit'leri içerir.

Yeni Özellikler

• FontStyle için özel ağırlık değerlerini ayarlamaya yönelik API eklendi. (I7390a)

Hata Düzeltmeleri

• Boş hedef harita nedeniyle getTouchDelegateInfo'daki hatayı düzeltin. (I2accf)

Sürüm 1.2.0-alpha02

1 Mayıs 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha02 iptal edilir. 1.2.0-alpha02 sürümü bu commit'leri içerir.

API Değişiklikleri

• Tıklanabilir öğelerde dalgalanma geri bildirimini devre dışı bırakma desteği eklendi. (If1ede)
• Dönüşüm API'si, bu özelliği desteklemediği için ArcModifiers'dan kaldırıldı (Ic0827).
• ArcDirectionProp Oluşturucu artık oluşturucuda bir değer bekliyor. (I76ada)
• PlatformDataValues.Builder.putAll yöntemi, bir PlatformDataValue öğesinin başka bir PlatformDataValue öğesiyle birleştirilmesine olanak tanır. (I50ba3)
• Text#setIsScalable, Text#setScalable olarak yeniden adlandırıldı. (If920e)
• Material Text, ölçeklenebilir boyutun (kullanıcı yazı tipi boyutu değiştirildiğinde büyür) kullanılıp kullanılmayacağını ayarlayabilir. (Ibc849)
• İçerik açıklamasını TitleChip olarak ayarlama seçeneği eklendi. (I5d21f)
• Yalnızca simgeyle doğru şekilde çalışması için CompactChip düzeltildi ve bu seçeneğe izin vermek üzere API güncellendi. (I6589e)

Hata Düzeltmeleri

• Başlatma sırasında yinelenen platform verileriyle ilgili olası bir sorun düzeltildi. (Iba0fd)
• Düğüm maliyetini almak için DynamicDataNode'a yeni bir alıcı ekleyin. Maliyet, dinamik düğüm kotası edinirken kullanılır. Şu anda, sabit değerlere sahip düğümlerin maliyeti 0, diğer tüm düğümlerin maliyeti ise 1 olacaktır. (Ia33e1)
• NO_OP_QUOTA_MANAGER öğesinden sayma mantığını kaldırın. (Ib50b8)
• PrimaryLayout, setResponsiveContentInsetEnabled olmadan kullanıldığında uyarı bildirmek ve hızlı düzeltme sağlamak için bir lint kuralı ekledik. (I12025)
• Dinamik ifade düğümlerinin sayısı sınırlıdır. (Iffae8)

Sürüm 1.2.0-alpha01

6 Mart 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha01 iptal edilir. 1.2.0-alpha01 sürümü bu commit'leri içerir.

Yeni Özellikler

• ProtoLayout Arc öğelerine artık ArcDirection (Clockwise, Counterclockwise veya Normal) ekleme seçeneği eklendi. Bu davranışı Arc, ArcLine veya ArcText'ye eklemek, bunların sağdan sola düzenlerdeki davranışlarını düzeltir. (I90699)
• EdgeContentLayout, kullanıcı deneyimi yönergeleriyle daha iyi uyum sağlamak, birincil etiketi üstte sabit bir yere yerleştirerek ve etiketler için duyarlı bir iç kısım kullanarak kutularda tutarlılık elde etmek amacıyla yeni bir setResponsiveContentInsetEnabled ayarlayıcıyla güncellendi. (I60175)
• Bu düzenin birincil etiketine, ikincil etiketine ve alt çipine duyarlı iç kenar ekleyen PrimaryLayout.setResponsiveContentInsetEnabled öğesini ekledik. Böylece içeriğin ekran kenarının dışına çıkmasını önledik. (I0c457)
• CircularProgressIndicator öğesinden dış kenar boşluklarını kaldırma yöntemi eklenerek daha küçük bir bileşen olarak kullanılabilmesi sağlandı. (I55c06)

API Değişiklikleri

• Döşeme oluşturucu artık varsayılan olarak tüm metin öğelerinde yazı tipi dolgusunu hariç tutuyor ve bu dolguyu dahil etme seçeneği sunmuyor. (I3e300)

Hata Düzeltmeleri

• Metinde üç nokta, harf aralığı ve ortalama hizalama kullanıldığında metin hizalamasıyla ilgili sorun düzeltildi. (I716c7)
• Skia yay çizimi sorunu için geçici çözüm eklendi. (I08f09)
• Sağdan sola düzenlerde ArcLine çizim yönünü düzeltir. (I6c141)

Sürüm 1.1

Sürüm 1.1.0

7 Şubat 2024

androidx.wear.protolayout:protolayout-*:1.1.0 iptal edilir. 1.1.0 sürümü şu commit'leri içerir.

1.0.0 sürümünden beri yapılan önemli değişiklikler

• ArcLine içinde gradyan desteği ve 360 dereceden büyük uzunlukların daha iyi gösterimi.
• Tarih-saat biçimlendirmesi, dinamik veri türleri için farklı saat dilimlerini destekler.
• Kısaltılmış metinleri işlemek için daha iyi metin otomatik boyutlandırma ve üç nokta seçenekleri.
• Boşluk, isteğe bağlı ağırlıkla genişletilmiş boyutları destekler.
• Tüm ProtoLayout API'lerine şema sürümü koşulu eklenir.
• Erişilebilirlik şartlarını karşılamak için hedef alanı herhangi bir Clickable öğesinde 48 dp x 48 dp olacak şekilde genişletin.
• Yazı tipi dolgusu varsayılan olarak devre dışıdır ve metin içeren tüm metin öğeleri ile Materyal bileşenlerinde geçerli olan tek davranıştır.

Ek değişiklikler

• 1.1.0 sürümünde yapılan değişikliklerin daha kapsamlı bir listesi için beta01 sürüm notlarına bakın.

Sürüm 1.1.0-rc01

24 Ocak 2024

androidx.wear.protolayout:protolayout-*:1.1.0-rc01 iptal edilir. 1.1.0-rc01 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

• Güncelleme etkinleştirildikten hemen sonra PlatformTimeUpdateNotifierImpl işaretleri gösterilir. (I77145)
• CircularProgressIndicator, sağdan sola düzenler için düzeltildi. Bundan sonra, her durumda saat yönünde ilerleyecektir. (I95ee3)
• Skia yay çizimi sorunu için geçici çözüm eklendi. (I08f09)

Sürüm 1.1.0-beta01

10 Ocak 2024

androidx.wear.protolayout:protolayout-*:1.1.0-beta01 iptal edilir. 1.1.0-beta01 sürümü şu commit'leri içerir.

Yeni Özellikler

Wear ProtoLayout'un 1.1.0-beta01 sürümü, kitaplığın bu sürümünün özelliklerinin tamamlandığını ve API'nin (deneysel olarak işaretlenen yerler hariç) kilitlendiğini gösterir. Wear ProtoLayout 1.1 aşağıdaki yeni işlevleri ve API'leri içerir:

• ArcLine artık SweepGradient ile Brush ekleyerek ve mevcut StrokeCap üzerine Shadow ekleyerek 360 dereceden büyük uzunlukları daha iyi temsil etmek için kapakta gölge oluşturarak gradyanı destekliyor.
• DynamicInstant, saat dilimli tarih ve saat biçimlendirmesini destekler. DynamicInstant ve DynamicDuration, durum veya platform veri türleri olarak kullanılabilir.
• Metin boyutu için otomatik boyutlandırma özelliği. Bu özellik, metin boyutunun üst öğenin içindeki alana göre otomatik olarak ölçeklendirileceği şekilde birden fazla boyutun FontStyle.setSizes olarak ayarlanmasına olanak tanır. Ayrıca, TEXT_OVERFLOW_ELLIPSIZE ekleyip TEXT_OVERFLOW_ELLIPSIZE_END desteğini sonlandırarak taşan metinler için üç nokta seçeneklerini iyileştirdik.
• Spacer artık isteğe bağlı ağırlıkla genişletilmiş boyutlara sahip olmayı destekliyor. ExpandedDimensionProp oluşturmak için DimensionBuilders.weight yardımcı yöntemini ekledik.
• Modifier.visible ile düzen öğelerini dinamik olarak gizleme ve gösterme desteği. Buna BoolProp içinde dinamik değerler olması da dahildir.
• Tüm ProtoLayout API'lerinde artık şema sürümü gereksinimi açıklaması var ve daha yeni bir API çağrılmadan önce sürüm kontrol edilebilir.
• Clickable simgesini içeren her öğenin hedef alanı, erişilebilirlik koşullarını daha iyi desteklemek için oluşturucuda en az 48x48 olacak şekilde genişletildi.
• Diğer Materyal bileşenleri ve Compose girişimlerinin ardından, artık tüm Text öğelerinde yazı tipi dolgusunu varsayılan olarak devre dışı bırakıyoruz. Ayrıca, AndroidTextStyle ve ilgili ayarlayıcılar herkese açık API'den kaldırıldı. Aşağıdaki hata düzeltmeleriyle birlikte:
• Kenar içeriğini EdgeContentLayout konumlandırmak için bir ayarlayıcı eklendi. Böylece kenar içeriği, diğer içeriklerden önce konumlandırılabilir.
• Tanınmayan bir enum değeriyle karşılaşıldığında sürekli olarak istisna oluşturuluyor.
• Bir ifade geçersiz bir sayısal değer (NaN veya sonsuz) verdiğinde ya da ArithmeticException oluşturduğunda ifadenin sonucunu geçersiz kılar.

API Değişiklikleri

• Oluşturucuda renklerin veya ColorStops değerinin kabul edilmesine izin vermek için SweepGradient API'sinde yapılan güncellemeler. (I6676f)

Hata Düzeltmeleri

• Yay öğelerinin çizileceği yönü belirlemek için kısıtlanmış bir API ve oluşturucu desteği eklendi. (Idef5a)
• Belirtilmediğinde RoundMode, FloatToInt32Node içinde varsayılan olarak Floor olur. Sağlanan RoundMode tanınmıyorsa düğüm yine de istisna oluşturur. (I1b2d8)

Sürüm 1.1.0-alpha04

13 Aralık 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha04 iptal edilir. 1.1.0-alpha04 sürümü şu commit'leri içerir.

Yeni Özellikler

• VersionInfo sınıfı, Comparable arayüzünü uygulamıyor. (I8d13c)
• Oluşturucu artık TEXT_OVERFLOW_ELLIPSIZE seçeneğini destekliyor. (I7f085)

API Değişiklikleri

• Metin taşması seçeneği TEXT_OVERFLOW_ELLIPSIZE_END artık kullanımdan kaldırıldı. Lütfen benzer davranışa sahip yeni API'yi TEXT_OVERFLOW_ELLIPSIZE kullanın. (I822d8)
• Diğer Materyal bileşenleri ve Compose girişimlerinin ardından, artık tüm Metin öğelerinde yazı tipi dolgusunu varsayılan olarak devre dışı bırakıyoruz. Ayrıca, AndroidTextStyle ve ilgili ayarlayıcılar herkese açık API'den kaldırıldı. (I79094, Ib0b03, I32959, Iaf7d5, Ifa298, I0a4ae, Ida9d3)
• Modifier.hidden, Modifier.visible ile değiştirildi (I56902)
• FontStyle#setSizes artık SpProp bağımsız değişkenleri yerine int bağımsız değişkenlerini kabul ediyor. (I02b37)

Hata Düzeltmeleri

• Tanımsız veya tanınmayan bir enum değeriyle karşılaşıldığında istisna oluşturun. (I9d2cf)
• Yeniden düzenleme DynamicTypeBindingRequest. (I27b57)
• Bir ifade geçersiz bir sayısal değer (NaN veya sonsuz) verdiğinde ya da ArithmeticException oluşturduğunda ifadenin sonucunu geçersiz kılar. (I681ae)

Sürüm 1.1.0-alpha03

29 Kasım 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha03 iptal edilir. 1.1.0-alpha03 sürümü şu commit'leri içerir.

Yeni Özellikler

• Düzen öğelerini dinamik olarak gizleme/gösterme için deneysel destek eklendi (I64a78)
• BoolProp için dinamik değer desteği ekleyin (I2fe96)
• ProtoLayout API'lerine şema sürümü gereksinimi ek açıklaması ekleyin (I0f03c)
• Maksimum satır sayısına ulaşılmamış olsa bile (ancak metin için yeterli alan yoksa) sabit bir üst kapsayıcıdaki metni üç nokta ile kısaltmak için TextOverflow'daki yeni seçenekle API'yi genişletme. (I110a9)
• Ağırlıkla ExpandedDimensionProp oluşturmak için yardımcı yöntem DimensionBuilders.weight eklendi. (I4f72b)
• DynamicInstant ve DynamicDuration, durum veya platform veri türleri olarak kullanılabilir. (I6819f)

API Değişiklikleri

• DynamicZonedDateTime öğesini gizlemek ve tüm işlemlerini DyanamicInstant öğesine taşımak için API'yi güncelleyin (I34b94).
• Boşluk öğesi artık genişlik/yükseklik için Genişletilmiş boyutunu destekliyor. (Ie7c94)
• Oluşturucuda tıklama hedef alanı uzantısını destekleme (I39c79)

Sürüm 1.1.0-alpha02

15 Kasım 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha02 iptal edilir. 1.1.0-alpha02 sürümü şu commit'leri içerir.

Yeni Özellikler

• API'ye ArcLine StrokeCap Shadow alanı eklendi. (I830ec)
• API'yi, Spacer'ın genişliğini veya yüksekliğini genişletilecek şekilde belirtebilecek şekilde genişletme. (I757ca)
• Metin boyutunu, ana öğenin içindeki alana göre otomatik olarak ölçeklendirmek için deneysel bir API ekledik. (Ibbe63)
• Minimum tıklanabilir boyutu destekleme (I178e3)
• StrokeCap Shadow için oluşturucu desteği eklendi. (I48b17)
• ArcLine'da Sweep Gradient için oluşturucu desteği eklendi. (I4d5bb)

Sürüm 1.1.0-alpha01

18 Ekim 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha01 iptal edilir. 1.1.0-alpha01 sürümü şu commit'leri içerir.

Yeni Özellikler

• Arcline'ya SweepGradient desteğiyle fırça seçeneği eklendi. (Ie7ce3)
• Saat dilimine göre tarih ve saat biçimlendirme desteği eklendi. (Ibfae0)
• Saat dilimli tarih ve saat biçimlendirmesi için gereken proto'lar ve Java sarmalayıcılar eklendi. (I97126)
• DynamicDataValue içinde depolanan değeri geri okumak için alıcılar eklendi. (Ie6cea)
• Kenar içeriğini EdgeContentLayout konumlandırmak için bir ayarlayıcı eklendi. Böylece kenar içeriği, diğer içeriklerden önce konumlandırılabilir. (Ie8e8a)

Hata Düzeltmeleri

• Birden fazla zaman veri kaynağı kaydı içeren bir ifadenin anında güncellenmemesi sorunu düzeltildi. (I8e1a8)
• Fark güncellemeleri sırasında kök öğeyi ortalamaya yönelik hata düzeltildi. (Ie48f7)
• Ayarlanmamış (veya boş) düzen kısıtlaması değerleri artık yoksayılmayacak. (Ibc785)
• Bir düzenin görünür hale gelmesi ile ardışık düzen düğümlerinin başlatılması arasındaki gecikme azaltıldı. (I38d4e)

Sürüm 1.0

Sürüm 1.0.0

9 Ağustos 2023

androidx.wear.protolayout:protolayout-*:1.0.0 iptal edilir. 1.0.0 sürümü şu commit'leri içerir.

1.0.0 sürümünün temel özellikleri

ProtoLayout kitaplığı, farklı Wear OS yüzeylerinde kullanılabilecek düzenler ve ifadeler oluşturmaya yönelik API'ler sunar. Örneğin, kutu kitaplığı, platform veri bağlamayı (kutu verilerinin daha hızlı güncellenmesi için) ve animasyonları desteklemek üzere bu API'leri kullanır.

Sürüm 1.0.0-rc01

26 Temmuz 2023

androidx.wear.protolayout:protolayout-*:1.0.0-rc01 iptal edilir. 1.0.0-rc01 sürümü şu commit'leri içerir.

• Döşemeler'den ProtoLayout'ya geçmek için lütfen buradaki talimatları uygulayın.

API Değişiklikleri

• setLayoutConstraintForDynamicAnchorAngle ve getLayoutConstraintForDynamicAnchorAngle yöntemleri Arc öğesinden kaldırıldı. Bu yöntemler yanlışlıkla eklenmiş ve sağlanan düzende herhangi bir etkisi olmamıştır. (If7d01)
• ProtoLayout düzeninin sahip olabileceği maksimum derinliği 30 iç içe yerleştirilmiş LayoutElements ile sınırlandırdık. (I8a74b)

Hata Düzeltmeleri

• DynamicColor, SpanText için ayarlanmışsa hata vermesi için bir kontrol ekledik. (I0e5bc)
• DAILY_CALORIES veri kaynağı biriminin kcal olduğu açıklığa kavuşturuldu. (Iaa785)

Sürüm 1.0.0-beta01

21 Haziran 2023

androidx.wear.protolayout:protolayout-*:1.0.0-beta01 iptal edilir. 1.0.0-beta01 sürümü şu commit'leri içerir.

Yeni Özellikler

• Zaman bağlama testleri için saatin ayarlanmasına izin verilir. (I05622)

API Değişiklikleri

• PlatformDataReceiver.onData() ve StateBuilders.Builder.addKeyToValueMapping artık güvenli olmayan genel türler yerine DynamicDataKey ile DynamicDataValue arasında tür güvenli eşleme kabul ediyor. Bu durumda DynamicDataValue artık DynamicType ile yazılır. Diğer Android sabitlerinin konumlandırılmasıyla eşleşmesi için HEART_RATE_ACCURACY_X sabitleri PlatformHealthSources köküne taşındı. HEART_RATE_ACCURACY_X int sabitleri artık değer sabiti yerine doğrudan DynamicHeartRateAccuracy.constant() ve DynamicHeartRateAccuracy.dynamicDataValueOf() içinde kullanılıyor. (I82ff5)
• PlatformHealthSources.Constants sınıfı yanlışlıkla oluşturulabilir hale getirilmiş. Bu sorun düzeltildi. (Icb849)
• PlatformTimeUpdateNotifier#setReceiver artık Supplier işlevi yerine Runnable ve Executor bildirimlerini alıyor. (I9d938)
• PlatformTimeUpdateNotifier#setReceiver içindeki parametre türünü Callable olarak değiştirip Supplier yaptık. (I664bf)
• CompactChip ve TitleChip artık simge eklemeyi destekliyor. (I5a01e)

Hata Düzeltmeleri

• oneof kullanmak için dinamik alanlar içeren Prop mesajlarını güncelleyin (I81739)
• Ayarlayıcıları olan aşırı yüklemeler için ayarlayıcıları yeniden kullanma uygulaması (Ied70c)
• Aşırı yüklenmelere sahip ayarlayıcılarda parmak izlerini düzgün şekilde kaydetme (I86ed2)

Sürüm 1.0.0-alpha11

7 Haziran 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha11 iptal edilir. 1.0.0-alpha11 sürümü şu commit'leri içerir.

Yeni Özellikler

• Nabız doğruluğu için PlatformDataKey eklendi. (I7f9b8)

API Değişiklikleri

• StateBuilders#getIdToValueMapping işlevini getKeyToValueMapping olarak yeniden adlandırın ve dönüş türünü Map<<AppDataKey<?>,DynamicDataValue> olarak değiştirin. (Iaa7ae)
• StateStore'yı nihai sınıf yapma (I408ca)
• TimeGateway arayüzü, protolayout-expression-pipeline kitaplığında PlatformTimeUpdateNotifier ile değiştirildi. Bu arayüz, zaman verilerinin güncellenmesi için istenen sıklığı sağlar. (I60869)
• PlatformDataProvider içindeki register/unregisterForData öğesini set/clearReceiver olarak yeniden adlandırın (I14b02)
• Materyal Metin'de getExcludeFontPadding, hasExcludeFontPadding olarak yeniden adlandırıldı. (Iea01d)
• Etiketi mükemmel şekilde hizalamak için ayarlayıcı tüm çip bileşenlerine eklendi. Tüm çiplerde artık minimum dokunulabilir hedef uygulanıyor. (I8ae92)
• LayoutDefaults#BUTTON_MAX_NUMBER, MAX_BUTTONS olarak yeniden adlandırıldı. (I84788)
• DAILY_DISTANCE, DAILY_DISTANCE_M olarak yeniden adlandırıldı. (I4f758)

Hata Düzeltmeleri

• Statik değerin neden zorunlu olduğunu netleştirmek için Prop türleri belgelerini güncelleyin. Statik değer sağlanmadığında kullanılan varsayılan değeri belirtin. (I155aa)
• PlatformDataKey ad alanları, Java stili adlandırma kurallarına uygun olmalıdır. (I47bda)

Sürüm 1.0.0-alpha10

24 Mayıs 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha10 iptal edilir. 1.0.0-alpha10 sürümü şu commit'leri içerir.

Yeni Özellikler

• Uygulama tarafından gönderilen duruma erişmek için AppDataKey, platform verilerine erişmek için PlatformDataKey, StateStore içinde ad alanı desteği ekleyin. (I7985e)
• DynamicBool için Equal ve NotEqual işlemlerini destekleyin. (I6a0c1)

API Değişiklikleri

• FontStyles sınıfı artık nihai (Iaa2ea)
• LayoutElementBuilders#FontStyles desteği sonlandırıldı. Lütfen androidx.wear.protolayout.Typography kullanın veya kendi FontStyle öğenizi oluşturun. (Ic929b)
• Action#Builder iç içe yerleştirilmiş arayüzünü Action arayüzünden gizleyin. Builder'ın uygulamaları LoadAction ve LaunchAction sınıfları tarafından sağlanır. (I1d70c)
• DynamicFloat ile FloatProp'nin kullanılmasına izin verin. FloatProp, düzeni değiştiren bir özellik olarak kullanılmadığı için düzen kısıtlamaları gerektirmez. (I286ac)
• LoalAction ve SetStateAction işlemleri henüz tam olarak desteklenmediği için kaldırıldı. (I5d6a6)
• Satır içi resim kaynakları için ARGB_8888 biçimi desteği eklendi. (I8a07c)
• StateEntryValue öğesini DynamicDataValue olarak yeniden adlandırın ve durum API'lerini DynamicDataKey (If1c01) kullanacak şekilde güncelleyin.
• StateStore'nın her örneğinde bellek kullanımı ve durum güncelleme süresinin iyi bir şekilde kontrol edilmesini ve sınırlandırılmasını sağlamak için StateStore'da izin verilen giriş sayısını sınırlıyoruz. Bu nedenle, geliştiricinin haritada MAX_STATE_ENTRY_COUNT girişten fazla olmaması gerekir. Aksi takdirde, StateStore oluştururken veya güncellerken IllegalStateException hatası alır. (Ibadb3)
• OnLoadTrigger ve OnConditionMetTrigger sınıflarını gizleyin ve setTrigger sınıfını OnConditionMetTrigger için setCondition olarak yeniden adlandırın. (Ibf629)
• Performans ve uyumluluk nedenleriyle ProtoLayout oluşturucular, AnimatedVectorDrawable kaynaklarındaki tüm özellikleri desteklemez. Desteklenen grubu tanımlayana kadar bu API'leri deneysel olarak işaretliyoruz. (Ic6daf)
• Günlük mesafe, günlük kalori ve günlük kat sayısı için dinamik türler eklendi. Platform sağlık kaynaklarının anahtarları artık PlatformHealthSources.Keys (Ib7637) altında
• Easing.cubicBezier yöntemi, CubicBezierEasing.Builder yönteminin yerini almıştır. Bu işlemle birlikte EasingFunction sınıfı kaldırılır ve bu sınıftaki kolaylaştırma sabitlerine artık doğrudan Easing arayüzünden erişilebilir. Ayrıca setInfiniteRepeatable, INFINITE_REPEATABLE_WITH_RESTART ve INFINITE_REPEATABLE_WITH_REVERSE (Ib41e7) ile değiştirilir.
• Nabız ve günlük adım sayısı sağlamak için PlatformDataProvider'ı uygulayın. SensorGateway arayüzü, herkese açık API'den kaldırıldı. (I55b84)
• PlatformDataProvider öğesini ekleyin ve sağlayıcının desteklenen anahtarı ifade işlem hattındaki düğüm tarafından gerektiğinde StateStore öğesini PlatformDataProvider öğesine kaydolacak şekilde güncelleyin. (Ib616a)
• SensorGateway artık herhangi bir durumu korumadığından Closeable değildir. (I6b4f7)
• CircularProgressIndicator'da ilerleme kaydetmek için FloatProp ile DynamicFloat kullanımına izin verin. Bu özellik, sürüm 1.2'yi destekleyen oluşturucularda desteklenir. Eski oluşturucular, sağlanırsa staticValue'ya, aksi takdirde 0'a (I0d91b) geri döner.
• MultiButtonLayout sabitleri, LayoutDefaults.MultiButtonLayoutDefaults sınıfı olarak yeniden düzenlendi. Bu sınıf artık düzendeki düğme sayısına bağlı olarak düğme boyutları için olanları içeriyor. (I13973)
• Material Text'te StringProp ile DynamicString kullanımını destekler. Bu özellik, sürüm 1.2'yi destekleyen oluşturucularda desteklenir. Eski oluşturucular, sağlanan statik değere geri döner. Text#getText dönüş türünü String olarak güncelleyin.StringProp (I7275b)

Sürüm 1.0.0-alpha09

10 Mayıs 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha09 iptal edilir. 1.0.0-alpha09 sürümü şu commit'leri içerir.

Yeni Özellikler

• Deneysel bir uzantı düzeni öğesi ekledik. Bu özelliğin varsayılan olarak kullanılamadığını ve düzen öğesini anlayabilen bir oluşturucu uzantısı gerektirdiğini unutmayın. (I6581d)
• ArcLine için StrokeCap desteği eklendi. (I94951)
• Koşullu Anlık işlem için destek eklendi. (I489a7)
• Koşullu Süre işlemi için destek eklendi. (Iab469)
• Saniyelerden süre oluşturma desteği eklendi. (Ib5fa1)

API Değişiklikleri

• enable/disablePlatformSource yöntemleri, DynamicTypeEvaluator öğesinden kaldırıldı. Güncellemelerden arayan taraf sorumlu olmalıdır. (I78c6d)
• Bağlı veri türlerinin boyutunun sınırlandırılmasına izin verin. (Ie2966)
• protolayout-material'da dinamik içerik açıklaması desteği ekleyin. (I62c8e)
• AnimationParameters'da süre ve gecikme için uzun ve @IntRange kullanın. (I388b6)

Sürüm 1.0.0-alpha08

19 Nisan 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha08 iptal edilir. 1.0.0-alpha08 sürümü şu commit'leri içerir.

Yeni Özellikler

• AndroidTextStyle adlı kişi LayoutElementBuilders grubuna eklendi. (I8d967)
• ProtoLayout Material Text'te yazı tipi dolgusunu hariç tutma ayarı için destek ekledik. (I17f5d)
• Satır içi resimler için artık ARGB_8888 destekleniyor. (I18c1e)
• DynamicColor artık onCondition işlemini destekliyor. (I10927)

API Değişiklikleri

• Geri sarma animasyonu için özel süre desteği (I3251f)
• SemanticDescription değiştiricisini ekledik. Ayrıca, ContentDescription bağlanamaz. (I3f1d)
• DynamicBool.isFalse() yöntemi artık DynamicBool.negate() ile değiştirildi ve DynamicBool.isTrue() kaldırıldı. Ayrıca, NaN DynamicFloat değerleri ve DynamicInt32 değerinin DynamicFloat değerine daraltılması artık geçersiz bir dinamik sonuç veriyor. (I6ac1e)
• Int ve float biçimlendiriciler artık Builder kalıbını kullanıyor. (Ieb213)

Hata Düzeltmeleri

• Animasyon uygulanabilir alanlardan yedek statik değer kaldırıldı. (Ifcb01)
• DynamicTypeValueReceiver#onPreUpdate kaldırıldı. (I2dc35)
• Dinamik ifadelerdeki dizelerin uzunluğu artık sınırlanmıştır. (I4c93)
• Gradle bağımlılıkları artık gerektiğinde implementation yerine doğru şekilde api olarak ayarlanıyor. (I40503)

Sürüm 1.0.0-alpha07

5 Nisan 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha07 iptal edilir. 1.0.0-alpha07 sürümü şu commit'leri içerir.

Yeni Özellikler

• StringProp'ye (I04342) dinamik değer desteği ekleme
• Bağlanabilir düzen öğelerini işaretleme (Ia110b)

API Değişiklikleri

• sensorGateway#registerSensorGatewayConsumer, Consumer'da yöntem yerine parametre olarak veri türünü alır. (Icf314)
• ObservableStateStore, StateStore olarak yeniden adlandırıldı. (Ieb0e2)
• DynamicTypeEvaluator.Builder yerine oluşturucu bağımsız değişkenleri eklendi. Bu sayede, artık varsayılan olarak boş bir mağazaya ayarlanmış olan ObservableStateStore dahil olmak üzere daha fazla isteğe bağlı bağımsız değişken kullanılabiliyor. (I6f832)
• DynamicTypeEvaluator içindeki parametrelerin sırası yeniden düzenlendi. (Ic1ba4)

Hata Düzeltmeleri

• Platform sensör kaynaklarından gelen sinyalleri aşağı akış düğümlerine doğru şekilde yayınlayın (I5a922).

Sürüm 1.0.0-alpha06

22 Mart 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha06 iptal edilir. 1.0.0-alpha06 sürümü şu commit'leri içerir.

Yeni Özellikler

• Dinamik ifadelerde kalp atış hızını ve günlük adımları kullanmak için deneysel bir API ekledik (Ifd711).
• Animasyonlar için geri ve ileri gecikme desteği eklendi. (Ic25f7)
• Kenarlık ve Arka Plan'a DynamicColor desteği eklendi.
• DimensionBuilder içindeki türlere dinamik değer desteği eklendi
• tiles-material düzeni ve bileşenleri protolayout-material düzenine taşınıyor

API Değişiklikleri

• LoadActionListener adlı kişi ProtoLayoutViewInstance grubuna eklendi. (If7806)

Hata Düzeltmeleri

• FloatNodesTest eklendi (Id7281)
• Yapılandırılmış bit eşlem yüklenemediğinde oluşturucu kilitlenmesi sorunu düzeltildi.

Sürüm 1.0.0-alpha05

8 Mart 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha05 iptal edilir. 1.0.0-alpha05 sürümü şu commit'leri içerir.

Yeni Özellikler

• Modifiers nesnesine deneysel bir "içerik güncelleme" animasyonu ekledik. Bu animasyon, düzen güncellemesi sırasında öğe (bu değiştiriciyle) veya alt öğelerinden biri değiştiğinde tetiklenir. (bd03e5d)

API Değişiklikleri

• Repeatable adlı albüme forwardRepeatDelayMillis ve reverseRepeatDelayMillis adlı kullanıcıları ekledik. Ayrıca AnimationSpec içindeki delayMillis öğesinin adını startDelayMillis (Ifb266) olarak değiştirdik.
• DynamicTypeEvaluator.bind yöntemleri artık bir Executor kabul ediyor. (I346ab)
• Dinamik tür bağlandıktan sonra değerlendirmeyi tetiklemek için BoundDynamicType öğesine startEvaluation yöntemini ekledik. (I19908)

Hata Düzeltmeleri

• Animator nesnesi, tek bir öğenin sonraki animasyonları için yeniden kullanılır. (Ia3be9)

Sürüm 1.0.0-alpha04

22 Şubat 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha04 iptal edilir. 1.0.0-alpha04 sürümü şu commit'leri içerir.

Yeni Özellikler

• ObservableStateStore artık bir anahtar kaldırıldığında da dinleyicileri bilgilendiriyor.
• DeviceParameters'ya (farklı sürümlere ve yazı tipi ayarlarına yanıt olarak koşullu düzenler oluşturmak için kullanılabilir) oluşturucu şema sürümü ve yazı tipi ölçeği eklendi.
• DynamicInt32 değerlerini (I05485) animasyonla gösterme desteği eklendi.
• OnLoad ve OnConditionalMet tetikleyicilerini ekledik. Bunlar, tetikleyiciyi destekleyen animasyonları başlatmak için kullanılabilir.
• Genişletilmiş boyutlar için düzen ağırlığı, sarılmış boyutlar için minimum boyut ekledik.
• Süre ve anlık dinamik türleri eklendi. Bunlar, dinamik bir ifadede anlık bir zamanı veya süreyi temsil etmek için kullanılabilir.
• Düzen kaynakları olarak AnimatedVectorDrawable ve SeekableAnimatedVectorDrawable desteği eklendi.

API Değişiklikleri

• Sensör verileri için API 29 veya sonraki bir sürüm gerekir. (I8099e)
• launchAction İki yardımcı yöntem (Etkinlikleri başlatmak için) ekledik.

Hata Düzeltmeleri

• Kartlar animasyonunda set/getSpec öğesini set/getAnimationSpec olarak yeniden adlandırma (I3d74b)

Sürüm 1.0.0-alpha03

8 Şubat 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha03 iptal edilir. 1.0.0-alpha03 sürümü şu commit'leri içerir.

Yeni Özellikler

• Protolayout-express kitaplığındaki dinamik türlere toByteArray() ve fromByteArray() eklendi.
• Protolayout-expression kitaplığındaki dinamik türlere toString() eklendi.
• Dinamik türler için değerlendirme desteği ekledik. Protolayout-expression-pipeline kitaplığındaki DynamicTypeEvaluator sınıfı, daha önce oluşturulmuş bir Dinamik türü (DynamicString, DynamicFloat, …) değerlendirmek (ve güncellenmiş değerleri almak) için kullanılabilir.
• Animasyonlar oynatılamadığında (değerlendirici tarafından devre dışı bırakıldıkları veya çalışan animasyonların sayısı belirlenen sınıra ulaştığı için) animasyonun yerine animasyon yapılabilir düğümde ayarlanan statik değerler kullanılır.

Sürüm 1.0.0-alpha02

25 Ocak 2023

androidx.wear.protolayout:protolayout:1.0.0-alpha02, androidx.wear.protolayout:protolayout-expression:1.0.0-alpha02 ve androidx.wear.protolayout:protolayout-proto:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü şu commit'leri içerir.

Yeni Özellikler

• androidx.wear.tiles:tiles'daki düzen oluşturucular androidx.wear.protolayout:protolayout'a taşınıyor. androidx.wear.tiles:tiles içindeki API'lerin desteği, sonraki alfa sürümlerinden birinde sonlandırılacak.

Sürüm 1.0.0-alpha01

11 Ocak 2023

androidx.wear.protolayout:protolayout-expression:1.0.0-alpha01 ve androidx.wear.protolayout:protolayout-proto:1.0.0-alpha01 yayınlandı. 1.0.0-alpha01 sürümü şu commit'leri içerir.

Yeni Özellikler

• Bu sürümde, dinamik değişkenlerden ifadeler oluşturmak için yeni bir kitaplık olan "ProtoLayout Expression" kullanıma sunuluyor.