Bir Bakışta
Son Güncelleme | Kararlı Sürüm | Serbest Bırakma Adayı | Beta Sürümü | Alfa Sürümü |
---|---|---|---|---|
12 Haziran 2024 | 1.1.0 | - | - | - |
Bağımlılıkları bildirme
Glance'a 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:
Eski
dependencies { // For Glance support implementation "androidx.glance:glance:1.1.0" // For AppWidgets support implementation "androidx.glance:glance-appwidget:1.1.0" // For Wear-Tiles support implementation "androidx.glance:glance-wear-tiles:1.0.0-alpha05" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.0-beta03" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { // For Glance support implementation("androidx.glance:glance:1.1.0") // For AppWidgets support implementation("androidx.glance:glance-appwidget:1.1.0") // For Wear-Tiles support implementation("androidx.glance:glance-wear-tiles:1.0.0-alpha05") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.0-beta03" } kotlinOptions { jvmTarget = "1.8" } }
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.
Sürüm 1.1
Sürüm 1.1.0
12 Haziran 2024
androidx.glance:glance-*: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
- Glance'ı 1.1.0 kararlı sürümüne taşır.
Sürüm 1.1.0-rc01
14 Mayıs 2024
androidx.glance:glance-*:1.1.0-rc01
yayınlandı. 1.1.0-rc01 sürümü bu kayıtları içerir.
Yeni Özellikler
- Bir Bakışta için Önizleme ek açıklamalarına genişlik ve yükseklik parametreleri eklendi. 1.1.0 Sürümünü Serbest Bırakma Adayı'na taşır.
API Değişiklikleri
- Scaffold'a isteğe bağlı parametre ekler. (If753f)
@Preview
bir Bakışta'ya genişlik ve yükseklik parametreleri ekleyin. (Ibabe8)- Bir bakışta Wear kartı önizlemeleri için sağlanan destek kaldırıldı. (I3850a)
FontStyle
için özel ağırlık değerlerinin ayarlanmasına yönelik API eklendi. (I7390a)- Temel uygulamaları daha iyi yansıtmak amacıyla
Viewfinder
öğesininImplementationMode
Sıralamalarını yeniden adlandırın veTransformationInfo.sourceRotation
için sabit sabit değerler ekleyin (Ic6149)
Hata Düzeltmeleri
- Geriye dönük uyumluluk modunda
ViewGroups
için oluşturma sorunlarına neden olan bir hata düzeltildi (I8de92)
Harici Katkı
- Deneysel
SharedTransitionScope
artık bir sınıf yerine arayüz oldu. (Iaf856, b/338415048, b/338414702)
Sürüm 1.1.0-beta02
17 Nisan 2024
androidx.glance:glance-*:1.1.0-beta02
yayınlandı. Bu sürüm, önceki sürümde bulunmayan kaynak jar dosyaları içeriyor.
Sürüm 1.1.0-beta01
3 Nisan 2024
androidx.glance:glance-*:1.1.0-beta01
yayınlandı. 1.1.0-beta01 sürümü bu kayıtları içerir.
Sürüm 1.1.0-alpha01
7 Şubat 2024
androidx.glance:glance-*:1.1.0-alpha01
yayınlandı. Sürüm 1.1.0-alpha01 bu kayıtları içerir.
Yeni Özellikler
- Kullanıcı Arayüzü Automator'ı gerektirmeyen Bakış için birim testi kitaplığı. Bakış kodu, görünümü şişirmek zorunda kalmadan doğrudan test edilebilir.
- Daha basit düzenler için daha üst düzey bileşenler.
- Yeni Değiştiriciler ve tema seçenekleri.
- Bir besteden RemoteViews akışı almak için yeni API,
runComposition
API Değişiklikleri
- Bakış temalarına yeni bir
widgetBackground
renk rolü ekler. (Ia2ab8) - Ekle
GlanceAppWidget.runComposition
(I6344c, b/298066147) - Yeni
TopBar
bileşeni ekler (Ibd361) clickable
değiştiricisine geçersiz kılmalar ekler. (Iacecf)- Düğmeleri renklendirmek için yeni bir API ekler. Bu, 1.0 sürümü gönderilene kadar deneysel bir uygulama olmalıdır. (I92523)
- Test için izole edilmiş küçük bir composable sağlamak amacıyla
provideComposable
gibiGlanceAppWidgetUnitTest
üzerinde çağrı yöntemlerine kapsam sağlayanrunGlanceAppWidgetUnitTest
, sağlanan içerikte bir Glance composable öğesi bulmak içinonNode
ekler. Böylece appWidget'ınızdaki her bir composable işlev için birim testleri yazabilir ve böylece, belirli girişler verildiğinde işlevin amaçlanan composable öğe kümesini çıkardığını doğrulayabilirsiniz. (I2f682) - Birim testlerinde kullanılmak üzere anlamsal bir
testTag
değiştiricisi ekler. (I8f62f) TitleBar
güncellemesi - metin ve simge ayrı ayrı renklendirilebilir. (Ia0a60)- İskele bileşenini ekler (I8a736)
actionRunCallack
hizmetini test etmek içinhasActionRunCallbackClickAction
filtresi veassertHasActionRunCallbackClickAction
onaylama ekler. Ayrıca, işlemle ilgili test filtreleri için ek kısayol varyantı işlevleri eklendi:hasStartActivityClickAction<activityClass>(..)
,hasStartServiceAction<receiverClass>(..)
,hasSendBroadcastAction<receiverClass>(..)
.assertHasXXX
muadilleri için benzer varyantlar ekler. (Ieca63)- Yayınlanmamış API'yi hareket ettirir. Bir değiştiriciyi dahili olandan herkese açık ancak kitaplıkla kısıtlı olarak değiştirir (If2a08)
- Hata oluştuğunda geliştiricilerin kod çalıştırabileceği
onCompositionError
yöntemi ekler (I9b56f) - Bir bakışta düğme ve simge düğmesi API'leri ekler (I0fd6f)
- İlerleme göstergeleriyle eşleşmesi için
isLinearProgressIndicator
,isIndeterminateLinearProgressIndicator
,isIndeterminateCircularProgressIndicator
filtreleri eklenir. Ayrıca, bir düğümün alt hiyerarşisinde belirli bir eşleştiriciyle (Ifd426) eşleşen bir alt öğeye sahip olup olmadığını test etmek içinhasAnyDescendants
filtresini de içerir - Hizmet / etkinlik veya yayınları başlatan tıklama işlemlerinin test edilmesini sağlamak için onaylamalar ve filtreler ekler. Ayrıca, giriş öğelerinin kontrol edilip edilmediğini test etmeyi de içerir. (I3041c)
Sürüm 1.0.0
Sürüm 1.0.0-alpha06
7 Şubat 2024
androidx.glance:glance-appwidget-preview:1.0.0-alpha06
ve androidx.glance:glance-preview:1.0.0-alpha06
yayınlandı. 1.0.0-alpha06 sürümü bu kayıtları içerir.
Yeni Özellikler
- Sürüm, ana Glance modülünü takip edecek şekilde güncellendi.
Sürüm 1.0.0
6 Eylül 2023
androidx.glance:glance-*:1.0.0
yayınlandı. 1.0.0 sürümü bu kayıtları içerir.
1.0.0'ın temel özellikleri
- Glance'ı kararlı 1.0.0 sürümüne taşıma
Sürüm 1.0.0-rc01
26 Temmuz 2023
androidx.glance:glance-*:1.0.0-rc01
yayınlandı. 1.0.0-rc01 sürümü bu kayıtları içerir.
Glance, 1.0.0 için kararlı sürüme geçmek üzere rc01'e taşınır.
Yeni Özellikler
- Daha kararlı işlem çağrıları için işlem lambda'larına anahtar parametreler ekler.
ActvityOptions
-startActivity
işlem sağlama yeteneği ekler.- Android 14 desteği eklendi
API Değişiklikleri
- Lambda kabul eden tüm öğeler için isteğe bağlı bir anahtar parametre eklendi. (Id96c1, b/282445798)
actionStartActivity
içinActivityOptions
paketini ayarlama desteği eklendi (I6a08d)- d,e,f,g-paths için birleştirilmiş genel ve deneysel API dosyaları (I03646, b/278769092)
- Yok, API dosyası değişiklikleri yalnızca yeniden sıralama yöntemlerinden oluşuyor (I5fa95)
GlanceAppWidgetReceiver
istekleri içinCoroutineContext
ayarını yapmak üzere API ekleyin (I0a100)LazyColumn
veLazyVerticalGrid
içinActivityOptions
sağlamak amacıyla listedeki tüm işlemlerde kullanılacak yeni bir API eklendi.(Id8d71)
Hata Düzeltmeleri
- Yok, API dosyası değişiklikleri yalnızca yeniden sıralama yöntemlerinden oluşuyor (I5fa95)
- Bir bakışta metin bileşeni stili demosu (Ie78a4)
Sürüm 1.0.0-beta01
10 Mayıs 2023
androidx.glance:glance-*:1.0.0-beta01
yayınlandı. 1.0.0-beta01 sürümü bu kayıtları içerir.
Yeni Özellikler
- Kitaplığı beta sürümüne taşır.
GlanceTheme
kullanarak tema oluşturma desteği eklendi. Ayrıca Bakış'ta malzeme 2 ve malzeme 3 stil temalarını desteklemek amacıyla glance-material ve glance-material3 modülleri eklendi.- Metin API'lerine
FontFamily
için destek eklendi. GlanceAppWidget
, oturuma dayalıWorkManager
bir güncelleme mekanizmasına taşındı.AppWidgets
için Glance kullanıcıları artık eskiContent
yöntemi yerineGlanceAppWidget.provideGlance
yöntemini geçersiz kılmalıdır. Bu süreç bir çalışan içinde gerçekleştiğinden artık kaynakları, veritabanını veya ağ öğelerini ayrı bir çalışana sahip olmak zorunda kalmadan yüklemek için ideal bir yer haline geldi.
API Değişiklikleri
Button
,Checkbox
,RadioButton
veSwitch
için*Defaults
API eklendi. Bakışı Jetpack Compose'un kalıplarıyla daha uyumlu hale getiriyor. (I94828)- Yeni Glance şablonları modülü (I94459)
ResourceColorProvider
öğesini modülün içinde kullanma. Çarpıcı değişim. Bazı renklerin dinamik kaynaklar, bazılarının ise tamamen çözümlendiği durumları önlemek amacıylaResourceColorProvider
yalnızca dinamik tema için kullanılmalıdır. Bu yüzden gereklidir. (Ib0db7)TextStyle
için seçenek olarakFontFamily
değerini ekler. (Ic19ba, b/274179837)Enum.valueOf
için değer parametresi adı değiştirildi (Ia9b89)- Enum
valueOf
(I818fe) öğesinden diğer atılmış istisnalar GlanceAppWidget
, ana giriş noktası olarakprovideGlance
kullanılacak şekilde güncellendi.GlanceAppWidget.Content
desteği sonlandırıldı. (I202b5)- Resimlere tonlama rengi sağlama seçeneği ekler (I26192, b/212418562)
- Kullanımdan kaldırılan gizli işlevlerin daha fazla döndürme türü boş değer atanabilirliği. (İbf7b0)
@JvmDefaultWithCompatibility
ek açıklaması ekleniyor (I8f206)- Kullanılmayan
SingleEntityTemplateData.displayHeader
kaldırıldı. (I7f094) - Lambda'ların geri çağırma olarak kullanılması için destek eklendi (Ia0bbd)
DayNightColorProvider
, bir bakış modülüne taşındı (I1842c, b/256934779)LocalColorProvider
öğesini Şablonlar'dan kaldırır. Şablonlar artıkGlanceTheme.colors
(Ic15e2) kullanacakText(style: TextStyle)
öğesinden boş değer kaldırıldı (I7123b, b/237012816)- Varsayılan metin rengi siyahtır. Boş değer atanabilirliğini kaldırın (I3072c, b/237012816)
- Dinamik temayı
ColorProviders
kendi nesnesi yapma.ResourceColorProvider
öğesini modülün içine dahil etme. (Id0e2d, b/237012816) - Tanımlanmamış kategoriyi
ImageSize
kampanyasına ekleyin. (I2fa39) - Kullanımdan kaldırılan
GlanceAppWidget.Content
işlevini (Ib05f6) kaldırın AndroidRemoteViews
öğesine parametre olarak değiştirici ekler. (I515d4)- Birim testini kolaylaştırmak için
GlanceAppWidget.compose
ekleyin (Ie9b28)
Hata Düzeltmeleri
- Bir Bakışta metin yazı tipleri için bir demo widget'ı eklendi (I5c3d7)
AndroidRemoteViews
öğesini Değiştirici ile büyük hale getirir.- Tutarsız tema renkleri ile ilgili sorunlar çözüldü
- Çarpışmaları önlemek için artık tüm kaynaklara ön ek ekleniyor
Sürüm 1.0.0-alpha05
5 Ekim 2022
androidx.glance:glance:1.0.0-alpha05
, androidx.glance:glance-appwidget:1.0.0-alpha05
ve androidx.glance:glance-wear-tiles:1.0.0-alpha05
yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.
Yeni Özellikler
GlanceAppWidgetManager
içinerequestPinGlanceAppWidget
ekleyerek uygulamaların, kullanıcıdan Bakışa dayalı widget'ını ana ekranına eklemesini istemesine olanak tanır. (Ic6e47)- Geliştiricilerin, widget'larını rootlanmış cihazlarda ve emülatörlerde adb'den güncelleme yapmaya zorlamasına olanak tanımak için
ACTION_DEBUG_UPDATE
öğesiniGlanceAppWidgetReceiver
ekler. (I94ae1)
API Değişiklikleri
- Kullanım alanını basitleştirmek için Bakış şablonlarındaki başlık işlem düğmelerini kaldırın. (Ie4387)
- Engelle alt sistem tasarımının yeniden kullanılması için Tek Öğe Şablonu yeniden düzenlendi. (Iecd2c)
Text/Image/Action
Blok tasarımının kullanılması için Yeniden Düzenlendi Bakış Listesi Şablonu. (If0cc1)TextBlock
veImageBlock
için öncelik numarası aralığı ekleyin. (I73100)
Hata Düzeltmeleri
- Material3 bağımlılığı kaldırıldı. (I28d1c)
- Bir bakışta şablon düzenlerinde kenar boşlukları ve boşluk eklemek için daha tutarlı bir sisteme yönelir. (I29773)
- Küçültülmüş sürümlerin oluşturulmasını engelleyen, hatalı biçimlendirilmiş ProGuard kuralını düzeltir.
Sürüm 1.0.0-alpha04
10 Ağustos 2022
androidx.glance:glance:1.0.0-alpha04
, androidx.glance:glance-appwidget:1.0.0-alpha04
ve androidx.glance:glance-wear-tiles:1.0.0-alpha04
yayınlandı. Sürüm 1.0.0-alpha04 bu kayıtları içerir.
Yeni Özellikler
- Düğme renklendirme özellikleri ekler.
- Daha iyi derleme zamanı kontrolü için
GlanceComposable
ek açıklaması ekler. - Wear'a özgü Glance özellikleri ekler.
API Değişiklikleri
- Glance Gallery Data API'sini ve Yoğun Görünüm'ü güncelleme. (Ibc7a8)
- Düğmeleri yapılandırmak için
ButtonColors
ekler. (Iea88d, b/236305351) ColorProvider.resolve
alanının adınıColorProvider.getColor
(Ic9dfe) olarak değiştirinTextStyle
öğesinecopy()
yöntemini ekler. (I9aef6)- Glance temalarının bir parçası olarak kullanılabilecek bir
ColorProviders
sınıfı ekler. (I848b9, b/237012816) - Stilleri ve daraltılmış görünüme Liste Şablonu desteğini ekleyin. (I50cdc)
GlanceModiier
veGlanceCurvedModifier
kelimelerine anlambilim ekleyin. (Ifda7e)GlanceComposable
notu ekleyin. (I5dbf0)- Bakışta Şablonlarını ana Bakış projesine taşır. (I9db94)
ColorProvider.resolve()
ekle (Ife532, b/214733442)- Mevcut bir
appWidgetId
öğesinden veya bir yapılandırma etkinliğinden bir niyettenGlanceId
almanın yeni yöntemi (Icb70c, b/230391946) GlanceComposable
notu ekleyin. (I2c21f)GlanceAppWidget
dışındaki koşu bestesi içinGlanceRemoteViews
eklendi. (I18f92)ProgressIndicatorDefaults
ürününde Rengi Kaldır. (I40299)- Herkese açık API'lerle tutarlılık sağlamak için
ActionCallback
uygulamasının onRun yöntemini onAction olarak yeniden adlandırın (API inceleme geri bildiriminin gerektirdiği şekilde). (Icfa57) - Bakış şablonu düzenlerini harita kullanacak şekilde dönüştürme (I46bfd)
RadioButton
composable (I4ecce) ekle- Wear kutuları oluşturmak için
GlanceWearTiles
eklendi (Ia9f65) GlanceCurvedModifier
reklam grubuna tıklanabilir olarak eklendi (Iec2a0)CurvedRow
işlevini kapsam olarak uygulayın ve normal composable ve/veya eğri öğeler eklemek için bir DSL oluşturun. Ayrıca, proto parçalardaArcLine
veArcSpacer
dillerine çevrilencurvedLine
vecurvedSpacer
eklendi (Ib955b)- Core ve appcompat içindeki null değer, Tiramisu DP2'yle (I0cbb7) eşleşecek şekilde güncellendi
- glance-wear-tiles'da
RuncallbackAction
desteği eklendi. Şimdilik NO parametresiyle yalnızcaRunCallbackAction
destekleniyor (Ide64a)
Harici Katkı
- :compose:ui:ui-test api (updateApi) test-coroutines-lib geçişi nedeniyle güncellendi (I3366d)
Sürüm 1.0.0-alpha03
23 Şubat 2022
androidx.glance:glance-*:1.0.0-alpha03
yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları içerir.
Yeni Özellikler
- Basitleştirilmiş durum tanımının varsayılan olarak Tercihler'e ayarlanması.
API Değişiklikleri
PreferencesGlanceStateDefinition
'yi varsayılan durum işleme yaparak durum işlemeyi basitleştirin.GlanceAppWidget.updateAppWidgetState
kaldırıldı ve varsayılan olarakPreferences
kullananupdateAppWidgetState
kullanıma sunuldu. (I58963)- Glance TemplateText sınıfı ekleyin ve Şablon tasarımını güncelleyin (I4e146)
- Serbest biçim şablonu (If03d6) için anahat altyapısı ekler
SingleEntityTemplate
düzenleriyle ilgili güncellemeler (If925d)LazyVerticalGrid
(I5f442) eklendiSingleEntityTemplate
(I01ee0) üzerindeColorProvider
kullan- Şablon sınıf adını güncelleyin (I3720e)
LinearProgressIndicator
veCircularProgressIndicator
composable eklendi. (Ie116b)
Hata Düzeltmeleri
- İlk bakış şablonları uygulaması, "tek öğe şablonu" verilerini ve örnek şablon düzenini tanımlar (I35837)
- Karo içeriğini varsayılan olarak ortaya hizala (I264be)
- glance-wear-tiles öğesinde fillMaxSize/Width/Height (Yükseklik) ile hata düzeltmesi (I0a39f)
Sürüm 1.0.0-alpha02
26 Ocak 2022
androidx.glance:glance-*:1.0.0-alpha02
yayınlandı. Sürüm 1.0.0-alpha02 bu kayıtları içerir.
Yeni Özellikler
Bu sürümde, "Glanceable" için optimize edilmiş composable'larla Compose çalışma zamanı aracılığıyla Wear Kartlarını derlemeye yönelik API setleri bulunur
- Kutunuzu composable Content() işlevinde oluşturmak için kullanılan bir hizmet olan
GlanceTileService
hizmetini genişleterek aşınma taşı hizmetinizi tanımlayın. - Kutulara özel bir bakış composable'ı takın:
CurvedRow
,CurvedText
. TimelineMode.SingleEntry
veTimelineMode.TimeBoundEntries
tanımlayarak öğe için farklı zaman çizelgesi modlarını kullanın.LocalTimeInterval
için yerel beste belirli bir zaman aralığını ifade eder.BorderModifer
, bir öğenin etrafına kenarlık uygulayan birGlanceModifier
öğesidir.
Bu sürümde AppWidget Bakışı'na İlerleme Göstergeleri de eklendi.
API Değişiklikleri
LinearProgressIndicator
veCircularProgressIndicator
composable eklendi. (Ie116b)actionStartBroadcastReceiver
değeriniactionSendBroadcast
(I7d555) olarak değiştirinGlanceAppWidget
onDelete geri çağırması (I4c795) için Bağlamı iletin
Hata Düzeltmeleri
- Mevcut ancak boşsa OPTIONS_APPWIDGET_SIZES doğru işleniyor. (I01f82)
Sürüm 1.0.0-alpha01
15 Aralık 2021
androidx.glance:glance:1.0.0-alpha01
, androidx.glance:glance-appwidget:1.0.0-alpha01
ve androidx.glance:glance-appwidget-proto:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.
İlk sürümdeki özellikler
- Glance'ın ilk sürümü, Compose Runtime'ı kullanarak AppWidget oluşturmak için kullanılan ilk API grubunu ve "Glanceables" için optimize edilmiş yeni Composable'lar içerir.
Özellikler
- Uygulamanızın widget'larını GlanceAppWidget ve GlanceAppWidgetReceiver ile tanımlayın.
- Glance Composable'ın ilk grubuyla kullanıcı arayüzünüzü oluşturun: Box, Row, Column, Text, Button, LazyColumn, Image, Boşluk.
- GlanceModifier yöntemlerini kullanarak composable'lara değiştiriciler uygulayın.
- Önceden tanımlanmış işlemlerle kullanıcı etkileşimini ele alın.
- ActionParameters ile Action parametresi sağlayın.
- SizeMode.Single, SizeMode.Exact veya SizeMode.Uyumlu değerlerini tanımlayarak farklı boyut modlarını işleyin.
- Bir GlanceStateDefinition sağlayarak GlanceAppWidget durumunu koruyun.
- LocalContext, LocalState, LocalGlanceId, LocalSize gibi yerel besteler.
- Mevcut RemoteView cihazlarınızla, AndroidRemoteViews Composable ile birlikte çalışabilir.