Aktivität

Aktivität

Nutzerhandbuch

API-Referenz
androidx.activity

Auf kombinierbare APIs zugreifen, die auf Aktivitäten basieren

Letzte Aktualisierung	Stabile Version	Releasekandidat	Beta-Ausgabe	Alphaversion
4. Juni 2025	1.10.1	1.11.0-rc01	-	1.12.0-alpha02

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von Activity hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die erforderlichen Artefakte hinzu:

Cool

dependencies {
    def activity_version = "1.10.1"

    // Java language implementation
    implementation "androidx.activity:activity:$activity_version"
    // Kotlin
    implementation "androidx.activity:activity-ktx:$activity_version"
}

Kotlin

dependencies {
    val activity_version = "1.10.1"

    // Java language implementation
    implementation("androidx.activity:activity:$activity_version")
    // Kotlin
    implementation("androidx.activity:activity-ktx:$activity_version")
}

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

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einem vorhandenen Problem Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.12

Version 1.12.0-alpha02

4. Juni 2025

androidx.activity:activity:1.12.0-alpha02, androidx.activity:activity-compose:1.12.0-alpha02 und androidx.activity:activity-ktx:1.12.0-alpha02 sind freigegeben. Version 1.12.0-alpha02 enthält diese Commits.

Fehlerkorrekturen

• NavigationEvent 1.0.0-alpha02: Behoben wurde ein ConcurrentModificationException, der beim Aufrufen von NavigationEventCallback.remove() auftreten konnte, wenn gleichzeitig die interne Liste der Closeable-Elemente geändert wurde. (I63066)

Version 1.12.0-alpha01

20. Mai 2025

androidx.activity:activity:1.12.0-alpha01, androidx.activity:activity-compose:1.12.0-alpha01 und androidx.activity:activity-ktx:1.12.0-alpha01 sind freigegeben. Version 1.12.0-alpha01 enthält diese Commits.

Neue Funktionen

• ComponentActivity und ComponentDialog wurden über die NavigationEventDispatcherOwner API in NavigationEvent 1.0.0-alpha01 eingebunden. Sie können jetzt über das Feld navigationEventDispatcher eine NavigationEventDispatcher aus Ihrer ComponentActivity abrufen. Da die OnBackPressedDispatcher auf der neuen Bibliothek neu geschrieben wurde, sollten alle bisherigen Verwendungen weiterhin ordnungsgemäß funktionieren. Sie sollten in Zukunft NavigationEventDispatcher und NavigationEventCallback verwenden. (Ib8eed, I6cc44, Ib7724, I9a0f7,b/412597031, b/415028038, b/412596729, b/412597140, b/412596012)

Version 1.11

Version 1.11.0-rc01

23. April 2025

androidx.activity:activity:1.11.0-rc01, androidx.activity:activity-compose:1.11.0-rc01 und androidx.activity:activity-ktx:1.11.0-rc01 sind freigegeben. Version 1.11.0-rc01 enthält diese Commits.

Version 1.11.0-beta01

9. April 2025

androidx.activity:activity:1.11.0-beta01, androidx.activity:activity-compose:1.11.0-beta01 und androidx.activity:activity-ktx:1.11.0-beta01 sind freigegeben. Version 1.11.0-beta01 enthält diese Commits.

Version 1.11.0-alpha02

26. März 2025

androidx.activity:activity:1.11.0-alpha02, androidx.activity:activity-compose:1.11.0-alpha02 und androidx.activity:activity-ktx:1.11.0-alpha02 sind freigegeben. Version 1.11.0-alpha02 enthält diese Commits.

API-Änderungen

• Die neuen EDGE_NONE und frameTimeMillis aus Android 16 Beta03 wurden in die BackEventCompat integriert, die von den handleOnBackStarted- und handleOnBackProgressed-Funktionen von OnBackPressedCallback bereitgestellt wird.

Abhängigkeitsupdates

• Aktivitäten werden jetzt mit API 36 kompiliert. (I510e8, b/301910674)

Version 1.11.0-alpha01

12. März 2025

androidx.activity:activity:1.11.0-alpha01, androidx.activity:activity-compose:1.11.0-alpha01 und androidx.activity:activity-ktx:1.11.0-alpha01 sind freigegeben. Version 1.11.0-alpha01 enthält diese Commits.

Neue Funktionen

• PickVisualMediaRequest hat die MediaCapabilities API hinzugefügt, damit Apps ihre Medienfunktionen angeben können, z. B. unterstützte HDR-Typen. (Ic3ee7)

Version 1.10

Version 1.10.1

26. Februar 2025

androidx.activity:activity:1.10.1, androidx.activity:activity-compose:1.10.1 und androidx.activity:activity-ktx:1.10.1 sind freigegeben. Version 1.10.1 enthält diese Commits.

Fehlerkorrekturen

• ViewTree, OnBackPressedDispatcherOwners und FullyDrawnReporterOwners können jetzt über nicht übereinstimmende übergeordnete Elemente einer Ansicht aufgelöst werden, z. B. über ein ViewOverlay. Weitere Informationen zu Elternelementen mit nicht übereinstimmenden Ansichten finden Sie in den Versionshinweisen von Core oder in der Dokumentation unter ViewTree.setViewTreeDisjointParent. (Ie7750)

Version 1.10.0

15. Januar 2025

androidx.activity:activity:1.10.0, androidx.activity:activity-compose:1.10.0 und androidx.activity:activity-ktx:1.10.0 sind freigegeben. Version 1.10.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.9.0

• Unter PhotoPicker können Sie jetzt Bilder in der gewünschten Reihenfolge auswählen und festlegen, welcher Tab (Alben oder Bilder) zuerst angezeigt werden soll.
• Die Aktivitätsergebnisverträge PickVisualMedia und PickMultipleVisualMedia, die die Bildauswahl auslösen, werden nicht mehr direkt an Google Play-Dienste delegiert, wenn die Bildauswahl des Systems nicht verfügbar ist. Stattdessen wird die öffentliche Aktion ACTION_SYSTEM_FALLBACK_PICK_IMAGES und die zugehörigen Extras verwendet, um OEMs und System-Apps als Fallback eine einheitliche Bildauswahl zur Verfügung zu stellen.
• Neue lokale LocalActivity-Komposition, die die Activity für den aktuellen Umfang bereitstellt. Entwickler müssen also keine Activity mehr von der LocalContext abrufen.

Version 1.10.0-rc01

11. Dezember 2024

androidx.activity:activity:1.10.0-rc01, androidx.activity:activity-compose:1.10.0-rc01 und androidx.activity:activity-ktx:1.10.0-rc01 sind freigegeben. Version 1.10.0-rc01 enthält diese Commits.

Fehlerkorrekturen

• Ein Problem wurde behoben, bei dem der Callback sofort beendet wurde, wenn der aktivierte Status geändert wurde, während PredictiveBackHandler aktiv war. Der aktuelle Rückruf wird jetzt unabhängig von den Änderungen am aktivierten Status beendet. (Ib8719)

Version 1.10.0-beta01

13. November 2024

androidx.activity:activity:1.10.0-beta01, androidx.activity:activity-compose:1.10.0-beta01 und androidx.activity:activity-ktx:1.10.0-beta01 wurden ohne Änderungen seit der letzten Alphaversion veröffentlicht. Version 1.10.0-beta01 enthält diese Commits.

Version 1.10.0-alpha03

30. Oktober 2024

androidx.activity:activity:1.10.0-alpha03, androidx.activity:activity-compose:1.10.0-alpha03 und androidx.activity:activity-ktx:1.10.0-alpha03 sind freigegeben. Version 1.10.0-alpha03 enthält diese Commits.

API-Änderungen

• Es wurde eine neue lokale LocalActivity-Komposition hinzugefügt, die die Activity für den aktuellen Umfang bereitstellt. Entwickler müssen also nicht mehr eine Activity aus der LocalContext abrufen. Außerdem gibt es eine neue Lint-Regel, die prüft, ob die LocalContext fälschlicherweise in eine Activity umgewandelt wird. (I7746a, b/283009666)

Fehlerkorrekturen

• Von Aktivität 1.9.3: PredictiveBackHandler löst seinen Rückruf nicht mehr aus, nachdem der Handler deaktiviert wurde. Dadurch wird ein Problem behoben, bei dem die NavHost aus Navigation Compose eine IndexOutOfBoundsException auslöste. (I3f75e, b/365027664, b/340202286)

Abhängigkeitsupdate

• Activity Compose ist jetzt von Compose Runtime 1.7.0 (I7746a, b/283009666) abhängig.

Version 1.10.0-alpha02

4. September 2024

androidx.activity:activity:1.10.0-alpha02, androidx.activity:activity-compose:1.10.0-alpha02 und androidx.activity:activity-ktx:1.10.0-alpha02 sind freigegeben. Version 1.10.0-alpha02 enthält diese Commits.

Verhaltensänderungen

• Die Aktivitätsergebnisverträge PickVisualMedia und PickMultipleVisualMedia, die die Bildauswahl auslösen, werden nicht mehr direkt an Google Play-Dienste delegiert, wenn die Bildauswahl des Systems nicht verfügbar ist. Stattdessen wird die öffentliche Aktion ACTION_SYSTEM_FALLBACK_PICK_IMAGES und die zugehörigen Extras verwendet, um OEMs und System-Apps als Fallback eine einheitliche Bildauswahl zur Verfügung zu stellen. Auf Geräten mit einer aktuellen Version der Google Play-Dienste sollte sich das nicht bemerkbar machen. (I3513d)

Fehlerkorrekturen

• Die manuelle Kennzeichnung des Zugriffs auf neue Plattform-APIs wurde entfernt, da dies bei Verwendung von R8 mit AGP 7.3 oder höher (z.B. R8 Version 3.3) und für alle Builds bei Verwendung von AGP 8.1 oder höher (z.B. D8 Version 8.1) automatisch über die API-Modellierung erfolgt. Kunden, die AGP nicht verwenden, wird empfohlen, auf D8 Version 8.1 oder höher zu aktualisieren. Weitere Details findest du in diesem Artikel. (I9496c, b/345472586)
• Aktivitäten: Es wurde ein Problem behoben, bei dem die Activity Compose PredictiveBackHandler API die Systemgeste „Zurück“ weiterhin für den Frame verarbeitete, in dem sie deaktiviert wurde. Dies konnte dazu führen, dass Bibliotheken wie Navigation Compose „Zurück“ auch bei einem leeren Rückstapel verarbeiten, was eine IndexOutOfBoundsException auslöste.1.9.2 (Ie3301, b/340202286)
• Unter Aktivitäten 1.9.1: Es wurde ein Problem mit PredictiveBackHandler behoben, bei dem nach dem Zurücksetzen des Systems der Versuch, onBackPressed über die OnBackPressedDispatcher auszuführen, fehlgeschlagen ist. (I5f1f8)

Version 1.10.0-alpha01

26. Juni 2024

androidx.activity:activity:1.10.0-alpha01, androidx.activity:activity-compose:1.10.0-alpha01 und androidx.activity:activity-ktx:1.10.0-alpha01 sind freigegeben. Diese Version wird in einem internen Branch entwickelt.

Neue Funktionen

• Unterstützung für neue PhotoPicker-Funktionen hinzugefügt, die in Android V eingeführt wurden, z. B. die Möglichkeit, Bilder in einer bestimmten Reihenfolge auszuwählen und festzulegen, welcher Tab (Alben oder Bilder) zuerst angezeigt werden soll.

Version 1.9

Version 1.9.3

16. Oktober 2024

androidx.activity:activity:1.9.3, androidx.activity:activity-compose:1.9.3 und androidx.activity:activity-ktx:1.9.3 sind freigegeben. Version 1.9.3 enthält diese Commits.

Fehlerkorrekturen

• PredictiveBackHandler löst nach der Deaktivierung des Handlers keinen Rückruf mehr aus. Dadurch wird ein Problem behoben, bei dem die NavHost aus Navigation Compose eine IndexOutOfBoundsException auslöste. (I3f75e, b/340202286)

Version 1.9.2

4. September 2024

androidx.activity:activity:1.9.2, androidx.activity:activity-compose:1.9.2 und androidx.activity:activity-ktx:1.9.2 sind freigegeben. Version 1.9.2 enthält diese lthcocommits.

Fehlerkorrekturen

• Ein Problem wurde behoben, durch das die Activity Compose PredictiveBackHandler API die Systemgeste „Zurück“ weiterhin für den Frame verarbeitete, in dem sie deaktiviert wurde. Dies konnte dazu führen, dass Bibliotheken wie Navigation Compose „Zurück“ auch bei einem leeren Rückstapel verarbeiten, was eine IndexOutOfBoundsException auslöste. (Ie3301, b/340202286)

Version 1.9.1

24. Juli 2024

androidx.activity:activity:1.9.1, androidx.activity:activity-compose:1.9.1 und androidx.activity:activity-ktx:1.9.1 sind freigegeben. Version 1.9.1 enthält diese Commits.

Fehlerkorrekturen

• Ein Problem mit PredictiveBackHandler wurde behoben, bei dem nach dem Zurücksetzen des Systems der Versuch, onBackPressed über die OnBackPressedDispatcher auszuführen, fehlgeschlagen ist. (I5f1f8)

Version 1.9.0

17. April 2024

androidx.activity:activity:1.9.0, androidx.activity:activity-compose:1.9.0 und androidx.activity:activity-ktx:1.9.0 sind freigegeben. Version 1.9.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.8.0

• ComponentActivity implementiert jetzt OnUserLeaveHintProvider, um Komponenten Callbacks für onUserLeaveHint-Ereignisse zu ermöglichen.
• Die OnBackPressedCallback-, BackHandler- und PredictiveBackHandler-APIs warnen jetzt beim Aufrufen von onBackPressedDispatcher.onBackPressed() beim Zurückgehen, da dadurch die vorhersagende Rückwärtsanimation immer unterbrochen wird. Weitere Informationen finden Sie im Best Practices-Leitfaden.
• Der Rest der Activity APIs wurde in Kotlin neu geschrieben und alle Erweiterungen, die zuvor in activity-ktx verfügbar waren, wurden zu activity verschoben. activity-ktx ist jetzt vollständig leer.
  • Im Rahmen der Umwandlung von ActivityResultLauncher in Kotlin ist die Methode getContract jetzt eine abstrakte Kotlin-Eigenschaft. Diese Änderung ist binärkompatibel, führt aber zu Fehlern in der Quelle, wenn Ihre Implementierung von ActivityResultLauncher in Kotlin geschrieben ist.

Version 1.9.0-rc01

3. April 2024

androidx.activity:activity:1.9.0-rc01, androidx.activity:activity-compose:1.9.0-rc01 und androidx.activity:activity-ktx:1.9.0-rc01 sind freigegeben. Version 1.9.0-rc01 enthält diese Commits.

Update der Abhängigkeiten

• Die Aktivität hängt jetzt vom Profile Installer 1.3.1 ab.

Version 1.9.0-beta01

20. März 2024

androidx.activity:activity:1.9.0-beta01, androidx.activity:activity-compose:1.9.0-beta01 und androidx.activity:activity-ktx:1.9.0-beta01 sind freigegeben. Version 1.9.0-beta01 enthält diese Commits.

Fehlerkorrekturen

• Behoben wurde eine Leistungsverschlechterung beim Starten von Aktivitäten, die bei Aktivität 1.9.0-alpha02 aufgetreten ist, weil die OnBackPressedDispatcher beim Erstellen der Aktivität aufgerufen wurde. (Ie75e3)

Version 1.9.0-alpha03

7. Februar 2024

androidx.activity:activity:1.9.0-alpha03, androidx.activity:activity-compose:1.9.0-alpha03 und androidx.activity:activity-ktx:1.9.0-alpha03 sind freigegeben. Version 1.9.0-alpha03 enthält diese Commits.

Lint-Warnung

• Die OnBackPressedCallback-, BackHandler- und PredictiveBackHandler-APIs warnen jetzt beim Aufrufen von onBackPressedDispatcher.onBackPressed() beim Zurückgehen, da dadurch die vorhersagende Rückwärtsanimation immer unterbrochen wird. Weitere Informationen finden Sie im Best Practices-Leitfaden. (1e4222, 2c950d, b/287505200)

Fehlerkorrekturen

• Wenn ein Zurück-Ereignis vom System gesendet wird, während eine bereits laufende Touch-Geste für die Vorhersage der Rückwärtsbewegung ausgeführt wird, wird die aktuell laufende Touch-Geste für die Vorhersage der Rückwärtsbewegung abgebrochen und das neue Zurück-Ereignis übernimmt, um eine neue Touch-Geste für die Vorhersage der Rückwärtsbewegung zu starten. (I3482e)
• Ein Absturz beim ersten Zugriff auf die onBackPressedDispatcher über eine ComponentActivity über einen Hintergrund-Thread wurde behoben. Es ist jetzt möglich, in jedem Thread auf die onBackPressedDispatcher zuzugreifen. (I79955)

Version 1.9.0-alpha02

24. Januar 2024

androidx.activity:activity:1.9.0-alpha02, androidx.activity:activity-compose:1.9.0-alpha02 und androidx.activity:activity-ktx:1.9.0-alpha02 sind freigegeben. Version 1.9.0-alpha02 enthält diese Commits.

Kotlin-Conversions

• ActivityResultRegistry wurde in Kotlin neu geschrieben. So wird sichergestellt, dass die Nullbarkeit der Gattungen im Vertrag, der an register übergeben wird, korrekt an die ActivityResultLauncher übergeben wird, die an Sie zurückgegeben wird. (I121f0)
• ActivityResult wurde in Kotlin neu geschrieben. Die ActivityResult-Kotlin-Erweiterungen, die die Destrukturierung in die Felder resultCode und data unterstützen, wurden von activity-ktx zu activity verschoben. (I0565a)
• Die Kotlin-Erweiterungen von by viewModels() für ComponentActivity und trackPipAnimationHintView wurden von activity-ktx zu activity verschoben. Das activity-ktx-Artefakt ist jetzt vollständig leer. (I0a444)

Fehlerkorrekturen

• Die enableEdgeToEdge API zeichnet jetzt um alle Displayausschnitte herum. (a3644b, b/311173461)
• Aktivität 1.8.2: Das Extra, das an ACTION_SYSTEM_FALLBACK_PICK_IMAGES des Aktivitätsvertrags für die Bildauswahl übergeben wurde, wurde korrigiert, damit der Schlüssel EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX korrekt übergeben wird."com.google.android.gms.provider.extra.PICK_IMAGES_MAX" OEMs, die eine systemeigene Bildauswahl implementieren, wird dringend empfohlen, beide Extras zu unterstützen, um die größtmögliche Kompatibilität zu gewährleisten. (I96a00)

Version 1.9.0-alpha01

29. November 2023

androidx.activity:activity:1.9.0-alpha01, androidx.activity:activity-compose:1.9.0-alpha01 und androidx.activity:activity-ktx:1.9.0-alpha01 sind freigegeben. Version 1.9.0-alpha01 enthält diese Commits.

Neue Funktionen

• ComponentActivity implementiert jetzt OnUserLeaveHintProvider, um Komponenten Callbacks für onUserLeaveHint-Ereignisse zu ermöglichen. (I54892)

API-Änderungen

• ComponentActivity wurde in Kotlin neu geschrieben. (I14f31)
• ActivityResultCaller wurde in Kotlin neu geschrieben. (Ib02e4)
• ActivityResultLauncher wurde in Kotlin neu geschrieben. Im Rahmen dieser Umstellung ist die getContract-Methode jetzt ein abstraktes Kotlin-Attribut. Diese Änderung ist binärkompatibel, führt aber zu Fehlern in der Quelle, wenn Ihre Implementierung von ActivityResultLauncher in Kotlin geschrieben ist. (Id4615)
• PickVisualMediaRequest hat jetzt dasselbe Mindest-API-Level 19 wie der PickVisualMedia-Aktivitätsergebnisvertrag. (Id6e21)

Abhängigkeitsupdate

• Die Aktivität hängt jetzt von Core 1.13.0-alpha01 ab. (I14f31)

Version 1.8

Version 1.8.2

13. Dezember 2023

androidx.activity:activity:1.8.2, androidx.activity:activity-compose:1.8.2 und androidx.activity:activity-ktx:1.8.2 sind freigegeben. Version 1.8.2 enthält diese Commits.

Fehlerkorrekturen

• Das Extra, das an ACTION_SYSTEM_FALLBACK_PICK_IMAGES des Aktivitätsvertrags für die Bildauswahl übergeben wurde, wurde korrigiert, damit der Schlüssel EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX statt "com.google.android.gms.provider.extra.PICK_IMAGES_MAX" verwendet wird. OEMs, die eine systemeigene Bildauswahl implementieren, wird dringend empfohlen, beide Extras zu unterstützen, um die größtmögliche Kompatibilität zu gewährleisten. (I96a00)

Version 1.8.1

15. November 2023

androidx.activity:activity:1.8.1, androidx.activity:activity-compose:1.8.1 und androidx.activity:activity-ktx:1.8.1 sind freigegeben. Version 1.8.1 enthält diese Commits.

Fehlerkorrekturen

• OnBackPressedDispatcher sendet jetzt weiterhin an die richtige OnBackPressedCallback, auch wenn eine neue OnBackPressedCallback hinzugefügt wird, während die Zurück-Geste verarbeitet wird. (Id0ff6)

Version 1.8.0

4. Oktober 2023

androidx.activity:activity:1.8.0, androidx.activity:activity-compose:1.8.0 und androidx.activity:activity-ktx:1.8.0 sind freigegeben. Version 1.8.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.7.0

• Intelligente „Zurück“-Touch-Geste: Die OnBackPressedCallback bietet jetzt neue Rückruffunktionen für die intelligente „Zurück“-Touch-Geste, um den Beginn, den Fortschritt und die Abbruch der Geste zu steuern. Außerdem gibt es den bisherigen handleOnBackPressed()-Rückruf, der ausgeführt wird, wenn die Geste ausgeführt wird. Außerdem ist das PredictiveBackHandler-Kompositelement enthalten, mit dem Vorhersageereignisse für die Zurück-Geste in der Aktivitätszusammenstellung verarbeitet werden können. Es stellt einen Stream von BackEventCompat-Objekten bereit, die in der von Ihnen bereitgestellten suspendierenden Lambda-Funktion erfasst werden müssen:

  PredictiveBackHandler { progress: Flow<BackEventCompat> ->
    // code for gesture back started
    try {
      progress.collect { backEvent ->
      // code for progress
    }
    // code for completion
    } catch (e: CancellationException) {
      // code for cancellation
    }
  }

ComponentActivity.onBackPressed() wurde zugunsten der APIs für die Rückgabe eingestellt. Entwickler sollten jetzt OnBackPressedDispatcher verwenden, anstatt diese Methode zu überschreiben.

• EdgeToEdge: ComponentActivity.enableEdgeToEdge() wurde hinzugefügt, um das randlose Display auf abwärtskompatible Weise einzurichten.

Version 1.8.0-rc01

20. September 2023

androidx.activity:activity:1.8.0-rc01, androidx.activity:activity-compose:1.8.0-rc01 und androidx.activity:activity-ktx:1.8.0-rc01 sind freigegeben. Version 1.8.0-rc01 enthält diese Commits.

Version 1.8.0-beta01

6. September 2023

androidx.activity:activity:1.8.0-beta01, androidx.activity:activity-compose:1.8.0-beta01 und androidx.activity:activity-ktx:1.8.0-beta01 sind freigegeben. Version 1.8.0-beta01 enthält diese Commits.

Verbesserung der Dokumentation

• Die Dokumentation von BackEventCompat wurde verbessert. (aosp/2722254)

Version 1.8.0-alpha07

23. August 2023

androidx.activity:activity:1.8.0-alpha07, androidx.activity:activity-compose:1.8.0-alpha07 und androidx.activity:activity-ktx:1.8.0-alpha07 sind freigegeben. Version 1.8.0-alpha07 enthält diese Commits.

Neue Funktionen

• Für „Activity Compose“ wurde ein neuer PredictiveBackHandler-Komposit hinzugefügt, um Ereignisse für die Vorhersage von Zurück-Gesten zu verarbeiten. Sie enthält eine Flow von BackEventCompat Objekten, die in der von Ihnen angegebenen Lambda-Funktion für die Aussetzung erfasst werden müssen:

  PredictiveBackHandler { progress: Flow<BackEventCompat> ->
    // code for gesture back started
    try {
      progress.collect { backEvent ->
      // code for progress
    }
    // code for completion
    } catch (e: CancellationException) {
      // code for cancellation
    }
  }
  

  Außerdem wird über eine Lint-Regel eine Warnung zur Kompilierzeit ausgegeben, um sicherzustellen, dass Flow collect() aufruft. (Id2773, b/294884345)

• Die onBackPressedDispatcher in ComponentActivity wird jetzt verzögert initialisiert, sodass sie nur bei Bedarf erstellt wird. (I0bf8e)

Fehlerkorrekturen

• ComponentActivity zeigt unter Android 13 keine NPE mehr an, wenn es einen onBackPressed()-Callback erhält und die Aktivität bereits DESTROYED wurde. (Idb055, b/291869278)
• Verwendungen der experimentellen isAtLeastU() API entfernt (Ie9117, b/289269026)

Version 1.8.0-alpha06

21. Juni 2023

androidx.activity:activity:1.8.0-alpha06, androidx.activity:activity-compose:1.8.0-alpha06 und androidx.activity:activity-ktx:1.8.0-alpha06 sind freigegeben. Version 1.8.0-alpha06 enthält diese Commits.

Neue Funktionen

• Die OnBackPressedDispatcher bricht jetzt alle Rückruffunktionen korrekt ab, die während einer vorrausschauenden Rückwärtsgeste entfernt werden. (I3f90f)

API-Änderungen

• Wenn du SystemBarStyle.auto an die enableEdgeToEdge API übergibst, kannst du jetzt den Lambda-Parameter detectDarkMode überschreiben, um benutzerdefinierte Logik für die Erkennung des Nachtmodus anzugeben. (aosp/2546393, b/278263793)

Version 1.8.0-alpha05

7. Juni 2023

androidx.activity:activity:1.8.0-alpha05, androidx.activity:activity-compose:1.8.0-alpha05 und androidx.activity:activity-ktx:1.8.0-alpha05 sind freigegeben. Diese Version wird in einem internen Branch entwickelt.

Hinweis: Diese Version kann nur mit dem Android 14 (Upside Down Cake) Beta 1 SDK oder höher kompiliert werden.

API-Änderungen

• Für „Aktivität“ gibt es jetzt eine BackEventCompat-Klasse, die als abwärtskompatible Version von BackEvent dient und von der Framework-Klasse BackEvent getrennt ist.
• Bruchänderung:Die Methoden handleOnBackStarted und handleOnBackProgressed von OnBackPressedCallback erhalten jetzt eine androidx.activity.BackEventCompat-Instanz anstelle einer Framework-Klasse android.window.BackEvent. Die entsprechenden @VisibleForTesting APIs auf OnBackPressedDispatcher wurden ebenfalls aktualisiert.
• Der Konstruktor für OnBackPressedDispatcher nimmt jetzt eine optionale Consumer<Boolean>-Instanz an, mit der die Eigentümer des Dispatchers einen Rückruf erhalten, wenn sich die Anzahl der aktivierten Rückrufe von null zu einem anderen Wert oder umgekehrt ändert.

Fehlerkorrekturen

• Unter Aktivität 1.7.2: ReportDrawn stürzt nicht mehr ab, wenn ein Bildschirm verlassen wird, bevor report aufgerufen wird. (Ic46f1, b/260506820)

Version 1.8.0-alpha04

10. Mai 2023

androidx.activity:activity:1.8.0-alpha04, androidx.activity:activity-compose:1.8.0-alpha04 und androidx.activity:activity-ktx:1.8.0-alpha04 sind freigegeben. Diese Version wurde aus einem internen Branch veröffentlicht.

Hinweis :Diese Version kann nur mit dem SDK für Android 14 (Upside Down Cake) Beta 2 kompiliert werden.

Fehlerkorrekturen

• Aktivität 1.7.1: ReportFullyDrawExecuter wird nicht mehr bei Verwendung von ComponentActivity mit ActivityScenario gesendet. (Id2ff2, b/277434271)

Version 1.8.0-alpha03

12. April 2023

androidx.activity:activity:1.8.0-alpha03, androidx.activity:activity-compose:1.8.0-alpha03 und androidx.activity:activity-ktx:1.8.0-alpha03 sind freigegeben. Diese Version wurde aus einem internen Branch veröffentlicht.

Hinweis: Diese Version kann nur mit dem SDK für Android 14 (Upside Down Cake) Beta 1 kompiliert werden.

Neue Funktionen

• ComponentActivity.setUpEdgeToEdge() wurde hinzugefügt, um das randlose Display auf einfache Weise und abwärtskompatibel einzurichten.

API-Änderungen

• ComponentActivity.onBackPressed() wurde zugunsten der APIs für die Rückgabe eingestellt. Entwickler sollten jetzt OnBackPressedDispatcher verwenden, anstatt diese Methode zu überschreiben. (Ibce2f, b/271596918)
• ComponentDialog und ComponentActivity enthalten jetzt die öffentliche API initViewTreeOwners(), mit der alle Eigentümer des Ansichtsbaums initialisiert werden, bevor die Inhaltsansicht festgelegt wird. (Ibdce0, b/261314581)

Fehlerkorrekturen

• Behoben: Fragmente haben Menühosts fälschlicherweise ungültig gemacht und zu unerwartetem Verhalten anderer Menüs in der Aktivität geführt. (I9404e, b/244336571)

Weitere Änderungen

• Für die ActivityResultRegister wird jetzt Kotlin Random anstelle von Java verwendet. (I4d98f, b/272096025)

Version 1.8.0-alpha02

8. März 2023

androidx.activity:activity:1.8.0-alpha02, androidx.activity:activity-compose:1.8.0-alpha02 und androidx.activity:activity-ktx:1.8.0-alpha02 sind freigegeben. Entwickelt aus einem internen Branch.

Hinweis :Diese Version kann nur mit dem SDK der Entwicklervorschau 2 von Android 14 (Upside Down Cake) kompiliert werden.

Update der Abhängigkeiten

• Von Aktivität 1.7.0-rc01: Die Aktivität hängt jetzt von Lifecycle 2.6.0 ab.

Version 1.8.0-alpha01

8. Februar 2023

androidx.activity:activity:1.8.0-alpha01, androidx.activity:activity-compose:1.8.0-alpha01 und androidx.activity:activity-ktx:1.8.0-alpha01 sind freigegeben. Diese Version wurde aus einem internen Branch erstellt.

Hinweis: Diese Version kann nur mit dem SDK der Entwicklervorschau 1 von Android 14 (Upside Down Cake) kompiliert werden.

Neue Funktionen

• Die Klasse OnBackPressedCallback enthält jetzt neue Rückwärts-Callbacks für die Vorhersage, um den Beginn, den Fortschritt und die Abbruch der Rückwärtsgeste zu verarbeiten. Außerdem gibt es den vorherigen handleOnBackPressed()-Callback, der ausgeführt wird, wenn die Rückwärtsgeste ausgeführt wird.

Version 1.7

Version 1.7.2

24. Mai 2023

androidx.activity:activity:1.7.2, androidx.activity:activity-compose:1.7.2 und androidx.activity:activity-ktx:1.7.2 sind freigegeben. Version 1.7.2 enthält diese Commits.

Fehlerkorrekturen

• Behebung eines Absturzes von ReportDrawn, wenn ein Bildschirm verlassen wird, bevor report aufgerufen wird. (Ic46f1, b/260506820)

Version 1.7.1

19. April 2023

androidx.activity:activity:1.7.1, androidx.activity:activity-compose:1.7.1 und androidx.activity:activity-ktx:1.7.1 sind freigegeben. Version 1.7.1 enthält diese Commits.

Fehlerkorrekturen

• Die ReportFullyDrawExecuter leckt nicht mehr, wenn ComponentActivity mit ActivityScenario verwendet wird. (Id2ff2, b/277434271)

Version 1.7.0

22. März 2023

androidx.activity:activity:1.7.0, androidx.activity:activity-compose:1.7.0 und androidx.activity:activity-ktx:1.7.0 sind freigegeben. Version 1.7.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.6.0

• Die Aktivitätsverträge für die Bildauswahl in PickVisualMedia und PickMultipleVisualMedia wurden aktualisiert und enthalten jetzt einen zusätzlichen Fallback für den Fall, dass MediaStore.ACTION_PICK_IMAGES nicht verfügbar ist. So können OEMs und System-Apps wie Google Play-Dienste die Bildauswahl auf einer größeren Auswahl von Android-Geräten und API-Levels konsistent bereitstellen, indem sie die Fallback-Aktion implementieren. Die Bildauswahl verwendet diesen Fallback, wenn er verfügbar ist, bevor auf Intent.ACTION_OPEN_DOCUMENT zurückgegriffen wird, die weiterhin für alle Geräte mit API 19 und höher unterstützt wird.
• ComponentDialog implementiert jetzt SavedStateRegistryOwner und hat Zugriff auf seine eigene SavedStateRegistry und legt die SavedStateRegistryOwner für seine ViewTree fest. Jetpack Compose kann jetzt in einem ComponentDialog verwendet werden, da es sowohl die LifecycleOwner als auch die SavedStateRegistryOwner erfüllt, die über die ViewTree APIs an das Fenster angehängt sind.
• Mit IntentSenderRequest.Builder.setFlags() können Sie jetzt mehrere Flags aus Intent festlegen, anstatt nur ein einzelnes.

Kotlin-Konvertierung

Einige Aktivitätsklassen wurden in Kotlin konvertiert. Alle konvertierten Klassen behalten ihre binäre Kompatibilität mit früheren Versionen bei. Bei den folgenden Klassen wurden nicht mit der Quelle kompatible Änderungen an Klassen vorgenommen, die in Kotlin geschrieben wurden: ActivityResultRegistryOwner, OnBackPressedDispatcherOwner.

In der folgenden Tabelle finden Sie die Quell-Conversions für die neue Version von „Aktivitäten“:

Aktivität 1.5	Aktivität 1.6
override fun getActivityResultRegistry() = activityResultRegistry	override val activityResultRegistry = activityResultRegistry
override fun getOnBackPressedDispatcher() = onBackPressedDispatcher	override val onBackPressedDispatcher = onBackPressedDispatcher

Diese Klassen wurden ebenfalls in Kotlin konvertiert, sind aber weiterhin mit der Quelle kompatibel: ContextAware, ContextAwareHelper, OnContextAvailableListener, IntentSenderRequest und OnBackPressedDispatcher

FullyDrawnReporter APIs

ComponentActivity bietet jetzt eine FullyDrawnReporter-Instanz, mit der mehrere Komponenten melden können, wenn sie für die Interaktion bereit sind. ComponentActivity wartet, bis alle Komponenten abgeschlossen sind, bevor reportFullyDrawn() in Ihrem Namen aufgerufen wird. Diese APIs übernehmen die Zeitanforderungen für Sie und müssen nicht im Rahmen eines onDraw-Aufrufs aufgerufen werden.

Wir empfehlen, die folgenden APIs zu aktivieren:

• Die Android Runtime wird benachrichtigt, wenn der Start abgeschlossen ist, damit der gesamte Code, der während einer Startsequenz mit mehreren Frames ausgeführt wird, berücksichtigt und für die Hintergrundkompilierung priorisiert wird.
• Signalisieren Sie Macrobenchmark und Play Vitals, wenn Ihre Anwendung für Startmesswerte als vollständig dargestellt betrachtet werden soll, damit Sie die Leistung erfassen können.

Es wurden drei Activity Compose APIs hinzugefügt, um die Verwendung der FullyDrawnReporter aus einzelnen Composeables zu vereinfachen:

• ReportDrawn bedeutet, dass Ihr Composeable sofort für Interaktionen bereit ist.
• ReportDrawnWhen nimmt ein Prädikat (d.h. list.count > 0), um anzugeben, wann Ihr Composed-Element für Interaktionen bereit ist.
• ReportDrawnAfter nimmt eine Aussetzungsmethode an, die nach Abschluss signalisiert, dass Sie für eine Interaktion bereit sind.

Abhängigkeitsupdates

• Die Aktivität hängt jetzt vom Lebenszyklus 2.6.1 ab. (8fc31d)
• Die Aktivität hängt jetzt von ProfileInstaller 1.3.0 ab. (83d3b1)

Version 1.7.0-rc01

8. März 2023

androidx.activity:activity:1.7.0-rc01, androidx.activity:activity-compose:1.7.0-rc01 und androidx.activity:activity-ktx:1.7.0-rc01 sind freigegeben. Version 1.7.0-rc01 enthält diese Commits.

Update der Abhängigkeiten

• Die Aktivität hängt jetzt von Lifecycle 2.6.0 ab.

Version 1.7.0-beta02

22. Februar 2023

androidx.activity:activity:1.7.0-beta02, androidx.activity:activity-compose:1.7.0-beta02 und androidx.activity:activity-ktx:1.7.0-beta02 sind freigegeben. Version 1.7.0-beta02 enthält diese Commits.

API-Änderungen

• Die Aktion und das Extra, die in den PickVisualMedia- und PickMultipleVisualMedia-Verträgen als Fallback verwendet werden, wenn MediaStore.ACTION_PICK_IMAGES nicht verfügbar ist, sind jetzt öffentliche Konstanten, die OEMs und System-Apps eine stabile API bieten, die eine einheitliche Bildauswahl ermöglicht. Die Implementierung dieses Fallbacks ist derzeit auf System-Apps beschränkt. (Icd320)

Version 1.7.0-beta01

8. Februar 2023

androidx.activity:activity:1.7.0-beta01, androidx.activity:activity-compose:1.7.0-beta01 und androidx.activity:activity-ktx:1.7.0-beta01 sind freigegeben. Version 1.7.0-beta01 enthält diese Commits.

Neue Funktionen

• Mit IntentSenderRequest.Builder.setFlags() können Sie jetzt mehrere Flags aus Intent festlegen, anstatt nur ein einzelnes. (Iac04c)

Fehlerkorrekturen

• Der Fallback für PickVisualMedia, wenn die Bildauswahl des Frameworks nicht verfügbar ist, schränkt die Verarbeitung jetzt korrekt auf Apps ein, die im System-Image des Geräts installiert sind. (If8ae6)

Kotlin-Conversions

• ActivityResultRegistryOwner ist jetzt in Kotlin geschrieben. Das ist eine nicht mit der Quelle kompatible Änderung für diese in Kotlin geschriebenen Klassen. Sie müssen jetzt die Property activityResultRegistry überschreiben, anstatt die vorherige getActivityResultRegistry()-Funktion zu implementieren. (I0b00e)
• OnBackPressedDispatcherOwner ist jetzt in Kotlin geschrieben. Das ist eine nicht mit der Quelle kompatible Änderung für diese in Kotlin geschriebenen Klassen. Sie müssen jetzt die Property onBackPressedDispatcher überschreiben, anstatt die vorherige getOnBackPressedDispatcher-Funktion zu implementieren. (Ia277d)
• ContextAware, ContextAwareHelper, OnContextAvailableListener, IntentSenderRequest und OnBackPressedDispatcher werden jetzt in Kotlin geschrieben. (I1a73e, Iada92, aosp/2410754, I18ac7, b/257291701)

Version 1.7.0-alpha04

25. Januar 2023

androidx.activity:activity:1.7.0-alpha04, androidx.activity:activity-compose:1.7.0-alpha04 und androidx.activity:activity-ktx:1.7.0-alpha04 sind freigegeben. Version 1.7.0-alpha04 enthält diese Commits.

Neue Funktionen

• Bei den Verträgen für PickVisualMedia- und PickMultipleVisualMedia-Aktivitätsergebnisse wird jetzt die von Google Play-Diensten bereitgestellte Bildauswahl verwendet, sofern verfügbar. Bisher wurde die vom Android-System bereitgestellte Bildauswahl verwendet (z. B. MediaStore.ACTION_PICK_IMAGES) ist nicht verfügbar. Die isPhotoPickerAvailable() API, die nur die vom Android-System bereitgestellte Bildauswahl erkennt, wurde eingestellt. Wir empfehlen die Verwendung der neuen isPhotoPickerAvailable(Context) API, die zurückgegeben wird, wenn eine der Bildauswahlen verfügbar ist. (I55be6)

Version 1.7.0-alpha03

11. Januar 2023

androidx.activity:activity:1.7.0-alpha03, androidx.activity:activity-compose:1.7.0-alpha03 und androidx.activity:activity-ktx:1.7.0-alpha03 sind freigegeben. Version 1.7.0-alpha03 enthält diese Commits.

Neue Funktionen

• ComponentDialog implementiert jetzt SavedStateRegistryOwner und hat Zugriff auf seine eigene SavedStateRegistry und legt die SavedStateRegistryOwner für seinen ViewTree fest. Jetpack Compose kann jetzt in einem ComponentDialog verwendet werden, da es sowohl die Anforderungen an LifecycleOwner als auch SavedStateRegistryOwner erfüllt, die über die ViewTree APIs an das Fenster angehängt sind. (Idca17, I73468 b/261162296)

API-Änderungen

• Es wurde ein ReportDrawn-Komposit hinzugefügt, das die Aktivität sofort als bereit zum Aufrufen von reportFullyDrawn kennzeichnet. (Ic5b14, b/259687964)

Kotlin-Conversions

• Die Klassen ActvitiyResultCallback und OnBackPressedCallback wurden in Kotlin konvertiert, wobei die Quell- und Binärkompatibilität beibehalten wurde. (Ifc5e5, Ide1b0, b/257291701)

Version 1.7.0-alpha02

24. Oktober 2022

androidx.activity:activity:1.7.0-alpha02, androidx.activity:activity-compose:1.7.0-alpha02 und androidx.activity:activity-ktx:1.7.0-alpha02 sind freigegeben. Version 1.7.0-alpha02 enthält diese Commits.

Fehlerkorrekturen

• Bei Aktivitäten 1.6.1 wurde ein Problem behoben, bei dem der PickMultipleVisualMedia-Aktivitätsergebnisvertrag auf Android R-Geräten nicht gestartet wurde, wenn der Standardwert für maxItems verwendet wurde. (Ie2776, b/249182130)

Version 1.7.0-alpha01

5. Oktober 2022

androidx.activity:activity:1.7.0-alpha01, androidx.activity:activity-compose:1.7.0-alpha01 und androidx.activity:activity-ktx:1.7.0-alpha01 sind freigegeben. Version 1.7.0-alpha01 enthält diese Commits.

FullyDrawnReporter APIs

ComponentActivity bietet jetzt eine FullyDrawnReporter-Instanz, mit der mehrere Komponenten melden können, wenn sie für die Interaktion bereit sind. ComponentActivity wartet, bis alle Komponenten abgeschlossen sind, bevor reportFullyDrawn() in Ihrem Namen aufgerufen wird. Diese APIs übernehmen die Zeitanforderungen für Sie und müssen nicht im Rahmen eines onDraw-Aufrufs aufgerufen werden.

Wir empfehlen, die folgenden APIs zu aktivieren:

• Die Android Runtime wird benachrichtigt, wenn der Start abgeschlossen ist, damit der gesamte Code, der während einer Startsequenz mit mehreren Frames ausgeführt wird, berücksichtigt und für die Hintergrundkompilierung priorisiert wird.
• Signalisieren Sie Macrobenchmark und Play Vitals, wenn Ihre Anwendung für Startmesswerte als vollständig dargestellt betrachtet werden soll, damit Sie die Leistung erfassen können.

Es wurden zwei Activity Compose APIs hinzugefügt, um die Verwendung der FullyDrawnReporter aus einzelnen Composeables zu vereinfachen:

• ReportDrawnWhen nimmt ein Prädikat (d.h. list.count > 0), um anzugeben, wann Ihr Composed-Element für Interaktionen bereit ist.
• ReportDrawnAfter nimmt eine Aussetzungsmethode an, die nach Abschluss signalisiert, dass Sie für eine Interaktion bereit sind.

Version 1.6.1

Version 1.6.1

24. Oktober 2022

androidx.activity:activity:1.6.1, androidx.activity:activity-compose:1.6.1 und androidx.activity:activity-ktx:1.6.1 sind freigegeben. Version 1.6.1 enthält diese Commits.

Fehlerkorrekturen

• Ein Problem wurde behoben, durch das der PickMultipleVisualMedia-Aktivitätsergebnisvertrag auf Android R-Geräten nicht gestartet wurde, wenn der Standardwert für maxItems verwendet wurde. (Ie2776, b/249182130)

Version 1.6.0

Version 1.6.0

21. September 2022

androidx.activity:activity:1.6.0, androidx.activity:activity-compose:1.6.0 und androidx.activity:activity-ktx:1.6.0 sind freigegeben. Version 1.6.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.5.0

• ActivityResultContracts.PickVisualMedia und ActivityResultContracts.PickMultipleVisualMedia wurden hinzugefügt, um einen abwärtskompatiblen Vertrag bereitzustellen, bei dem MediaStore.ACTION_PICK_IMAGES verwendet wird, wenn die Bildauswahl verfügbar ist, und Intent.ACTION_OPEN_DOCUMENT, wenn sie nicht verfügbar ist.
• Die OnBackInvokedCallback in Android 13 wurde in die OnBackPressedDispatchers von ComponentActivity und ComponentDialog integriert. So funktionieren alle auf OnBackPressedDispatcher basierenden APIs, wenn eine vorhersagende Zurück-Geste aktiviert ist.

Version 1.6.0-rc02

7. September 2022

androidx.activity:activity:1.6.0-rc02, androidx.activity:activity-compose:1.6.0-rc02 und androidx.activity:activity-ktx:1.6.0-rc02 sind freigegeben. Version 1.6.0-rc02 enthält diese Commits.

Fehlerkorrekturen

• OnBackPressedDispatcher registriert die OnBackInvokedCallback jetzt bei der PRIORITY_DEFAULT anstelle der PRIORITY_OVERLAY. (I3901f)
• Bei Klassen, die ComponentActivity erweitern, werden jetzt immer beide onMultiWindowModeChanged()-Callbacks gesendet. (Ic4d85)
• Die ActivityResultRegistry gibt kein Ergebnis mehr an die ActivityResultCallback zurück, wenn der launch-Aufruf eine Exception auslöst und der Callback ohne LifecycleOwner registriert wurde. (Ia7ff7, b/238350794)
• ComponentActivity sendet jetzt Menüaufrufe korrekt, ohne dass die Super-Funktion in Ihrer Aktivität aufgerufen werden muss. (Ie33c5, b/238057118)

Abhängigkeitsupdate

• Die Activity-Bibliothek hängt jetzt von Lifecycle 2.5.1 ab. (If6697)

Version 1.6.0-rc01

24. August 2022

androidx.activity:activity:1.6.0-rc01, androidx.activity:activity-compose:1.6.0-rc01 und androidx.activity:activity-ktx:1.6.0-rc01 sind freigegeben. Version 1.6.0-rc01 enthält diese Commits.

Fehlerkorrekturen

• Wenn Sie SDK-Versionen vor 33 verwenden, führt das Initialisieren einer OnBackPressedDispatcher nicht mehr zu ClassVerificationErrors. (Ic32e1)
• Bei Klassen, die den onPictureInPictureModeChanged()-Callback von ComponentActivity überschreiben, werden die Callbacks jetzt immer gesendet. (Ib7fdb)

Version 1.6.0-beta01

10. August 2022

androidx.activity:activity:1.6.0-beta01, androidx.activity:activity-compose:1.6.0-beta01 und androidx.activity:activity-ktx:1.6.0-beta01 sind freigegeben. Version 1.6.0-beta01 enthält diese Commits.

API-Änderungen

• Die veralteten Methoden startActivityForResult und startIntentSenderForResult in ComponentActivity wurden mit @NonNull gekennzeichnet, da das Übergeben von null immer zu einem Absturz geführt hat. (Id2a25, b/231476082)

Fehlerkorrekturen

• Von Aktivität 1.5.1: Die ActivityResultRegistry gibt kein Ergebnis mehr an die ActivityResultCallback zurück, wenn der launch-Aufruf eine Exception auslöst und der Callback ohne LifecycleOwner registriert wurde. (Ia7ff7, b/238350794)
• Aktivität 1.5.1: ComponentActivity sendet Menüaufrufe jetzt richtig an onPrepareOptionMenu()-, onCreateOptionsMenu()- und onOptionsItemSelected()-Überschreibungen, ohne dass die Superfunktion aufgerufen werden muss. (Ie33c5, b/238057118)

Abhängigkeitsupdate

• Aktivität 1.5.1: Die Activity-Bibliothek hängt jetzt von der Lifecycle-Version 2.5.1 ab. (If6697)

Version 1.6.0-alpha05

15. Juni 2022

androidx.activity:activity:1.6.0-alpha05, androidx.activity:activity-compose:1.6.0-alpha05 und androidx.activity:activity-ktx:1.6.0-alpha05 sind freigegeben. Version 1.6.0-alpha05 wurde in einem privaten Pre-Release-Branch entwickelt und hat keine öffentlichen Commits.

API-Änderungen

• minCompileSdk ist jetzt 33, um mit dem Tiramisu Beta 3 SDK übereinzustimmen.

Fehlerkorrekturen

• Der Absturz auf älteren Geräten bei der SDK-Erweiterungsüberprüfung für die PickVisualMedia ActivityResultContract wurde behoben. Die ACTION_OPEN_DOCUMENT sollte jetzt auf Geräten mit Android 10 und niedriger funktionieren.

Version 1.6.0-alpha04

18. Mai 2022

androidx.activity:activity:1.6.0-alpha04 und androidx.activity:activity-ktx:1.6.0-alpha04 werden freigegeben.

Fehlerkorrekturen

• Ein Fehler in PickVisualMediaRequest wurde behoben, bei dem der Versuch, eine Anfrage entweder über den Builder oder die Kotlin-Funktion der obersten Ebene zu erstellen, zu einem Stack-Overflow führte.
• Die OnBackInvokedCallback in Android 13 Dev Beta 2 in die von ComponentDialog bereitgestellte OnBackPressedDispatcher eingebunden. So können alle auf OnBackPressedDispatcher basierenden APIs verwendet werden, wenn die vorhersagende Zurück-Geste aktiviert ist.

Version 1.6.0-alpha03

27. April 2022

androidx.activity:activity:1.6.0-alpha03, androidx.activity:activity-compose:1.6.0-alpha03 und androidx.activity:activity-ktx:1.6.0-alpha03 sind freigegeben.

• Hinweis: Diese Version wird nur mit dem SDK der Android 13-Entwickler-Beta 1 kompiliert.

Neue Funktionen

• ActivityResultContracts.PickVisualMedia und ActivityResultContracts.PickMultipleVisualMedia wurden hinzugefügt, um einen abwärtskompatiblen Vertrag bereitzustellen, bei dem MediaStore.ACTION_PICK_IMAGES verwendet wird, wenn die Bildauswahl verfügbar ist, und Intent.ACTION_OPEN_DOCUMENT, wenn sie nicht verfügbar ist.
• Die OnBackInvokedCallback in Android 13 Dev Beta 1 in die von ComponentActivity bereitgestellte OnBackPressedDispatcher eingebunden. So können alle auf OnBackPressedDispatcher basierenden APIs verwendet werden, wenn die vorhersagende Zurück-Geste aktiviert ist.

Version 1.6.0-alpha01

23. März 2022

androidx.activity:activity:1.6.0-alpha01, androidx.activity:activity-compose:1.6.0-alpha01 und androidx.activity:activity-ktx:1.6.0-alpha01 sind freigegeben.

• Hinweis: Diese Version wird nur mit dem SDK der Android 13-Entwicklervorschau 2 kompiliert.

Neue Funktionen

• Änderungen aus der Android 13-Entwicklervorschau 2 in ComponentActivity integriert.

Version 1.5.1

Version 1.5.1

27. Juli 2022

androidx.activity:activity:1.5.1, androidx.activity:activity-compose:1.5.1 und androidx.activity:activity-ktx:1.5.1 sind freigegeben. Version 1.5.1 enthält diese Commits.

Fehlerkorrekturen

• Die ActivityResultRegistry gibt kein Ergebnis mehr an die ActivityResultCallback zurück, wenn der launch()-Aufruf eine Exception auslöst und der Callback ohne LifecycleOwner registriert wurde. (Ia7ff7, b/238350794)

• ComponentActivity sendet jetzt Menüaufrufe an onPrepareOptionMenu(), onCreateOptionsMenu() und onOptionsItemSelected()-Überschreibungen, ohne dass die Superfunktion aufgerufen werden muss. (Ie33c5, b/238057118)

Update der Abhängigkeiten

• Die Activity-Bibliothek hängt jetzt vom Lebenszyklus 2.5.1 ab. (If6697)

Version 1.5.0

Version 1.5.0

29. Juni 2022

androidx.activity:activity:1.5.0, androidx.activity:activity-compose:1.5.0 und androidx.activity:activity-ktx:1.5.0 sind freigegeben. Version 1.5.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.4.0

• ComponentDialog: ComponentDialog ist eine Unterklasse von Dialog, die eine OnBackPressedDispatcher enthält, die aufgerufen wird, wenn die Schaltfläche „Zurück“ des Systems gedrückt wird und das Dialogfeld sichtbar ist. Wichtig ist, dass diese Unterklasse auch die ViewTreeOnBackPressedDispatcherOwner festlegt. So können Ansichten den richtigen Dispatcher auf eine generische Weise abrufen, unabhängig davon, ob er in einer ComponentActivity oder ComponentDialog vorhanden ist.
• Callback-Schnittstellen: ComponentActivity implementiert jetzt eine Reihe modularer Callback-Schnittstellen, die anstelle der Activity-Callbacks verwendet werden können. Dazu gehören: OnNewIntentProvider, OnConfigurationChangedProvider, OnTrimMemoryProvider, OnPictureInPictureModeChangedProvider und OnMultiWindowModeChangedProvider.
• Integration von CreationExtras: ComponentActivity kann jetzt über die CreationExtras des Lebenszyklus 2.5.0 einen zustandslosen ViewModelProvider.Factory bereitstellen.

Sonstige Änderungen

• Der Konstruktor ohne Parameter für ActivityResultContracts.CreateDocument wurde eingestellt und durch einen neuen Konstruktor ersetzt, der einen bestimmten MIME-Typ (z.B. „image/png“), wie von Intent.ACTION_CREATE_DOCUMENT gefordert.

Version 1.5.0-rc01

11. Mai 2022

androidx.activity:activity:1.5.0-rc01, androidx.activity:activity-compose:1.5.0-rc01 und androidx.activity:activity-ktx:1.5.0-rc01 werden ohne Änderungen gegenüber 1.5.0-beta01 veröffentlicht. Version 1.5.0-rc01 enthält diese Commits.

Version 1.5.0-beta01

20. April 2022

androidx.activity:activity:1.5.0-beta01, androidx.activity:activity-compose:1.5.0-beta01 und androidx.activity:activity-ktx:1.5.0-beta01 sind freigegeben. Version 1.5.0-beta01 enthält diese Commits.

Abhängigkeitsupdates

• Die Aktivität hängt jetzt vom Lebenszyklus 2.4.0-beta01 ab.

Version 1.5.0-alpha05

6. April 2022

androidx.activity:activity:1.5.0-alpha05, androidx.activity:activity-compose:1.5.0-alpha05 und androidx.activity:activity-ktx:1.5.0-alpha05 sind freigegeben. Version 1.5.0-alpha05 enthält diese Commits.

Fehlerkorrekturen

• onPanelClosed() von ComponentActivity ruft jetzt auch super onPanelClosed() auf. Dadurch wurde ein Problem behoben, bei dem die Methode onContextMenuClosed nicht aufgerufen wurde. (Ib6f77)

Version 1.5.0-alpha04

23. März 2022

androidx.activity:activity:1.5.0-alpha04, androidx.activity:activity-compose:1.5.0-alpha04 und androidx.activity:activity-ktx:1.5.0-alpha04 sind freigegeben. Version 1.5.0-alpha04 enthält diese Commits.

Fehlerkorrekturen

• SavedStateViewFactory unterstützt jetzt die Verwendung von CreationExtras, auch wenn es mit einer SavedStateRegistryOwner initialisiert wurde. Wenn Extras angegeben werden, werden die initialisierten Argumente ignoriert. (I6c43b, b/224844583)

Version 1.5.0-alpha03

23. Februar 2022

androidx.activity:activity:1.5.0-alpha03, androidx.activity:activity-compose:1.5.0-alpha03 und androidx.activity:activity-ktx:1.5.0-alpha03 sind freigegeben. Version 1.5.0-alpha03 enthält diese Commits.

API-Änderungen

• Sie können jetzt CreationExtras an die Aktivitätsfunktion by viewModels() übergeben (I6a3e6, b/217600303)

Version 1.5.0-alpha02

9. Februar 2022

androidx.activity:activity:1.5.0-alpha02, androidx.activity:activity-compose:1.5.0-alpha02 und androidx.activity:activity-ktx:1.5.0-alpha02 sind freigegeben. Version 1.5.0-alpha02 enthält diese Commits.

Neue Funktionen

• ComponentActivity implementiert jetzt die OnPictureInPictureModeChangedProvider-Schnittstelle, damit jede Komponente Ereignisse zur Änderung des Bild-im-Bild-Modus empfangen kann. (I9f567)
• ComponentActivity implementiert jetzt die Schnittstelle OnMultiWindowModeChangedProvider, damit jede Komponente Änderungsereignisse für den Mehrfenstermodus empfangen kann. (I62d91)

Version 1.5.0-alpha01

26. Januar 2022

androidx.activity:activity:1.5.0-alpha01, androidx.activity:activity-compose:1.5.0-alpha01 und androidx.activity:activity-ktx:1.5.0-alpha01 sind freigegeben. Version 1.5.0-alpha01 enthält diese Commits.

Neue Funktionen

• ComponentActivity kann jetzt mit ViewModel CreationExtras verwendet werden, die im Rahmen von Lifecycle 2.5.0-alpha01 eingeführt wurden. (Ie7e00, b/207012584)
• ComponentDialog wurde hinzugefügt, eine Unterklasse von Dialog, die eine OnBackPressedDispatcher enthält, die aufgerufen wird, wenn die Schaltfläche „Zurück“ des Systems gedrückt wird, während das Dialogfeld sichtbar ist. Wichtig ist, dass diese untergeordnete Klasse auch die ViewTreeOnBackPressedDispatcherOwner festlegt. So können Ansichten den richtigen Dispatcher auf allgemeine Weise abrufen, unabhängig davon, ob er in einer ComponentActivity oder einer ComponentDialog vorhanden ist. (I8a1bc)
• ComponentActivity implementiert jetzt die neue OnNewIntentProvider-Schnittstelle, damit alle Komponenten diese Ereignisse empfangen können. (If1f8b)
• ComponentActivity implementiert jetzt die neue OnConfigurationChangedProvider-Schnittstelle, damit alle Komponenten diese Ereignisse empfangen können. (If623b)
• ComponentActivity implementiert jetzt die neue OnTrimMemoryProvider-Benutzeroberfläche, damit alle Komponenten diese Ereignisse empfangen können. (Ia9295)

API-Änderungen

• Der Konstruktor ohne Parameter für ActivityResultContracts.CreateDocument wurde eingestellt und durch einen neuen Konstruktor ersetzt, der einen bestimmten MIME-Typ (z.B. "image/png"), wie von Intent.ACTION_CREATE_DOCUMENT gefordert. (I2bec6)
• Die mit einer Ansicht verknüpfte OnBackPressedDispatcherOwner kann jetzt über die ViewTreeOnBackPressedDispatcherOwner abgerufen werden, anstatt die Context zu übergeben. (I74685)

Fehlerkorrekturen

• Ein Absturz beim ersten Zugriff auf eine ViewModel über einen registerForActivityResult()-Callback oder die Callbacks zu einer LifecycleObserver, die im Rahmen von init einer ComponentActivity hinzugefügt wurde, wurde behoben. (Ife83f)

Version 1.4.0

Version 1.4.0

27. Oktober 2021

androidx.activity:activity:1.4.0, androidx.activity:activity-compose:1.4.0 und androidx.activity:activity-ktx:1.4.0 sind freigegeben. Version 1.4.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.3.0

• AndroidX ComponentActivity implementiert jetzt die MenuHost-Schnittstelle. So kann jeder Komponente der ActionBar Menüpunkte hinzugefügt werden, indem der Aktivität eine MenuProvider-Instanz hinzugefügt wird. Jedem MenuProvider kann optional ein Lifecycle hinzugefügt werden, das die Sichtbarkeit dieser Menüpunkte automatisch basierend auf dem Lifecycle-Status steuert und das Entfernen des MenuProvider verwaltet, wenn der Lifecycle zerstört wird.
• Die Klasse ActivityResultContract wurde in Kotlin neu geschrieben, damit Entwickler, die benutzerdefinierte Verträge in Kotlin schreiben, die richtige Nullbarkeit für ihre Eingabe- und Ausgabeklassen definieren können.
• Die Klasse ActivityResultContracts und ihre Verträge wurden in Kotlin neu geschrieben, um die richtige Nullbarkeit zu gewährleisten.

Version 1.4.0-rc01

13. Oktober 2021

androidx.activity:activity:1.4.0-rc01, androidx.activity:activity-compose:1.4.0-rc01 und androidx.activity:activity-ktx:1.4.0-rc01 sind freigegeben. Version 1.4.0-rc01 enthält diese Commits.

Fehlerkorrekturen

• Die ActivityResultRegistry gibt kein Ergebnis mehr an die ActivityResultCallback zurück, wenn der launch-Aufruf eine Exception auslöst. (If4f91, b/200845664)

Version 1.4.0-beta01

29. September 2021

androidx.activity:activity:1.4.0-beta01, androidx.activity:activity-compose:1.4.0-beta01 und androidx.activity:activity-ktx:1.4.0-beta01 sind freigegeben. Version 1.4.0-beta01 enthält diese Commits.

API-Änderungen

• Der Typ für ActivityResultContracts.OpenMultipleDocuments und ActivityResultContracts.GetMultipleContents wurde korrigiert, der dazu führte, dass bei Verwendung des Codes aus der Programmiersprache Java der Ausgabetyp List<? extends Uri> verwendet wurde. (If71de)
• Auf öffentliche Konstanten in den Klassen ActivityResultContracts.StartActivityForResult, ActivityResultContracts.StartIntentSenderForResult und ActivityResultContracts.RequestMultiplePermissions kann jetzt über ihre jetzt öffentlichen Companion-Objekte zugegriffen werden, wenn Kotlin verwendet wird. (aosp/1832555)

Aktualisierungen der Dokumentation

• Die Mitteilung zur Einstellung von APIs, die jetzt von den Activity Result APIs verarbeitet werden, nämlich startActivityForResult, startIntentSenderForResult, onActivityResult, requestPermissions und onRequestPermissionsResult, wurde um weitere Details ergänzt. (cce80f)

Version 1.4.0-alpha02

15. September 2021

androidx.activity:activity:1.4.0-alpha02, androidx.activity:activity-compose:1.4.0-alpha02 und androidx.activity:activity-ktx:1.4.0-alpha02 sind freigegeben. Version 1.4.0-alpha02 enthält diese Commits.

Neue Funktionen

• Das activity-compose-Artefakt enthält jetzt einen LaunchDuringComposition-Lint-Fehler, der verhindert, dass die launch-Methode von ActivityResultLauncher als Teil der Zusammensetzung aufgerufen wird, da die Zusammensetzung ohne Nebenwirkungen erfolgen sollte. Verwenden Sie die APIs zur Verwaltung von Nebenwirkungen. (7c2bbe, b/191347220)

API-Änderungen

• Die Klasse ActivityResultContract wurde in Kotlin neu geschrieben, damit Entwickler, die benutzerdefinierte Verträge in Kotlin schreiben, die richtige Nullbarkeit für ihre Eingabe- und Ausgabeklassen definieren können. (I8a8f5)
• Die Klasse ActivityResultContracts und ihre Verträge wurden in Kotlin neu geschrieben, um die richtige Null-Zulässigkeit zu gewährleisten. (I69802)

Version 1.4.0-alpha01

1. September 2021

androidx.activity:activity:1.4.0-alpha01, androidx.activity:activity-compose:1.4.0-alpha01 und androidx.activity:activity-ktx:1.4.0-alpha01 sind freigegeben. Version 1.4.0-alpha01 enthält diese Commits.

Neue Funktionen

• AndroidX ComponentActivity implementiert jetzt die MenuHost-Schnittstelle. So kann jeder Komponente der ActionBar Menüpunkte hinzugefügt werden, indem der Aktivität eine MenuProvider-Instanz hinzugefügt wird. Jedem MenuProvider kann optional ein Lifecycle hinzugefügt werden, das die Sichtbarkeit dieser Menüpunkte automatisch basierend auf dem Lifecycle-Status steuert und das Entfernen des MenuProvider verwaltet, wenn der Lifecycle zerstört wird. (I3b608):

/**
  * Using the addMenuProvider() API directly in your Activity
  **/
class ExampleActivity : ComponentActivity(R.layout.activity_example) {

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Add menu items without overriding methods in the Activity
   addMenuProvider(object : MenuProvider {
      override fun onCreateMenu(menu: Menu, menuInflater: MenuInflater) {
        // Add menu items here
        menuInflater.inflate(R.menu.example_menu, menu)
      }

      override fun onMenuItemSelected(menuItem: MenuItem): Boolean {
        // Handle the menu selection
        return true
      }
    })
  }
}

/**
  * Using the addMenuProvider() API in a Fragment
  **/
class ExampleFragment : Fragment(R.layout.fragment_example) {

  override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    // The usage of an interface lets you inject your own implementation
    val menuHost: MenuHost = requireActivity()
  
    // Add menu items without using the Fragment Menu APIs
    // Note how we can tie the MenuProvider to the viewLifecycleOwner
    // and an optional Lifecycle.State (here, RESUMED) to indicate when
    // the menu should be visible
    menuHost.addMenuProvider(object : MenuProvider {
      override fun onCreateMenu(menu: Menu, menuInflater: MenuInflater) {
        // Add menu items here
        menuInflater.inflate(R.menu.example_menu, menu)
      }

      override fun onMenuItemSelected(menuItem: MenuItem): Boolean {
        // Handle the menu selection
        return true
      }
    }, viewLifecycleOwner, Lifecycle.State.RESUMED)
  }

Verhaltensänderungen

• Die ActivityResultRegistry wirft jetzt eine IllegalStateException, wenn versucht wird, launch() auf einem ActivityResultLauncher aufzurufen, der nicht registriert oder abgemeldet wurde. (Ida75d, b/192567522)

Externer Beitrag

• Vielen Dank an dmitrilc für die Korrektur eines Tippfehlers in der ActivityResult-Dokumentation. (#221)

Version 1.3.1

Version 1.3.1

4. August 2021

androidx.activity:activity:1.3.1, androidx.activity:activity-compose:1.3.1 und androidx.activity:activity-ktx:1.3.1 sind freigegeben. Version 1.3.1 enthält diese Commits.

Abhängigkeitsupdates

• Die Aktivität hängt jetzt von Kotlin 1.5.21 ab.
• „Aktivitäten erstellen“ hängt jetzt von „Erstellen 1.0.1“ ab.

Version 1.3.0

Version 1.3.0

28. Juli 2021

androidx.activity:activity:1.3.0, androidx.activity:activity-compose:1.3.0 und androidx.activity:activity-ktx:1.3.0 sind freigegeben. Version 1.3.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.2.0

• Activity Compose-Artefakt: Das activity-compose-Artefakt bietet die setContent-Erweiterungsmethode zum Hosten Ihrer Jetpack Compose-Benutzeroberfläche in einer Aktivität und Compose-spezifische Wrapper für die Interaktion mit den ComponentActivity APIs zur Verarbeitung der Systemrück-Schaltfläche und der Activity Result APIs. Weitere Informationen finden Sie in der Dokumentation.
• CaptureVideo-Kontrakt: Der CaptureVideo ActivityResultContract ersetzt den jetzt eingestellten TakeVideo-Kontrakt und gibt einen booleschen Wert zurück, der den Erfolg angibt und in vielen Kamera-Apps funktioniert.
• Tracking der Bild-im-Bild-Vorschau: Nutzer von activity-ktx können jetzt die trackPipAnimationHintView-Erweiterungsmethode auf Activity verwenden, um die PictureInPictureParams automatisch mit der neuen Position der Ansicht neu zu erstellen, wenn sich die Position relativ zum Fenster ändert.

Version 1.3.0-rc02

14. Juli 2021

androidx.activity:activity:1.3.0-rc02, androidx.activity:activity-compose:1.3.0-rc02 und androidx.activity:activity-ktx:1.3.0-rc02 sind freigegeben. Version 1.3.0-rc02 enthält diese Commits.

Fehlerkorrekturen

• Die ActivityResultRegistry-Callbacks werden jetzt richtig gespeichert und wiederhergestellt, sodass Callbacks nicht im savedState dupliziert werden. (I97816, b/191893160)

Version 1.3.0-rc01

1. Juli 2021

androidx.activity:activity:1.3.0-rc01, androidx.activity:activity-compose:1.3.0-rc01 und androidx.activity:activity-ktx:1.3.0-rc01 werden ohne Änderungen gegenüber 1.3.0-beta02 veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.

Version 1.3.0-beta02

16. Juni 2021

androidx.activity:activity:1.3.0-beta02, androidx.activity:activity-compose:1.3.0-beta02 und androidx.activity:activity-ktx:1.3.0-beta02 sind freigegeben. Version 1.3.0-beta02 enthält diese Commits.

activity-compose wurde aktualisiert, sodass es von „Compose 1.0.0-beta09“ abhängt. androidx.compose.ui:ui-test-junit4 hat jetzt eine Abhängigkeit von activity-compose zur Kompilierungszeit.

Version 1.3.0-beta01

2. Juni 2021

androidx.activity:activity:1.3.0-beta01, androidx.activity:activity-compose:1.3.0-beta01 und androidx.activity:activity-ktx:1.3.0-beta01 sind freigegeben. Version 1.3.0-beta01 enthält diese Commits.

API-Änderungen

• Die zuvor verworfene Methode @Composable registerForActivityResult() wurde entfernt. Verwenden Sie rememberLauncherForActivityResult(). (Ic39d3)

Version 1.3.0-alpha08

18. Mai 2021

androidx.activity:activity:1.3.0-alpha08, androidx.activity:activity-compose:1.3.0-alpha08 und androidx.activity:activity-ktx:1.3.0-alpha08 sind freigegeben. Version 1.3.0-alpha08 enthält diese Commits.

Neue Funktionen

• Die neue CaptureVideo ActivityResultContract gibt einen booleschen Wert an deine ActivityResultCallback zurück, der angibt, ob dein Video erfolgreich an der angegebenen URI gespeichert wurde. Dieser ersetzt den jetzt veralteten TakeVideo-Vertrag, da Kamera-Apps die Rückgabe einer Miniatur-Bitmap nur sehr selten unterstützten, was das Ergebnis unbrauchbar machte. (Ie21f2, b/185938070)
• Neue API Activity#setPipAnimationHintView hinzugefügt, um den Quell-Rechteckhinweis von PipParams zu aktualisieren, wenn sich die Ansicht bewegt. (I9063d)

API-Änderungen

• Die Funktion rememberLauncherForActivityResult gibt jetzt einen Launcher zurück, der die Funktion unregister() ersetzt. Die Registrierung und Deregistrierung des Launchers wird automatisch von rememberLauncherForActivityResult verwaltet. (I2443e)

Kompatibilität von Compose

• androidx.activity:activity-compose:1.3.0-alpha08 ist nur mit Compose-Version 1.0.0-beta07 und höher kompatibel.

Version 1.3.0-alpha07

21. April 2021

androidx.activity:activity:1.3.0-alpha07, androidx.activity:activity-compose:1.3.0-alpha07 und androidx.activity:activity-ktx:1.3.0-alpha07 sind freigegeben. Version 1.3.0-alpha07 enthält diese Commits.

Fehlerkorrekturen

• rememberLauncherForActivityResult gibt jetzt eine stabile Referenz auf dieselbe ActivityResultLauncher-Instanz zurück, auch wenn sich der Vertrag aufgrund von Neuzusammensetzungen ändert. (Id2d6d)
• Bei der Verwendung instabiler Versionen von Fragmenten über 1.3.0 wird nicht mehr der falsch positive Lint-Fehler ausgegeben, dass 1.3.0 verwendet werden soll. (aosp/1670206, b/184847092)

Version 1.3.0-alpha06

7. April 2021

androidx.activity:activity:1.3.0-alpha06, androidx.activity:activity-compose:1.3.0-alpha06 und androidx.activity:activity-ktx:1.3.0-alpha06 sind freigegeben. Version 1.3.0-alpha06 enthält diese Commits.

API-Änderungen

• Die registerForActivityResult() API wurde in rememberLauncherForActivityResult() umbenannt, um besser zu verdeutlichen, dass das zurückgegebene ActivityResultLauncher ein verwaltetes Objekt ist, das in Ihrem Namen gespeichert wird. Wenn Sie versuchen, unregister mit der zurückgegebenen ActivityResultLauncher aufzurufen, wird jetzt ein Fehler ausgegeben. (I2bb6d)
• LocalOnBackPressedDispatcherOwner.current und LocalActivityResultRegistryOwner.current geben jetzt einen optionalen Wert zurück, um besser zu bestimmen, ob er in der aktuellen Komposition verfügbar ist. Bei APIs, für die diese APIs erforderlich sind, z. B. BackHandler und rememberLauncherForActivityResult(), wird jetzt ein ausführlicherer Fehler ausgegeben, wenn der zugrunde liegende Inhaber nicht gefunden wird. NavHost funktioniert jetzt auch dann, wenn kein OnBackPressedDispatcherOwner gefunden wird, z. B. in der Vorschau der NavHost. (I7d8b4)

Fehlerkorrekturen

• Die BackHandler fängt jetzt die Zurück-Tastendrücke korrekt ab, wenn die Aktivität STOPPED und dann wieder STARTED ist und andere Rückruffunktionen mit einem LifecycleOwner hinzugefügt wurden. (I71de6, b/182284739)
• Die Verwendung der Methodenerweiterung launch() mit einer benutzerdefinierten ActivityResultContract mit einer Unit-Eingabe führt nicht mehr zu einer NullPointerException (I76282, b/183837954)

Version 1.3.0-alpha05

24. März 2021

androidx.activity:activity:1.3.0-alpha05, androidx.activity:activity-compose:1.3.0-alpha05 und androidx.activity:activity-ktx:1.3.0-alpha05 sind freigegeben. Version 1.3.0-alpha05 enthält diese Commits.

Fehlerkorrekturen

• Aktivität 1.2.2: Ein Problem bei der InvalidFragmentVersionForActivityResult-Lint-Prüfung wurde behoben, das bei Verwendung von Fragment 1.3.1 oder höher zu einem False Positive führte. (I54da1, b/182388985)
• Aktivität 1.2.2: ComponentActivity vermeidet jetzt einen ClassNotFoundException, wenn ein Intent von einem ActivityResultContract gestartet wird, das zuvor als Extra in einem anderen Intent gehalten wurde. (Ieff05, b/182906230)

Abhängigkeitsupdates

• Aktivität 1.2.2: Die Aktivität hängt jetzt vom Lebenszyklus 2.3.1 ab.

Version 1.3.0-alpha04

10. März 2021

androidx.activity:activity:1.3.0-alpha04, androidx.activity:activity-compose:1.3.0-alpha04 und androidx.activity:activity-ktx:1.3.0-alpha04 sind freigegeben. Version 1.3.0-alpha04 enthält diese Commits.

Fehlerkorrekturen

• Unter Aktivitäten 1.2.1: RequestMultiplePermissions gibt jetzt immer Ergebnisse für alle angeforderten Berechtigungen zurück, nicht nur für Berechtigungen, die zuvor nicht gewährt wurden. (I50bc3, b/180884668)
• Unter Aktivitäten 1.2.1: ActivityResultRegistry sorgt jetzt dafür, dass laufende launch()-Anfragen ihre Ergebnisse zurückgeben, auch wenn Sie unregister() und dann noch einmal register() mit demselben Schlüssel ausführen. (I9ef34, b/181267562)
• Activity Compose fügt dem Laufzeit-Classpath keine Testabhängigkeiten mehr hinzu. (Ifd8b3)
• Ein Problem mit BackHandler wurde behoben, bei dem das zuvor festgelegte onBack-Lambda nach der Neuzusammensetzung weiterhin verwendet wurde. (8eb5eb)

Version 1.3.0-alpha03

24. Februar 2021

androidx.activity:activity:1.3.0-alpha03, androidx.activity:activity-compose:1.3.0-alpha03 und androidx.activity:activity-ktx:1.3.0-alpha03 sind freigegeben. Version 1.3.0-alpha03 enthält diese Commits.

Neue Funktionen

• Es gibt jetzt eine komponierbare registerForActivityResult-Funktion, mit der Ergebnisse aus Aktivitäten in Composeables abgerufen werden können. (Ia7851, b/172690553)

API-Änderungen

• LocalOnBackPressedDispatcherOwner hat jetzt provides-Funktionen, die mit CompositionLocalProvider verwendet werden können und die asProvidableCompositionLocal() API ersetzen. (I45d24)

Hinweis: Activity Compose 1.3.0-alpha03 ist nur mit Compose 1.0.0-beta01 kompatibel.

Version 1.3.0-alpha02

10. Februar 2021

androidx.activity:activity:1.3.0-alpha02, androidx.activity:activity-compose:1.3.0-alpha02 und androidx.activity:activity-ktx:1.3.0-alpha02 sind freigegeben. Version 1.3.0-alpha02 enthält diese Commits.

Fehlerkorrekturen

• Ein Problem in Activity Compose 1.3.0-alpha01 wurde behoben, das bei Verwendung von Compose 1.0.0-alpha12 zu einer NoSuchMethodError: No static method setContent-Ausnahme führte. Alle Compose-Nutzer sollten 1.3.0-alpha02 und höher verwenden. (b/179911234)

API-Änderungen

• Mit der BackHandler API kann ein Composable die Schaltfläche „Zurück“ des Systems abfangen. (I58ed5, b/172154006)

Hinweis: Activity Compose 1.3.0-alpha02 ist nur mit Compose 1.0.0-alpha12 kompatibel.

Version 1.3.0-alpha01

10. Februar 2021

androidx.activity:activity:1.3.0-alpha01, androidx.activity:activity-compose:1.3.0-alpha01 und androidx.activity:activity-ktx:1.3.0-alpha01 sind freigegeben. Version 1.3.0-alpha01 enthält diese Commits.

Achtung :Verwenden Sie stattdessen Version 1.3.0-alpha02. In 1.3.0-alpha01 wurde ein kritisches Problem gefunden, das dazu führt, dass Activity Compose und die davon abhängigen Bibliotheken mit einer NoSuchMethodError: No static method setContent-Ausnahme abstürzen. (b/179911234)

Neue Funktionen

• Das neue activity-compose-Artefakt bietet Jetpack Compose-spezifische Helpers für androidx.activity-spezifische APIs.
  • ComponentActivity.setContent wurde von androidx.compose.ui.platform.setContent nach androidx.activity.compose.setContent verschoben. (Icf416)

Hinweis: Activity Compose 1.0.0-alpha01 ist nur mit Compose 1.0.0-alpha12 kompatibel.

Bekannte Probleme

• Wenn Sie „Activity Compose“ 1.3.0-alpha01 und darauf basierende Bibliotheken wie androidx.compose.ui:ui-test-junit4:1.0.0-alpha12 verwenden, führt dies zu einer NoSuchMethodError: No static method setContent-Ausnahme. (b/179911234)

Version 1.2.4

Version 1.2.4

21. Juli 2021

androidx.activity:activity:1.2.4 und androidx.activity:activity-ktx:1.2.4 werden freigegeben. Version 1.2.4 enthält diese Commits.

Fehlerkorrekturen

• Aktivität 1.3.0-rc02: Die Callbacks der ActivityResultRegistry werden jetzt ordnungsgemäß gespeichert und wiederhergestellt, sodass Callbacks nicht im gespeicherten Status dupliziert werden. (I97816, b/191893160)

Version 1.2.3

Version 1.2.3

5. Mai 2021

androidx.activity:activity:1.2.3 und androidx.activity:activity-ktx:1.2.3 werden freigegeben. Version 1.2.3 enthält diese Commits.

Fehlerkorrekturen

• Die Verwendung der Methodenerweiterung launch() mit einer benutzerdefinierten ActivityResultContract mit einer Unit-Eingabe führt nicht mehr zu einer NullPointerException (I76282, b/183837954)
• Ein falsch positiver Lint-Fehler wurde behoben, bei dem Sie aufgefordert wurden, Fragment 1.3.0 zu verwenden, wenn Sie einen Snapshot-, Alpha-, Beta- oder RC-Build einer neueren Version von Fragments verwenden. (f4a57e, b/184847092)

Version 1.2.2

Version 1.2.2

24. März 2021

androidx.activity:activity:1.2.2 und androidx.activity:activity-ktx:1.2.2 werden freigegeben. Version 1.2.2 enthält diese Commits.

Fehlerkorrekturen

• Ein Problem bei der InvalidFragmentVersionForActivityResult-Lint-Prüfung wurde behoben, das bei Verwendung von Fragment 1.3.1 oder höher zu einem falsch positiven Ergebnis geführt hat. (I54da1, b/182388985)
• ComponentActivity vermeidet jetzt ein ClassNotFoundException, wenn eine Intent von einer ActivityResultContract gestartet wird, die zuvor als Extra in einer anderen Intent gehalten wurde. (Ieff05, b/182906230)

Abhängigkeitsupdates

• Die Aktivität hängt jetzt vom Lebenszyklus 2.3.1 ab.

Version 1.2.1

Version 1.2.1

10. März 2021

androidx.activity:activity:1.2.1 und androidx.activity:activity-ktx:1.2.1 werden freigegeben. Version 1.2.1 enthält diese Commits.

Fehlerkorrekturen

• RequestMultiplePermissions gibt jetzt immer Ergebnisse für alle angeforderten Berechtigungen zurück, nicht nur für Berechtigungen, die zuvor nicht gewährt wurden. (I50bc3, b/180884668)
• ActivityResultRegistry sorgt jetzt dafür, dass laufende launch()-Anfragen ihre Ergebnisse zurückgeben, auch wenn Sie unregister() und dann noch einmal register() mit demselben Schlüssel senden. (I9ef34, b/181267562)

Version 1.2.0

Hinweis: Die Kotlin-abhängigen Bibliotheken dieser Version (activity-ktx) sind auf den Bytecode der Programmiersprache Java 8 ausgerichtet. Weitere Informationen zur Verwendung in Ihrem Projekt finden Sie unter Java 8-Sprachfunktionen verwenden.

Version 1.2.0

10. Februar 2021

androidx.activity:activity:1.2.0 und androidx.activity:activity-ktx:1.2.0 werden freigegeben. Version 1.2.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.1.0

• Activity Result APIs: ComponentActivity bietet jetzt eine ActivityResultRegistry, mit der Sie startActivityForResult()+onActivityResult()- sowie requestPermissions()+onRequestPermissionsResult()-Abläufe verarbeiten können, ohne Methoden in Ihrer Aktivität oder Ihrem Fragment zu überschreiben. Außerdem bietet sie über ActivityResultContract eine verbesserte Typsicherheit und Hooks zum Testen dieser Abläufe. Weitere Informationen finden Sie im aktualisierten Hilfeartikel Ergebnis aus einer Aktivität abrufen.

Hinweis: Wenn Sie auf „Aktivität 1.2.0“ umstellen, müssen Sie auch auf Fragment 1.3.0 umstellen, um Probleme mit ungültigen Anfragecodes zu beheben und dafür zu sorgen, dass Berechtigungsanfragen korrekt gesendet werden. Die InvalidFragmentVersionForActivityResult-Lint-Prüfung warnt Sie, wenn Sie nicht auf eine geeignete Fragmentversion umstellen.

• ContextAware: ComponentActivity implementiert jetzt ContextAware. Du kannst also eine oder mehrere OnContextAvailableListener-Instanzen hinzufügen, die einen Callback vor der Basis-Activity.onCreate() erhalten.

  • Mit einer anhaltenden Kotlin-Erweiterung withContextAvailable() können Sie einen Block ohne Aussetzung ausführen, wenn der Kontext verfügbar ist, und ein Ergebnis zurückgeben.
  • Diese API wird von FragmentActivity in Fragment 1.3.0 verwendet, um den Status der FragmentManager wiederherzustellen. Alle Listener, die Unterklassen von FragmentActivity hinzugefügt werden, werden nach diesem Listener ausgeführt.
  • Diese API wird von AppCompatActivity in AppCompat 1.3.0-alpha02 oder höher verwendet. Alle Listener, die Unterklassen von AppCompatActivity hinzugefügt werden, werden nach diesem Listener ausgeführt.

• ViewTree-Unterstützung: ComponentActivity unterstützt jetzt die APIs ViewTreeLifecycleOwner.get(View), ViewTreeViewModelStoreOwner.get(View) und ViewTreeSavedStateRegistryOwner, die in Lifecycle 2.3.0 und SavedState 1.1.0 hinzugefügt wurden. Die Aktivität wird dann für alle Ansichten, die der ComponentActivity direkt hinzugefügt wurden, als LifecycleOwner, ViewModelStoreOwner und SavedStateRegistryOwner zurückgegeben.

Hinweis :Wenn Sie AppCompatActivity verwenden, müssen Sie AppCompat 1.3.0-alpha01 oder höher verwenden, um ViewTree-Unterstützung zu erhalten.

• Backport von reportFullyDrawn(): Die Activity-Methode von reportFullyDrawn() wurde in ComponentActivity zurückportiert, damit sie auf allen API-Ebenen funktioniert. Dadurch wurde ein Absturz bei API 19 behoben und die Methode für alle API-Ebenen wurde getrackt.

Version 1.2.0-rc01

16. Dezember 2020

androidx.activity:activity:1.2.0-rc01 und androidx.activity:activity-ktx:1.2.0-rc01 werden freigegeben. Version 1.2.0-rc01 enthält diese Commits.

Fehlerkorrekturen

• Mit ActivityResultRegistry wird jetzt immer der genau gespeicherte Status wiederhergestellt. (Idd56b)
• ComponentActivity.reportFullyDrawn (Ic7632) Tracing hinzufügen

Externer Beitrag

• ComponentActivity überschreibt jetzt reportFullyDrawn(), sodass es auf allen API-Ebenen aufgerufen werden kann. Außerdem wurde ein Absturz beim Aufrufen dieser Methode ohne die entsprechende Systemberechtigung auf Geräten mit API 19 behoben. Viele Grüße Simon Schiller (b/163239764, #103)

Version 1.2.0-beta02

2. Dezember 2020

androidx.activity:activity:1.2.0-beta02 und androidx.activity:activity-ktx:1.2.0-beta02 werden freigegeben. Version 1.2.0-beta02 enthält diese Commits.

Fehlerkorrekturen

• Ein Problem wurde behoben, bei dem die Activity Result API bei der Registrierung mit einem Lifecycle nicht auf den Lebenszyklus STARTED wartete, bevor Ergebnisse zurückgegeben wurden. (I109ea)

Externer Beitrag

• Die Dokumentation für launch() wurde aktualisiert, um explizit darauf hinzuweisen, dass eine ActivityNotFoundException geworfen werden kann. Vielen Dank, Michał Zieliński! (aosp/1493580)

Version 1.2.0-beta01

1. Oktober 2020

androidx.activity:activity:1.2.0-beta01 und androidx.activity:activity-ktx:1.2.0-beta01 werden freigegeben. Version 1.2.0-beta01 enthält diese Commits.

Fehlerkorrekturen

• Der ActivityResultRegistry generiert jetzt zufällige Ganzzahlen, bis er eine Ganzzahl findet, die nicht als Anfragecode register() zugewiesen ist. So wird ein möglicher Ganzzahlüberlauf verhindert, der durch das Inkrementieren von Anfragecodes verursacht wird. (b/168779518)

• Lifecycle-Beobachter werden ordnungsgemäß entfernt, wenn unregister() auf einer ActivityResultLauncher aufgerufen wird. (b/165608393)

Verhaltensänderungen

• Die ActivityResultRegistry wirft jetzt eine IllegalStateException, wenn versucht wird, register() mit einer LifecycleOwner aufzurufen, deren Lifecycle bereits STARTED erreicht hat. (b/165435866)

Dokumentation aktualisiert

• In der ContextAware-Dokumentation wird auf LifecycleOwner verwiesen, um Lifecycle-Callbacks als geeigneten Ort für Erstellungs- und Destruktionsereignisse hervorzuheben. (aosp/1414152)

Version 1.2.0-alpha08

19. August 2020

androidx.activity:activity:1.2.0-alpha08 und androidx.activity:activity-ktx:1.2.0-alpha08 werden freigegeben. Version 1.2.0-alpha08 enthält diese Commits.

Neue Funktionen

• ComponentActivity implementiert jetzt ContextAware. Du kannst also eine oder mehrere OnContextAvailableListener-Instanzen hinzufügen, die vor der Basis-Activity.onCreate() einen Rückruf erhalten. (b/161390636)
  • Mit einer anhaltenden Kotlin-Erweiterung withContextAvailable() können Sie einen Block ohne Aussetzung ausführen, wenn der Kontext verfügbar ist, und ein Ergebnis zurückgeben. (I8290c)
  • Diese API wird von FragmentActivity in Fragment 1.3.0-alpha08 verwendet, um den Status der FragmentManager wiederherzustellen. Alle Listener, die Unterklassen von FragmentActivity hinzugefügt werden, werden nach diesem Listener ausgeführt. (I513da)
  • Diese API wird von AppCompatActivity in AppCompat 1.3.0-alpha02 verwendet. Alle Listener, die Unterklassen von AppCompatActivity hinzugefügt werden, werden nach diesem Listener ausgeführt. (I513da)

Fehlerkorrekturen

• Ein Problem mit der ActivityResultFragmentVersionDetector-Lint-Prüfung wurde behoben, das bei Verwendung von Lint 27.1.0 oder höher zu Abstürzen führte. (b/162155191)

Version 1.2.0-alpha07

22. Juli 2020

androidx.activity:activity:1.2.0-alpha07 und androidx.activity:activity-ktx:1.2.0-alpha07 werden freigegeben. Version 1.2.0-alpha07 enthält diese Commits.

Neue Funktionen

• Es wurde eine neue InvalidFragmentVersionForActivityResult-Lint-Prüfung hinzugefügt, die überprüft, ob Sie Fragment 1.3.0-alpha07 verwenden, wenn Sie die Activity Result API verwenden. So werden Laufzeitabstürze aufgrund von Problemen mit ungültigem Anfragecode und nicht funktionierenden Berechtigungsanfragen vermieden, die durch die Verwendung älterer Fragmentversionen verursacht werden. (b/152554847)

Externer Beitrag

• Ein ArrayIndexOutOfBoundsException wurde beim Parsen der Ergebnisse für den RequestPermission-Aktivitätsergebnisvertrag behoben. (I8f9e3, b/161057605)

Version 1.2.0-alpha06

10. Juni 2020

androidx.activity:activity:1.2.0-alpha06 und androidx.activity:activity-ktx:1.2.0-alpha06 werden freigegeben. Version 1.2.0-alpha06 enthält diese Commits.

Neue Funktionen

• Sie können jetzt die Klasse ActivityResult in Kotlin destrukturieren, um direkt auf requestCode und intent zuzugreifen. (b/157212935)
• Mit ActivityResultLauncher können Sie jetzt den ActivityResultContract abrufen, mit dem der Launcher registriert wurde. (b/156875743)

API-Änderungen

• Funktionsgefährdende Änderung: Die Methode invoke() von ActivityResultRegistry wurde in onLaunch() umbenannt. (b/157496491)
• Der OpenMultipleDocuments-Vertrag gibt dem registrierten Rückruf jetzt eine leere Liste anstelle von null zurück, wenn kein Ergebnis zurückgegeben wird. (b/157348014)

Version 1.2.0-alpha05

20. Mai 2020

androidx.activity:activity:1.2.0-alpha05 und androidx.activity:activity-ktx:1.2.0-alpha05 werden freigegeben. Version 1.2.0-alpha05 enthält diese Commits.

Neue Funktionen

• Unterstützung für ViewTreeViewModelStoreOwner aus Lifecycle 2.3.0-alpha03 und ViewTreeSavedStateRegistryOwner aus SavedState 1.1.0-alpha01 hinzugefügt, wenn eine View in einer ComponentActivity verwendet wird. (aosp/1297993, aosp/1300264)

API-Änderungen

• Der TakePicture-Vertrag gibt jetzt ein boolean zurück, das den Erfolg angibt, anstatt eine Miniaturansicht Bitmap, da dies von Kamera-Apps beim Schreiben des Bilds in die angegebene Uri nur sehr selten unterstützt wurde. (b/154302879)
• Die invoke()-Erweiterungen von ActivityResultLauncher wurden entfernt und durch die explizite Verwendung von launch() ersetzt, um besser zu verdeutlichen, dass es sich um asynchrone Vorgänge handelt. Dem androidx.activity.result-Paket für ActivityResultLauncher<Void> und ActivityResultLauncher<Unit> wurden Kotlin-Erweiterungen für launch hinzugefügt, sodass null bzw. Unit nicht mehr übergeben werden müssen. Das entspricht dem Verhalten der bisherigen invoke()-Erweiterungen. (aosp/1304674, aosp/1304675)
• Die IntentSenderRequest.Builder-Methoden für setFlagsMask() und setFlagsValues() wurden in einer einzigen setFlags()-Methode kombiniert. (aosp/1302111)

Fehlerkorrekturen

• Beim Registrieren einer ActivityResultCallback mit einer LifecycleOwner wurde ein Problem behoben, bei dem der Rückruf ausgelöst wurde, bevor der Status STARTED erreicht wurde. (aosp/1309744)

Verhaltensänderungen

• Die ActivityResultRegistry generiert jetzt Anfragecodes, die mit 0xFFFF statt mit 0 beginnen. So wird verhindert, dass sich startActivityForResult() oder requestPermissions() in einer Aktivität überschneiden. (aosp/1302324)

Version 1.2.0-alpha04

29. April 2020

androidx.activity:activity:1.2.0-alpha04 und androidx.activity:activity-ktx:1.2.0-alpha04 werden freigegeben. Version 1.2.0-alpha04 enthält diese Commits.

Neue Funktionen

• Den ActivityResult APIs wurde ein Vertrag hinzugefügt, mit dem startIntentSenderForResult aufgerufen werden kann. (b/153007517)

API-Änderungen

• Die Methode prepareCall() wurde in registerForActivityResult() umbenannt, sowohl hier bei ComponentActivity als auch in Fragment 1.3.0-alpha04. (aosp/1278717)
• Die Verträge GetContents, OpenDocuments und RequestPermissions wurden in GetMultipleContents, OpenMultipleDocuments und RequestMultiplePermissions umbenannt. (aosp/1280161)
• ComponentActivity implementiert jetzt die ActivityResultRegisteryOwner-Schnittstelle. (aosp/1290888)
• – Die APIs startActivityForResult()/onActivityResult() und onRequestPermissionsResult() auf ComponentActivity wurden eingestellt. Verwenden Sie die Activity Result APIs. (b/154751887)

Fehlerkorrekturen

• Wenn du die GetMultipleContents- und OpenMultipleDocuments-Verträge verwendest und einen einzelnen Artikel auswählst, wird er jetzt korrekt an deinen Callback zurückgegeben. (b/152941153)

Version 1.2.0-alpha03

1. April 2020

androidx.activity:activity:1.2.0-alpha03 und androidx.activity:activity-ktx:1.2.0-alpha03 werden freigegeben. Version 1.2.0-alpha03 enthält diese Commits.

Neue Funktionen

• Die Verträge TakeVideo, PickContact, GetContent, GetContents, OpenDocument, OpenDocuments, OpenDocumentTree und CreateDocument wurden zu den von ActivityResultContracts bereitgestellten vordefinierten Verträgen hinzugefügt. (aosp/1262482, aosp/1266916, aosp/1268960)
• Die Activity Result APIs unterstützen jetzt das Starten einer Aktivität für ein Ergebnis mit einer optionalen ActivityOptionsCompat. (b/151860054)

API-Änderungen

• Der TakePicture-Vertrag nimmt jetzt eine Uri-Eingabe für den Speicherort des Bildes an. Der vorherige Vertrag, der keine Eingaben zulässt, wurde in TakePicturePreview umbenannt. (aosp/1262482)
• Die Methode registerActivityResultCallback() von ActivityResultRegistry wurde in register() umbenannt. (aosp/1267621)
• Die Methode dispose() von ActivityResultLauncher wurde in unregister() umbenannt und die unregisterResultCallback() von ActivityResultRegistry wurde entfernt. (aosp/1267621)
• Die createIntent()-Methode von ActivityResultContact nimmt jetzt zusätzlich zur Eingabe eine Context an, um explizite Intents zu erstellen. (aosp/1238800)
• Eine ActivityResultContract kann jetzt getSynchronousResult() überschreiben, um ein Ergebnis zu liefern, ohne startActivityForResult aufzurufen. Dieser Wert wird in den RequestPermission- und RequestPermissions-Verträgen verwendet, um den Status „gewährt“ zu senden, wenn die angeforderten Berechtigungen bereits gewährt wurden. (b/151110799)
• Der zuvor verfügbare Dial-Vertrag wurde entfernt, da diese Intent nicht mit startActivityForResult() verwendet werden soll. (aosp/1266916)
• Viele der Activity Result APIs, die nicht erweitert werden sollen, sind jetzt final. Dazu gehören getActivityResultRegistry(), die prepareCall()-Methoden, alle Methoden von ActivityResultRegistry mit Ausnahme von invoke() und einige der Standardverträge, die keine optionalen Extras unterstützen. (b/152439361)

Fehlerkorrekturen

• Ein Fehler bei NullPointerException in ActivityResultRegistry wurde behoben, der beim Versuch auftrat, Ergebnisse an einen Rückruf zu senden, der nach einer Konfigurationsänderung noch nicht neu registriert wurde. ActivityResultRegistry behält diese ausstehenden Ergebnisse jetzt bei und sendet sie, wenn der Rückruf neu registriert wird. (b/152137004)

Hinweis :Wenn Sie auf „Aktivität 1.2.0-alpha03“ umstellen, müssen Sie auf „Fragment 1.3.0-alpha03“ umstellen, wenn Sie zuvor „Fragment 1.3.0-alpha02“ verwendet haben oder die Verträge RequestPermission oder RequestPermissions verwenden möchten.

Version 1.2.0-alpha02

18. März 2020

androidx.activity:activity:1.2.0-alpha02 und androidx.activity:activity-ktx:1.2.0-alpha02 werden freigegeben. Version 1.2.0-alpha02 enthält diese Commits.

Neue Funktionen

• ActivityResultRegistry: ComponentActivity bietet jetzt eine ActivityResultRegistry, mit der Sie die Abläufe startActivityForResult()+onActivityResult() sowie requestPermissions()+onRequestPermissionsResult() verarbeiten können, ohne Methoden in Ihrer Aktivität oder Ihrem Fragment zu überschreiben. Außerdem bietet sie über ActivityResultContract eine verbesserte Typsicherheit und Hooks zum Testen dieser Abläufe. Weitere Informationen finden Sie im aktualisierten Hilfeartikel Ergebnis aus einer Aktivität abrufen. (b/125158199)

Hinweis: Wenn Sie auf „Aktivität“ 1.2.0-alpha02 umstellen, müssen Sie auf Fragment 1.3.0-alpha02 oder höher umstellen, um die RequestPermission- oder RequestPermissions-Aktivitätsergebnisverträge verwenden zu können.

Version 1.2.0-alpha01

4. März 2020

androidx.activity:activity:1.2.0-alpha01 und androidx.activity:activity-ktx:1.2.0-alpha01 werden freigegeben. Version 1.2.0-alpha01 enthält diese Commits.

Neue Funktionen

• Die ViewTreeLifecycleOwner.get(View) API, die im Lebenszyklus 2.3.0-alpha01 hinzugefügt wurde, wird jetzt unterstützt. Die Aktivität wird dann als LifecycleOwner für alle Aufrufe zurückgegeben, die der Aktivität direkt hinzugefügt wurden. (aosp/1182955)

Fehlerkorrekturen

• Eine Regression wurde behoben, die in „Aktivitäten“ 1.1.0 unter älteren Versionen der Plattform auftrat. Dabei führte onBackPressed() aufgrund eines Fehlers in android.app.FragmentManager zu einer IllegalStateException. (b/146290338)

Version 1.1.0

Hinweis: Die Kotlin-abhängigen Bibliotheken dieser Version (activity-ktx) sind auf den Bytecode der Programmiersprache Java 8 ausgerichtet. Weitere Informationen zur Verwendung in Ihrem Projekt finden Sie unter Java 8-Sprachfunktionen verwenden.

Version 1.1.0

22. Januar 2020

androidx.activity:activity:1.1.0 wird veröffentlicht. Version 1.1.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.0.0

• Integration von Lifecycle ViewModel SavedState: SavedStateViewModelFactory ist jetzt die Standard-Factory, die bei Verwendung von by viewModels(), dem ViewModelProvider-Konstruktor oder ViewModelProviders.of() mit einer ComponentActivity oder einer ihrer Unterklassen verwendet wird.

Version 1.1.0-rc03

4. Dezember 2019

androidx.activity:activity:1.1.0-rc03 und androidx.activity:activity-ktx:1.1.0-rc03 werden freigegeben. Version 1.1.0-rc03 enthält diese Commits.

Änderungen an Abhängigkeiten

• Die Aktivität hängt jetzt vom Lebenszyklus 2.2.0-rc03 und vom Lebenszyklus-ViewModel-Speicherstatus 1.0.0-rc03 ab.

Version 1.1.0-rc02

7. November 2019

androidx.activity:activity:1.1.0-rc02 und androidx.activity:activity-ktx:1.1.0-rc02 werden freigegeben. Version 1.1.0-rc02 enthält diese Commits.

Änderungen an Abhängigkeiten

• Die Aktivität hängt jetzt vom Lebenszyklus 2.2.0-rc02 ab.

Version 1.1.0-rc01

23. Oktober 2019

androidx.activity:activity:1.1.0-rc01 und androidx.activity:activity-ktx:1.1.0-rc01 werden ohne Änderungen gegenüber 1.1.0-beta01 veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

Version 1.1.0-beta01

9. Oktober 2019

androidx.activity:activity:1.1.0-beta01 und androidx.activity:activity-ktx:1.1.0-beta01 werden freigegeben. Version 1.1.0-beta01 enthält diese Commits.

Änderungen an Abhängigkeiten

• Die Aktivität hängt jetzt von SavedState 1.0.0 stable ab.

Version 1.1.0-alpha03

5. September 2019

androidx.activity:activity:1.1.0-alpha03 und androidx.activity:activity-ktx:1.1.0-alpha03 werden freigegeben. Die Commits, die in dieser Version enthalten sind, finden Sie hier.

Neue Funktionen

• Die Aktivität hängt jetzt von Core 1.1.0 Stable ab.

Fehlerkorrekturen

• Die Aktivität hängt jetzt vom Lebenszyklus 2.2.0-alpha04 ab.

Version 1.1.0-alpha02

7. August 2019

androidx.activity:activity:1.1.0-alpha02 und androidx.activity:activity-ktx:1.1.0-alpha02 werden freigegeben. Die Commits, die in dieser Version enthalten sind, finden Sie hier.

Neue Funktionen

• SavedStateViewModelFactory ist jetzt die Standard-Fabrik, die bei Verwendung von by viewModels(), dem ViewModelProvider-Konstruktor oder ViewModelProviders.of() mit einer ComponentActivity verwendet wird (b/135716331)

Version 1.1.0-alpha01

2. Juli 2019

androidx.activity:activity:1.1.0-alpha01 und androidx.activity:activity-ktx:1.1.0-alpha01 werden freigegeben. Die Commits, die in dieser Version enthalten sind, finden Sie hier.

Neue Funktionen

• activity ist jetzt vom Lebenszyklus 2.2.0-alpha02 abhängig. (aosp/1007817)
• activity-ktx hat eine Abhängigkeit von lifecycle-runtime-ktx hinzugefügt. Sie müssen sie nicht mehr explizit zu Ihren Abhängigkeiten hinzufügen, wenn Sie activity-ktx oder Bibliotheken verwenden, die von activity-ktx abhängen (z. B. fragment-ktx). (aosp/987162)

Version 1.0.0

Version 1.0.0

5. September 2019

androidx.activity:activity:1.0.0 und androidx.activity:activity-ktx:1.0.0 werden freigegeben. Die Commits, die in dieser Version enthalten sind, finden Sie hier.

Wichtige Funktionen von 1.0.0

• ComponentActivity: ComponentActivity dient als neue Basisklasse für FragmentActivity in Fragment 1.1.0 und damit auch für AppCompatActivity in AppCompat 1.1.0.
• activity-ktx: Das activity-ktx-Modul enthält eine by viewModels-Kotlin-Eigenschaftserweiterung für den Zugriff auf ViewModels. Dieses Modul wird automatisch eingefügt, wenn du fragment-ktx aus Fragment 1.1.0 einfügst.
• OnBackPressedDispatcher: Als kombinierbare Alternative zum Überschreiben von onBackPressed() können Sie jetzt eine OnBackPressedCallback von jedem LifecycleOwner (z. B. einem Fragment) registrieren, um Ereignisse der Rückwärtsschaltfläche des Systems abzufangen. activity-ktx wurde eine Lambda-Funktion mit der Empfängerversion addCallback hinzugefügt. Weitere Informationen finden Sie unter Dokumentation zur benutzerdefinierten Rücknavigation bereitstellen.
• Einstellung „onRetainCustomNonConfigurationInstance“ eingestellt: Die onRetainCustomNonConfigurationInstance() API und die zugehörige getLastCustomNonConfigurationInstance() API wurden eingestellt. Wir empfehlen dringend, ViewModels zum Speichern von nicht konfigurationsspezifischen Status zu verwenden. Sie bieten eine kombinierbare Lösung, die für jede ViewModelStoreOwner geeignet ist, die die Inhaberschaft der beibehaltenen Objekte klar macht und einen onCleared()-Callback zum Bereinigen von Ressourcen bereitstellt, wenn die Aktivität endgültig zerstört wird.

Version 1.0.0-rc01

2. Juli 2019

androidx.activity:activity:1.0.0-rc01 und androidx.activity:activity-ktx:1.0.0-rc01 werden ohne Änderungen gegenüber 1.0.0-beta01 veröffentlicht. Die Commits, die in dieser Version enthalten sind, finden Sie hier.

Version 1.0.0-beta01

5. Juni 2019

androidx.activity::activity:1.0.0-beta01 und androidx.activity:activity-ktx:1.0.0-beta01 werden ohne Änderungen gegenüber 1.0.0-alpha08 veröffentlicht. Die Commits, die in dieser Version enthalten sind, finden Sie hier.

Version 1.0.0-alpha08

7. Mai 2019

androidx.activity:activity:1.0.0-alpha08 und androidx.activity:activity-ktx:1.0.0-alpha08 werden freigegeben. Die Commits, die in dieser Version enthalten sind, finden Sie hier.

API-Änderungen

• Funktionsgefährdende Änderung: Die zuvor eingestellten Methoden addOnBackPressedCallback und removeOnBackPressedCallback für ComponentActivity wurden entfernt. aosp/953857
• Die Methoden setEnabled() und isEnabled() von OnBackPressedCallback sind jetzt endgültig. b/131416833
• Die remove()-Methode von OnBackPressedCallback ist jetzt endgültig. aosp/952720
• OnBackPressedDispatcher hat jetzt öffentliche Konstruktoren, mit denen Sie eigene Instanzen für Tests erstellen können. aosp/953431
• onBackPressed() für ComponentActivity ist jetzt explizit als @MainThread gekennzeichnet aosp/952721

Fehlerkorrekturen

• Ein ConcurrentModificationException wurde behoben, das beim Aufrufen von remove() aus der handleOnBackPressed()-Methode eines OnBackPressedCalback auftrat, das mit einem LifecycleOwner hinzugefügt wurde. b/131765095

Version 1.0.0-alpha07

25. April 2019

androidx.activity:activity:1.0.0-alpha07 und androidx.activity:activity-ktx:1.0.0-alpha07 werden freigegeben. Die Commits, die in dieser Version enthalten sind, finden Sie hier.

API-Änderungen

Mit dieser Version werden wichtige Änderungen an der Verarbeitung der onBackPressed() vorgenommen. Weitere Informationen finden Sie in der aktualisierten Dokumentation zu benutzerdefinierten Rückseiten.

• Die Methoden für OnBackPressedCallback und OnBackPressedDispatcher wurden als @MainThread gekennzeichnet. (aosp/943813)
• Die handleOnBackPressed()-Methode gibt keine boolean mehr zurück. Stattdessen ist OnBackPressedCallback jetzt eine abstrakte Klasse, die aktiviert oder deaktiviert werden kann. Nur wenn die neue isEnabled()-Methode „true“ zurückgibt, wird handleOnBackPressed() aufgerufen. In diesem Fall müssen Sie die Schaltfläche „Zurück“ verarbeiten. (aosp/944518)
• Die addCallback-Methoden von OnBackPressedDispatcher geben keine Cancellable-Instanz mehr zurück. OnBackPressedCallback enthält jetzt eine remove()-Methode, die diese Funktion erfüllt. So können Sie remove() während handleOnBackPressed() aufrufen. (aosp/944519) (aosp/946316)
• activity-ktx enthält jetzt einen Callback auf Empfängerebene für addCallback, der eine Lambda-Funktion akzeptiert, die handleOnBackPressed() implementiert und Zugriff auf isEnabled und remove() hat (aosp/944520)

Version 1.0.0-alpha06

3. April 2019

androidx.activity:activity:1.0.0-alpha06 und androidx.activity:activity-ktx:1.0.0-alpha06 werden freigegeben. Die Commits, die in dieser Version enthalten sind, finden Sie hier.

API-Änderungen

• ComponentActivity enthält jetzt einen zweiten Konstruktor, der einen @LayoutRes int annimmt. Damit wird das vorherige Verhalten ersetzt, bei dem die AppCompatActivity-Klasse mit @ContentView annotiert wurde. Dieser Ansatz funktioniert sowohl in App- als auch in Bibliotheksmodulen. (b/128352521)
• Die OnBackPressedCallback-bezogenen APIs für ComponentActivity wurden zugunsten der neuen OnBackPressedDispatcher eingestellt, die über getOnBackPressedDispatcher() abgerufen werden kann. (aosp/922523)
• Methoden zum Hinzufügen eines neuen OnBackPressedCallback zum OnBackPressedDispatcher geben jetzt ein Cancellable-Objekt zurück. So kann der Rückruf entfernt werden, ohne dass ein expliziter Verweis auf das OnBackPressedDispatcher erforderlich ist. (aosp/922523)
• Wenn Sie eine OnBackPressedCallback mit einer zugehörigen LifecycleOwner hinzufügen, wird die OnBackPressedCallback jetzt beim Starten bzw. Beenden des Lebenszyklus hinzugefügt oder entfernt. (aosp/922523)

Version 1.0.0-alpha05

13. März 2019

androidx.activity:activity:1.0.0-alpha05 und androidx.activity:activity-ktx:1.0.0-alpha05 werden veröffentlicht. Eine vollständige Liste der Commits, die in dieser Version enthalten sind, finden Sie hier.

Neue Funktionen

• @ContentView Anmerkungsabfragen werden jetzt im Cache gespeichert (b/123709449)

Version 1.0.0-alpha04

30. Januar 2019

androidx.activity:activity 1.0.0-alpha04 und androidx.activity:activity-ktx 1.0.0-alpha04 werden freigegeben.

Neue Funktionen

• Unterstützung für die @ContentView-Klassenannotation hinzugefügt, mit der Sie angeben können, welche Layout-XML-Datei anstelle von setContentView() aufgebläht werden soll. (aosp/837619)

API-Änderungen

• Hinweis hinzugefügt, dass getViewModelStore() nicht überschrieben werden sollte und in einem zukünftigen Release endgültig festgelegt wird. Wenn Sie diese Methode derzeit überschreiben, stellen Sie bitte eine Funktionsanfrage. (aosp/837619)

Fehlerkorrekturen

• Das activity-Modul hängt jetzt von Version 2.1.0-alpha02 von ViewModel ab, um der Abhängigkeit des activity-ktx-Moduls zu entsprechen.

Version 1.0.0-alpha03

17. Dezember 2018

androidx.activity 1.0.0-alpha03 wird veröffentlicht.

Neue Funktionen

• ComponentActivity implementiert jetzt BundleSavedStateRegistryOwner und ist von der neu veröffentlichten SavedState-Bibliothek abhängig [aosp/815133]
• Bei ComponentActivity wird jetzt ein Fehler im Android-Framework umgangen, der dazu führte, dass der InputMethodManager die zuletzt fokussierte Ansicht leckte [b/37122102]

Version 1.0.0-alpha02

3. Dezember 2018

API-Änderungen

• Hinweis hinzugefügt, dass getLifecycle() nicht überschrieben werden sollte und in einer zukünftigen Version zu final wird. Wenn Sie diese Methode derzeit überschreiben, stellen Sie bitte eine Funktionsanfrage. (aosp/815834)

Version 1.0.0-alpha01

5. November 2018

In androidx.activity 1.0.0-alpha01 wird ComponentActivity eingeführt, eine neue Basisklasse der vorhandenen FragmentActivity und AppCompatActivity.

Neue Funktionen

• Sie können jetzt eine OnBackPressedCallback über addOnBackPressedCallback registrieren, um onBackPressed()-Callbacks zu erhalten, ohne die Methode in Ihrer Aktivität überschreiben zu müssen.
• Es wurde ein neuer by viewModels()-Kotlin-Property-Delegierter zum Abrufen von ViewModels aus einer ComponentActivity hinzugefügt.
• Ausstehende Eingabeereignisse wie Klicks werden in onStop() jetzt abgebrochen.

API-Änderungen

• Die Implementierung von LifecycleOwner und ViewModelStoreOwner wurde von FragmentActivity nach ComponentActivity verschoben.
• onRetainCustomNonConfigurationInstance wurde eingestellt. Verwenden Sie ViewModel zum Speichern von Objekten, die Konfigurationsänderungen überstehen müssen.