Anzeige

Mit einer Jetpack Compose-API Layouts für Remote-Oberflächen erstellen
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alpharelease
12. Juni 2024 1.1.0 - - -

Abhängigkeiten deklarieren

Zum Hinzufügen einer Abhängigkeit von Glance müssen Sie Ihrem Projekt das Maven-Repository von Google hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre Anwendung oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:

Cool

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"
    }
}

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Dein Feedback hilft uns, Jetpack zu verbessern. Lassen Sie uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie eine neue erstellen. Durch Klicken auf die Stern-Schaltfläche können Sie zu einem vorhandenen Problem abstimmen.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.1

Version 1.1.0

12. Juni 2024

androidx.glance:glance-*:1.1.0 wird freigegeben. Version 1.1.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.0.0

  • Verschiebt Glance auf die stabile Version 1.1.0.

Version 1.1.0-rc01

14. Mai 2024

androidx.glance:glance-*:1.1.0-rc01 wird freigegeben. Version 1.1.0-rc01 enthält diese Commits.

Neue Funktionen

  • Den Vorschauanmerkungen für Glance wurden Parameter für Breite und Höhe hinzugefügt. Verschiebt 1.1.0 zum Release-Kandidaten.

API-Änderungen

  • Fügt dem Scaffold einen optionalen Parameter hinzu. (If753f)
  • Füge „Glance“-@Preview Parameter für Breite und Höhe hinzu. (Ibabe8)
  • Die Unterstützung für die Vorschau der Glanz Wear-Kacheln wurde entfernt. (I3850a)
  • Es wurde eine API zum Festlegen benutzerdefinierter Gewichtungswerte für FontStyle hinzugefügt. (I7390a)
  • Benennen Sie die ImplementationMode-Enums von Viewfinder um, um die zugrunde liegenden Implementierungen besser widerzuspiegeln, und fügen Sie feste Konstanten für TransformationInfo.sourceRotation (Ic6149) hinzu

Fehlerkorrekturen

  • Es wurde ein Fehler behoben, der Rendering-Probleme für ViewGroups im Abwärtskompatibilitätsmodus verursachte (I8de92).

Externer Beitrag

Version 1.1.0-beta02

17. April 2024

androidx.glance:glance-*:1.1.0-beta02 wird freigegeben. Diese Version enthält Quelldateien, die in der vorherigen Version fehlten.

Version 1.1.0-beta01

3. April 2024

androidx.glance:glance-*:1.1.0-beta01 wird freigegeben. Version 1.1.0-beta01 enthält diese Commits.

Version 1.1.0-alpha01

7. Februar 2024

androidx.glance:glance-*:1.1.0-alpha01 wird freigegeben. Version 1.1.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Komponententestbibliothek für Glance, für die UI Automator nicht erforderlich ist. Der Glance-Code kann direkt getestet werden, ohne die Ansicht zu erhöhen.
  • Höhere Komponenten für einfachere Layouts.
  • Neue Modifikatoren und Designoptionen.
  • Neue API zum Abrufen eines Ablaufs von RemoteViews aus einer Komposition, runComposition

API-Änderungen

  • Dadurch wird den Glance-Designs die neue Farbrolle widgetBackground hinzugefügt. (Ia2ab8)
  • GlanceAppWidget.runComposition (I6344c, b/298066147) hinzufügen
  • Fügt eine neue TopBar-Komponente hinzu (Ibd361)
  • Fügt dem clickable-Modifikator Überschreibungen hinzu. (Iacecf)
  • Fügt eine neue API zum Abfärben von Schaltflächen hinzu. Dies sollte bis zur Auslieferung von Version 1.0 experimentell sein. (I92523)
  • Fügt runGlanceAppWidgetUnitTest hinzu, das einen Bereich für den Aufruf von Methoden auf GlanceAppWidgetUnitTest enthält, z. B. provideComposable, um eine kleine isolierte zusammensetzbare Funktion für Testzwecke und onNode bereitzustellen, um im bereitgestellten Inhalt ein zusammensetzbares Element der Funktion „Live-Anzeige“ zu finden. Auf diese Weise können Sie Einheitentests für einzelne zusammensetzbare Funktionen in „appWidget“ schreiben, um zu überprüfen, ob die Funktion bei bestimmten Eingaben den gewünschten Satz zusammensetzbarer Übersichtselemente ausgibt. (I2f682)
  • Fügt in der Semantik einen testTag-Modifikator zur Verwendung in Einheitentests hinzu. (I8f62f)
  • Aktualisierung TitleBar – Text und Symbol können einzeln abfärbt werden. (Ia0a60)
  • Scaffold-Komponente wird hinzugefügt (I8a736)
  • Fügt den hasActionRunCallbackClickAction-Filter und die assertHasActionRunCallbackClickAction-Assertion zum Testen von actionRunCallack hinzu. Außerdem werden zusätzliche Kurzformfunktionen für aktionsbezogene Testfilter hinzugefügt: hasStartActivityClickAction<activityClass>(..), hasStartServiceAction<receiverClass>(..) und hasSendBroadcastAction<receiverClass>(..). Fügt ähnliche Varianten für ihre assertHasXXX-Gegenstücke hinzu. (Ieca63)
  • Verschiebt die unveröffentlichte API Ändert einen Modifikator von „intern“ in „öffentlich“, aber in einer Mediathek eingeschränkt (If2a08)
  • Fügt die Methode onCompositionError hinzu, mit der Entwickler Code ausführen können, wenn ein Fehler auftritt (I9b56f)
  • Fügt Schaltflächen- und iconbutton-APIs zu Blick hinzu (I0fd6f)
  • Fügt isLinearProgressIndicator-, isIndeterminateLinearProgressIndicator- und isIndeterminateCircularProgressIndicator-Filter hinzu, um den Fortschrittsanzeigen zu entsprechen. Zusätzlich enthält der hasAnyDescendants-Filter, mit dem getestet werden kann, ob ein Knoten in seiner untergeordneten Hierarchie einen Nachfolger hat, der mit einem bestimmten Matcher übereinstimmt (Ifd426)
  • Fügt Assertions und Filter hinzu, um das Testen von Klickaktionen zu ermöglichen, die Dienst / Aktivität oder Broadcasts starten. Umfasst auch das Testen, ob Eingabeelemente überprüft werden. (I3041c)

Version 1.0.0

Version 1.0.0-alpha06

7. Februar 2024

androidx.glance:glance-appwidget-preview:1.0.0-alpha06 und androidx.glance:glance-preview:1.0.0-alpha06 werden veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Die Version wurde aktualisiert, um dem Glance-Hauptmodul zu entsprechen.

Version 1.0.0

6. September 2023

androidx.glance:glance-*:1.0.0 wird freigegeben. Version 1.0.0 enthält diese Commits.

Hauptfunktionen von Version 1.0.0

  • Glance auf die stabile Version 1.0.0 umstellen

Version 1.0.0-rc01

26. Juli 2023

androidx.glance:glance-*:1.0.0-rc01 wird freigegeben. Version 1.0.0-rc01 enthält diese Commits.

Verschiebt Glance zu rc01 auf dem Weg zur stabilen Version für 1.0.0.

Neue Funktionen

  • Fügt wichtige Parameter zu Aktions-Lambdas für einen stabileren Aktionsaufruf hinzu.
  • Bietet die Möglichkeit, ActvityOptions für startActivity-Aktionen bereitzustellen.
  • Android 14 wird unterstützt

API-Änderungen

  • Ein optionaler Schlüsselparameter wurde für alle Elemente hinzugefügt, die Lambdas akzeptieren. (Id96c1, b/282445798)
  • Unterstützung für das Festlegen des Pakets „ActivityOptions“ für actionStartActivity (I6a08d)
  • Zusammengeführte öffentliche und experimentelle API-Dateien für d,e,f,g-paths (I03646, b/278769092)
  • Nicht zutreffend, API-Dateiänderungen sind nur Neuanordnungsmethoden (I5fa95)
  • API hinzufügen, um CoroutineContext für GlanceAppWidgetReceiver-Anfragen festzulegen (I0a100)
  • Eine neue API wurde hinzugefügt, um ActivityOptions für LazyColumn und LazyVerticalGrid bereitzustellen, die für alle Aktionen in der Liste verwendet wird.(Id8d71)

Fehlerkorrekturen

  • Nicht zutreffend, API-Dateiänderungen sind nur Neuanordnungsmethoden (I5fa95)
  • Demo für den Stil der Glance-Textkomponente (Ie78a4)

Version 1.0.0-beta01

10. Mai 2023

androidx.glance:glance-*:1.0.0-beta01 wird freigegeben. Version 1.0.0-beta01 enthält diese Commits.

Neue Funktionen

  • Versetzt die Bibliothek in die Betaversion.
  • Unterstützung für Designs mithilfe von GlanceTheme , ergänzt die Module „look-material“ und „look-material3“ für Designs von Material 2 und Material 3 in Glance.
  • Unterstützung für FontFamily wurde zu Text-APIs hinzugefügt.
  • GlanceAppWidget wurde in einen auf WorkManager-Sitzungen basierenden Aktualisierungsmechanismus verschoben. Nutzer von Glance für AppWidgets sollten jetzt GlanceAppWidget.provideGlance anstelle der alten Content-Methode überschreiben. Da dies bei einem Worker der Fall ist, können Sie hier Ressourcen, Datenbanken oder Netzwerkelemente laden, ohne einen separaten Worker verwenden zu müssen.

API-Änderungen

  • *Defaults API für Button, Checkbox, RadioButton und Switch hinzugefügt. Sie gleicht den Mustern von Jetpack Compose und schont den Blick näher. (I94828)
  • Neues Vorlagenmodul für Glance (I94459)
  • ResourceColorProvider wird intern für das Modul erstellt. Funktionsgefährdende Änderung Erforderlich, da ResourceColorProvider nur für dynamische Designs verwendet werden sollte, um Situationen zu vermeiden, in denen einige Farben dynamische Ressourcen sind und andere vollständig aufgelöst werden. (Ib0db7)
  • Fügt FontFamily als Option für TextStyle hinzu. (Ic19ba, b/274179837)
  • Name des Wertparameters für Enum.valueOf geändert (Ia9b89)
  • Mehr ausgelöste Ausnahmen von Aufzählung valueOf (I818fe)
  • GlanceAppWidget wurde aktualisiert, um provideGlance als Haupteinstiegspunkt zu verwenden. GlanceAppWidget.Content wurde eingestellt. (I202b5)
  • Option zum Bereitstellen einer Farbtonfarbe für Bilder (I26192, b/212418562)
  • Höhere Null-Zulässigkeit von Rückgabetypen für verworfene Funktionen, die ausgeblendet wurden. (Ibf7b0)
  • Anmerkung @JvmDefaultWithCompatibility hinzufügen (I8f206)
  • Die nicht verwendete SingleEntityTemplateData.displayHeader wurde entfernt. (I7f094)
  • Die Verwendung von Lambdas als Callbacks wird jetzt unterstützt (Ia0bbd).
  • DayNightColorProvider zum Glanz-Modul verschoben (I1842c, b/256934779)
  • Entfernt LocalColorProvider aus Vorlagen. Für Vorlagen wird jetzt GlanceTheme.colors (Ic15e2) verwendet
  • Null-Zulässigkeit aus Text(style: TextStyle) entfernt (I7123b, b/237012816)
  • Schwarz als Standardtextfarbe. Null-Zulässigkeit entfernen (I3072c, b/237012816)
  • Das dynamische Design ColorProviders wird als eigenes Objekt konfiguriert. ResourceColorProvider wird intern für das Modul erstellt. (Id0e2d, b/237012816)
  • Fügen Sie ImageSize die nicht definierte Kategorie hinzu. (I2fa39)
  • Verworfene GlanceAppWidget.Content-Funktion entfernen (Ib05f6)
  • Fügt AndroidRemoteViews einen Modifikator als Parameter hinzu. (I515d4)
  • Fügen Sie GlanceAppWidget.compose hinzu, um Unittests zu vereinfachen (Ie9b28)

Fehlerkorrekturen

  • Demo-Widget für Glance-Textschriftarten hinzugefügt (I5c3d7)
  • Vergrößert AndroidRemoteViews mit dem Modifikator
  • Probleme mit uneinheitlichen Designfarben behoben
  • Alle Ressourcen werden jetzt vorangestellt, um Konflikte zu vermeiden

Version 1.0.0-alpha05

5. Oktober 2022

androidx.glance:glance:1.0.0-alpha05, androidx.glance:glance-appwidget:1.0.0-alpha05 und androidx.glance:glance-wear-tiles:1.0.0-alpha05 wurden veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Neue Funktionen

  • Fügt requestPinGlanceAppWidget zu GlanceAppWidgetManager hinzu, damit Apps Nutzer dazu auffordern können, ihr auf einen Blick basiertes Widget zum Startbildschirm hinzuzufügen. (Ic6e47)
  • Dadurch wird ACTION_DEBUG_UPDATE zu GlanceAppWidgetReceiver hinzugefügt, damit Entwickler ein Update von ADB auf gerooteten Geräten und Emulatoren erzwingen können. (I94ae1)

API-Änderungen

  • Entfernen Sie Aktionsschaltflächen in der Kopfzeile aus Glance-Vorlagen, um den Anwendungsfall zu vereinfachen. (Ie4387)
  • Überarbeitete Vorlage für eine einzelne Entität zur Wiederverwendung des Block-Subsystemdesigns. (Iecd2c)
  • Überarbeitete Vorlage für Liste der Übersichten zur Verwendung desText/Image/Action-Blockdesigns. (If0cc1)
  • Fügen Sie einen Prioritätsnummernbereich für TextBlock und ImageBlock hinzu. (I73100)

Fehlerkorrekturen

  • Material3-Abhängigkeit entfernt. (I28d1c)
  • Bewegt sich in Richtung eines einheitlicheren Systems für das Hinzufügen von Rändern und Abständen in Layouts für Blickvorlagen. (I29773)
  • Es wurde eine fehlerhafte Proguard-Regel behoben, durch die das Erstellen minimierter Releases blockiert wurde.

Version 1.0.0-alpha04

10. August 2022

androidx.glance:glance:1.0.0-alpha04, androidx.glance:glance-appwidget:1.0.0-alpha04 und androidx.glance:glance-wear-tiles:1.0.0-alpha04 wurden veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Fügt Funktionen zum Einfärben von Schaltflächen hinzu.
  • Zur besseren Überprüfung der Kompilierungszeit wird die Anmerkung GlanceComposable hinzugefügt.
  • Dadurch werden Wear-spezifische Funktionen von „Glance“ hinzugefügt.

API-Änderungen

  • Glance Gallery Data API und komprimierte Ansicht aktualisieren. (Ibc7a8)
  • Fügt ButtonColors zum Konfigurieren von Schaltflächen hinzu. (Iea88d, b/236305351)
  • ColorProvider.resolve umbenennen in ColorProvider.getColor (Ic9dfe)
  • Fügt die Methode copy() zu TextStyle hinzu. (I9aef6)
  • Fügt eine ColorProviders-Klasse hinzu, die als Teil von Designs für Glance verwendet werden kann. (I848b9, b/237012816)
  • Unterstützung für Listenvorlagen zu Listenstilen und minimierter Ansicht hinzufügen. (I50cdc)
  • Fügen Sie GlanceModiier und GlanceCurvedModifier eine Semantik hinzu. (Ifda7e)
  • Füge die Anmerkung GlanceComposable hinzu. I5dbf0.
  • Verschiebt Glance-Vorlagen in das Glance-Hauptprojekt. (I9db94)
  • ColorProvider.resolve() hinzufügen (Ife532, b/214733442)
  • Neue Methode zum Abrufen von GlanceId aus einer vorhandenen appWidgetId oder einem Intent aus einer Konfigurationsaktivität (Icb70c, b/230391946)
  • Füge die Anmerkung GlanceComposable hinzu. (I2c21f)
  • GlanceRemoteViews zum Ausführen der Komposition außerhalb von GlanceAppWidget hinzugefügt. (I18f92)
  • Farbe in ProgressIndicatorDefaults entfernen. (I40299)
  • Benennen Sie die onRun-Methode von ActionCallback entsprechend dem Feedback zur API-Überprüfung aus Gründen der Konsistenz mit den öffentlichen APIs in onAction um. (ICFa57)
  • Layouts mit Blickvorlagen in eine Karte umwandeln (I46bfd)
  • Zusammensetzbare Funktion RadioButton hinzufügen (I4ecce)
  • GlanceWearTiles zum Erstellen von Bekleidungskacheln hinzugefügt (Ia9f65)
  • Anklickbar zu GlanceCurvedModifier hinzugefügt (Iec2a0)
  • Implementieren Sie CurvedRow als Bereich und erstellen Sie eine DSL, um normale zusammensetzbare und/oder gebogene Elemente hinzuzufügen. Außerdem wurden curvedLine und curvedSpacer hinzugefügt, die in Proto-Kacheln in ArcLine und ArcSpacer übersetzt werden (Ib955b).
  • Null-Zulässigkeit in Core und Appcompat für Tiramisu DP2 (I0cbb7) aktualisiert
  • Unterstützung für RuncallbackAction in Glanz-Wear-Kacheln hinzugefügt, derzeit wird nur RunCallbackAction mit NO-Parameter unterstützt (Ide64a)

Externer Beitrag

  • :compose:ui:ui-test api (updateApi) aufgrund der Migration von test-coroutines-lib aktualisiert (I3366d)

Version 1.0.0-alpha03

23. Februar 2022

androidx.glance:glance-*:1.0.0-alpha03 wird freigegeben. Version 1.0.0-alpha03 enthält diese Commits.

Neue Funktionen

  • Vereinfachte Statusdefinition zur Standardeinstellung „Einstellungen“.

API-Änderungen

  • Vereinfachen Sie die Statusverarbeitung, indem Sie PreferencesGlanceStateDefinition als Standardverarbeitung festlegen. GlanceAppWidget.updateAppWidgetState wurde entfernt und updateAppWidgetState eingeführt, das standardmäßig Preferences verwendet. (I58963)
  • „Glance TemplateText“-Klasse hinzufügen und Vorlagendesign aktualisieren (I4e146)
  • Damit wird die Umrissinfrastruktur für die Vorlage „Freies Format“ hinzugefügt (If03d6).
  • Aktualisierungen von SingleEntityTemplate-Layouts (If925d)
  • LazyVerticalGrid (I5f442) hinzugefügt
  • ColorProvider auf SingleEntityTemplate (I01ee0) verwenden
  • Name der Vorlagenklasse aktualisieren (I3720e)
  • Die zusammensetzbaren Funktionen LinearProgressIndicator und CircularProgressIndicator wurden hinzugefügt. (Ie116b)

Fehlerkorrekturen

  • Implementierung von Vorlagen auf dem ersten Blick, definiert Daten aus „Vorlage für einzelne Artikel“ und Beispiellayout (I35837)
  • Kachelraster standardmäßig zentrieren (I264be)
  • Fehlerkorrektur für „fillMaxSize/Width/Height“ in „look-wear-tiles“-Kacheln (I0a39f)

Version 1.0.0-alpha02

26. Januar 2022

androidx.glance:glance-*:1.0.0-alpha02 wird freigegeben. Version 1.0.0-alpha02 enthält diese Commits.

Neue Funktionen

Dieser Release enthält die APIs zum Erstellen von Wear-Kacheln mithilfe der Compose-Laufzeit mit zusammensetzbaren Funktionen, die für „Glanceable“ optimiert sind

  • Deklarieren Sie Ihren Kacheldienst, indem Sie GlanceTileService erweitern, einen Dienst zum Erstellen der Kachel in der Funktion „Zusammensetzbare Content()“.
  • Mit diesen zusammensetzbaren Funktionen kannst du Kacheln auf einen Blick erstellen: CurvedRow, CurvedText.
  • Definiere TimelineMode.SingleEntry und TimelineMode.TimeBoundEntries, um verschiedene Zeitachsenmodi für Kacheln zu verwalten.
  • LocalTimeInterval bezieht sich die lokale Zusammensetzung auf ein bestimmtes Zeitintervall.
  • BorderModifer ist ein GlanceModifier, mit dem ein Rahmen um ein Element angewendet wird.

In dieser Version werden auch Fortschrittsanzeigen zu AppWidget Glance hinzugefügt.

API-Änderungen

  • Die zusammensetzbaren Funktionen LinearProgressIndicator und CircularProgressIndicator wurden hinzugefügt. (Ie116b)
  • actionStartBroadcastReceiver zu actionSendBroadcast (I7d555) ändern
  • Kontext an den onDelete-Callback GlanceAppWidget übergeben (I4c795)

Fehlerkorrekturen

  • OPTIONS_APPWIDGET_SIZES wird korrekt verarbeitet, wenn es vorhanden, aber leer ist. (I01f82)

Version 1.0.0-alpha01

15. Dezember 2021

androidx.glance:glance:1.0.0-alpha01, androidx.glance:glance-appwidget:1.0.0-alpha01 und androidx.glance:glance-appwidget-proto:1.0.0-alpha01 wurden veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Funktionen in der ersten Version

  • Die erste Version von Glance enthält die ersten APIs zum Erstellen von AppWidget unter Verwendung von Compose Runtime mit einer Reihe neuer zusammensetzbarer Funktionen, die für „Glanceables“ optimiert sind.

Funktionen