Bir Bakışta

Jetpack Compose tarzı bir API kullanarak uzak yüzeyler için düzenler oluşturun.
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:

Groovy

dependencies {
    // For Glance support
    implementation "androidx.glance:glance:1.1.1"
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.1.1"

    // 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.1")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.1.1")

    // 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.

Yeni sayı oluşturma

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 öğesinin ImplementationMode Sıralamalarını yeniden adlandırın ve TransformationInfo.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ı

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 gibi GlanceAppWidgetUnitTest üzerinde çağrı yöntemlerine kapsam sağlayan runGlanceAppWidgetUnitTest, sağlanan içerikte bir Glance composable öğesi bulmak için onNode 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çin hasActionRunCallbackClickAction filtresi ve assertHasActionRunCallbackClickAction 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çin hasAnyDescendants 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çin ActivityOptions 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çin CoroutineContext ayarını yapmak üzere API ekleyin (I0a100)
  • LazyColumn ve LazyVerticalGrid için ActivityOptions 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 eski Content yöntemi yerine GlanceAppWidget.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 ve Switch 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ıyla ResourceColorProvider yalnızca dinamik tema için kullanılmalıdır. Bu yüzden gereklidir. (Ib0db7)
  • TextStyle için seçenek olarak FontFamily 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ı olarak provideGlance 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ık GlanceTheme.colors (Ic15e2) kullanacak
  • Text(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çine requestPinGlanceAppWidget 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 öğesini GlanceAppWidgetReceiver 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 ve ImageBlock 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ştirin
  • TextStyle öğesine copy() 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 ve GlanceCurvedModifier 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 niyetten GlanceId almanın yeni yöntemi (Icb70c, b/230391946)
  • GlanceComposable notu ekleyin. (I2c21f)
  • GlanceAppWidget dışındaki koşu bestesi için GlanceRemoteViews 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çalarda ArcLine ve ArcSpacer dillerine çevrilen curvedLine ve curvedSpacer 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ızca RunCallbackAction 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 olarak Preferences kullanan updateAppWidgetState 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) eklendi
  • SingleEntityTemplate (I01ee0) üzerinde ColorProvider kullan
  • Şablon sınıf adını güncelleyin (I3720e)
  • LinearProgressIndicator ve CircularProgressIndicator 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 ve TimelineMode.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 bir GlanceModifier öğesidir.

Bu sürümde AppWidget Bakışı'na İlerleme Göstergeleri de eklendi.

API Değişiklikleri

  • LinearProgressIndicator ve CircularProgressIndicator composable eklendi. (Ie116b)
  • actionStartBroadcastReceiver değerini actionSendBroadcast (I7d555) olarak değiştirin
  • GlanceAppWidget 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