Wear
androidx.wear.activity
androidx.wear.ambient
androidx.wear.input
androidx.wear.utils
androidx.wear.widget
androidx.wear.widget.drawer
(Tüm Wear paketleri için refdocs'a bakın)
Bu tabloda androidx.wear
grubundaki tüm yapılar listelenir.
Yapı | Kararlı Sürüm | Serbest Bırakma Adayı | Beta Sürümü | Alfa Sürümü |
---|---|---|---|---|
wear | 1.3.0 | - | - | 1.4.0-alpha01 |
Wear-giriş | 1.1.0 | - | - | 1.2.0-alpha02 |
aşınma-giriş testi | 1.1.0 | - | - | 1.2.0-alpha02 |
kalıcı | 1.0.0 | - | - | 1.1.0-alpha01 |
Wear-telefon etkileşimleri | 1.0.1 | - | - | 1.1.0-alpha04 |
Wear-uzaktan-etkileşimler | 1.0.0 | - | - | 1.1.0-alpha02 |
Bağımlılıkları bildirme
Wear'da bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.
Uygulamanızın veya modülünüz için build.gradle
dosyasına ihtiyaç duyduğunuz yapıların bağımlılıklarını ekleyin:
Modern
dependencies { implementation "androidx.wear:wear:1.3.0" // Add support for wearable specific inputs implementation "androidx.wear:wear-input:1.1.0" implementation "androidx.wear:wear-input-testing:1.1.0" // Use to implement wear ongoing activities implementation "androidx.wear:wear-ongoing:1.0.0" // Use to implement support for interactions from the Wearables to Phones implementation "androidx.wear:wear-phone-interactions:1.0.1" // Use to implement support for interactions between the Wearables and Phones implementation "androidx.wear:wear-remote-interactions:1.0.0" }
Kotlin
dependencies { implementation("androidx.wear:wear:1.3.0") // Add support for wearable specific inputs implementation("androidx.wear:wear-input:1.1.0") implementation("androidx.wear:wear-input-testing:1.1.0") // Use to implement wear ongoing activities implementation("androidx.wear:wear-ongoing:1.0.0") // Use to implement support for interactions from the Wearables to Phones implementation("androidx.wear:wear-phone-interactions:1.0.1") // Use to implement support for interactions between the Wearables and Phones implementation("androidx.wear:wear-remote-interactions:1.0.0") }
Bağımlılıklar hakkında daha fazla bilgi edinmek için Derleme bağımlılıkları ekleme konusuna bakın.
Geri bildirim
Geri bildiriminiz Jetpack'i daha iyi hale getirmemize yardımcı oluyor. Yeni sorunlar keşfederseniz veya bu kitaplığı nasıl geliştirebileceğimizle ilgili fikirleriniz varsa 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.
Daha fazla bilgi için Sorun İzleyici belgelerine bakın.
Wear Core Sürüm 1.0
Sürüm 1.0.0-alpha01
29 Mayıs 2024
androidx.wear:wear-core:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.
API Değişiklikleri
- Wear'da çalışma zamanı API uyumluluğu kontrolüne yardımcı olmak için yeni bir
WearApiVersionhelper
sınıfı eklendi. İstemciler, uyumluluğu kontrol etmek için bu statik yardımcı sınıfı ve sağlanan yöntemi (#isApiVersionAtLeast(VERSION)
) kullanabilir.
Wear Araçları Önizleme Sürümü 1.0
Sürüm 1.0.0
29 Kasım 2023
androidx.wear:wear-tooling-preview:1.0.0
yayınlandı. 1.0.0 sürümü bu kayıtları içerir.
1.0.0 sürümündeki özellikler
WearDevices
uygulamasını, kullanıcı arayüzü önizlemeleri için kullanılabilecek geçerli Wear cihazlarının listesine ekleyin.
Sürüm 1.0.0-rc01
15 Kasım 2023
androidx.wear:wear-tooling-preview:1.0.0-rc01
, hiçbir değişiklik yapılmadan serbest bırakıldı. 1.0.0-rc01 sürümü bu kayıtları içerir.
Sürüm 1.0.0-beta01
18 Ekim 2023
androidx.wear:wear-tooling-preview:1.0.0-beta01
, hiçbir değişiklik yapılmadan serbest bırakıldı. 1.0.0-beta01 sürümü bu kayıtları içerir.
Sürüm 1.0.0-alpha01
23 Ağustos 2023
androidx.wear:wear-tooling-preview:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.
API Değişiklikleri
WearDevices
özelliğini, kullanıcı arayüzü önizlemeleri için kullanılabilecek geçerli Wear cihazlarının listesine ekleyin (Ib036e)
Wear Sürümü 1.4
Sürüm 1.4.0-alpha01
15 Kasım 2023
androidx.wear:wear:1.4.0-alpha01
yayınlandı. Sürüm 1.4.0-alpha01 bu kayıtları içerir.
Hata Düzeltmeleri
- Mesaj olmadığında
ConfirmationOverlay
simgesini dikey olarak ortalayın. (I496d8)
Wear Sürümü 1.3
Sürüm 1.3.0
9 Ağustos 2023
androidx.wear:wear:1.3.0
, 1.3.0-rc01
tarihinden bu yana herhangi bir değişiklik olmadan yayınlandı. 1.3.0 sürümü bu kayıtları içerir.
1.2.0'dan sonraki önemli değişiklikler
LifecycleObserver
özelliğini kullanmak içinAmbientModeSupport
uygulamasını taşıyın.AmbientModeSupport
desteğini sonlandırıp onun yerine yaşam döngüsüne duyarlı yeni sınıfları kullanmaya başlayın.ConfirmationOverlay
uygulamasını yeni simgeler/düzen, yazı tipleri ve yazı tipi metrikleriyle güncelleyinSwipeDismissTransitionHelper
,FragmentContainerView
kullanılırken hataları düzeltmek için 2.View
yerine arka plan çekilebilir özelliğini kullanacak şekilde güncellendiSwipeDismissFrameLayout
animasyonu, Wear platformu ve Wear Compose uygulamalarıyla tutarlı olacak şekilde güncellendi.- Dikey kaydırmalı parçaların yanlışlıkla kapatılmasını önlemek için
SwipeDismissFrameLayout
hata düzeltmesi ArcLayout
artık normal Düzen ağırlıklarına benzer bir şekilde çalışan genişletme ağırlıklarını destekliyor.layoutDirection
kanalınıArcLayout
üzerinde destekleyin
Sürüm 1.3.0-rc01
21 Haziran 2023
androidx.wear:wear:1.3.0-rc01
, 1.3.0-beta01
tarihinden bu yana herhangi bir değişiklik olmadan yayınlandı. 1.3.0-rc01 sürümü bu kayıtları içerir.
Sürüm 1.3.0-beta01
7 Haziran 2023
androidx.wear:wear:1.3.0-beta01
yayınlandı. 1.3.0-beta01 sürümü bu kayıtları içerir.
API Değişiklikleri
AmbientLifecycleObserver
geri bildirimden sonra güncellendi.AmbientLifecycleObserverInterface
,AmbientLifecycleObserver
olarak yeniden adlandırıldı.AmbientLifecycleObserver(...)
çağrısı yapılarak bir örnek elde edilebilir.isAmbient
, yöntem yerine alan olarak taşındı. (I84b4f)
Hata Düzeltmeleri
SwipeToDismiss
ürününde alfa ve çeviriyi sıfırlarken üst görünümün boş olduğu durumları işlemek için boş denetimleri ekleme. (Ib0ec7)
Sürüm 1.3.0-alpha05
19 Nisan 2023
androidx.wear:wear:1.3.0-alpha05
yayınlandı. Sürüm 1.3.0-alpha05 bu kayıtları içerir.
API Değişiklikleri
LifecycleObserver
özelliğini kullanmak içinAmbientModeSupport
uygulamasını taşıyın.AmbientModeSupport
desteğini sonlandırıp onun yerine yaşam döngüsüne duyarlı yeni sınıfları kullanıma sunun. (I1593b)
Hata Düzeltmeleri
FragmentContainerView
kullanılırken hataları düzeltmek üzere görünüm eklemek yerine çekilebilir öğeleri kullanmak içinSwipeDismissTransitionHelper
arka plan kaydırma yaklaşımını güncelleyin. (I851cd)
Sürüm 1.3.0-alpha04
25 Ocak 2023
androidx.wear:wear:1.3.0-alpha04
yayınlandı. Sürüm 1.3.0-alpha04 bu kayıtları içerir.
Hata Düzeltmeleri
SwipeDismissFrameLayout
uygulamasındaki animasyonu, Wear platformu ve Wear Compose uygulamalarıyla tutarlı olacak şekilde güncelledik. (I7261b)
Sürüm 1.3.0-alpha03
24 Ağustos 2022
androidx.wear:wear:1.3.0-alpha03
yayınlandı. Sürüm 1.3.0-alpha03 bu kayıtları içerir.
Yeni Özellikler
ArcLayout
artık normal Düzen ağırlıklarına benzer bir şekilde çalışan genişletme ağırlıklarını destekliyor. Bu sayede, açılarını doğrudan hesaplamak zorunda kalmadan alt öğelerin göreli boyutunu belirtebilirsiniz. Ayrıca, alt öğeleri ağırlıklarla genişletirken dikkate alınan en iyiMaxAngleDegrees
denemesini de ekledik. Örneğin, ağırlıkları 90 derece olan birkaç alt öğe kullanarak yayı sabitleyebilirsiniz. Bu durumda, genişlemeyen öğeler tarafından kapsanan alan da dikkate alınacaktır.
API Değişiklikleri
ArcLayout.LayoutParams
öğesine ağırlık ekledik. Bu sayede widget, mevcut alanı dolduracak şekilde genişletilir. Birden fazla widget varsa kullanılabilir alandaki payları, ağırlıklarıyla orantılı olur. Ayrıca, genişletmeyi 90 derece olarak sınırlandırabilmeniz içinArcLayout.setMaxAngleDegrees
eklendi (NB bu şekilde sabit boyutlu alt widget'ların düzenini etkilemez). Son olarakArcLayout.Widget
, artıkArcLayout
öğesinin bir Widget'ı sıfır olmayan bir boyutla bilgilendirmesini sağlayansetSweepAngleDegrees
özelliğine sahiptir. (I75f24)setColorFilter
boş değer atanabilirliği güncellendi(I99ddf, b/236498063)
Sürüm 1.3.0-alpha02
23 Şubat 2022
androidx.wear:wear:1.3.0-alpha02
yayınlandı. Sürüm 1.3.0-alpha02 bu kayıtları içerir.
Yeni Özellikler
ArcLayout
platformunda (I14d49)layoutDirection
kanalını destekleyin- Onay Paylaşımı için iyileştirilmiş içerik açıklaması mesajı (I0fdf8)
ConfirmationOverlay
öğesini yeni simge/düzen ile güncelleyin. (If5b54)
Hata Düzeltmeleri
- Ambiyansla ilgili kodun korunduğundan emin olmak için ProGuard kuralları eklendi (Idaa10)
- Hızlıca Kaydırma Çerçevesi'ndeki parçaları dikey kaydırmayla (Idb6d8) yanlışlıkla kapatmayın (Idb6d8)
- Mesaj olmadığında Onay Paylaşımı'nı düzeltme (I63e6f)
Harici Katkı
- Dae Gyu LEE (Samsung) - Dikey kaydırmalı kaydırma efektindeki parçaların yanlışlıkla kapatılmasını önleyin (Idb6d8)
Sürüm 1.3.0-alpha01
29 Eylül 2021
androidx.wear:wear:1.3.0-alpha01
yayınlandı. Sürüm 1.3.0-alpha01 bu kayıtları içerir.
Hata Düzeltmeleri
ConfirmationOverlay
artık daha uzun mesajlar için cihazın çerçevesine (veya ekran dışına) çıkmadan simgeyi yukarı itiyor. (I54bff)
Wear Devam Eden Etkileşimler ve Sürüm 1.1.0
VerWear-Phone-Engagements Sürüm 1.1.0-alpha04
10 Ocak 2024
androidx.wear:wear-phone-interactions:1.1.0-alpha04
yayınlandı. Sürüm 1.1.0-alpha04 bu kayıtları içerir.
API Değişiklikleri
- Uzaktan kimlik doğrulamasının kullanılıp kullanılamadığını kontrol eden
RemoteAuthClient.isRemoteAuthAvailable
eklendi. (Ibc10c)
Sürüm 1.1.0-alpha02
10 Ocak 2024
androidx.wear:wear-remote-interactions:1.1.0-alpha02
yayınlandı. Sürüm 1.1.0-alpha02 bu kayıtları içerir.
API Değişiklikleri
- Uzaktan etkinlik başlatma işlevinin kullanılabilir olup olmadığını kontrol etmeye yardımcı olan
RemoteActivityHelper.isRemoteActivityHelperAvailable
özelliğini ekledik. (I107a9) RemoteActivityHelper
oluşturucusunu, Java ile uyumlu, isteğe bağlı parametreye sahip olacak şekilde güncelledik. (I75554)
Sürüm 1.1.0-alpha01
21 Haziran 2023
androidx.wear:wear-remote-interactions:1.1.0-alpha01
yayınlandı. Sürüm 1.1.0-alpha01 bu kayıtları içerir.
Hata Düzeltmeleri
RemoteActivityHelper
ürününde tamamlama ve hata işleme işlemlerinin yapılma şekli iyileştirildi. (I60d60)
Harici Katkı
- Guava bağımlılığını
wear-remote-interactions
üzerinden kaldırın ve daha küçük alternatifler kullanın.
Wear-Phone-Engagements Sürüm 1.1.0-alpha03
9 Mart 2022
androidx.wear:wear-phone-interactions:1.1.0-alpha03
yayınlandı. Sürüm 1.1.0-alpha03 bu kayıtları içerir.
Hata Düzeltmeleri
- Belirtilen istek URL'sinde yönlendirme URL'si ayarlanmamışsa
OAuthRequest
kaynağındakiredirectUrl
artık boş bir Dize döndürüyor. (I44242)
Wear-Phone-Engagements Sürüm 1.1.0-alpha02
15 Aralık 2021
androidx.wear:wear-phone-interactions:1.1.0-alpha02
yayınlandı. Sürüm 1.1.0-alpha02 bu kayıtları içerir.
Hata Düzeltmeleri
- Kod örneği snippet'indeki hata ve
ErrorCode
(I260e8) geçersiz bağlantı dahil olmak üzereRemoteAuthClient
dokümanlarındaki hataları düzeltin
Wear-Phone-Engagements Sürüm 1.1.0-alpha01
15 Eylül 2021
androidx.wear:wear-phone-interactions:1.1.0-alpha01
yayınlandı. Sürüm 1.1.0-alpha01 bu kayıtları içerir.
API Değişiklikleri
Wear Devam Eden Etkileşimler ve Sürüm 1.0.0
Wear-Phone-Etkileşimleri Sürüm 1.0.1
15 Aralık 2021
androidx.wear:wear-phone-interactions:1.0.1
yayınlandı. 1.0.1 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
excludedTags
olmadan köprü bildirimleri devre dışı bırakılmaya çalışılırkenBridgingManager
öğesinden hata atıldı.
Wear-Telefon Etkileşimleri Wear-Remote-Etkileşimler Sürüm 1.0.0
15 Eylül 2021
androidx.wear:wear-phone-interactions:1.0.0
ve androidx.wear:wear-remote-interactions:1.0.0
yayınlandı. 1.0.0 sürümü bu kayıtları içerir.
1.0.0'ın temel özellikleri
Telefon Etkileşim Kitaplığı, Giyilebilir Cihazlardan Telefonlara etkileşimler için API'ler içerir. Şunları içerir:
PhoneDeviceType
, yalnızca giyilebilir cihazlarda kullanılmak üzere mevcut kol saatinin eşlendiği telefon türünü belirlemek için yardımcı yöntemler sağlar.- Çalışma zamanında bildirimleri etkinleştirmek/devre dışı bırakmak ve isteğe bağlı olarak köprü modundan muaf olan bildirimler için etiketler ayarlamak için
BridgingManager
,BridgingManagerService
veBridgingConfig
API'lerini kullanın. RemoteAuthClient
, Giyilebilir cihazlarda uzaktan kimlik doğrulama desteğinin yanı sıra OAuth PKCE uzantısının eklenmesine yönelik destek sağlıyor. İletişim için ek işleyiciler ve yardımcı sınıflar sağlanır.
Uzaktan Etkileşim Kitaplığı, Giyilebilir Cihazlar ile Telefonlar arasındaki etkileşimlere yönelik API'leri içerir. Şunları içerir:
WatchFaceConfigIntentHelper
, telefondaki tamamlayıcı öğenin kadran yapılandırma etkinliklerinde kimliği ve bileşen adını belirten yardımcı işlevler sağlar.- Diğer cihazlarda (ör. saatten telefona) açılış amaçları için kullanılabilen
RemoteActivityHelper
sınıfı.
Wear-Telefon Etkileşimleri Wear-Remote-Etkileşimler Sürüm 1.0.0-rc01
1 Eylül 2021
androidx.wear:wear-phone-interactions:1.0.0-rc01
ve androidx.wear:wear-remote-interactions:1.0.0-rc01
yayınlandı. 1.0.0-rc01 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
- RemoteActivityHelper (I60d60) kullanılırken Google Play Hizmetleri'nde ortaya çıkan hataların arayana aktarılmasını engelleyen hata düzeltildi
- Bağlı düğüm olmadığında veya istenen nodeId bulunamazsa RemoteActivityHelper'ın Geleceğini hiçbir zaman gerçekleştirememesine neden olan hatayı düzeltin (I60d60)
Wear-Devam eden Sürüm 1.1
Sürüm 1.1.0-alpha01
23 Ağustos 2023
androidx.wear:wear-ongoing:1.1.0-alpha01
yayınlandı. Sürüm 1.1.0-alpha01 bu kayıtları içerir.
API Değişiklikleri
- Devam Eden Etkinlik'e bir içerik açıklama alanı ekleyin. Bu bilgi, erişilebilirlik hizmetleri tarafından Devam Eden Etkinliği tanımlamak için kullanılır. (I79fc6)
Hata Düzeltmeleri
- SDK 33 ve sonraki sürümlerde
POST_NOTIFICATIONS
izninin verilmesini gerektiren API'lere@RequiresPermission
eklendi. (Ie542e, b/238790278)
Wear-OnContinue Sürüm 1.0.0
1 Eylül 2021
androidx.wear:wear-ongoing:1.0.0
yayınlandı. 1.0.0 sürümü bu kayıtları içerir.
1.0.0'ın temel özellikleri
- Wear Devam Eden Etkinlikler API'si, aralarında üçüncü taraf geliştiriciler de bulunan geliştiricilere, etkinliklerini "Devam Eden Etkinlik" olarak işaretlemek ve gerekli bilgileri sağlamak için kullanılan bir API'dir.
- Devam Eden Aktiviteler, saatin arka planında çalışabilecek aktiviteleri ifade eder (ör. antrenmanlar, çağrılar ve medya). Wear 3'te, devam ettiği belirtilen bir etkinlik, kadranda özel bir yer paylaşımı simgesi ve uygulama başlatıcıda farklı bir oluşturma özelliği kullanılarak daha belirgin hale getirilecek.
- Daha fazla bilgi edinmek için Wear Devam Eden Etkinlik Kılavuzu'na bakın
Wear-Telefon Etkileşimleri Wear-Uzaktan-Etkileşimler Sürüm 1.0.0-beta01
18 Ağustos 2021
androidx.wear:wear-phone-interactions:1.0.0-beta01
ve androidx.wear:wear-remote-interactions:1.0.0-beta01
yayınlandı. 1.0.0-beta01 sürümü bu kayıtları içerir.
API Değişiklikleri
RemoteIntentHelper
sınıfının adıRemoteActivityHelper
olarak değiştirildi.RemoteIntentHelper#getRemoteIntentExtraIntent
veRemoteIntentHelper#getRemoteIntentNodeId
işlevleri sırasıylaRemoteActivityHelper#getTargetIntent
veRemoteActivityHelper#getTargetNodeId
olarak yeniden adlandırıldı. (Id2042)
Wear-OnContinue Sürüm 1.0.0-rc01
18 Ağustos 2021
androidx.wear:wear-ongoing:1.0.0-rc01
, 1.0.0-beta01
tarihinden bu yana herhangi bir değişiklik olmadan yayınlandı. 1.0.0-rc01 sürümü bu kayıtları içerir.
Wear-OnContinue Sürüm 1.0.0-beta01
4 Ağustos 2021
androidx.wear:wear-ongoing:1.0.0-beta01
yayınlandı. 1.0.0-beta01 sürümü bu kayıtları içerir.
API Değişiklikleri
- OnvingActivity.Builder aracındaki bazı setter'lar, belirleyicilere ve toplayıcılara simetri ve tutarlılık sağlamak için artık boş bir bağımsız değişken kabul ediyor (I17ee5)
Wear-Phone-Engagements Sürüm 1.0.0-alpha07
4 Ağustos 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha07
yayınlandı. 1.0.0-alpha07 sürümü bu kayıtları içerir.
API Değişiklikleri
WearTypeHelper.isChinaDevice
,WearTypeHelper.isChinaBuild
olarak yeniden adlandırıldı. (I47302)- RemoteAuthClient kitaplığını cihaz türüne (RoW/Çin) göre otomatik olarak redirect_uri'yi seçecek şekilde güncelledik. (I38866)
- BridgingConfig'in Bundle'a/paketten dönüştürülmesinin ClassCastException ile başarısız olmasına neden olan hata düzeltildi. BridgingManagerService sınıfı için birim testleri eklendi. (I68ecb)
Wear-Remote-Etkileşimler Sürüm 1.0.0-alpha06
4 Ağustos 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha06
yayınlandı. 1.0.0-alpha06 sürümü bu kayıtları içerir.
Wear-Phone-Interactions Sürüm 1.0.0-alpha06
21 Temmuz 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha06
yayınlandı. 1.0.0-alpha06 sürümü bu kayıtları içerir.
API Değişiklikleri
BridgingManagerSeviceBinder
sınıfı artık Hizmet'in bir alt sınıfı ve BridgingManagerSevice olarak yeniden adlandırıldı. (I9fca2)RemoteAuthClient.Callback.onAuthorizationError
yöntemi, OAuthRequest parametresini içerecek şekilde değiştirildi. Geri çağırmayı gerektiren yöntemlerde, geri çağırmanın çalışması için artık bir yürütücü de gerekir. (I35e11)
Hata Düzeltmeleri
- Daha fazla belgelenmiş parametreyle ve mümkün olduğunda özellikleri kullanarak kimlik doğrulama API'sını daha anlaşılır hale getirdik. (I12287)
Wear-Phone-Engagements Sürüm 1.0.0-alpha05
30 Haziran 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha05
yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
BridgingConfig.Builder
oluşturucuda iletilmesi gereken, belgelenmiş parametreler.
Wear-OnContinue Sürüm 1.0.0-alpha06
2 Haziran 2021
androidx.wear:wear-ongoing:1.0.0-alpha06
yayınlandı. 1.0.0-alpha06 sürümü bu kayıtları içerir.
API Değişiklikleri
- Devam Eden Etkinliğe Başlık alanı ekleyin. (I7a405)
Hata Düzeltmeleri
SerializationHelper.copy()
artık bilgilerin savunma kopyasını oluşturuyor (I8b276)- İyileştirilmiş setCategory belgeleri (Iff01f)
Wear-OnContinue Sürüm 1.0.0-alpha05
18 Mayıs 2021
androidx.wear:wear-ongoing:1.0.0-alpha05
yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.
API Değişiklikleri
OngoingActivity
artık doğrudan Oluşturucu aracılığıyla ayarlanan tüm değerleri (veya ilişkili Bildirim'den alınan varsayılan değerleri) almak için alıcıları kullanıyor. (Id8ac8)- Yeni
Status
sınıfı artıkOngoingActivity
durumunu oluşturmak için kullanılıyor OngoingActivityData
veOngoingActivityStatus
artık herkese açık API'nin bir parçası değil.
- Yeni
TextStatusPart
veTimerStatusPart
sınıfları artık herkese açık API'nin bir parçası değil. (I57fb6)- Statik metinle bir
Part
oluşturmak içinStatus.TextPart
işlevini kullanın. - Kronometreyle
Part
oluşturmak için (sayma)Status.Stopwatch
işlevini kullanın - Zamanlayıcı içeren bir
Part
oluşturmak için (geri sayım)Status.Timer
işlevini kullanın
- Statik metinle bir
Wear-OnContinue Sürüm 1.0.0-alpha04
5 Mayıs 2021
androidx.wear:wear-ongoing:1.0.0-alpha04
yayınlandı. Sürüm 1.0.0-alpha04 bu kayıtları içerir.
API Değişiklikleri
- OnoutgoingActivity'deki fromAvailableOnttingActivity yöntemleri artık, recoveryOnoutgoingActivity olarak adlandırılır.
- OngoActivity'nin artık tam bir alıcı grubu var. Bunlar, daha önce yalnızca OnvingActivityData'da bulunanlar. (I0ee4d)
Wear-Remote-Etkileşimler Sürüm 1.0.0-alpha05
21 Temmuz 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha05
yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.
API Değişiklikleri
Diğer cihazlarda (ör. saatten telefona) niyet açmak için kullanılabilecek
RemoteIntentHelper
sınıfını (eski adıyla Giyilebilir Destek Kitaplığı'nda bulunan RemoteIntent) ekledik. (I1d7e0)PlayStoreAvailability sınıfı, AndroidX kitaplığından kaldırıldı. Play Store'un bağlı bir telefonda kullanılıp kullanılamadığını algılamak için
androidx.phone.interactions.PhoneTypeHelper.getPhoneDeviceType
yöntemini kullanarak bağlı telefonun bir Android telefon olup olmadığını belirleyin. Ardından, bağlı telefonun Çin'e ait bir cihaz olup olmadığını belirlemek içinandroidx.wear.utils.WearTypeHelper.isChinaDevice
yöntemini kullanın. Telefon bir Android telefonsa ve bir Çin cihaz değilse Play Store kullanılabilir. (Ie7dec)
Wear-Phone-Engagements Sürüm 1.0.0-alpha04
7 Nisan 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha04
yayınlandı. Sürüm 1.0.0-alpha04 bu kayıtları içerir.
API Değişiklikleri
- Yeni kitaplığı, Giyilebilir Destek Kitaplığı'ndaki uygulama ile geriye dönük uyumlu hale getirmek için
ErrorCode
sabit değerleri güncellendi.
Hata Düzeltmeleri
- OAuth oturumu başlatılırken yeni OAuth API'sinin neden olduğu istisna düzeltildi.
Wear-Remote-Etkileşimler Sürüm 1.0.0-alpha03
7 Nisan 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha03
yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları içerir.
API Değişiklikleri
PlayStoreAvailability
, statik yöntemlerle tamamlayıcı nesne içeren bir sınıf olarak değiştirildi. Kullanım aynı kalır.
Hata Düzeltmeleri
WatchFaceConfigIntentHelper
özet dokümanı, örnek kodu gerçek HTML karakterleriyle doğru şekilde gösterecek şekilde düzeltildi.
Wear-Devam Eden Wear-Phone-Etkileşimleri Sürüm 1.0.0-alpha03
10 Mart 2021
androidx.wear:wear-ongoing:1.0.0-alpha03
ve androidx.wear:wear-phone-interactions:1.0.0-alpha03
yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları içerir.
Yeni Özellikler
- OAuthClient'ı Giyilebilir Destek Kitaplığı'ndan AndroidX'e taşıyın. Taşınan bu sınıfın adı RemoteAuthClient olarak değiştirildi ve Giyilebilir cihazlarda uzaktan kimlik doğrulama desteğinin yanı sıra OAuth PKCE uzantısı ekleme desteği de sunuyor. İletişim için ek işleyiciler ve yardımcı sınıflar sağlanır.
- Devam eden etkinlikler artık yeni OnvingActivity.Builder oluşturucuyu kullanarak etiketi olan bir Bildirim ile ilişkilendirilebilir.
API Değişiklikleri
- Devam Eden Etkinlikler Kitaplığı'nda bildirim etiketleri için destek eklendi (I653b4)
- OAuthClient'ı Wear Destek Kitaplığı'ndan AndroidX'e taşıyıp OAuth PKCE uzantısı için destek (I3eaaa) ekleme
Wear-Remote-Etkileşimler Sürüm 1.0.0-alpha02
10 Mart 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha02
yayınlandı. Sürüm 1.0.0-alpha02 bu kayıtları içerir.
Yeni Özellikler
- PlayStoreAvailability sınıfı, Giyilebilir Destek Kitaplığı'ndan AndroidX'e taşınıyor. Bu işlem, Play Store'un telefonda kullanılıp kullanılamadığını kontrol etmeyi sağlayan bir API sağlıyor.
Hata Düzeltmeleri
- PlayStoreAvailability sınıfı, Giyilebilir Destek Kitaplığı'ndan AndroidX'e taşınıyor. (I69bfe)
Sürüm 1.0.0-alpha02
10 Şubat 2021
androidx.wear:wear-ongoing:1.0.0-alpha02
ve androidx.wear:wear-phone-interactions:1.0.0-alpha02
yayınlandı. Sürüm 1.0.0-alpha02 bu kayıtları içerir.
API Değişiklikleri
- Daha karmaşık durum desteği eklendi. Bunlar, bir (veya birkaç) şablondan ve şablonun yer tutucularını doldurmak için kullanılacak bir dizi Bölümden oluşur. OnhaveActivityStatus, artık yalnızca tek bir parçayla (Metin veya Kronometre) basit durumlar oluşturmak için statik bir yönteme ve daha karmaşık durumlar oluşturmak için de Oluşturucu'ya sahip. (I1fe81)
- BridgingManager ve BridgingConfig sınıflarını Wear Destek Kitaplığı'ndan AndroidX'e taşıyın. Bu API'ler, çalışma zamanında bildirimleri etkinleştirme/devre dışı bırakma için API'ler sağlar ve isteğe bağlı olarak köprü modundan muaf olan bildirimler için etiketler ayarlayın. (I3a17e)
Sürüm 1.0.0-alpha01
27 Ocak 2021
androidx.wear:wear-ongoing:1.0.0-alpha01
, androidx.wear:wear-phone-interactions:1.0.0-alpha01
ve androidx.wear:wear-remote-interactions:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.
API Değişiklikleri
Devam Eden Etkinlikler kitaplığını yeni bir alt kitaplığa taşıyın: sürekli kullanılan etkinlikler. Sınıflar artık androidx.wear.on başı paketinde (eski adıyla androidx.wear.onhingactivities) (I7c029) bulunmaktadır.
Giyilebilir cihazlardan Telefonlara kadar etkileşimleri destekleyen sınıfları içerecek yeni bir destek kitaplığı oluşturun. Başlangıçta, Giyilebilir Cihaz Destek Kitaplığı'ndan taşınan sınıflara eklenir. (Id5180)
PhoneDeviceType sınıfını Giyilebilir Destek Kitaplığı'ndan AndroidX'e taşıyın. Taşınan sınıfın adı PhoneTypeHelper olarak değiştirildi. Bu sayede, geçerli kol saatinin yalnızca giyilebilir cihazlarda kullanılmak üzere eşlendiği telefon türünü belirleme konusunda yardımcı yöntemler sağlanır. (Ibd947)
Giyilebilir Cihazlar ve Telefonlar arasındaki etkileşimleri destekleyen sınıfları içerecek yeni bir destek kitaplığı oluşturun. Başlangıçta, Giyilebilir Cihaz Destek Kitaplığı'ndan taşınan sınıflara eklenir. (I9deb4)
WatchFaceCompanion sınıfını Wearable Support Library'den AndroidX'e taşıyın. Taşınan sınıfın adı WatchFaceConfigIntentHelper olarak değiştirildi. Bu özellik, telefondaki tamamlayıcı uygulamada saat yüzü yapılandırma etkinliklerinde kimliği ve bileşen adını belirtmek için yardımcı işlevler sağlar. Giyilebilir cihazdaki kadranı yapılandırmak için de yerel olarak kullanılabilir. (Ia455f)
Wear Özellikleri ve Kadran 1.0.0
Sürüm 1.0.0-alfa22
15 Eylül 2021
androidx.wear:wear-*:1.0.0-alpha22
yayınlandı. 1.0.0-alpha22 sürümü bu kayıtları içerir.
Yeni Özellikler
- EditorSession artık yaşam döngüsü gözlemleyicilerine abone olduğundan etkinliğiniz sona erdiğinde bu özelliği kapatmak zorunda kalmazsınız.
API Değişiklikleri
- EditorSession ve ListenableEditorSession artık complicationSlotsState, ComplicationsPreviewData ve ComplicationsDataSourceInfo için kotlin StateFlows'u kullanmaktadır. (I761d9)
- EditorSession#userStyle artık
MutableStateFlow<UserStyle>
(I32ca9) - EditorSession.createOnWatchEditorSession artık bir yaşam döngüsü gözlemleyicisi kullanmaktadır ve onDestroy gözlemlediğinde otomatik olarak kapanır. Ayrıca
createOnWatchEditorSession
artık yalnızca etkinliğin iletilmesini gerektiriyor. ListenableEditorSession işlevi için de aynı değişiklikler uygulandı. (Ic6b7f) - CustomValueUserStyleSetting'in oluşturucusu, genel API'nin bir parçası olarak yeniden etkinleştirildi. (I2e69a)
UserStyle
artıkMap<UserStyleSetting, UserStyleSetting.Option>
öğesinden devralıyor ve ayar şemada yoksa veya seçenek ayarla eşleşmiyorsaMutableUserStyleSetting#put
, IllegalArgumentException hatası verir. (Iba40f)
Sürüm 1.0.0-alfa21
1 Eylül 2021
androidx.wear:wear-*:1.0.0-alpha21
yayınlandı. 1.0.0-alpha21 sürümü bu kayıtları içerir.
API Değişiklikleri
- Tüm herkese açık kadranı, istemci, düzenleyici ve özellik API'leri artık java.time. Instant, bir Long yerine zamanlar için kullanılmaktadır. Bu nedenle, minimum API düzeyi 26'ya yükselmiştir. (I3cd48)
- Kadran ve özellik API'leri artık Takvim yerine sabit ZonedDateTime'ı kullanıyor. (I25cf8)
- ComplicationSlots artık NoDataComplicationData ile başlatılıyor, ComplicationSlot.complicationData artık her zaman bir değere sahip ve CanvasComplicationDrawable.complicationData artık null özellikli değil. (I4dfd6) Bu, kadranlar arasında geçiş yaparken komplikasyonların titremesini azaltır (ancak ortadan kaldırmaz).
Sürüm 1.0.0-alfa20
18 Ağustos 2021
androidx.wear:wear-*:1.0.0-alpha20
yayınlandı. Sürüm 1.0.0-alpha20 bu kayıtları içerir.
API Değişiklikleri
- ComplicationDataSourceInfoRetriever.retrievePreviewComplicationData null değeri döndürdüğünde kullanılabilecek, ComplicationDataSourceInfo öğesine createFallbackPreviewData ekledik. (I38c4d)
- ComplicationDataSourceUpdateRequester, birim testlerinde taklit yapmaya olanak tanıyacak bir arayüze dönüştürüldü. ComplicationDataSourceUpdateRequester.create() ile somut bir ComplicationDataSourceUpdateRequester oluşturabilirsiniz. (I7da22)
- RenderParameters.pressedComplicationSlotIds öğeleri
WatchFace.TapListener.onTap
,onTapEvent(@TapType tapType: Int, tapEvent: TapEvent)
ile değiştirildi. AyrıcaInteractiveWatchFaceClient.displayPressedAnimation
kaldırıldı. (Kimlik87d2) - setimportantForAccessibility (I990fa) için açık ileti dizisi ek açıklaması eklendi
- ComplicationSlotBoundsType, wear/wear-watchface'te androidx-wear-watchface.ComplicationSlotBoundsType konumuna taşındı. (I09420)
- UserStyleSetting ve Seçenekler'e dize kaynak kimliklerini geçirme desteği ekledik. Bu nesneleri oluşturmak için önerilen yöntemdir. (I03d5f)
- UserStyle Schema'nın maksimum kablo boyutuna sınırlar uygulanmıştır. Ayrıca, şemadaki Simgeler 400x400 pikselden büyük olmamalıdır. (I3b65b)
- UserStyle örneklerinde (I95a40) değişiklik yapılmasını desteklemek için bir MutableUserStyle sınıfı ekledik
ListenableWatchFaceMetadataClient.Companion#listenableCreateWatchFaceMetadataClient
alanının adınıListenableWatchFaceMetadataClient.Companion#createListenableWatchFaceMetadataClient
olarak değiştirdik. (I64ce2)- EditorState.previewComplicationsData öğelerini yalnızca etkinleştirilen özelliklere ilişkin verileri içerecek şekilde değiştirdik. Ayrıca,
renderWatchFaceToBitmap
veyaPreviewScreenshotParams
işlevine geçirildiğinde, kadranın varsayılan önizleme süresiyle oluşturma isteği gönderenEditorSession.DEFAULT_PREVIEW_TIME_MILLIS
parametresini ekledik. (If7b3c) - Herkese açık API'den CharSequence'i alan UserStyleSetting kurucularını kaldırdık. Bunun yerine StringResource kimlikleri gerektiren kurucuları kullanmanız önerilir. (I8537b)
CurrentUserStyleRepository.UserStyleChangeListener
artık SAM dönüşümünü destekliyor. (I85989)
Sürüm 1.0.0-alfa19
4 Ağustos 2021
androidx.wear:wear-*:1.0.0-alpha19
yayınlandı. Sürüm 1.0.0-alpha19 bu kayıtları içerir.
API Değişiklikleri
WatchFaceMetadataClient.createWatchFaceMetadataClient
içinListenableFuture
sarmalayıcısı sağlayanListenableWatchFaceMetadataClient.listenableCreateWatchFaceMetadataClient
öğesini ekledik. (I5fa37)UserStyleOption.getOptionForId
, artık bayt dizisi yerineUserStyleOption.Id
kabul ediyor. (I469be)BooleanOption.TRUE
veBooleanOption.FALSE
sabit değerlerini sağlayın ve örnek oluşturulmasına izin vermeyin (I46e09)- wear-watchface-client içindeki RemoteException oluşturabilen yöntemlere artık uygun şekilde ek açıklamalar eklendi. (Ib8438)
- Tutarlılık için
EditorSession.createOnWatchEditingSession
öğesinin adınıcreateOnWatchEditorSession
olarak değiştirdik. Adından da anlaşılacağı üzerecreateHeadlessEditingSession
artıkcreateHeadlessEditorSession
oldu. Guava sarmalayıcılarının adı da değiştirildi. (I1526b) EditorSession
artık bir arayüz veListenableEditorSession.commitChangesOnClose
doğru şekilde yetkilendirildi. (I7dc3e)- Çakışan kimliklere (Ic2715) sahip ayarları veya seçenekleri olan tüm kullanıcı stili şemalarını artık reddediyoruz.
UserStyleSetting.Id
kabul eden aşırı yüklenmiş birUserStyle.get
eklendi. (I2aa0f)
Sürüm 1.0.0-alpha18
21 Temmuz 2021
androidx.wear:wear-*:1.0.0-alpha18
yayınlandı. 1.0.0-alpha18 sürümü bu kayıtları içerir.
API Değişiklikleri
ComplicationHelperActivity
içeriğiniandroidx.wear:wear-watchface
kitaplığa taşıdık. (I39e76)- Tutarlılık ve netlik sağlamak amacıyla
ComplicationProvider
,ComplicationDataSource
olarak yeniden adlandırıldı ve adında Sağlayıcı bulunan tüm sınıflar da benzer şekilde yeniden adlandırıldı. (Iaef0b) CanvasComplication.isHighlighted
,RenderParameters.pressedComplicationSlotIds
hücresine taşındı. Bu,CanvasComplication
öğesini durum bilgisiz hale getirmeye yönelik bir adımdır. Bu değişikliği desteklemek içinCanvasComplication.render
artıkslotId
parametresini de parametre olarak alıyor veComplicationSlot
öğesiniGlesTextureComplication
öğesine iletiyoruz. (I50e6e)EditorRequest
öğesineheadlessDeviceConfig
ekledik. Boş değilse bu parametre, etkileşimli örneğe göre işlem yapmak yerine EditorSession'ı desteklemek için gözetimsiz bir örnek oluşturmak amacıyla kullanılır. Bu, düzenleyicinin geçerli olmayan bir kadran için çağrılmasını sağlar. (I0a820)UserStyleSchema
gibi statik kadran meta verilerinin etkili bir şekilde alınmasını veComplicationSlots
ile ilgili ayrıntıların düzeltilmesini sağlayan deneysel birWatchFaceMetadataClient
ekledik. (İ6bfdf)CanvasRenderer.uiThreadInit
adlı kuruluşun adını init olarak değiştirdik. (I6fff9)- EditorRequest için isteğe bağlı yeni bir parametre olan PreviewScreenParams'ı ekledik. Bu parametre, EditorSession'a bu parametre ile kaydedildiğinde önizleme ekran görüntüsü almasını söyler. Önizleme resmi
EditorState.previewImage
tarihinde gösterildi. (Ic2c16)
Hata Düzeltmeleri
- Geliştiricilerin artık ComplicationHelperActivity öğelerini kendi manifestlerine eklemelerine gerek yoktur. (I6f0c2)
Sürüm 1.0.0-alpha17
30 Haziran 2021
androidx.wear:wear-*:1.0.0-alpha17
yayınlandı. 1.0.0-alpha17 sürümü bu kayıtları içerir.
Yeni Özellikler
GlesRenderer
ürünündemakeUiThreadContextCurrent
vemakeBackgroundThreadContextCurrent
, her ikisi deRunnable
kabul edenrunUiThreadGlCommands
verunBackgroundThreadGlCommands
ile değiştirildi. Kitaplık, herhangi bir zamanda çalıştırılabilir yalnızca bir GL komutunun yürütülebilir olmasını sağlar.UiThread initialziaion'u kolaylaştırmak için herhangi bir oluşturma çağrısından önce UiThread'de bir kez çağrılan
CanvasRenderer.uiThreadInit
öğesini ekledik. Ayrıca,CanvasComplication
içinRenderer
veCanvasComplication
adlı kullanıcıların durum paylaşmasını kolaylaştıranonRendererCreated
özelliğini ekledik.Anlaşılır olması için
Complication
uygulamasını kullanıma bağlı olarakComplicationSlot
vecomplicationId
olarakcomplicationSlotId
veyacomplicationInstanceId
olarak değiştirdik
API Değişiklikleri
- Anlaşılır olması için
Complication
uygulamasını kullanıma bağlı olarakComplicationSlot
,complicationId
isecomplicationSlotId
veyacomplicationInstanceId
olarak yeniden adlandırdık. Complication kullanan sınıflar da benzer şekilde yeniden adlandırıldı. Örneğin, ComplicationManager artık ComplicationSlotsManager olarak adlandırılıyor. (I4da44) - GlesRenderer'da
makeUiThreadContextCurrent
vemakeBackgroundThreadContextCurrent
, her ikisi deRunnable
kabul edenrunUiThreadGlCommands
verunBackgroundThreadGlCommands
ile değiştirildi. Bu işlevler yalnızca oluşturma,runBackgroundThreadGlCommands
veonUiThreadGlSurfaceCreated
dışında GL çağrıları yapmanız gerektiğinde gereklidir. Bu işlem, her biri aynı işlemde (potansiyel olarak farklı kadranlarda) kendi bağlamına sahip birden fazla GlesRenderer olabileceği için gereklidir. Buna ek olarak, paylaşılan geçerli GL bağlamına erişim şimdi senkronize edilir. (I04d59) - Oluşturulacak herhangi bir çağrıdan önce UiThread'de bir kez çağrılan
CanvasRenderer.uiThreadInit
eklendi. Ayrıca, anlaşılırlık açısından GlesRenderer'daonGlContextCreated
öğesinionBackgroundThreadGlContextCreated
veonGlSurfaceCreated
öğesinionUiThreadGlSurfaceCreated
olarak yeniden adlandırdık. (If86d0) HeadlessWatchFaceClient
veInteractiveWatchFaceClient
getComplicationsSlotState
,getComplicationSlotsState
olarak yeniden adlandırıldı.ComplicationSlot
içinde:createRoundRectComplicationBuilder
,createBackgroundComplicationBuilder
vecreateEdgeComplicationBuilder
, sırasıylacreateRoundRectComplicationSlotBuilder
,createBackgroundComplicationSlotBuilder
vecreateEdgeComplicationSlotBuilder
olarak yeniden adlandırıldı. (Ib9adc)- Renderer ve CanvasComplication'ın durumu paylaşmasını kolaylaştıran onRendererCreated öğesini CanvasComplication'a ekledik. (I5e1ac)
Sürüm 1.0.0-alfa16
16 Haziran 2021
androidx.wear:wear-*:1.0.0-alpha16
yayınlandı. 1.0.0-alpha16 sürümü bu kayıtları içerir.
Yeni Özellikler
- Mesaj dizisi modelinde yapılan son değişikliklerle ilgili çeşitli hataları ve kadran üzerinde gerçekleştirilen düzenleyiciyle ilgili diğer sorunları giderdik.
Hata Düzeltmeleri
onComplicationProviderChooserResult
içinde NPE'yi önleme (b/189594557)- Eski yüzeyler vedrawBlack ile ilgili sorunları düzeltme (b/189452267)
complicationsManager.watchState
erişim yarışını düzeltin (b/189457893)- Arka plan iş parçacığı ömrü hatasını düzeltme (b/189445428)
- R sürümünden önceki kadran düzenleyicisi sorunlarını düzeltme (b/189126313)
- Düzenleyici stili değişiklikleri için doğrudan başlatma parametrelerini güncelleme (b/187177307)
Sürüm 1.0.0-alfa15
2 Haziran 2021
androidx.wear:wear-*:1.0.0-alpha15
yayınlandı. 1.0.0-alpha15 sürümü bu kayıtları içerir.
Yeni Özellikler
Kadranı başlatma işleminin büyük kısmı artık arka plan ileti dizisinde yapılıyor. Tüm kadranı oluşturma işlemleri yüklendikten sonra UiThread'de yapılıyor. Yükleme ve oluşturma arasında bellek engeli olduğu için çoğu kullanıcı kadranının özel bir şey yapmasına gerek yoktur. GLES kullanan kadranlar istisna olabilir, bağlam ileti dizisine özgüdür ve bağlantılı iki bağlam oluştururuz.Böylece GL kaynaklarını (ör. dokular ve gölgelendiriciler) arka plan iş parçacığına yükleyip UiThread'de kullanabilirsiniz.
Kadran tasarımını üç işleve ayırdık: createUserStyleSchema, createComplicationsManager ve createWatchFace. createUserStyleSchema ve createComplicationsManager işlemlerinin hızlı olduğunu ve createWatchFace'in öğeleri yüklemesinin biraz zaman alabileceğini varsayıyoruz. Bundan hemen sonra, DefaultComplicationProviderPolicies ve varsayılan ComplicationType için bir Complication Kimlikleri eşlemesi döndüren WatchFaceControlClient.getDefaultProviderPoliciesAndType
işlevini kullanıma sunduk. Sorguyu gerçekleştirmek için kadranın tamamen başlatılmasına gerek olmadığından bu işlem, gözetimsiz bir örnek oluşturmaktan daha hızlıdır.
Son olarak özellikler artık CanvasComplication oluşturucularının geç yapılandırılmasına olanak tanıyan bir CanvasComplicationFactory ile oluşturulur.
API Değişiklikleri
@TargetApi
,@RequiresApi
ile değiştirildi. (I0184a, b/187447093, b/187447094)- DefaultComplicationProviderPolicies ve varsayılan ComplicationType için Özellik Kimliklerinin haritasını döndüren
WatchFaceControlClient.getDefaultProviderPoliciesAndType
kullanıma sunuldu. Mümkün olduğunda, kadranı tam olarak oluşturmaktan kaçınan hızlı bir yol kullanılmalıdır. Bunu kolaylaştırmak için WatchFaceService API'nin iki yeni yöntemle değiştirilmesi gerekiyor: createUserStyleSchema ve createComplicationsManager. Bu yöntemlerin sonuçları createWatchFace'a iletilir. Ayrıca, Özellikler artık CanvasComplication oluşturucularının geç oluşturulmasına izin veren bir CanvasComplicationFactory ile oluşturuluyor. (Iad6c1) - MOST_RECENT_APP, SystemProvider'lardan kaldırıldı. (I3df00)
- ObservableWatchData artık güvenilir bir sınıf. (Ic940d)
- CanvasComplicationFactory.create (genellikle io ile sınırlanır), arayüz iş parçacığı oluşturma işlemi başlamadan önce artık her özellik için bir arka plan iş parçacığında çağrılır. Yapım ve oluşturma arasında bellek engeli bulunur. Bu nedenle, özel iş parçacığı temel öğeleri gerekmez. (Ia18f2)
- Kadran oluşturma işlemi artık arka plan iş parçacığında gerçekleştiriliyor ancak tüm oluşturma kullanıcı arayüzü iş parçacığında yapılıyor, GlesRenderer bunu desteklemek için iki bağlantılı bağlamı destekliyor. WatchFaceControlClient.createHeadlessWatchFaceClient ve WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient, WatchFaceService.createWatchFace işlemlerini tamamlamadan bu sorunu çözebilir. WatchFace'i başlatma işlemi tamamlanana kadar sonraki API çağrıları engellenir. (Id9f41)
- EXPANSION_DP ve STROKE_WIDTH_DP artık api.txt içinde görünür değil. (I54801)
- Boş oturum göndermek yerine hata oluştuğunda EditorSession.createOnWatchEditingSession'ın TimeoutSubscriptionException hatası vermesini sağladık. Ayrıca, EditorRequest.createFromIntent ve EditorSession.createOnWatchEditingSession parametrelerini döndüren değer artık NonNull olacaktır. (I41eb4)
Sürüm 1.0.0-alpha14
18 Mayıs 2021
androidx.wear:wear-*:1.0.0-alpha14
yayınlandı. Sürüm 1.0.0-alpha14 bu kayıtları içerir.
Yeni Özellikler
EditorSession.openComplicationProviderChooser
artıkComplicationProviderInfo
komplikasyon kimliğini ve sağlayıcı seçici tarafından döndürülen ek ekstraları içeren bir Bundle içeren ChosenComplicationProvider değerini döndürüyor.- Buna ek olarak, kodları Kotlin'e istikrarlı bir şekilde taşıyoruz. Kadran API'sinin büyük bir kısmı artık Kotlin'de tanımlanıyor.
API Değişiklikleri
- GlesRenderer özellikleri
eglContext
veeglDisplay
artık null kullanılamaz. Tüm GL hataları artık RuntimeExceptions yerineGlesRenderer.GlesException
aracılığıyla bildiriliyor. (Ib1005) androidx.wear.watchface.complications.rendering.ComplicationDrawable
öğesini Java'dan Kotlin'e (Ibc3eb) taşıdık.androidx.wear.watchface.complications.rendering.ComplicationStyle
uygulamasını Java'dan Kotlin'e (I3375e) taşıdık.- EditorSession içindeki her özellik için özellik sağlayıcı hakkında bilgi ekledik. (I37f14)
EditorSession.openComplicationProviderChooser
sonucunun kapsamını, seçilen kullanıcı tarafından döndürülen bilgileri içerecek şekilde genişlettik. (Iead6d)
Wear Özellikleri ve Kadran Sürümü 1.0.0-alpha13
5 Mayıs 2021
androidx.wear:wear-*:1.0.0-alpha13
yayınlandı. Sürüm 1.0.0-alpha13 bu kayıtları içerir.
Yeni Özellikler
Kadranlarda saatin ve karmaşıklığın dışında önemli görsel öğeler bulunabilir. Bunun için ekran okuyucu desteği sağlamak amacıyla, kadranı artık Oluşturucu'nun additionalContentDescriptionLabel özelliği aracılığıyla erişilebilirlik ContentDescriptionEtiketleri belirtebilecektir. Buna ek olarak, ContentDescriptionEtiketlerin sıralamasını kontrol etmek içinmizeAccessibilityTraversalIndex eklendi. Bu, bir ComplicationsUserStyleSetting tarafından değiştirilebilir.
Geliştiricileri ekran okuyucularını dikkatli bir şekilde düşünmeye teşvik etmek için
ShortTextComplicationData.Builder
,LongTextComplicationData.Builder
veRangedValueComplicationData.Builder
contentDescription
alanlarını bileşenlerine geçirmeyi zorunlu hale getirdik.contentDescription
içinComplicationText.EMPTY
aktarılırsa metin ve başlıktan otomatik olarak bircontentDescription
oluşturulur.Saat yüzü başlatma sırasında bir istisna atarsa
WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient
artıkServiceStartFailureException
değerini atar. Bu da kadran başlatılırken sorunların teşhis edilmesini çok kolaylaştırır.
API Değişiklikleri
- ComplicationProviderInfo'ya, Wear OS'in eski sürümlerini desteklemek için gerekli olan boş bileşen adına sahip olma desteği ekledik. (I744d2)
androidx.wear.complications.SystemProviders
, Java'dan Kotlin'e taşındı. (Ia1f8b)- android.support.wearable.complications içinde bulunan genel API'deki tüm sınıfları gizledik ve AndroidX'te gerektiğinde ilgili sarmalayıcılar oluşturduk. (I7bd50)
TimeDifferenceComplicationText.Builder
paketindekisetMinimumUnit
olan yöntemisetMinimalTimeUnit
olarak yeniden adlandırdık. (I20c64)ShortTextComplicationData.Builder
,LongTextComplicationData.Builder
veRangedValueComplicationData.Builder
contentDescription
alanlarını kurucuda iletilmesini zorunlu hale getirdik. (I8cb69)- ComplicationProviderService.onComplicationUpdate'i, onComplicationRequest olarak yeniden adlandırdık ve bu yöntemin kimlik ve tür parametresini data ComplicationRequest olarak kapsülledik. Karşılık gelen işleyici, ComplicationRequestListener ve yöntemi ComplicationRequestListener.onComplicationData olarak yeniden adlandırıldı. (Iaf146)
ComplicationData
öğesindenisActiveAt
yöntemini kaldırdık ve bunun yerinevalidTimeRange
alanını gösterdik. Bu yöntem çağrısıvalidTimeRange.contains
ile değiştirilebilir. (I65936)- ComplicationProviderService.onComplicationActivated yönteminin açıklamasını, int (Idb5ff) yerine bir ComplicationType alacak şekilde değiştirdik.
- ProviderUpdateRequester, Java'dan Koltin'e taşındı. (Ibce13)
- GlesRender.makeContextCurrent artık herkese açık. Kadran kodunun, oluşturma ve onGlContextCreated dışında gl çağrıları yapması gerekebilir. Ayrıca, bunu çağırmak için hem etkileşimli hem de gözetimsiz bir bağlam olabilir. (I8a43c)
- Saat yüzü başlatma sırasında hata verirse WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient artık ServiceStartFailureException hatası bildirir. Ayrıca, createWatchFace 6 saniyeden uzun sürerse WatchFaceService artık bir istisna oluşturur. (I59b2f)
GlesTextureComplication
öğesinin kullanılmayan id özelliğini kaldırdık. (I28958)- Saat yüzü artık
Renderer
ürününün additionalContentDescriptionLabel özelliği aracılığıyla erişilebilirlik ContentDescriptionEtiketler'i belirtebilir. Özelliklere, ContentDescriptionEtiketlerin sıralamasını kontrol etmeye ek olarakAccessibilityTraversalIndex eklendi. Bu, bir ComplicationsUserStyleSetting tarafından değiştirilebilir. (Ib7362) - Saat yüzünde dokunma etkinliği işlemeyle ilgili dokümanları genişlet. (Iaf31e)
Hata Düzeltmeleri
EditorSession.getComplicationsPreviewData()
artık yalnızca boş olmayan her komplikasyon için bir harita döndürüyor. Boş özellikler için bir BlankComplicationData örneği kullanılıyor. (I1ef7e)
Wear Özellikleri ve Kadran Sürümü 1.0.0-alpha12
21 Nisan 2021
androidx.wear:wear-*:1.0.0-alpha12
yayınlandı. 1.0.0-alpha12 sürümü bu kayıtları içerir.
Yeni Özellikler
Kadran düzenleyicilerinin, kadranın hangi yönünün yapılandırıldığını aktarmasına yardımcı olmak için kadranın belirli bölümlerini vurgulaması gerekir. RenderParameters'i, stillerin ve özelliklerin (komplikasyonların) vurgulanmasına izin verecek şekilde genişlettik. Alfa şeffaflığıyla saat yüzünün üst kısmına yerleştirilmek üzere tasarlanan yeni bir isteğe bağlı Vurgulama Katmanı eklendi (ekran görüntüsü api'leri bu işlemi sizin için yapabilir veya maksimum esneklik için Vurgulama Katmanı'nı kendi başına sağlayabilir). Örneğin, kol saatinin görünümünü yapılandırmanıza olanak veren bir stiliniz olduğunu varsayalım. Vurgulama katmanındaki oluşturucunuz bu ellerin etrafına bir dış çizgi çizebilir.
Erişilebilirlik için Complication Provider desteğini teşvik etmek için PhotoImageComplicationData.Builder, MonochromaticImageComplicationData.Builder ve SmallImageComplicationData.Builder öğelerini, contentDescription alanını zorunlu bir kurucu bağımsız değişkeni olacak hale getirdik. Uç özelliklerini (ekranın kenarına çizilen) desteklemek için ComplicationTapFilter ve Complication.createEdgeComplicationBuilder eklendi. Kenar özelliklerinin oluşturulması ve test edilmesi saat yüzüne bırakılır. Uç isabet testi, tamamlayıcı düzenleyicide desteklenmez.
API Değişiklikleri
- SystemProvider'lardaki sabit değerlere
PROVIDER_
ön eki eklendi. (I1e773) PhotoImageComplicationData.Builder
,MonochromaticImageComplicationData.Builder
veSmallImageComplicationData.Builder
contentDescription
alanlarını oluşturucuda iletilmesi zorunlu hale getirdik. (I9643a)ProviderInfoRetriever.requestPreviewComplicationData
,retrievePreviewComplicationData
olarak yeniden adlandırıldı. (I911ee)ComplicationProviderService
, Java'dan Koltin'e taşındı. (I849f2)ComplicationProviderService.onBind
yöntemi artık nihai (I39af5)CanvasComplication
arayüzünü yeniden etkinleştiripCanvasComplicaitonDrawable
,GlesTextureComplication
veComplicationHighlightRenderer
öğeleriniwear-watchface-complications-rendering
kuruluş birimine taşıdık. (I84670)RenderParameters
, öne çıkan anlar oluşturma işlemini daha uzun sürede desteklemek için yeniden düzenlendi. Artık stillerin yanı sıra tek bir özelliği veya özelliği oluşturan vurguların oluşturulmasını isteyebilirsiniz. Bunlara ek olarak, CanvasRenderer ve GlesRenderer'da, düzenleyici tarafından istenen vurgulamaları oluşturmak için yeni bir soyut createhighlighttier yöntemi kullanılır. Katman, WatchFaceKatman olarak yeniden adlandırıldı. (Ic2444)- Uç özelliklerini desteklemek için
ComplicationTapFilter
veComplication.createEdgeComplicationBuilder
eklendi. Kenar özelliklerinin oluşturulması ve test edilmesi saat yüzüne bırakılır. İsabet testi, düzenleyicilerin içinden desteklenmez. (Ia6604) DoubleRangeUserStyleSetting
veLongRangeUserStyleSetting
için:defaultValue
,maximumValue
veminimumValue
artık kotlin mülkü oldu. Ayrıca,UserStyleSetting.Option
toBooleanOption, toCoplicationOptions, toListOption ve benzer işlevler kaldırıldı. (I52899)- Kadranda kullanılabilen cihaz özelliklerine çene boyutunu ekleyin. (I76e1e)
ComplicationHighlightRenderer
oluşturucu artıkoutlineExpansion
veoutlineStrokeWidth
parametrelerini kabul ediyor. (I87009)ComplicationDrawable.getNoDataText
artık genel API'nin bir parçası. (I00598)
Sürüm 1.0.0-alpha11
7 Nisan 2021
androidx.wear:wear-*:1.0.0-alpha11
yayınlandı. Sürüm 1.0.0-alpha11 bu kayıtları içerir.
Yeni Özellikler
- Kadran API'leri daha iyi hale getirildi. Değişikliklerin çoğu basit yeniden adlandırmalardan oluşuyor, ancak
InteractiveWatchFaceWcsClient
veInteractiveWatchFaceSysUiClient
,InteractiveWatchFaceClient
olarak birleştirildi.
API Değişiklikleri
- ContentDescriptionLabel.text artık eski giyilebilir cihaz destek kitaplığı TimeDependentText yerine ComplicationText olarak adlandırılıyor. (I80c03)
SystemProviders.GOOGLE_PAY
tüm Android R cihazlarda bulunduğu garanti edilmediği için listeden kaldırıldı. Bu sağlayıcıyıDefaultComplicationProviderPolicy
(If01b5) üzerinden kullanmaya devam edebilirsiniz- Tutarlılık için ComplicationUpdateCallback'i ComplicationUpdateListener olarak yeniden adlandırdık. (I61ec7)
- UserStyle kablo biçimi haritası
Map<String, byte[]>
olarak değiştirildi ve kolaylık sağlamak amacıyla herkese açık API'yeUserStyleData
sınıfı eklendi ve artık wear-watchface-client ve wear-watchface-editor tarafından kullanılıyor. Ayrıca, CustomValueUserStyleSetting.CustomValueOption.value artıkString
yerinebyte[]
. (Iaa103) UserStyleSetting
veUserStyleSetting.Option
artık kimliklerini depolamak için String yerine sırasıylaUserStyleSetting.Id
veUserStyleSetting.Option.Id
kullanıyor. (I63f72)InteractiveWatchFaceClient.SystemState
,WatchUiState
olarak yeniden adlandırıldı. (I6a4e0)- Sorumluluğun bölünmesini açıklamak zor olduğu için
InteractiveWatchFaceWcsClient
veInteractiveWatchFaceSysUiClient
birleştirildi (Iff3fa) - Katman sıralama değerleri, daha anlaşılır olması için yeniden adlandırıldı.
Layer#TOP_LAYER
,Layer#COMPLICATIONS_OVERLAY
veLayer#BASE_LAYER
artıkLayer#BASE
(Ia144e) oldu UserStyleListener
,UserStyleChangeListener
(I18524) olarak yeniden adlandırıldıUserStyleRepository
,CurrentUserStyleRepository
(I6ea53) olarak yeniden adlandırıldıInteractiveWatchFaceWcsClient.updateInstance
,updateWatchfaceInstance
olarak yeniden adlandırıldı. (I321dc)- WatchFace TapType etkinlikleri, MotionEvents / Compose ile uyumlu olacak şekilde yeniden adlandırıldı. (I0dfd0)
- TakeWatchfaceEkran görüntüsü, generateWatchFaceToBitmap olarak, getComplicationEkran görüntüsü ise generateComplicationToBitmap (Ie0697) olarak yeniden adlandırılmıştır
- CanvasComplication arayüzü, açık sınıf CanvasComplicationDrawable için kaldırıldı. (I1f81f)
WatcfaceControlServiceFactory
, herkese açık API'den kaldırıldı. (I1f8d3)CanvasComplication.setData
alan adının adınıCanvasComplication.loadData
olarak değiştirdik. (If1239)ComplicationsManager.bringAttentionToComplication
,displayPressedAnimation
olarak yeniden adlandırıldı. (Ic4297)WatchFaceService.createWatchFace
artık@UiThread
ek açıklamasına sahip. (Ib54c2)- Bir hatayı düzeltmek için CanvasComplicationDrawable parametresinin adı değiştirildi. (I50dac)
- AIDL üzerinden
HeadlessWatchFaceClient
göndermeyi desteklemek içinHeadlessWatchFaceClient.toBundle()
veHeadlessWatchFaceClient.createFromBundle
özelliklerini ekledik. (I07c35) - HeadlessWatchFaceClient ve InteractiveWatchFaceClient artık, herhangi bir nedenden (ör. kadran sonlandırılarak) bağlantının kesilip kesilmediğini gözlemlemenizi sağlayan ClientConnectListener ve isConnectionAlive() özelliklerini kullanabilirler. (Ie446d)
WatchFaceControlClient#getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync
artık bir askıya alma işlevi olarak yeniden adlandırıldı vegetOrCreateInteractiveWatchFaceClient
olarak yeniden adlandırıldı. (Ib745d)EditorState.commitChanges
vehasCommitChanges()
,shouldCommitChanges()
olarak yeniden adlandırıldı. (I06e04)previewComplicationData
, (genellikle) haritada birden fazla komplikasyon olduğunu göstermek içinpreviewComplicationsData
olarak yeniden adlandırıldı. (I56c06)InteractiveWatchFaceWcsClient.bringAttentionToComplication
,ComplicationsManager.displayPressedAnimation
ile tutarlı olması içindisplayPressedAnimation
olarak yeniden adlandırıldı. (Ic9999)- Saat yüzü örnek kimliğinin tüm örnekleri yeni bir WatchFaceId sınıfında (I45fdf) kapsüllendi.
complicationState
özelliği, çoğulluğu belirtmek içincomplicationsState
olarak yeniden adlandırıldı. (Ided07)- Çeşitli wear-watchface-client Bağlayıcı dönüşümlerini kaldırdık. Bunlar gerekli olmalıdır. (Icc4c0)
- Tutarlılık için
EditorServiceClient
, gözlemciler yerine işleyiciler kullanılacak şekilde yeniden düzenlendi. (Iec3a4) InteractiveWatchFaceSysUiClient
veWatchFaceControlClient
sürümlerine eksik birkaç@Px
ek açıklaması ekledik. (I3277a)- Tutarlılık için EditorObserverCallback'i EditorObserverListener olarak yeniden adlandırdılar. (Ie572d)
- EditorState.watchFaceInstanceId, Android R API düzeyi ve üstü ile kısıtlanmıştır ve artık null kullanılamaz. (Id52bb)
EditorSession.launchComplicationProviderChooser
,openComplicationProviderChooser
olarak yeniden adlandırıldı. (I9d441)EditorSession.createOnWatchEditingSessionAsync
,createOnWatchEditingSession
olarak yeniden adlandırıldı ve askıya alma işlevi olarak değiştirildi. (Id257b)EditorSession
web sitesine eksik olan birçok@UiThread
ek açıklaması eklendi. (I6935c)UserStyleSetting.affectsLayers
,affectedLayers
olarak yeniden adlandırıldı. (I6e22b)
Sürüm 1.0.0-alfa10
24 Mart 2021
androidx.wear:wear-*:1.0.0-alpha10
yayınlandı. Sürüm 1.0.0-alpha10 bu kayıtları içerir.
Yeni Özellikler
- Artık WatchFaceService.createWatchFace sırasında açık gl nesneleri (ör. dokular) oluşturulabilir.Çünkü GlesRenderer artık createWatchFace içinde yapılabilen initOpenGLContext için açık bir çağrı gerektirir.
API Değişiklikleri
IdAndComplicationData
biraz garipti ve genel API'den kaldırıldı. Bunu kullanan sınıflar ve arayüzler yeniden düzenlendi. (I4c928)ReferenceTime
ifadesiniCountUpTimeReference
veCountDownTimeReference
ile değiştirdik. Bu değerler daha açıklayıcıdır. (Ib66c6)- Bazı eksik
@Px
ve@ColorInt
ek açıklamaları eklendi. (I9bbc3) Complication.complicationConfigExtras
artık boş değersiz ve varsayılan olarakBundle.EMPTY
değerine ayarlı. (Iad04f)GlesRenderer
artık yol çalışmasından sonrainitOpenGLContext
numaralı telefonu aramanızı gerektiriyor. Bu işlev dahili bir ayrıntıydı ancak daha önce createWatchFace içinde GL çağrılarına izin vermek için artık genel API'dedir. (I726c2)Complication.setRenderer
gerekli olmaması gerektiği için kaldırıldı. (Ie992f)Complicaiton.setComplicationBounds
artık herkese açık API'nin bir parçası değil. Bir özelliğin konumunu ayarlamanız gerekiyorsa bunuComplicationsUserStyleSetting
aracılığıyla yapabilirsiniz. (Ibd9e5)ComplicationsManager.TapCallback.onComplicationSingleTapped
,onComplicationTapped
olarak yeniden adlandırıldı. (I3a55c)ComplicationOutlineRenderer.drawComplicationSelectOutline
,drawComplicationOutline
olarak yeniden adlandırıldı. (I14b88)
Sürüm 1.0.0-alpha09
10 Mart 2021
androidx.wear:wear-complications-*:1.0.0-alpha09
ve androidx.wear:wear-watchface-*:1.0.0-alpha09
yayınlandı. Sürüm 1.0.0-alpha09 bu kayıtları içerir.
Yeni Özellikler
- WCS/SysUI ana makinesi ile kadran arasındaki arayüz gelişmiştir. Artık düzenleyiciler, bir stil değişikliğinin bir özelliği etkinleştirip devre dışı bırakamayacağını belirleyebilir (enabled = initialEnabled ve ComplicationsUserStyleSetting'daki geçersiz kılma işlemleri). Ayrıca,
EditorService.closeEditor
SysUI'nin gerektiğinde kadran düzenleyicisini uzaktan kapatmasına da izin verir. - Buna ek olarak
InteractiveWatchFaceWcsClient.setUserStyle
, tek seferde örnek kimliğini değiştiren, stili ayarlayan ve özellikleri temizleyen daha güçlü birupdateInstance
komutuyla çalışır.
API Değişiklikleri
- TraceEvents, saat yüzü kitaplıklarına eklendi. (I1a141)
ComplicationState
artık stiller değiştirmenin sonuçlarını tahmin etmek için yararlı olan yeni birinitiallyEnabled
özelliğine sahip. (I8c905)InteractiveWatchFaceWcsClient.setUserStyle
ifadesinin yerine, örnek kimliğini değiştiren, stili ayarlayan ve özellikleri temizleyen daha güçlü birupdateInstance
komutuyla değiştirdik. (Ife6f6)- WatchFaceClient ekran görüntüsü API'leri, ekran görüntülerini artık yavaş olduğundan sıkıştırmamaktadır. Bununla birlikte, son işleme sürecini arayan kişiye bırakırız. (Id35af)
- Artık
EditorService.closeEditor
ile kadran düzenleyicilerini uzaktan kapatabilirsiniz. (Ic5aa4) - Boş değer atanabilirliği ek açıklamaları eklendi (Ic16ed)
Sürüm 1.0.0-alpha08
24 Şubat 2021
androidx.wear:wear-*:1.0.0-alpha08
yayınlandı. 1.0.0-alpha08 sürümü bu kayıtları içerir.
Yeni Özellikler
- Bazı kadranlar bir veya daha fazla belirli özelliğe göre tasarlanmıştır. Bu özelliği desteklemek için Complication.Builder#setFixedComplicationProvider işlevini ekledik. Doğru değerine ayarlanırsa kullanıcının özelliği bu alandaki özelliği değiştirmesini engeller.
- Kadran kitaplıklarında öncelikle Kotlin kullanılır ve eş yordamlar (ör. askıya alma işlevleri) kullanılır. Java kullanıcıları için şu kitaplıklarda birlikte çalışabilirliği iyileştirmek için ListenableFuture sarmalayıcıları sağladık: wear/wear-watchface-guava, wear/wear-watchface-client-guava ve wear/wear-watchface-editor-guava.
API Değişiklikleri
- Sağlayıcı seçiciyi başlatan özelliklere iki kez dokunma desteğini kaldırdık. Bu özellik, kadranlarda yaygın değildi ve SysUI'nin uygulanmasını karmaşık hale getirdi. (I3ef24)
- Bağlayıcı beklenmedik bir şekilde kapanırsa ProviderInfoRetriever yöntemleri ServiceConnectionedException hatası verebilir. (Ib2cc4)
- Android 11'den itibaren, ProviderChooser'ın ne zaman çalıştırılabileceğiyle ilgili kısıtlamalar olacaktır. Ayrıca, düzenleyicilerin yeni
wear-watchface-editor
ile oluşturulmasını istiyoruz. Bu nedenle, ComplicationHelperActivity herkese açık API'den kaldırılıyor. (Ib19c1) - ComplicationText statik yöntemlerini kaldırarak geliştiricilerin lehine işlem yapın. (Ibe399)
- Çeşitli kadran kitaplığı askıya alma yöntemleri için guava ListenableFuture sarmalayıcılarını kullanıma sunduk. (I16b2c)
- API'nin netliğini sağlamak amacıyla RenderParameters için
LayerMode.DRAW_OUTLINED
dışındaki LayerMode'larda kullanmak üzere renk tonu gerektirmeyen ikincil bir oluşturucu ekledik. (I497ea) - Önceden, varsayılan bir bağımsız değişkeni olduğu için ListUserStyleSetting diğerinden farklıydı. Artık tüm StyleSetting alt sınıf kurucuları en son varsayılan değeri alır. (I9dbfd)
- CanvasComplication, alt sınıfı uygulamayı kolaylaştıran gizli bir yöntem içerecek şekilde yeniden düzenlendi (I5b321)
- Güncellemeleri bir gözlemciye (genellikle SysUI) aktarmak için EditorResult'ı yeni EditorService ve
EditorSession.broadcastState()
ile yeniden düzenledik. (Ic4370) - Bazı kadranlar, sağlayıcının kullanıcı tarafından yapılandırılamadığı kadranın ayrılmaz bir parçası olarak belirli bir özelliği temel alarak oluşturulmuştur. Bunu desteklemek için
Complication.Builder#setFixedComplicationProvider
eklentisini ekledik. (I4509e) - EditorRequest, Bileşen Adı yerine paket adını belirtir. Bunun nedeni, SysUI'nin düzenleyicinin sınıf adını aramasının uygun olmaması ve bizim yalnızca paket adına ihtiyacımız olmasıydı. (Ib6814)
Sürüm 1.0.0-alpha07
10 Şubat 2021
androidx.wear:wear-*:1.0.0-alpha07
yayınlandı. 1.0.0-alpha07 sürümü bu kayıtları içerir.
Yeni Özellikler
- WatchFaceService.createWatchFace artık bir askıya alma işlevi haline geldi. Bu sayede, saat yüzünde IO beklerken kullanıcı arayüzü iş parçacığını engellemesi gerekmiyor. Benzer şekilde, wear-watchface-editor ve wear-complications-verileri
API Değişiklikleri
- PhotoImage sınıfını kaldırın ve Simgeyi doğrudan kullanın. (I8a70b)
- ComplicationData'nın currentTimeRange değerini gösterin. (I91366)
- Resim benzeri özellikleri daha açık hale getirin. (I81700)
- wear-watchface-editor ve wear-complications-verileri, eş yordamlar yerine askıya alma işlevlerini kullanacak şekilde yeniden düzenlendi. Rx java ve Future uyumlu sarmalayıcılarını izleyin. (If3c5f)
- Bağlantı sorunları veya API desteği eksikliği nedeniyle requestPreviewComplicationData önizleme verileri döndüremezse ProviderInfoRetriever artık PreviewNotAvailableException hatasını bildirir. (I4964d)
- WatchFaceControlService::createWatchFaceControlClient artık askıya alınmış bir özellik. getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient, artık
Deferred<InteractiveWatchFaceWcsClient>
kodunu döndüren getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync olarak yeniden adlandırıldı. RX java ve Future uyumlu sarmalayıcılarını takip edin. (I5d461) CATEGORY_PROVIDER_CONFIG_ACTION
alanının adınıCATEGORY_PROVIDER_CONFIG
olarak değiştirin. (I7c068)- Kadran bazen düzenleyici etkinliğinin başlamasından kısa bir süre sonrasına kadar kullanılamayacağından, createOnWatchEditingSession işlevi askıya alındı. (Ida9aa)
- WatchFaceService.createWatchFace artık ana iş parçacığını engellemeniz gerekiyordu ve eş zamansız başlatmaya olanak tanıyan bir askıya alma işlevidir. (If076a)
- UserStyle artık bir dizi operatörüne sahip. UserStyle.Option'ya yayınlama yardımcıları ekledik. (I35036)
- Kararsız gizli API'nin bir kısmını değiştiren UserStyle tel biçimleriyle ilgili sıralama hatasını düzelttik. (I8be09)
- UserStyle içinde uygulamaya özel tek bir dizeyi depolamanıza olanak tanıyan CustomValueUserStyleSetting'i ekledik. Varsayılan kadran düzenleyiciler bu değeri yoksayar. (Ic04d2)
- InstanceID, Android WearOS'in yükseltemediğimiz R ve eski sürümlerindeki amaç ekstralarında iletilmez. Bunu desteklemek için artık InstancID'nin null değerine izin veriyoruz. (Id8b78)
- EditorRequest artık WatchFaceEditorContract.createIntent'te (I3cd06) bileşen olarak ayarlanmış Bileşen Adı düzenleyicisini içeriyor
- Kadran Editor Sonuçları artık önizleme ComplicationData öğesini içeriyor. Bu sayede arayan kişi, düzenleme işleminden sonra kadran görüntüsünün ekran görüntüsünü alıyor. (I2c561)
Hata Düzeltmeleri
- UserStyle, UserStyleSetting ve UserStyleSchema'ya toString() geçersiz kılmaları eklendi. Böylece bu sınıflarla çalışmayı biraz daha keyifli hale getirdiler. (I9f5ec)
Sürüm 1.0.0-alpha06
27 Ocak 2021
androidx.wear:wear-*:1.0.0-alpha06
yayınlandı. 1.0.0-alpha06 sürümü bu kayıtları içerir.
Yeni Özellikler
- Kadran geliştiricilerinin ve potansiyel olarak OEM'lerin stil ve komplikasyon editörü oluşturmasına olanak tanıyan yeni bir kitaplık takma/kadran düzenleyicisini kullanıma sunduk. SysUI, saat yüzüne bir Intent gönderir. Bu Intent, WatchFace ayrıntılarına erişmek ve Activity.setWatchRequestResult aracılığıyla sonucu kaydetmek için yeni EditorSession sınıfını kullanır. Bunu desteklemek için, saat yüzü düzenleyicilerinin ComplicationData önizleme isteğinde bulunmasını sağlayan ProviderInfoRetriever.requestPreviewComplicationData öğesini ekledik. ComplicationData önizlemesinin avantajı, canlı verilerden farklıdır, düzenleyicinizi oluştururken izin iletişim kutuları gösterme konusunda endişelenmenize gerek yoktur (kullanıcı izni olan bir sağlayıcı seçerse yine de izni vermesi istenir).
API Değişiklikleri
- ComplicationProviderInfo'da artık sağlayıcının Bileşen Adı için bir alan bulunuyor. Bu alan desteği ileri bir tarihte WearOS'a eklenecek ve boş bırakılacaktır. (Id8fc4)
- Saat yüzü düzenleyicilerinin, ComplicationData önizlemesi isteğinde bulunmasını sağlayan ProviderInfoRetriever.requestPreviewComplicationData etiketini ekledik. Canlı özellikler için izin gerekebileceğinden ve etkin olmayan özellikler için önizleme verilerini görüntüleyebileceğinizden bu yararlı bir özelliktir. (I2e1df)
- ComplicationManager artık, WatchFace oluşturucunun isteğe bağlı bir parametresidir ve bağımsız değişkenler buna olanak tanıyacak şekilde yeniden sıralanmıştır. (I66c76)
- Özellikler'e isteğe bağlı bir Bundle ekledik. Bu paket, sağlayıcı seçici etkinliğini başlatmak için gönderilen niyetle birleştirilir. (Ifd4ad)
- Kadranı ve SysUi tarafından barındırılan düzenleyicileri desteklemek için yeni bir
wear-watchface-editor
kitaplığı ekledik. SysUI bir amaç göndererek bu düzenleyicileri başlatır. Kadran etkinliği hizmeti, WatchFace ayrıntılarına erişmek ve Activity.setWatchRequestResult aracılığıyla sonucu kaydetmek için yeni EditorSession sınıfını kullanabilir. (I2110d) - LayerMode.DRAW_HIGHLIGHTED, artık LayerMode.DRAW_OUTLINED olarak adlandırılıyor. RenderParameters.highlightComplicationId ise artık RenderParameters.selectedComplicationId olarak adlandırılıyor. Böylece, bir dış çizgiye ek olarak belirtilen özellik vurgulanıyor. (I90a40)
- Saat yüzünün oluşturulması beklenirken hizmet ölürse WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient'ın geleceği artık ServiceStartFailureException ile çözümlenebilir. (I0f509)
- Bu verileri getirmek eşzamansız bir işlem olduğundan EditorSession.complicationPreviewData artık bir ListenableFuture oldu. (Iead9d)
Hata Düzeltmeleri
- ComplicationOverlay'den kullanılmayan alanları ve complicationBounds'u etkin halde bırakıyoruz. (I17b71)
Sürüm 1.0.0-alpha05
13 Ocak 2021
androidx.wear:wear-*:1.0.0-alpha05
yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.
Yeni Özellikler
Kadranlar genellikle çeşitli komplikasyonların gösterildiği bir dizi komplikasyon yapılandırmalarını destekler. Bu kurulumu kolaylaştırmak için, derleyicide setEnabled(false) işlevini çağırarak başlangıçta devre dışı bırakılan özellikleri artık destekliyoruz. Bunlar daha sonra ComplicationsUserStyleSetting aracılığıyla etkinleştirilebilir.
API Değişiklikleri
- ComplicationHelperActivity artık kullanımı kolaylaştıran bir int dizisi yerine
Collection<ComplicationType>
kabul ediyor. (I1f13d) ProviderInfoRetriever.retrieveProviderInfo
artıkListenableFuture<ProviderInfo[]>
değerini doğru şekilde döndürüyor. (If2710)- Artık derleyicide setEnabled(false) işlevini çağırarak başlangıçta devre dışı bırakılmış bir özellik oluşturabilirsiniz. (Idaa53)
- WatchFaceState artık yalnızca gözetimsiz örnekler için doğru olan bir isHeadless özelliğine sahip. (Ifa900)
- ComplicationDrawable artık isteğe bağlı olarak çekilebilir öğelerin eşzamanlı yüklenmesini destekler. Bu, ekran görüntüsü API'leri tarafından kullanılır. (I34d4a)
Sürüm 1.0.0-alpha04
16 Aralık 2020
androidx.wear:wear-*:1.0.0-alpha04
yayınlandı. Sürüm 1.0.0-alpha04 bu kayıtları içerir.
Yeni Özellikler
- Wear kadran kitaplığı artık tür başına ayar sınırlarını destekliyor. Örneğin, ComplicationType.LONG_TEXT için geniş sınırlayıcı kutu kullanırken diğer türler için daha küçük bir sınırlayıcı kutu kullanabilirsiniz.
API Değişiklikleri
- Özellikler artık, komplikasyon türü boyutlarına göre bir
Map<ComplicationType, RectF>
öğesini sarmalayan ComplicationBounds özelliğini kullanmaktadır. (I1ebe7) - RenderParameters artık ekran görüntülerinde kullanılacak vurgu tonunu belirtmenizi sağlıyor. (Iff42b)
- Özellikleri değiştirmek için artık ComplicationsUserStyleSetting özelliğini kullanmanız gereken sınırlar hariç olmak üzere, işletim sisteminin senkronize olmasını sağlamak amaçlanır. (I8dc5d)
- Oluşturucu artık işaretli bir sınıf. Bu, CanvasRenderer ve GlesRenderer'ın artık Renderer'ın iç sınıfları olduğu anlamına gelir. (Iab5d4, b/173803230)
- CanvasComplicationDrawable.drawVurgular,drawOutline olarak yeniden adlandırıldı. ObservableWatchData'da artık birkaç UiThread ek açıklaması eksik. ScreenState, WatchState'ten tamamen kaldırıldı. (If1393)
- Wear-watchface için minimum API düzeyi artık 25'tir. Not: Donanım kanvas desteği için API düzeyi 26 veya üzeri gerekir. (Ic9bbd)
- InteractiveWatchFaceWcsClient artık bir getComplicationIdAt yardımcısına sahip. (I05811)
- wear-watchface-client için API düzeyi 25'e düşürüldü ancak ekran görüntüsü API'leri için API düzeyi 27 gerekli. (Id31c2)
Hata Düzeltmeleri
- Bu işlemin mevcut ComplicationData ComplicationType değerini ComplicationState içinde gösterir. (I9b390)
- InteractiveWatchFaceWcs'te artık, belirtilen özelliği kısaca vurgulamak için "bringAttentionToComplication" yöntemi vardır. (I6d31c)
InteractiveWatchFaceWcsClient#setUserStyle
artık Map<string, string=""> kabul eden bir aşırı yüke sahip. Bu, UserStyle'ı oluşturmak için gereken fazladan IPC gidiş dönüş seyahatini önleyebilir. (I24eec)</string,>
Sürüm 1.0.0-alpha03
2 Aralık 2020
androidx.wear:wear-*:1.0.0-alpha03
yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları içerir.
Yeni Özellikler
Özellik sınıfının artık kadranların ComplicationData değişikliklerini gözlemlemesini sağlayan bir compicationData özelliği bulunuyor. Bu şekilde, özelliğin boyutları komplikasyonun türüne göre değişebilir.
Değişken kare hızları artık Renderer.interactiveDrawModeUpdateDelayMillis'e atanarak desteklenmektedir. Saniyede bir kısa animasyonlar çalıştıran saat kadranlarında bu, animasyon uygulama yapılmadığında uyku moduna geçerek güç tasarrufu sağlayabilir.
API Değişiklikleri
BACKGROUND_IMAGE
, ilgili sınıflarla birliktePHOTO_IMAGE
olarak yeniden adlandırıldı. Bu özellik türü özellikle arka planlar için kullanılmadığından ad değişikliğine gidiyor. (I995c6)- DefaultComplicationProviderPolicy'ye IntDefs ile düzgün bir şekilde ek açıklama eklenmiş. (I3b431)
- Gizli TimeDependentText sınıfı artık ContentDescriptionLabel aracılığıyla gösterilmez. Bunun yerine, metni belirli bir zamanda almak için bir erişimci ekleriz. (Ica692)
- ObservableWatchData'nın oluşturucusu artık dahilidir. (I30121, b/173802666)
- Saat yüzlerinin ComplicationData değişikliklerini gözlemleyebilmesini sağlayan compicationData artık komplikasyonda bulunuyor. Ayrıca, komplikasyonda sağlanan tarih ve saatte herhangi bir şeyin oluşturulması gerekip gerekmediğini anlamak için kullanabileceğiniz yeni bir isActiveAt çağrısı vardır. (Ic0e2a)
- Boş
SharedMemoryImage
artık herkese açık API'de değil. (I7ee17) WatchFace.overridePreviewReferenceTimeMillis
artık bir IntRange ek açıklamasına sahip, alıcı ve setter ise tutarlı adlara sahip. (Ia5f78)Complication.Builder
, daha net bir ifadeyleComplication.createRoundRectComplicationBuilder
veyaComplication.createBackgroundComplicationBuilder
ile oluşturuldu (I54063)- WatchFace.TapListener özelliği, komplikasyonlarla tüketilmeyen dokunmaların WatchFace tarafından gözlemlenmesini sağlıyor. (Ic2fe1, b/172721168)
- WatchFace artık
Renderer.interactiveDrawModeUpdateDelayMillis
öğesine atayarak değişken kare hızlarını destekliyor. Bu, animasyon yapmadığı zamanlarda uyuyarak pil ömrünün korunmasına yardımcı olabilir. (I707c9) - WatchFace.Builder artık gerekli değildir. inValidate() ve engagementUpdateRateMillis öğeleri Oluşturucu'ya taşındı. (I329ea)
- Daha iyi Java birlikte çalışabilirliği için WatchState'teki boole mülklerinin alıcıları yeniden adlandırıldı (I6d2f1)
- Tutarlılık için TapListener, TapCallback olarak ve InValidateCallback için InValidateListener'ı yeniden adlandırdı. (I9414e)
- Wear 2.0 kadran stili seçenekleri, daha net olmaları için kendi sınıflarına taşındı. WatchFace.Builder setter'ları artık simetrik WatchFace sınıfı alıcıları içerir. (Iefdfc)
- Mevcut bir örneği alan veya Wallaper hizmeti bağlanıp motoru oluşturduktan sonra oluşturan InteractiveWatchFaceWcsClient ve
WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
eklendi. (Id666e) - WatchFaceControlClient, artık testlerin taklit etmesine olanak tanıyan bir arayüzdür. (I875d9)
- HeadlessWatchFaceClient, InteractiveWatchFaceSysUiClientImpl, InteractiveWatchFaceWcsClient, artık testi daha iyi kolaylaştıran arayüzler oldular. (I7cdc3)
wear-watchface-complications-rendering
kapsamındaki yöntemlere ek açıklamalar eklendi (I0d65c)
Hata Düzeltmeleri
android.content.res.Configuration#isScreenRound()
(Ifadf4) öğesini kopyalayan DeviceConfig'den ekran şeklini kaldırın- Yalnızca istemci oluşturulduktan sonra alabileceğiniz şemayı bilmeden
UserStyle
oluşturmak zor olduğundan,WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
öğesiUserStyle
yerineMap<String, String>
kabul edecek şekilde değiştirildi. (Iea02a) - Kablo biçimi yerine
ComplicationState
kullanmak içinInteractiveWatchFaceWcsClient
sorununu düzeltin. (Icb8a4) - Kadran editörleri yalnızca yerleşik sınıfları anladığı için
UserStyleSettings
artık kapalı bir sınıftır. (I2d797)
Sürüm 1.0.0-alpha02
11 Kasım 2020
androidx.wear:wear-*:1.0.0-alpha02
yayınlandı. Sürüm 1.0.0-alpha02 bu kayıtları içerir.
API Değişiklikleri
ComplicationDetails
artıkComplicationState
olarak adlandırılmış ve düzgün bir şekilde sarmalanmış.@ComplicationData.ComplicationType
giyilebilir cihaz desteğinin kullanımlarıComplicationType
Android sürümüne taşındı. (I4dd36)- RenderParameters özelliğine, ekran görüntülerindeki tek bir özelliği vurgulama isteğinde bulunmanıza olanak tanıyan isteğe bağlı bir
highlightedComplicationId
parametresi ekleyin. (I66ce9) - Tutarlılık için yeni stil özellikleri API'sini kullanmak üzere
ComplicationProviderService
(Id5aea) getPreviewReferenceTimeMillis
artıkDeviceConfig
için referans süreleri alıyor. (I779fe)- Renderer API yüzeyi basitleştiriliyor. Bunun yerine, değişiklikleri gözlemlemek için
SurfaceHolder.Callback
kullanılabilir. (I210db) CanvasComplicationRenderer
,Renderer
yerine uzanmıyor. Ad, daha anlaşılır olması için yeniden adlandırıldı. (Ibe880)
Hata Düzeltmeleri
- İlk
androidx.wear:wear-watchface-client
sürümü (I1e35e) - Daha anlaşılır olması için
GlesTextureComplication#renderer
adı değiştirildi (Ib78f7) - Daha net olması için
StyleCategory
adınıStyleSetting
olarak değiştirin (I488c7) - Daha temiz bir API için
UserStyleSchema
ekleme (If36f8)
Sürüm 1.0.0-alpha01
28 Ekim 2020
androidx.wear:wear-complications-*:1.0.0-alpha01
ve androidx.wear:wear-watchface-*:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.
API Değişiklikleri
- Herkese açık API'de açığa çıkarmak istemediğimiz bazı öğeler kaldırıldı. (I41669)
androidx.wear:wear-complications-provider
kitaplığı oluştur. (I77f1f)- ComplicationsUserStyleCategory, özellikleri yapılandırmak için önerilen yeni kategoridir (I96909)
- Wear-complication-data API'sini ekleyin. (I7c268)
- Boole döndürme değerlerine sahip işlevlerde "get" yerine "is" ön eki eklenecek (If36ff)
- API tavsiyesi, bu sınıf, parametreleri oluşturucu aracılığıyla almak üzere yeniden düzenlendiği için korumalı kullanmaktan kaçınmanızı önerir. (I61644)
- Daha net olması için setbackgroundComplication'ı yeniden adlandırın. (I96fe3)
- ComplicationDrawable isVurgulanan ve veriler (I4dcc8) için Kotlin özelliklerini kullanın
- ComplicationRenderer.InvalidateCallback yerine, Complication#invalidate() (I4f4c6) kodunu ekleriz
- Bu API'lerin desteği WearableSupport'ta sonlandırılmaktadır ve API'ler buradan kaldırılmıştır. (Ib425c)
- Wear 2.0 eski özelliklerini vurgulamak için bazı WatchFace oluşturma yöntemlerini yeniden adlandırdı. (Idb775)
- Wear/kol saati yüzü için ilk beta API adayı (Id3981)
- API'nin ilk izlenen sürümü. (Ie9fe6)
- ComplicationDrawable.BorderStyle IntDef düzgün şekilde gizleniyor ve tutarlılık için ComplicationStyle 'a geçin. (I27f7a)
- ComplicationStyle yöntemleri için eksik ek açıklamaları ekleme (I838fd)
- Bu kitaplıkta genel API yüzeyi yok (I88e2b)
- Artık tüm stil kategorisi Seçenek sınıfları düzgün şekilde nihai. (Ib8323)
- API'nin ilk izlenen sürümü. (I27c85)
Hata Düzeltmeleri
- ComplicationProviderService, açık bir getComplicationPreviewData yöntemine sahip olacak şekilde değiştirildi. (I4905f)
- EksikGetterMatchingBuilder için API lint kontrolü, Androidx için etkinleştirildi (I4bbea, b/138602561)
- wear-complications-rendering işlemini yeniden adlandırın. (Ifea02)
- Stil kategorisi görünen adları artık CharSequences (I28990) oldu
- Mevcut tema ve stil adlandırma kurallarını eşleştirmek için Geçersiz Kılma değerini Yer Paylaşımı ile değiştirme. (I4fde9)
- Daha anlaşılır olması için UserStyle#getOptions yeniden adlandırıldı. (I695b6)
Sürüm 1.2.0
Sürüm 1.2.0
15 Eylül 2021
androidx.wear:wear:1.2.0
yayınlandı. 1.2.0 sürümü bu kayıtları içerir.
1.1.0'dan sonraki önemli değişiklikler
Görünüme eklenebilecek en büyük dairenin eğriliğinin ardından kavisli metnin kolayca yazılmasını sağlayan CurvedText bileşeni eklendi. Kullanım örneği:
<androidx.wear.widget.CurvedText android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="example curved text" app:anchorAngleDegrees="180" app:anchorPosition="center" app:clockwise="false" style="@android:style/TextAppearance.Large" />
Alt öğelerini saat yönünde veya saat yönünün tersine bir yay üzerinde tek tek yerleştirmek için ArcLayout kapsayıcısı eklendi. Alt öğeleri, hem standart Android widget'ı hem de
ArcLayout.Widget
arayüzünü uygulayan "kıvrımlı" widget'lar olabilir. (I536da) Kullanım örneği:<androidx.wear.widget.ArcLayout android:layout_width="match_parent" android:layout_height="match_parent" app:anchorPosition="center"> <ImageView android:layout_width="20dp" android:layout_height="20dp" android:src="@drawable/ic_launcher" /> <androidx.wear.widget.CurvedText android:layout_width="match_parent" android:layout_height="match_parent" android:text="Curved Text" style="@android:style/TextAppearance.Small" android:padding="2dp" /> </androidx.wear.widget.WearArcLayout>
Bir etkinlikte kullanılması amaçlanan, geri düğmesiyle kapatma ve/veya hızlıca kaydırarak kapatma işlemlerini gerçekleştiren, yeni bir düzen kapsayıcısı olan DismissibleFrameLayout eklendi. Kapatma işlemiyle ilgili işlem yapmak için en az bir dinleyici eklenmelidir. İşleyici genellikle kapsayıcı görünümü veya bir parçayı geçerli etkinlikten kaldırır. Özellikler üzerinde doğrudan kontrol sahibi olmak için setSwipeDismissible(boole) ve setBackButtonDismissible(boole) sağlanır. Bu yeni düzenin, mevcut scrollDismissFrameLayout'un yerini alması amaçlanmıştır.
Cihaz, AmbientModeSupport sınıfında ambiyans modundan çıktığında bir Etkinliğin "otomatik olarak devam ettirilebileceğini" belirtmek için destek eklendi. Bu işlev daha önce WearableSupportLibrary'nin kullanımdan kaldırılan WearableActivity sınıfında kullanılabiliyordu. (I336ab)
WearableCalendarContract sınıfı Giyilebilir Destek Kitaplığı'ndan taşındı. Bu API, CalendarContract aracılığıyla kullanılabilen verilerin bir alt kümesini sağlar ancak giyilebilir cihazlarla otomatik olarak senkronize edilir. (I6f2d7)
Belirtilen Wear cihazının Çin için olup olmadığını belirlemek için
androidx.wear.utils
uygulamasına yeni bir APIWearTypeHelper
eklendi. (Ib01a9)androidx.wear.widget.ConfirmationOverlay
uygulamasına, ardından animasyon açıklaması eklenmişse mesajları okuyacak erişilebilirlik özellikleri eklendi. (I524dd)Mesaj sağlanmadığındaConfirmActivity'nin kilitlenmesine neden olan hata düzeltildi. (Ie6055)
RecyclerView'ların yatay olarak kaydırılarak
WearableDrawerLayout
ürününün tüm etkileşimlere göz atmasına neden olan hata düzeltildi. (I24c7f)
Sürüm 1.2.0-rc01
1 Eylül 2021
androidx.wear:wear:1.2.0-rc01
, son beta sürümünden bu yana hiçbir değişiklik olmadan yayınlandı. 1.2.0-rc01 sürümü bu kayıtları içerir.
Sürüm 1.2.0-beta01
18 Ağustos 2021
androidx.wear:wear:1.2.0-beta01
yayınlandı. 1.2.0-beta01 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
- Herhangi bir mesaj sağlanmadığındaConfirmActivity'nin kilitlenmesine neden olan hatayı düzeltin. (Ie6055)
Sürüm 1.2.0-alfa13
4 Ağustos 2021
androidx.wear:wear:1.2.0-alpha13
yayınlandı. Sürüm 1.2.0-alpha13 bu kayıtları içerir.
API Değişiklikleri
WearTypeHelper.isChinaDevice
,WearTypeHelper.isChinaBuild
olarak yeniden adlandırıldı. (I47302)
Hata Düzeltmeleri
androidx.wear.widget.ConfirmationOverlay
ürününe, animasyon açıklamasının ardından ayarlanmış mesajları sesli okuyacak erişilebilirlik özellikleri ekledik. (I524dd)
Sürüm 1.2.0-alfa12
21 Temmuz 2021
androidx.wear:wear:1.2.0-alpha12
yayınlandı. Sürüm 1.2.0-alpha12 bu kayıtları içerir.
API Değişiklikleri
- Belirtilen Wear cihazının Çin için olup olmadığını belirlemek amacıyla
androidx.wear.utils
uygulamasına yeni bir APIWearTypeHelper
ekledik. (Ib01a9)
Sürüm 1.2.0-alfa11
30 Haziran 2021
androidx.wear:wear:1.2.0-alpha11
yayınlandı. Sürüm 1.2.0-alpha11 bu kayıtları içerir.
Hata Düzeltmeleri
- RecyclerView'ların yatay olarak kaydırılarak
WearableDrawerLayout
ürününün tüm etkileşimlere göz atmasına neden olan hata düzeltildi. (I24c7f)
Sürüm 1.2.0-alfa10
2 Haziran 2021
androidx.wear:wear:1.2.0-alpha10
yayınlandı. Sürüm 1.2.0-alpha10 bu kayıtları içerir.
Yeni Özellikler
- Alpha10, Kavisli Metin ve ArcLayouts'taki erişilebilirlik desteğini iyileştiriyor. API'nin açıklığa kavuşturulmasına yardımcı olmak için DismissibleFrameLayout'a bazı küçük yeniden adlandırma işlemleri de ekler.
API Değişiklikleri
DismissibleFrameLayout
(Ib195e) dokümanında aşağıdaki yöntemleri yeniden adlandırdık:Callback#onDismissed
->Callback#onDismissedFinished
isSwipeDismissible
->isDismissableBySwipe
isBackButtonDismissible
->isDismissableByBackButton
- Aşağıdaki yöntemleri son haline getirdik (Ib195e):
setBackButtonDismissible
setSwipeDismissible
registerCallback
unregisterCallback
Hata Düzeltmeleri
- TalkBack'te CurvedTextView içeriğini kullanın. (I05798)
- ArcLayout'ta normal görünümler için daha iyi erişilebilirlik. (I4418d)
Sürüm 1.2.0-alpha09
18 Mayıs 2021
androidx.wear:wear:1.2.0-alpha09
yayınlandı. Sürüm 1.2.0-alpha09 bu kayıtları içerir.
API Değişiklikleri
- Metin yazı tipini ve kalın/italik stilini ayarlamak için yeni bir
CurvedTextView.setTypeface()
işlevi (TextView
işlevine benzer) eklendi. (I4653c) WearArcLayout
adınıArcLayout
,WearCurvedText
adınıCurvedText
,WearArcLayout.ArcLayoutWidget
adını daArcLayout.Widget
olarak değiştirdik. (I6e5ce)ArcLayout.Widget
tarihindegetThicknessPx
,getThickness
olarak yeniden adlandırıldı.ArcLayout.LayoutParams
öğesindeki dikey hizalama sabitleri artıkVERTICAL_ALIGN_
ile başlayacak şekilde adlandırıldı (öncekiVALIGN_
yerine)
CurvedTextView
tarihinde,setMinSweepDegrees
vesetMaxSweepDegrees
yöntemlerisetSweepRangeDegrees
(I7a9d9) ile değiştirildi
Sürüm 1.2.0-alpha08
5 Mayıs 2021
androidx.wear:wear:1.2.0-alpha08
yayınlandı. Sürüm 1.2.0-alpha08 bu kayıtları içerir.
API Değişiklikleri
- Kodun daha anlaşılır olmasını sağlamak için bazı açı parametrelerine ve dönüş türlerine
@FloatRange
ek açıklamaları ekledik. (I430dd) WearArcLayout.ArcLayoutWidget
arayüzünde,insideClickArea
yöntemi artık isPointInsideClickArea olarak adlandırılıyor. (Ia7307)
Sürüm 1.2.0-alpha07
24 Mart 2021
androidx.wear:wear:1.2.0-alpha07
yayınlandı. Sürüm 1.2.0-alpha07 bu kayıtları içerir.
Hata Düzeltmeleri
- WearArcLayout'un içindeki kıvrımlı olmayan alt öğelerde, yüksekliği genişlikten büyük olan ekran boyutunun kullanılmasından kaynaklanan hataları düzeltme. Bu kavisli olmayan alt öğeler artık tüm ekran türlerinde yay içine doğru şekilde yerleştirilmiştir.
Sürüm 1.2.0-alpha06
27 Ocak 2021
androidx.wear:wear:1.2.0-alpha06
yayınlandı. Sürüm 1.2.0-alpha06 bu kayıtları içerir.
API Değişiklikleri
- Devam Eden Etkinlikler kitaplığını yeni bir alt kitaplığa taşıyın: sürekli kullanılan etkinlikler. Sınıflar artık androidx.wear.on başı paketinde (eski adıyla androidx.wear.onhingactivities) (I7c029) bulunmaktadır.
- WearableCalendarContract sınıfını Wearable Support Library'den AndroidX'e taşıyın. Bu API, CalendarContract aracılığıyla kullanılabilen verilerin bir alt kümesini sağlar ancak giyilebilir cihazlarla otomatik olarak senkronize edilir. (I6f2d7)
Hata Düzeltmeleri
- Giyilebilir cihazlarda (Ic24e3) tam ekrana geri dönmenin ana yolu, hızlıca kaydırarak kapatma işlevi olduğundan Kapatılabilir FrameLayout'ta geri düğmesi kapatma özelliğini varsayılan olarak devre dışı bırakın.
- WearArcLayout'ta (Icf912) alt öğelerin görünürlüğünü işlemeyle ilgili bazı sorunlar düzeltildi
Sürüm 1.2.0-alpha05
13 Ocak 2021
androidx.wear:wear:1.2.0-alpha05
yayınlandı. Sürüm 1.2.0-alpha05 bu kayıtları içerir.
Hata Düzeltmeleri
- Bu sınıfın genel kullanımını daha iyi göstermek amacıyla örnek snippet'lar sağlamak için AmbientModeSupport sınıfının javadoc dosyasını güncelleyin.
Sürüm 1.2.0-alpha04
16 Aralık 2020
androidx.wear:wear:1.2.0-alpha04
yayınlandı. Sürüm 1.2.0-alpha04 bu kayıtları içerir.
API Değişiklikleri
- Cihaz, AmbientModeSupport sınıfında ambiyans modundan çıktığında bir Etkinliğin "otomatik olarak devam ettirilebileceğini" belirtmek için destek eklendi. Bu işlev daha önce WearableSupportLibrary'nin kullanımdan kaldırılan WearableActivity sınıfında kullanılabiliyordu. (I336ab)
- OnvingActivity
- OnvingActivity oluşturulurken artık kategori ayarlanabilir (ör.
OngoingActivitiy.Builder.getCategory(String)
). - OnvingActivityData'da artık OnOutboundActivity'nin ne zaman oluşturulduğuna dair bir zaman damgası var -
OngoingActivityData.getTimestamp()
- (I91cb4)
- OnvingActivity oluşturulurken artık kategori ayarlanabilir (ör.
- Düzen parametrelerini MarginLayoutParams'ı genişletecek şekilde değiştirerek WearArcLayout'un alt öğeleri için kenar boşluğu ayarlama desteği eklendi (ör. WearArcLayout.LayoutParams, android.view.ViewGroup.MarginLayoutParams'ı genişletir). (I2cd88)
- WearCurvedTextView'un tutturma türü varsayılanını
WearArcLayout.ANCHOR_CENTER
(eski adıylaWearArcLayout.ANCHOR_START
) olarak değiştirin. Bu, eğri metin varsayılan olarak kendisini üstte x merkezli olarak çizdiği ve üst yay düzeni onu olması gereken yere döndürebileceği için yay düzeni ile eğri metin arasındaki sözleşmeyi basitleştirir. (I105ff)
Sürüm 1.2.0-alpha03
2 Aralık 2020
androidx.wear:wear:1.2.0-alpha03
yayınlandı. Sürüm 1.2.0-alpha03 bu kayıtları içerir.
Yeni Özellikler
Bir etkinlikte kullanılması amaçlanan, geri düğmesiyle kapatma ve/veya hızlıca kaydırarak kapatma işlemlerini gerçekleştiren, yeni bir düzen kapsayıcısı olan DismissibleFrameLayout. Kapatma işlemiyle ilgili işlem yapmak için en az bir dinleyici eklenmelidir. İşleyici genellikle kapsayıcı görünümü veya bir parçayı geçerli etkinlikten kaldırır. Özellikler üzerinde doğrudan kontrol sahibi olmak için setSwipeDismissible(boole) ve setBackButtonDismissible(boole) sağlanır. Bu yeni düzenin, mevcut scrollDismissFrameLayout'un yerini alması amaçlanmıştır.
Kavisli widget'lar artık dokunma etkinliklerini işliyor. Bir WearArcLayout içindeki normal widget'lar, tüm dokunma etkinliklerini koordinat alanlarıyla eşlenmiş olarak alır. WearCurvedTextView (WearArcLayout içinde veya dışında), onClick ve onLongClick işleyicilerini ayarlayabilir.
Devam eden etkinlik sınıfları, özel serileştirme/serileştirmeyi kullanma yerine artık VersionedParcelables olarak adlandırılmaktadır. Statik simge ve dokunma amacı artık gereklidir.
API Değişiklikleri
- WearCurvedTextView için "sweepDegrees" özelliği, bu widget'a daha esnek bir düzen vermek için minSweepDegrees ve maxSweepDegrees olarak ayrılmıştır.
Sürüm 1.2.0-alpha02
11 Kasım 2020
androidx.wear:wear:1.2.0-alpha02
yayınlandı. Sürüm 1.2.0-alpha02 bu kayıtları içerir.
Bu sürümde, ilk kez yeni bir "Devam Eden Etkinlikler API'si" eklendi. Geliştiriciler bu API'yi, fitness egzersizi veya medya oynatma oturumu gibi uzun süreli bir etkinliğin devam ettiğini belirtmek için kullanılabilir. Geliştiricilerin kadranda veya uygulama başlatıcıda gösterilmek üzere "mesafe ve süre çalışması" ya da "mevcut parça çalıyor" gibi düzenli durum güncellemeleri sağlamasına olanak tanır. Bu işlev, devam eden etkinlik işlevi etkinleştirilmiş gelecekteki cihazlara yöneliktir.
API Değişiklikleri
- Devam Eden Etkinlikler için Yeni API. Bu, "desteklenmeyen cihazlarda" kullanılamaz. (I69a31)
Sürüm 1.2.0-alpha01
28 Ekim 2020
androidx.wear:wear:1.2.0-alpha01
yayınlandı. Sürüm 1.2.0-alpha01 bu kayıtları içerir.
Yeni Özellikler
- Görünüme eklenebilecek en büyük dairenin eğriliğinden sonra, kavisli metnin kolayca yazılmasını sağlayan WearCurvedTextView bileşeni eklendi. Kullanım örneği:
<androidx.wear.widget.WearCurvedTextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="example curved text"
app:anchorAngleDegrees="180"
app:anchorPosition="center"
app:clockwise="false"
style="@android:style/TextAppearance.Large"
/>
- Alt öğelerini saat yönünde veya saat yönünün tersine bir yay üzerinde tek tek yerleştirmek için WearArcLayout kapsayıcısı eklendi. Alt öğeleri hem standart Android widget'ı hem de ArcLayoutWidget arayüzünü uygulayan "kıvrımlı" widget'lar olabilir. Kullanım örneği:
<androidx.wear.widget.WearArcLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
app:anchorPosition="center">
<ImageView
android:layout_width="20dp"
android:layout_height="20dp"
android:src="@drawable/ic_launcher"
/>
<androidx.wear.widget.WearCurvedTextView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:text="Curved Text"
style="@android:style/TextAppearance.Small"
android:padding="2dp"
/>
</androidx.wear.widget.WearArcLayout>
(I536da)
Wear-Giriş 1.2
Sürüm 1.2.0-alpha02
29 Eylül 2021
androidx.wear:wear-input:1.2.0-alpha02
ve androidx.wear:wear-input-testing:1.2.0-alpha02
yayınlandı. Sürüm 1.2.0-alpha02 bu kayıtları içerir.
API Değişiklikleri
disallowEmoji
, emoji çizme seçeneğinin gösterilip gösterilmeyeceğini ayarlamak içinWearableRemoteInputExtender
uygulamasındasetEmojisAllowed
olarak yeniden adlandırıldı. (I28393)
Sürüm 1.2.0-alpha01
15 Eylül 2021
androidx.wear:wear-input:1.2.0-alpha01
ve androidx.wear:wear-input-testing:1.2.0-alpha01
yayınlandı. Sürüm 1.2.0-alpha01 bu kayıtları içerir.
API Değişiklikleri
WearableButtons
kaynağındaki tüm düğme konumu sabitleri gösterildi. (Ibb12c)- android.app.RemoteInput öğesine Wear'a özel ekstralar eklemek için kullanılabilecek
WearableRemoteInputExtender
sınıfı eklendi. (I01903)
Wear-Giriş 1.1.0
Sürüm 1.1.0
18 Ağustos 2021
androidx.wear:wear-input:1.1.0
ve androidx.wear:wear-input-testing:1.1.0
yayınlandı. 1.1.0 sürümü bu kayıtları içerir.
1.0.0'dan sonraki önemli değişiklikler
RemoteInputIntentHelper
eklendi.- Bu sınıf, RemoteInput Intent'i derlemek için kullanılabilir. Bu daha sonra, özelleştirilebilir bir etkinlikte kullanıcılarınızdan girdi istemek için kullanılabilir.
Sürüm 1.1.0-rc01
4 Ağustos 2021
androidx.wear:wear-input:1.1.0-rc01
ve androidx.wear:wear-input-testing:1.1.0-rc01
yayınlandı. 1.1.0-rc01 sürümü bu kayıtları içerir.
androidx.wear:wear-input:1.1.0-beta01
ve androidx.wear:wear-input-testing:1.1.0-beta01
tarihinden bu yana API değişikliği yok
Sürüm 1.1.0-beta01
21 Temmuz 2021
androidx.wear:wear-input:1.1.0-beta01
ve androidx.wear:wear-input-testing:1.1.0-beta01
, 1.1.0-alpha03
tarihinden bu yana herhangi bir değişiklik olmadan yayınlandı. 1.1.0-beta01 sürümü bu kayıtları içerir.
Sürüm 1.1.0-alpha03
30 Haziran 2021
androidx.wear:wear-input:1.1.0-alpha03
ve androidx.wear:wear-input-testing:1.1.0-alpha03
yayınlandı. Sürüm 1.1.0-alpha03 bu kayıtları içerir.
Hata Düzeltmeleri
RemoteInputHelper.putRemoteInputsExtra
aracılığıylaRemoteInput
eklenmiş olan RemoteInput niyetlerinin reddedilmesine neden olan hata düzeltildi.
Sürüm 1.1.0-alpha02
18 Mayıs 2021
androidx.wear:wear-input:1.1.0-alpha02
ve androidx.wear:wear-input-testing:1.1.0-alpha02
yayınlandı. Sürüm 1.1.0-alpha02 bu kayıtları içerir.
API Değişiklikleri
RemoteInputIntentHelper
'ın başlık, iptal, onay ve devam eden etiketlerini temsil eden fazladan öğeleri almak veya yerleştirmek için kullanılan yöntemlerinde artık bu etiketler içinString
yerineCharSequence
kullanılmaktadır. (I0e71f)
Sürüm 1.1.0-alpha01
27 Ocak 2021
androidx.wear:wear-input:1.1.0-alpha01
ve androidx.wear:wear-input-testing:1.1.0-alpha01
yayınlandı. Sürüm 1.1.0-alpha01 bu kayıtları içerir.
API Değişiklikleri
- RemoteInputIntent sınıfını Giyilebilir Destek Kitaplığı'ndan AndroidX'e taşıyın. Taşınan sınıf, intent başlatarak uzaktan girişleri desteklemek için yardımcı işlevler sağlayan RemoteInputIntentHelper olarak yeniden adlandırıldı. (I47cee)
Wear-Giriş 1.0.0
Sürüm 1.0.0
2 Aralık 2020
androidx.wear:wear-input:1.0.0
ve androidx.wear:wear-input-testing:1.0.0
yayınlandı. 1.0.0 sürümü bu kayıtları içerir.
Bu sürüm, 1.0.0-rc01
ile aynı.
1.0.0'ın temel özellikleri
WearableButtons işlevi, Giyilebilir Destek Kitaplığı'ndan Jetpack'e taşındı.
androidx.wear:wear-input
kitaplığıyla geliştirilen test uygulamalarına yardımcı olmak içinandroidx.wear.input.WearableButtonsProvider
uygulayanandroidx.wear.input.test.TestWearableButtonsProvider
eklendi.
Sürüm 1.0.0-rc01
11 Kasım 2020
androidx.wear:wear-input:1.0.0-rc01
ve androidx.wear:wear-input-testing:1.0.0-rc01
yayınlandı. 1.0.0-rc01 sürümü bu kayıtları içerir.
Bu sürüm, 1.0.0-beta01
ile aynı.
Sürüm 1.0.0-beta01
28 Ekim 2020
androidx.wear:wear-input:1.0.0-beta01
ve androidx.wear:wear-input-testing:1.0.0-beta01
, 1.1.0-alpha01
tarihinden bu yana herhangi bir değişiklik olmadan yayınlandı. 1.0.0-beta01 sürümü bu kayıtları içerir.
Wear-Giriş Testi Sürümü 1.0.0-alpha01
14 Ekim 2020
androidx.wear:wear-input-testing:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.
API Değişiklikleri
androidx.wear:wear-input
kitaplığıyla geliştirilen test uygulamalarına yardımcı olmak içinandroidx.wear.input.WearableButtonsProvider
uygulayanandroidx.wear.input.test.TestWearableButtonsProvider
eklendi. (I0ed0c)
Wear-Giriş Sürümü 1.0.0-alpha01
2 Eylül 2020
androidx.wear:wear-input:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.
Yeni Özellikler
WearableButtons işlevi, Giyilebilir Destek Kitaplığı'ndan Jetpack'e taşındı. Bir sonraki Jetpack sürümünde androidx.wear:wear-input-testing
kitaplığında ek test desteği sağlanacaktır.
Sürüm 1.1.0
Sürüm 1.1.0
14 Ekim 2020
androidx.wear:wear:1.1.0
yayınlandı. 1.1.0 sürümü bu kayıtları içerir.
1.0.0'dan bu yana yapılan önemli değişiklikler
- Android adlandırma kuralına uymak amacıyla,
BoxInsetLayout
içinboxedEdges özelliğine (şu andalayout_BoxedEdges
)layout_
ön eki eklendi. Bu işlem, bu özellikler için Android Studio'daki linter hatasını kaldırır. (I4272f) - Onay iletişim kutusunun gösterildiği süre boyunca izin vermek için isteğe bağlı
EXTRA_ANIMATION_DURATION_MILLIS
öğesiConfirmationActivity
öğesine eklendi. (adb83ce, b/143356547) WearableActionDrawView
, çekmece ilk kez açılıncaya kadar işlem çekmecesi şişirmesini geciktirecek şekilde güncellendi. (I01026, b/163870541)
Sürüm 1.1.0-rc03
2 Eylül 2020
androidx.wear:wear:1.1.0-rc03
yayınlandı. 1.1.0-rc03 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
- İşlem Çekmecesi açıldığında içerik göstermemesiyle ilgili sorun düzeltildi. (I01026, b/163870541)
Sürüm 1.1.0-rc02
24 Haziran 2020
androidx.wear:wear:1.1.0-rc02
yayınlandı. 1.1.0-rc02 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
- Android adlandırma kuralına uymak amacıyla,
BoxInsetLayout
içinboxedEdges özelliğine (şu andalayout_boxedEdges
)layout_
ön eki eklendi. Bu işlem, bu özellikler için Android Studio'daki linter hatasını kaldırır.
Sürüm 1.1.0-rc01
14 Mayıs 2020
androidx.wear:wear:1.1.0-rc01
, .1.0-beta01
tarihinden bu yana herhangi bir değişiklik olmadan yayınlandı. 1.1.0-rc01 sürümü bu kayıtları içerir.
Sürüm 1.1.0-beta01
29 Nisan 2020
androidx.wear:wear:1.1.0-beta01
, androidx.wear:wear:1.1.0-alpha01
tarihinden bu yana herhangi bir değişiklik olmadan yayınlandı. 1.3.0-beta01 sürümü bu kayıtları içerir.
Sürüm 1.1.0-alpha01
15 Nisan 2020
androidx.wear:wear:1.1.0-alpha01
yayınlandı. Sürüm 1.1.0-alpha01 bu kayıtları içerir.
API Değişiklikleri
- Onay iletişim kutusunun gösterildiği süre boyunca izin vermek için isteğe bağlı
EXTRA_ANIMATION_DURATION_MILLIS
öğesiConfirmationActivity
öğesine eklendi. (adb83ce, 134523c, b/143356547)
Hata Düzeltmeleri
WearableActionDrawView
, çekmece ilk kez açılıncaya kadar işlem çekmecesi şişirmesini geciktirecek şekilde güncellendi. (5cd32f7)