Activité

Déclarer des dépendances

Pour ajouter une dépendance sur Activity, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

dependencies {
    def activity_version = "1.9.0"

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

dependencies {
    val activity_version = "1.9.0"

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

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Version 1.9

Version 1.9.0

17 avril 2024

Publication d'androidx.activity:activity:1.9.0, androidx.activity:activity-compose:1.9.0 et androidx.activity:activity-ktx:1.9.0. La version 1.9.0 contient ces commits.

Changements importants depuis la version 1.8.0

• ComponentActivity implémente désormais OnUserLeaveHintProvider pour permettre aux composants de rappeler les événements onUserLeaveHint.
• Les API OnBackPressedCallback, BackHandler et PredictiveBackHandler vous avertissent désormais lorsque vous appelez onBackPressedDispatcher.onBackPressed() lors du traitement du retour, car cela interrompra toujours l'animation de prévisualisation du Retour. Pour en savoir plus, consultez le guide des bonnes pratiques.
• Le reste des API Activity a été réécrit en Kotlin et toutes les extensions auparavant disponibles dans activity-ktx ont été déplacées vers activity. activity-ktx est désormais complètement vide.
  • Dans le cadre de la conversion de ActivityResultLauncher en Kotlin, la méthode getContract est désormais une propriété Kotlin abstraite. Il s'agit d'une modification compatible avec le binaire, mais la source ne fonctionne pas si votre implémentation de ActivityResultLauncher est écrite en Kotlin.

Version 1.9.0-rc01

3 avril 2024

Publication d'androidx.activity:activity:1.9.0-rc01, androidx.activity:activity-compose:1.9.0-rc01 et androidx.activity:activity-ktx:1.9.0-rc01. La version 1.9.0-rc01 contient ces commits.

Mise à jour de la dépendance

• Activity dépend désormais de Profile Installer 1.3.1.

Version 1.9.0-beta01

20 mars 2024

Publication d'androidx.activity:activity:1.9.0-beta01, androidx.activity:activity-compose:1.9.0-beta01 et androidx.activity:activity-ktx:1.9.0-beta01. La version 1.9.0-beta01 contient ces commits.

Correction de bugs

• Correction d'une régression des performances de démarrage d'activité introduite dans Activity 1.9.0-alpha02, causée par l'appel de OnBackPressedDispatcher lors de la création de l'activité. (Ie75e3).

Version 1.9.0-alpha03

7 février 2024

Publication d'androidx.activity:activity:1.9.0-alpha03, androidx.activity:activity-compose:1.9.0-alpha03 et androidx.activity:activity-ktx:1.9.0-alpha03. Liste des commits de la version 1.9.0-alpha03

Avertissement lint

• Les API OnBackPressedCallback, BackHandler et PredictiveBackHandler vous avertissent désormais lorsque vous appelez onBackPressedDispatcher.onBackPressed() lors du traitement du retour, car cela interrompra toujours l'animation de prévisualisation du Retour. Pour en savoir plus, consultez le guide des bonnes pratiques. (1e4222, 2c950d, b/287505200).

Correction de bugs

• Si un événement de retour est envoyé par le système démarré lors d'une prévisualisation du geste Retour en cours, celle-ci est annulée et le nouvel événement de retour prend le relais pour lancer une nouvelle prévisualisation du geste Retour. (I3482e).
• Correction d'un plantage lors du premier accès à onBackPressedDispatcher depuis un ComponentActivity depuis un thread d'arrière-plan. Vous pouvez désormais accéder en toute sécurité à onBackPressedDispatcher sur n'importe quel thread. (I79955).

Version 1.9.0-alpha02

24 janvier 2024

Publication d'androidx.activity:activity:1.9.0-alpha02, androidx.activity:activity-compose:1.9.0-alpha02 et androidx.activity:activity-ktx:1.9.0-alpha02. Liste des commits de la version 1.9.0-alpha02

Conversions Kotlin

• ActivityResultRegistry a été réécrit en Kotlin. Cela garantit que la possibilité de valeur nulle des génériques du contrat transmis à register sera correctement transmise au ActivityResultLauncher qui vous sera renvoyé. (I121f0).
• ActivityResult a été réécrit en Kotlin. Les extensions Kotlin ActivityResult compatibles avec la déstructuration dans les champs resultCode et data ont été déplacées de activity-ktx vers activity. (I0565a).
• Les extensions Kotlin de by viewModels() pour ComponentActivity et trackPipAnimationHintView ont été déplacées de activity-ktx vers activity. L'artefact activity-ktx est désormais complètement vide. (I0a444).

Correction de bugs

• L'API enableEdgeToEdge dessine désormais les découpes d'écran. (a3644b, b/311173461).
• À partir de Activity 1.8.2: correction de l'extra transmis au ACTION_SYSTEM_FALLBACK_PICK_IMAGES du contrat d'activité du sélecteur de photos afin de lui transmettre correctement la clé EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX, au lieu d'utiliser l'extra avec la clé "com.google.android.gms.provider.extra.PICK_IMAGES_MAX". Il est vivement recommandé si vous êtes un OEM et que vous implémentez un sélecteur de photos de remplacement du système pour prendre en charge ces deux extras et garantir une compatibilité optimale. (I96a00).

Version 1.9.0-alpha01

29 novembre 2023

Publication d'androidx.activity:activity:1.9.0-alpha01, androidx.activity:activity-compose:1.9.0-alpha01 et androidx.activity:activity-ktx:1.9.0-alpha01. Liste des commits de la version 1.9.0-alpha01

Nouvelles fonctionnalités

• ComponentActivity implémente désormais OnUserLeaveHintProvider pour permettre aux composants de rappeler les événements onUserLeaveHint. (I54892).

Modifications apportées à l'API

• ComponentActivity a été réécrit en Kotlin. (I14f31).
• ActivityResultCaller a été réécrit en Kotlin. (Ib02e4).
• ActivityResultLauncher a été réécrit en Kotlin. Lors de cette conversion, la méthode getContract est désormais une propriété Kotlin abstraite. Il s'agit d'une modification compatible avec le binaire, mais la source ne fonctionne pas si votre implémentation de ActivityResultLauncher est écrite en Kotlin. (Id4615).
• PickVisualMediaRequest dispose désormais du même niveau d'API minimal de 19 que le contrat Activity Result PickVisualMedia. (Id6e21).

Mise à jour de la dépendance

• Activity dépend désormais de Core 1.13.0-alpha01. (I14f31).

Version 1.8

Version 1.8.2

13 décembre 2023

Publication d'androidx.activity:activity:1.8.2, androidx.activity:activity-compose:1.8.2 et androidx.activity:activity-ktx:1.8.2. Liste des commits de la version 1.8.2

Correction de bugs

• Correction de l'extra transmis au ACTION_SYSTEM_FALLBACK_PICK_IMAGES du contrat d'activité du sélecteur de photos afin de lui transmettre correctement la clé EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX, au lieu de l'utiliser avec la clé "com.google.android.gms.provider.extra.PICK_IMAGES_MAX". Il est vivement recommandé si vous êtes un OEM et que vous implémentez un sélecteur de photos de remplacement du système pour prendre en charge ces deux extras et garantir une compatibilité optimale. (I96a00).

Version 1.8.1

15 novembre 2023

Publication d'androidx.activity:activity:1.8.1, androidx.activity:activity-compose:1.8.1 et androidx.activity:activity-ktx:1.8.1. Liste des commits de la version 1.8.1

Correction de bugs

• OnBackPressedDispatcher continue désormais à envoyer au OnBackPressedCallback approprié, même après l'ajout d'un nouveau OnBackPressedCallback pendant que le geste Retour est géré. (Id0ff6).

Version 1.8.0

4 octobre 2023

Publication d'androidx.activity:activity:1.8.0, androidx.activity:activity-compose:1.8.0 et androidx.activity:activity-ktx:1.8.0. Liste des commits de la version 1.8.0

Changements importants depuis la version 1.7.0

• Prédiction du retour : OnBackPressedCallback propose désormais de nouveaux rappels de prévisualisation du Retour pour gérer le démarrage du geste Retour, la progression tout au long du geste et l'annulation du geste Retour, en plus du rappel handleOnBackPressed() précédent lorsque le geste Retour est validé. Cela inclut également le composable PredictiveBackHandler, qui permet de gérer les événements de prévisualisation du geste Retour dans Activity Compose. Il fournit un flux d'objets BackEventCompat qui doivent être collectés dans le lamba de suspension que vous fournissez:

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

Abandon de ComponentActivity.onBackPressed() au profit des API de traitement. Les développeurs doivent désormais utiliser OnBackPressedDispatcher au lieu de remplacer cette méthode.

• EdgeToEdge : ComponentActivity.enableEdgeToEdge() a été ajouté pour faciliter la configuration de l'écran bord à bord, d'une manière rétrocompatible.

Version 1.8.0-rc01

20 septembre 2023

Publication d'androidx.activity:activity:1.8.0-rc01, androidx.activity:activity-compose:1.8.0-rc01 et androidx.activity:activity-ktx:1.8.0-rc01. Liste des commits de la version 1.8.0-rc01

Version 1.8.0-beta01

6 septembre 2023

Publication d'androidx.activity:activity:1.8.0-beta01, androidx.activity:activity-compose:1.8.0-beta01 et androidx.activity:activity-ktx:1.8.0-beta01. Liste des commits de la version 1.8.0-beta01

Amélioration de la documentation

• Amélioration de la documentation de BackEventCompat. (aosp/2722254).

Version 1.8.0-alpha07

23 août 2023

Publication d'androidx.activity:activity:1.8.0-alpha07, androidx.activity:activity-compose:1.8.0-alpha07 et androidx.activity:activity-ktx:1.8.0-alpha07. Liste des commits de la version 1.8.0-alpha07

Nouvelles fonctionnalités

• Activity Compose a ajouté un nouveau composable PredictiveBackHandler pour gérer les événements de prévisualisation du geste Retour. Elle fournit une Flow d'objets BackEventCompat qui doivent être collectés dans le lamba de suspension que vous fournissez:

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

  Il s'accompagne également d'un avertissement au moment de la compilation via une règle lint pour s'assurer que Flow appelle collect(). (Id2773, b/294884345).

• onBackPressedDispatcher dans ComponentActivity est désormais initialisé en différé afin d'être créé uniquement lorsque cela est nécessaire. (I0bf8e).

Correction de bugs

• ComponentActivity n'affiche plus d'exception NPE sur Android 13 lorsqu'il reçoit un rappel onBackPressed() et que l'activité a déjà été DESTROYED. (Idb055, b/291869278).
• Suppression des utilisations de l'API isAtLeastU() expérimentale. (Ie9117, b/289269026)

Version 1.8.0-alpha06

21 juin 2023

Publication d'androidx.activity:activity:1.8.0-alpha06, androidx.activity:activity-compose:1.8.0-alpha06 et androidx.activity:activity-ktx:1.8.0-alpha06. Liste des commits de la version 1.8.0-alpha06

Nouvelles fonctionnalités

• OnBackPressedDispatcher annule désormais correctement tous les rappels supprimés lors de la prévisualisation du geste Retour. (I3f90f).

Modifications apportées à l'API

• Lorsque vous transmettez SystemBarStyle.auto à l'API enableEdgeToEdge, vous pouvez désormais ignorer le paramètre lambda detectDarkMode pour fournir une logique personnalisée permettant de détecter le mode Nuit. (aosp/2546393, b/278263793).

Version 1.8.0-alpha05

7 juin 2023

Publication d'androidx.activity:activity:1.8.0-alpha05, androidx.activity:activity-compose:1.8.0-alpha05 et androidx.activity:activity-ktx:1.8.0-alpha05. Cette version est développée dans une branche interne.

Modifications apportées à l'API

• Activity fournit désormais une classe BackEventCompat qui sert de version rétrocompatible de BackEvent, dissociée de la classe BackEvent du framework.
• Modification destructive:Les méthodes handleOnBackStarted et handleOnBackProgressed de OnBackPressedCallback reçoivent désormais une instance androidx.activity.BackEventCompat au lieu d'une classe android.window.BackEvent du framework. Les API @VisibleForTesting équivalentes sur OnBackPressedDispatcher ont également été mises à jour.
• Le constructeur de OnBackPressedDispatcher utilise désormais une instance Consumer<Boolean> facultative qui permet aux propriétaires du coordinateur de recevoir un rappel chaque fois que le nombre de rappels activés passe de zéro à un nombre non nul ou inversement.

Correction de bugs

• À partir de Activity 1.7.2: correction du plantage de ReportDrawn lorsque l'utilisateur quitte un écran avant l'appel de report. (Ic46f1, b/260506820).

Version 1.8.0-alpha04

10 mai 2023

Publication d'androidx.activity:activity:1.8.0-alpha04, androidx.activity:activity-compose:1.8.0-alpha04 et androidx.activity:activity-ktx:1.8.0-alpha04. Publication à partir d'une branche interne.

Correction de bugs

• À partir de Activity 1.7.1 : le ReportFullyDrawExecuter ne fuit plus lorsque vous utilisez ComponentActivity avec ActivityScenario. (Id2ff2, b/277434271).

Version 1.8.0-alpha03

12 avril 2023

Publication d'androidx.activity:activity:1.8.0-alpha03, androidx.activity:activity-compose:1.8.0-alpha03 et androidx.activity:activity-ktx:1.8.0-alpha03. Publication à partir d'une branche interne.

Nouvelles fonctionnalités

• Ajout de ComponentActivity.setUpEdgeToEdge() pour configurer facilement l'écran bord à bord d'une manière rétrocompatible.

Modifications apportées à l'API

• Abandon de ComponentActivity.onBackPressed() au profit des API de traitement. Les développeurs doivent désormais utiliser OnBackPressedDispatcher au lieu de remplacer cette méthode. (Ibce2f, b/271596918).
• ComponentDialog et ComponentActivity contiennent désormais l'API publique initViewTreeOwners() à utiliser pour initialiser tous les propriétaires de l'arborescence de vue avant de définir la vue de contenu. (Ibdce0, b/261314581).

Correction de bugs

• Correction d'un problème qui empêchait les fragments d'invalider par erreur les MenuHosts et d'entraîner le comportement inattendu d'autres menus de l'activité. (I9404e, b/244336571).

Autres changements

• ActivityResultRegister utilise désormais Kotlin Random au lieu de Java. (I4d98f, b/272096025).

Version 1.8.0-alpha02

8 mars 2023

Publication d'androidx.activity:activity:1.8.0-alpha02, androidx.activity:activity-compose:1.8.0-alpha02 et androidx.activity:activity-ktx:1.8.0-alpha02. Développé à partir d'une branche interne.

Mise à jour de la dépendance

• À partir de Activity 1.7.0-rc01: l'activité dépend désormais de Lifecycle 2.6.0.

Version 1.8.0-alpha01

8 février 2023

Publication d'androidx.activity:activity:1.8.0-alpha01, androidx.activity:activity-compose:1.8.0-alpha01 et androidx.activity:activity-ktx:1.8.0-alpha01. Créé à partir d'une branche interne.

Nouvelles fonctionnalités

• La classe OnBackPressedCallback contient désormais de nouveaux rappels de progression de la prévisualisation du Retour pour gérer le démarrage du geste de retour, la progression tout au long de ce geste et son annulation en plus du rappel handleOnBackPressed() précédent lorsque le geste de retour est validé.

Version 1.7

Version 1.7.2

24 mai 2023

Publication d'androidx.activity:activity:1.7.2, androidx.activity:activity-compose:1.7.2 et androidx.activity:activity-ktx:1.7.2. Liste des commits de la version 1.7.2

Correction de bugs

• Correction du plantage de ReportDrawn lors de la sortie d'un écran avant l'appel de report. (Ic46f1, b/260506820).

Version 1.7.1

19 avril 2023

Publication d'androidx.activity:activity:1.7.1, androidx.activity:activity-compose:1.7.1 et androidx.activity:activity-ktx:1.7.1. Liste des commits de la version 1.7.1

Correction de bugs

• Correction du problème de fuite de ReportFullyDrawExecuter lors de l'utilisation de ComponentActivity avec ActivityScenario. (Id2ff2, b/277434271).

Version 1.7.0

22 mars 2023

Publication d'androidx.activity:activity:1.7.0, androidx.activity:activity-compose:1.7.0 et androidx.activity:activity-ktx:1.7.0. Liste des commits de la version 1.7.0

Changements importants depuis la version 1.6.0

• Les contrats d'activité du sélecteur de photos dans PickVisualMedia et PickMultipleVisualMedia ont été mis à jour pour inclure une solution de remplacement supplémentaire lorsque MediaStore.ACTION_PICK_IMAGES est indisponible. Cela permet aux OEM et aux applications système, telles que les services Google Play, d'offrir une expérience cohérente dans le sélecteur de photos sur un plus grand nombre d'appareils Android et de niveaux d'API en implémentant l'action de remplacement. Le sélecteur de photos utilisera cette création de remplacement si elle est disponible avant de revenir à Intent.ACTION_OPEN_DOCUMENT, qui reste compatible avec tous les appareils utilisant l'API 19 et les versions ultérieures.
• ComponentDialog implémente désormais SavedStateRegistryOwner, a accès à son propre SavedStateRegistry et définit SavedStateRegistryOwner pour son ViewTree. Il est désormais possible d'utiliser Jetpack Compose dans un ComponentDialog, car il répond aux exigences LifecycleOwner et SavedStateRegistryOwner associées à la fenêtre via les exigences des API ViewTree.
• IntentSenderRequest.Builder.setFlags() vous permet désormais de définir plusieurs indicateurs à partir d'Intent au lieu d'un seul.

Conversion Kotlin

Un certain nombre de classes Activity ont été converties en Kotlin. Toutes les classes converties conservent leur compatibilité binaire avec les versions précédentes. Les classes suivantes comportent des modifications incompatibles avec la source pour les classes écrites en Kotlin: ActivityResultRegistryOwner et OnBackPressedDispatcherOwner.

Le tableau ci-dessous présente les conversions sources pour la nouvelle version de l'activité:

Ces classes ont également été converties en Kotlin, mais restent compatibles avec la source: ContextAware, ContextAwareHelper, OnContextAvailableListener, IntentSenderRequest et OnBackPressedDispatcher.

API FullyDrawnReporter

ComponentActivity fournit maintenant une instance FullyDrawnReporter qui permet à plusieurs composants d'indiquer qu'ils sont prêts à interagir. ComponentActivity attend que tous les composants aient terminé avant d'appeler reportFullyDrawn() en votre nom. Ces API s'occupent des exigences temporelles et n'ont pas besoin d'être appelées dans le cadre d'un appel onDraw.

Nous vous encourageons à activer les API suivantes :

• Envoi d'un signal à Android Runtime lorsque le démarrage est terminé pour s'assurer que tout le code exécuté au cours d'une séquence de démarrage multiframe est inclus et prioritaire pour la compilation en arrière-plan
• Envoi d'un signal à Macrobenchmark et Play Vitals lorsque votre application doit être considérée comme entièrement dessinée pour les métriques de démarrage, afin que vous puissiez suivre les performances

Trois API Activity Compose ont été ajoutées pour faciliter l'utilisation de FullyDrawnReporter à partir de composables individuels:

• ReportDrawn indique que votre composable est immédiatement prêt à interagir.
• ReportDrawnWhen utilise un prédicat (par exemple, list.count > 0) pour indiquer à quel moment votre composable est prêt à interagir.
• ReportDrawnAfter utilise une méthode de suspension qui, lorsqu'elle s'achève, indique que vous êtes prêt à interagir.

Mises à jour des dépendances

• Activity dépend désormais de Lifecycle 2.6.1. (8fc31d).
• Activity dépend désormais de ProfileInstaller 1.3.0. (83d3b1).

Version 1.7.0-rc01

8 mars 2023

Publication d'androidx.activity:activity:1.7.0-rc01, androidx.activity:activity-compose:1.7.0-rc01 et androidx.activity:activity-ktx:1.7.0-rc01. Liste des commits de la version 1.7.0-rc01

Mise à jour de la dépendance

• Activity dépend désormais de Lifecycle 2.6.0.

Version 1.7.0-beta02

22 février 2023

Publication d'androidx.activity:activity:1.7.0-beta02, androidx.activity:activity-compose:1.7.0-beta02 et androidx.activity:activity-ktx:1.7.0-beta02. Liste des commits de la version 1.7.0-beta02

Modifications apportées à l'API

• L'action et l'extra utilisés par les contrats PickVisualMedia et PickMultipleVisualMedia en tant que solution de secours lorsque MediaStore.ACTION_PICK_IMAGES est indisponible sont désormais des constantes publiques qui offrent la stabilité de l'API aux OEM et aux applications système qui souhaitent offrir une expérience cohérente avec le sélecteur de photos. L'implémentation de cette création de remplacement est toujours limitée aux applications système. (Icd320).

Version 1.7.0-beta01

8 février 2023

Publication d'androidx.activity:activity:1.7.0-beta01, androidx.activity:activity-compose:1.7.0-beta01 et androidx.activity:activity-ktx:1.7.0-beta01. Liste des commits de la version 1.7.0-beta01

Nouvelles fonctionnalités

• IntentSenderRequest.Builder.setFlags() vous permet désormais de définir plusieurs indicateurs à partir d'Intent au lieu d'un seul. (Iac04c)

Correction de bugs

• L'élément de substitution de PickVisualMedia lorsque le sélecteur de photos du framework est indisponible limite désormais le traitement aux applications installées sur l'image système de l'appareil. (If8ae6)

Conversions Kotlin

• ActivityResultRegistryOwner est désormais écrit en Kotlin. Il s'agit d'une modification incompatible avec la source pour les classes écrites en Kotlin. Vous devez maintenant remplacer la propriété activityResultRegistry au lieu d'implémenter la fonction getActivityResultRegistry() précédente. (I0b00e)
• OnBackPressedDispatcherOwner est désormais écrit en Kotlin. Il s'agit d'une modification incompatible avec la source pour les classes écrites en Kotlin. Vous devez maintenant remplacer la propriété onBackPressedDispatcher au lieu d'implémenter la fonction getOnBackPressedDispatcher précédente. (Ia277d)
• ContextAware, ContextAwareHelper, OnContextAvailableListener, IntentSenderRequest et OnBackPressedDispatcher sont maintenant écrits en Kotlin. (I1a73e, Iada92, aosp/2410754, I18ac7, b/257291701)

Version 1.7.0-alpha04

25 janvier 2023

Publication d'androidx.activity:activity:1.7.0-alpha04, androidx.activity:activity-compose:1.7.0-alpha04 et androidx.activity:activity-ktx:1.7.0-alpha04. Liste des commits de la version 1.7.0-alpha04.

Nouvelles fonctionnalités

• Les contrats Activity Result PickVisualMedia et PickMultipleVisualMedia utiliseront désormais un sélecteur de photos fourni par les services Google Play, le cas échéant, lorsque le sélecteur de photos fourni par le système Android (par exemple, MediaStore.ACTION_PICK_IMAGES) ne sera pas disponible. L'API isPhotoPickerAvailable() qui ne détecte que le sélecteur de photos fourni par le système Android est maintenant obsolète. Il est recommandé d'utiliser la nouvelle API isPhotoPickerAvailable(Context), qui s'affichera si l'un des deux sélecteurs de photos est disponible. (I55be6)

Version 1.7.0-alpha03

11 janvier 2023

Publication d'androidx.activity:activity:1.7.0-alpha03, androidx.activity:activity-compose:1.7.0-alpha03 et androidx.activity:activity-ktx:1.7.0-alpha03. Liste des commits de la version 1.7.0-alpha03

Nouvelles fonctionnalités

• ComponentDialog implémente maintenant SavedStateRegistryOwner, a accès à son propre SavedStateRegistry et définit SavedStateRegistryOwner pour son ViewTree. Vous pouvez désormais utiliser Jetpack Compose dans ComponentDialog, car il répond aux exigences LifecycleOwner et SavedStateRegistryOwner associées à la fenêtre via les exigences des API ViewTree. (Idca17, I73468, b/261162296)

Modifications apportées à l'API

• Ajout d'un composable ReportDrawn qui marque immédiatement l'activité comme prête à appeler reportFullyDrawn. (Ic5b14, b/259687964)

Conversions Kotlin

• Les classes ActvitiyResultCallback et OnBackPressedCallback ont toutes deux été converties en Kotlin, tout en conservant une compatibilité source et binaire. (Ifc5e5, Ide1b0, b/257291701)

Version 1.7.0-alpha02

24 octobre 2022

Publication d'androidx.activity:activity:1.7.0-alpha02, d'androidx.activity:activity-compose:1.7.0-alpha02 et d'androidx.activity:activity-ktx:1.7.0-alpha02. Liste des commits de la version 1.7.0-alpha02

Correction de bugs

• Dans Activity 1.6.1 : résolution d'un problème qui empêchait le contrat de résultat d'activité PickMultipleVisualMedia de se lancer sur les appareils Android R lorsque la valeur par défaut de maxItems était utilisée. (Ie2776, b/249182130)

Version 1.7.0-alpha01

5 octobre 2022

Publication d'androidx.activity:activity:1.7.0-alpha01, d'androidx.activity:activity-compose:1.7.0-alpha01 et d'androidx.activity:activity-ktx:1.7.0-alpha01. Liste des commits de la version 1.7.0-alpha01

API FullyDrawnReporter

ComponentActivity fournit maintenant une instance FullyDrawnReporter qui permet à plusieurs composants d'indiquer qu'ils sont prêts à interagir. ComponentActivity attend que tous les composants aient terminé avant d'appeler reportFullyDrawn() en votre nom. Ces API s'occupent des exigences temporelles et n'ont pas besoin d'être appelées dans le cadre d'un appel onDraw.

Nous vous encourageons à activer les API suivantes :

• Envoi d'un signal à Android Runtime lorsque le démarrage est terminé pour s'assurer que tout le code exécuté au cours d'une séquence de démarrage multiframe est inclus et prioritaire pour la compilation en arrière-plan
• Envoi d'un signal à Macrobenchmark et Play Vitals lorsque votre application doit être considérée comme entièrement dessinée pour les métriques de démarrage, afin que vous puissiez suivre les performances

Deux API Activity Compose ont été ajoutées pour faciliter l'utilisation de FullyDrawnReporter à partir de composables individuels :

• ReportDrawnWhen utilise un prédicat (par exemple, list.count > 0) pour indiquer à quel moment votre composable est prêt à interagir.
• ReportDrawnAfter utilise une méthode de suspension qui, lorsqu'elle s'achève, indique que vous êtes prêt à interagir.

Version 1.6.1

Version 1.6.1

24 octobre 2022

Publication d'androidx.activity:activity:1.6.1, androidx.activity:activity-compose:1.6.1 et d'androidx.activity:activity-ktx:1.6.1. Liste des commits de la version 1.6.1

Correction de bugs

• Résolution d'un problème qui empêchait le contrat de résultat d'activité PickMultipleVisualMedia de se lancer sur les appareils Android R lorsque la valeur par défaut de maxItems était utilisée. (Ie2776, b/249182130)

Version 1.6.0

Version 1.6.0

21 septembre 2022

Publication d'androidx.activity:activity:1.6.0, androidx.activity:activity-compose:1.6.0 et androidx.activity:activity-ktx:1.6.0. Liste des commits de la version 1.6.0

Changements importants depuis la version 1.5.0

• Ajout d'ActivityResultContracts.PickVisualMedia et d'ActivityResultContracts.PickMultipleVisualMedia pour fournir un contrat rétrocompatible utilisant MediaStore.ACTION_PICK_IMAGES lorsque le sélecteur de photos est disponible et Intent.ACTION_OPEN_DOCUMENT lorsqu'il n'est pas disponible.
• Intégration d'OnBackInvokedCallback dans Android 13 dans les OnBackPressedDispatchers fournis par ComponentActivity et ComponentDialog. Cela garantit que toutes les API basées sur OnBackPressedDispatcher fonctionnent lorsque vous activez une prévisualisation du geste Retour.

Version 1.6.0-rc02

7 septembre 2022

Publication d'androidx.activity:activity:1.6.0-rc02, androidx.activity:activity-compose:1.6.0-rc02 et androidx.activity:activity-ktx:1.6.0-rc02. Liste des commits de la version 1.6.0-rc02

Correction de bugs

• OnBackPressedDispatcher enregistre désormais OnBackInvokedCallback avec la PRIORITY_DEFAULT au lieu de PRIORITY_OVERLAY. (I3901f)
• Les deux rappels de onMultiWindowModeChanged() seront désormais toujours envoyés aux classes qui étendent ComponentActivity. (Ic4d85)
• ActivityResultRegistry ne renvoie plus de résultat au ActivityResultCallback lorsque l'appel de launch génère une Exception et que le rappel a été enregistré sans LifecycleOwner. (Ia7ff7, b/238350794)
• ComponentActivity enverra maintenant correctement les appels du menu sans avoir à appeler la fonction Super dans votre activité. (Ie33c5, b/238057118)

Mise à jour de la dépendance

• La bibliothèque Activity dépend désormais de Lifecycle 2.5.1. (If6697)

Version 1.6.0-rc01

24 août 2022

Publication d'androidx.activity:activity:1.6.0-rc01, d'androidx.activity:activity-compose:1.6.0-rc01 et d'androidx.activity:activity-ktx:1.6.0-rc01. Liste des commits de la version 1.6.0-rc01

Correction de bugs

• L'initialisation d'un OnBackPressedDispatcher ne génère plus de ClassVerificationError lors de l'utilisation de versions de SDK antérieures à la version 33. (Ic32e1)
• Des rappels seront toujours envoyés aux classes qui ignorent le rappel onPictureInPictureModeChanged() de ComponentActivity. (Ib7fdb)

Version 1.6.0-beta01

10 août 2022

Publication d'androidx.activity:activity:1.6.0-beta01, d'androidx.activity:activity-compose:1.6.0-beta01 et d'androidx.activity:activity-ktx:1.6.0-beta01. Liste des commits de la version 1.6.0-beta01

Modifications apportées à l'API

• Marquage des méthodes startActivityForResult et startIntentSenderForResult obsolètes sur ComponentActivity avec @NonNull, car la transmission de null a toujours entraîné un plantage. (Id2a25, b/231476082)

Correction de bugs

• À partir de Activity 1.5.1 : le ActivityResultRegistry ne renvoie plus de résultat au ActivityResultCallback lorsque l'appel de launch génère une Exception et que le rappel a été enregistré sans LifecycleOwner. (Ia7ff7, b/238350794)
• À partir de Activity 1.5.1 : ComponentActivity enverra maintenant correctement les appels du menu vers les remplacements de onPrepareOptionMenu(), onCreateOptionsMenu() et onOptionsItemSelected(), sans avoir à appeler la fonction Super. (Ie33c5, b/238057118)

Mise à jour de la dépendance

• À partir de Activity 1.5.1 : la bibliothèque Activity dépend désormais de la version 2.5.1 de Lifecycle. (If6697)

Version 1.6.0-alpha05

15 juin 2022

Publication d'androidx.activity:activity:1.6.0-alpha05, androidx.activity:activity-compose:1.6.0-alpha05 et androidx.activity:activity-ktx:1.6.0-alpha05. La version 1.6.0-alpha05 a été développée dans une branche de version préliminaire privée et ne comporte aucun commit public.

Modifications apportées à l'API

• minCompileSdk correspond maintenant à 33 pour s'aligner sur le SDK de Tiramisu bêta 3.

Correction de bugs

• Correction du plantage sur les appareils plus anciens lors de la vérification de l'extension SDK de PickVisualMedia ActivityResultContract afin qu'elle fonctionne désormais avec ACTION_OPEN_DOCUMENT sur les appareils exécutant Android 10 ou une version antérieure.

Version 1.6.0-alpha04

18 mai 2022

Publication d'androidx.activity:activity:1.6.0-alpha04 et d'androidx.activity:activity-ktx:1.6.0-alpha04.

Correction de bugs

• Correction d'une erreur dans PickVisualMediaRequest provoquant un dépassement de pile lors de la tentative de création d'une requête via le compilateur ou la fonction Kotlin de niveau supérieur.
• Intégration du OnBackInvokedCallback dans la version Dev bêta 2 d'Android 13 dans le OnBackPressedDispatcher fourni par ComponentDialog. Cela garantit que toutes les API basées sur OnBackPressedDispatcher fonctionnent lorsque vous activez une prévisualisation du geste Retour.

Version 1.6.0-alpha03

27 avril 2022

Publication d'androidx.activity:activity:1.6.0-alpha03, androidx.activity:activity-compose:1.6.0-alpha03 et androidx.activity:activity-ktx:1.6.0-alpha03.

• Remarque : Cette version ne sera compilée qu'avec le SDK de la version Developer bêta 1 d'Android 13.

Nouvelles fonctionnalités

• Ajout d'ActivityResultContracts.PickVisualMedia et d'ActivityResultContracts.PickMultipleVisualMedia pour fournir un contrat rétrocompatible utilisant MediaStore.ACTION_PICK_IMAGES lorsque le sélecteur de photos est disponible et Intent.ACTION_OPEN_DOCUMENT lorsqu'il n'est pas disponible.
• Intégration d'OnBackInvokedCallback dans la version Dev bêta 1 d'Android 13 dans l'OnBackPressedDispatcher fourni par ComponentActivity. Cela garantit que toutes les API basées sur OnBackPressedDispatcher fonctionnent lorsque vous activez une prévisualisation du geste Retour.

Version 1.6.0-alpha01

23 mars 2022

Publication d'androidx.activity:activity:1.6.0-alpha01, d'androidx.activity:activity-compose:1.6.0-alpha01 et d'androidx.activity:activity-ktx:1.6.0-alpha01.

• Remarque : Cette version ne sera compilée qu'avec le SDK de la version Preview développeur 2 d'Android 13.

Nouvelles fonctionnalités

• Modifications intégrées de la version Preview développeur 2 d'Android 13 dans ComponentActivity.

Version 1.5.1

Version 1.5.1

27 juillet 2022

Publication d'androidx.activity:activity:1.5.1, androidx.activity:activity-compose:1.5.1 et androidx.activity:activity-ktx:1.5.1. Liste des commits de la version 1.5.1

Correction de bugs

• ActivityResultRegistry ne renvoie plus de résultat au ActivityResultCallback lorsque l'appel de launch() génère une Exception et que le rappel a été enregistré sans LifecycleOwner. (Ia7ff7, b/238350794)

• ComponentActivity enverra maintenant correctement les appels du menu vers les remplacements de onPrepareOptionMenu(), onCreateOptionsMenu() et onOptionsItemSelected(), sans avoir à appeler la fonction Super. (Ie33c5, b/238057118)

Mise à jour de la dépendance

• La bibliothèque Activity dépend désormais de Lifecycle 2.5.1. (If6697)

Version 1.5.0

Version 1.5.0

29 juin 2022

Publication d'androidx.activity:activity:1.5.0, androidx.activity:activity-compose:1.5.0 et androidx.activity:activity-ktx:1.5.0. Liste des commits de la version 1.5.0

Changements importants depuis la version 1.4.0

• ComponentDialog : ComponentDialog est une sous-classe de Dialog comprenant un OnBackPressedDispatcher qui sera appelé lorsque l'utilisateur appuie sur le bouton "Retour" du système et que la boîte de dialogue est visible. Il est important de noter que cette sous-classe définit également le ViewTreeOnBackPressedDispatcherOwner, ce qui permet aux vues d'utiliser un moyen générique pour récupérer le bon coordinateur, qu'il se trouve dans une ComponentActivity ou une ComponentDialog.
• Interfaces de rappel : ComponentActivity implémente désormais un ensemble d'interfaces de rappel modulaires pouvant être utilisées à la place des rappels de Activity. Parmi ces interfaces figurent les suivantes : OnNewIntentProvider, OnConfigurationChangedProvider, OnTrimMemoryProvider, OnPictureInPictureModeChangedProvider et OnMultiWindowModeChangedProvider.
• Intégration de CreationExtras : ComponentActivity peut désormais fournir un ViewModelProvider.Factory sans état via les CreationExtras de Lifecycle 2.5.0.

Autres modifications

• Abandon et remplacement du constructeur sans paramètre pour ActivityResultContracts.CreateDocument par un nouveau constructeur qui prend un type MIME concret (par exemple, "image/png") comme requis par Intent.ACTION_CREATE_DOCUMENT.

Version 1.5.0-rc01

11 mai 2022

Publication d'androidx.activity:activity:1.5.0-rc01, d'androidx.activity:activity-compose:1.5.0-rc01 et d'androidx.activity:activity-ktx:1.5.0-rc01 sans aucune modification par rapport à la version 1.5.0-beta01. Liste des commits de la version 1.5.0-rc01.

Version 1.5.0-beta01

20 avril 2022

Publication d'androidx.activity:activity:1.5.0-beta01, androidx.activity:activity-compose:1.5.0-beta01 et androidx.activity:activity-ktx:1.5.0-beta01. Liste des commits de la version 1.5.0-beta01

Mises à jour des dépendances

• Activity dépend désormais de Lifecycle 2.4.0-beta01.

Version 1.5.0-alpha05

6 avril 2022

Publication d'androidx.activity:activity:1.5.0-alpha05, androidx.activity:activity-compose:1.5.0-alpha05 et androidx.activity:activity-ktx:1.5.0-alpha05. Liste des commits de la version 1.5.0-alpha05.

Correction de bugs

• onPanelClosed() de ComponentActivity appelle désormais également la fonction Super onPanelClosed(), ce qui résout le problème où la méthode onContextMenuClosed n'était pas appelée. (Ib6f77)

Version 1.5.0-alpha04

23 mars 2022

Publication d'androidx.activity:activity:1.5.0-alpha04, androidx.activity:activity-compose:1.5.0-alpha04 et androidx.activity:activity-ktx:1.5.0-alpha04. Liste des commits de la version 1.5.0-alpha04.

Correction de bugs

• SavedStateViewFactory est désormais compatible avec CreationExtras, même lorsqu'ils ont été initialisés avec un SavedStateRegistryOwner. Les arguments initialisés sont ignorés si des éléments supplémentaires sont fournis. (I6c43b, b/224844583)

Version 1.5.0-alpha03

23 février 2022

Publication d'androidx.activity:activity:1.5.0-alpha03, androidx.activity:activity-compose:1.5.0-alpha03 et androidx.activity:activity-ktx:1.5.0-alpha03. Liste des commits de la version 1.5.0-alpha03

Modifications apportées à l'API

• Vous pouvez maintenant transmettre CreationExtras à la fonction by viewModels() de l'activité. (I6a3e6, b/217600303)

Version 1.5.0-alpha02

9 février 2022

Publication d'androidx.activity:activity:1.5.0-alpha02, androidx.activity:activity-compose:1.5.0-alpha02 et androidx.activity:activity-ktx:1.5.0-alpha02. Liste des commits de la version 1.5.0-alpha02

Nouvelles fonctionnalités

• ComponentActivity implémente désormais l'interface OnPictureInPictureModeChangedProvider pour permettre à n'importe quel composant de recevoir des événements de modification du mode Picture-in-picture. (I9f567)
• ComponentActivity implémente désormais l'interface OnMultiWindowModeChangedProvider pour permettre à n'importe quel composant de recevoir des événements de modification du mode multifenêtre. (I62d91)

Version 1.5.0-alpha01

26 janvier 2022

Publication d'androidx.activity:activity:1.5.0-alpha01, androidx.activity:activity-compose:1.5.0-alpha01 et androidx.activity:activity-ktx:1.5.0-alpha01. Liste des commits de la version 1.5.0-alpha01

Nouvelles fonctionnalités

• ComponentActivity s'intègre désormais avec ViewModel CreationExtras, qui a été introduit dans Lifecycle 2.5.0-alpha01. (Ie7e00, b/207012584)
• Ajout de ComponentDialog, une sous-classe de Dialog qui comprend un OnBackPressedDispatcher qui sera appelé lorsque l'utilisateur appuie sur le bouton "Retour" du système lorsque la boîte de dialogue est visible. Il est important de noter que cette sous-classe définit également le ViewTreeOnBackPressedDispatcherOwner, ce qui permet aux vues d'utiliser un moyen générique pour récupérer le bon coordinateur, qu'il se trouve dans une ComponentActivity ou une ComponentDialog. (I8a1bc)
• ComponentActivity implémente désormais la nouvelle interface OnNewIntentProvider pour permettre à n'importe quel composant de recevoir ces événements. (If1f8b)
• ComponentActivity implémente désormais la nouvelle interface OnConfigurationChangedProvider pour permettre à n'importe quel composant de recevoir ces événements. (If623b)
• ComponentActivity implémente désormais la nouvelle interface OnTrimMemoryProvider pour permettre à n'importe quel composant de recevoir ces événements. (Ia9295)

Modifications apportées à l'API

• Abandon et remplacement du constructeur sans paramètre pour ActivityResultContracts.CreateDocument par un nouveau constructeur qui prend un type MIME concret (par exemple, "image/png") comme requis par Intent.ACTION_CREATE_DOCUMENT. (I2bec6)
• Le OnBackPressedDispatcherOwner associé à View peut désormais être récupéré via ViewTreeOnBackPressedDispatcherOwner, au lieu de compter sur la diffusion du Context. (I74685)

Correction de bugs

• Correction d'un plantage survenant lors du premier accès au ViewModel à partir d'un rappel de registerForActivityResult() ou de rappels d'un LifecycleObserver ajoutés dans init d'une ComponentActivity. (Ife83f)

Version 1.4.0

Version 1.4.0

27 octobre 2021

Publication d'androidx.activity:activity:1.4.0, androidx.activity:activity-compose:1.4.0 et androidx.activity:activity-ktx:1.4.0. Liste des commits de la version 1.4.0

Changements importants depuis la version 1.3.0

• ComponentActivity d'AndroidX implémente maintenant l'interface MenuHost. Tous les composants peuvent ainsi ajouter des éléments de menu à la ActionBar en ajoutant une instance MenuProvider à l'activité. Chaque MenuProvider peut éventuellement être ajouté avec un Lifecycle qui contrôlera automatiquement la visibilité de ces éléments de menu en fonction de l'état Lifecycle et gérera la suppression du MenuProvider lorsque le Lifecycle est détruit.
• La classe ActivityResultContract a été réécrite en Kotlin pour s'assurer que les développeurs qui écrivent des contrats personnalisés en Kotlin puissent définir la possibilité de valeur nulle correcte pour leurs classes d'entrée et de sortie.
• La classe ActivityResultContracts et ses contrats ont été réécrits en Kotlin pour obtenir une possibilité de valeur nulle correcte.

Version 1.4.0-rc01

13 octobre 2021

Publication d'androidx.activity:activity:1.4.0-rc01, d'androidx.activity:activity-compose:1.4.0-rc01 et d'androidx.activity:activity-ktx:1.4.0-rc01. Liste des commits de la version 1.4.0-rc01

Correction de bugs

• ActivityResultRegistry ne renvoie plus de résultat au ActivityResultCallback lorsque l'appel de launch génère une Exception. (If4f91, b/200845664)

Version 1.4.0-beta01

29 septembre 2021

Publication d'androidx.activity:activity:1.4.0-beta01, androidx.activity:activity-compose:1.4.0-beta01 et androidx.activity:activity-ktx:1.4.0-beta01. Liste des commits de la version 1.4.0-beta01

Modifications apportées à l'API

• Correction du type des ActivityResultContracts.OpenMultipleDocuments et ActivityResultContracts.GetMultipleContents entraînant l'utilisation du type de sortie de List<? extends Uri> lors de l'utilisation du code du langage de programmation Java. (If71de)
• Les constantes publiques des classes ActivityResultContracts.StartActivityForResult, ActivityResultContracts.StartIntentSenderForResult et ActivityResultContracts.RequestMultiplePermissions sont désormais accessibles lorsque vous utilisez Kotlin via leurs objets Companion publics. (aosp/1832555)

Mises à jour de la documentation

• Le message d'abandon des API, désormais gérées par les API Activity Result, à savoir startActivityForResult, startIntentSenderForResult, onActivityResult, requestPermissions et onRequestPermissionsResult, comporte davantage de détails. (cce80f)

Version 1.4.0-alpha02

15 septembre 2021

Publication d'androidx.activity:activity:1.4.0-alpha02, androidx.activity:activity-compose:1.4.0-alpha02 et androidx.activity:activity-ktx:1.4.0-alpha02. Liste des commits de la version 1.4.0-alpha02

Nouvelles fonctionnalités

• L'artefact activity-compose contient maintenant une erreur de lint LaunchDuringComposition qui vous empêche d'appeler la méthode launch de ActivityResultLauncher dans la composition, car celle-ci ne doit pas avoir d'effets secondaires. Utilisez les API pour la gestion des effets secondaires. (7c2bbe, b/191347220)

Modifications apportées à l'API

• La classe ActivityResultContract a été réécrite en Kotlin pour s'assurer que les développeurs qui écrivent des contrats personnalisés en Kotlin puissent définir la possibilité de valeur nulle correcte pour leurs classes d'entrée et de sortie. (I8a8f5)
• La classe ActivityResultContracts et ses contrats ont été réécrits en Kotlin pour obtenir une possibilité de valeur nulle correcte. (I69802)

Version 1.4.0-alpha01

1er septembre 2021

Publication d'androidx.activity:activity:1.4.0-alpha01, d'androidx.activity:activity-compose:1.4.0-alpha01 et d'androidx.activity:activity-ktx:1.4.0-alpha01. Liste des commits de la version 1.4.0-alpha01

Nouvelles fonctionnalités

• ComponentActivity d'AndroidX implémente maintenant l'interface MenuHost. Tous les composants peuvent ainsi ajouter des éléments de menu à la ActionBar en ajoutant une instance MenuProvider à l'activité. Chaque MenuProvider peut éventuellement être ajouté avec un Lifecycle qui contrôlera automatiquement la visibilité de ces éléments de menu en fonction de l'état Lifecycle et gérera la suppression du MenuProvider lorsque le Lifecycle est détruit. (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)
  }

Nouveaux comportements

• Le ActivityResultRegistry génère désormais une IllegalStateException lors d'une tentative d'appel de launch() sur un ActivityResultLauncher qui n'a pas été enregistré ou dont l'enregistrement a été annulé. (Ida75d, b/192567522)

Contribution externe

• Nous remercions dmitrilc pour la correction d'une faute de frappe dans la documentation sur ActivityResult. (#221)

Version 1.3.1

Version 1.3.1

4 août 2021

Publication d'androidx.activity:activity:1.3.1, d'androidx.activity:activity-compose:1.3.1 et d'androidx.activity:activity-ktx:1.3.1. Liste des commits de la version 1.3.1.

Mises à jour des dépendances

• Activity dépend désormais de Kotlin 1.5.21.
• Activity Compose dépend désormais de Compose 1.0.1.

Version 1.3.0

Version 1.3.0

28 juillet 2021

Publication d'androidx.activity:activity:1.3.0, d'androidx.activity:activity-compose:1.3.0 et d'androidx.activity:activity-ktx:1.3.0. Liste des commits de la version 1.3.0

Changements importants depuis la version 1.2.0

• Artefact Activity Compose : l'artefact activity-compose fournit la méthode d'extension setContent pour héberger votre UI Jetpack Compose dans une activité, ainsi que des wrappers spécifiques à Compose pour interagir avec les API ComponentActivity pour la gestion du bouton "Retour" du système et des API Activity Result. Consultez la documentation pour en savoir plus.
• Contrat CaptureVideo : CaptureVideo ActivityResultContract remplace le contrat TakeVideo, désormais obsolète, et renvoie une valeur booléenne indiquant la réussite de l'opération, qui fonctionne avec de nombreuses applications d'appareil photo.
• Suivi de la vue optimisée Picture-in-picture : les utilisateurs de activity-ktx peuvent désormais utiliser la méthode d'extension trackPipAnimationHintView sur Activity pour recréer automatiquement les PictureInPictureParams avec la nouvelle position de la vue lorsqu'elle change de position par rapport à la fenêtre.

Version 1.3.0-rc02

14 juillet 2021

Publication d'androidx.activity:activity:1.3.0-rc02, d'androidx.activity:activity-compose:1.3.0-rc02 et d'androidx.activity:activity-ktx:1.3.0-rc02. Liste des commits de la version 1.3.0-rc02

Correction de bugs

• Les rappels de ActivityResultRegistry sont maintenant correctement enregistrés et restaurés. Les rappels ne sont donc pas dupliqués dans "savedState". (I97816, b/191893160)

Version 1.3.0-rc01

1er juillet 2021

Publication d'androidx.activity:activity:1.3.0-rc01, d'androidx.activity:activity-compose:1.3.0-rc01 et d'androidx.activity:activity-ktx:1.3.0-rc01 sans aucune modification par rapport à la version 1.3.0-beta02. Liste des commits de la version 1.3.0-rc01.

Version 1.3.0-beta02

16 juin 2021

Publication d'androidx.activity:activity:1.3.0-beta02, androidx.activity:activity-compose:1.3.0-beta02 et androidx.activity:activity-ktx:1.3.0-beta02. Liste des commits de la version 1.3.0-beta02.

Mise à jour de activity-compose pour dépendre de Compose 1.0.0-beta09. androidx.compose.ui:ui-test-junit4 comporte désormais une dépendance de temps de compilation sur activity-compose.

Version 1.3.0-beta01

2 juin 2021

Publication d'androidx.activity:activity:1.3.0-beta01, androidx.activity:activity-compose:1.3.0-beta01 et androidx.activity:activity-ktx:1.3.0-beta01. Liste des commits de la version 1.3.0-beta01.

Modifications apportées à l'API

• La méthode @Composable registerForActivityResult(), qui était obsolète, a été supprimée. Veuillez utiliser rememberLauncherForActivityResult(). (Ic39d3)

Version 1.3.0-alpha08

18 mai 2021

Publication d'androidx.activity:activity:1.3.0-alpha08, d'androidx.activity:activity-compose:1.3.0-alpha08 et d'androidx.activity:activity-ktx:1.3.0-alpha08. Liste des commits de la version 1.3.0-alpha08.

Nouvelles fonctionnalités

• Le nouveau ActivityResultContract de CaptureVideo renvoie une valeur booléenne à votre ActivityResultCallback pour indiquer si votre vidéo a bien été enregistrée dans l'URI donné. Cela remplace le contrat TakeVideo, désormais obsolète, car les applications d'appareil photo sont très rarement compatibles avec le renvoi d'un bitmap miniature. Le résultat est donc inutile. (Ie21f2, b/185938070)
• Ajout de l'API Activity#setPipAnimationHintView pour mettre à jour l'optimisation rect source des "PipParams" chaque fois que la vue se déplace. (I9063d)

Modifications apportées à l'API

• La fonction rememberLauncherForActivityResult renvoie désormais un lanceur d'applications qui abandonne la fonction unregister(). L'enregistrement et l'annulation de l'enregistrement du lanceur d'applications sont automatiquement gérés par rememberLauncherForActivityResult. (I2443e)

Compatibilité avec Compose

• androidx.activity:activity-compose:1.3.0-alpha08 n'est compatible qu'avec les versions 1.0.0-beta07 et ultérieures de Compose.

Version 1.3.0-alpha07

21 avril 2021

Publication d'androidx.activity:activity:1.3.0-alpha07, androidx.activity:activity-compose:1.3.0-alpha07 et androidx.activity:activity-ktx:1.3.0-alpha07. Liste des commits de la version 1.3.0-alpha07.

Correction de bugs

• rememberLauncherForActivityResult renvoie désormais une référence stable à la même instance ActivityResultLauncher, même si le contrat change en raison de recompositions. (Id2d6d)
• L'utilisation de versions instables de Fragment ultérieures à la version 1.3.0 ne générera plus d'erreur de lint faux positif vous invitant à utiliser la version 1.3.0. (aosp/1670206, b/184847092)

Version 1.3.0-alpha06

7 avril 2021

Publication d'androidx.activity:activity:1.3.0-alpha06, d'androidx.activity:activity-compose:1.3.0-alpha06 et d'androidx.activity:activity-ktx:1.3.0-alpha06. Liste des commits de la version 1.3.0-alpha06.

Modifications apportées à l'API

• Remplacement du nom de l'API registerForActivityResult() par rememberLauncherForActivityResult() afin de mieux indiquer que le ActivityResultLauncher renvoyé est un objet géré qui est mémorisé en votre nom. Si vous tentez d'appeler unregister, le ActivityResultLauncher renvoyé génère une erreur. (I2bb6d)
• LocalOnBackPressedDispatcherOwner.current et LocalActivityResultRegistryOwner.current renvoient désormais une possibilité de valeur nulle pour mieux déterminer si elle est disponible dans la composition actuelle. Les API qui nécessitent ces API, telles que BackHandler et rememberLauncherForActivityResult(), génèrent désormais une erreur plus descriptive si le propriétaire associé est introuvable. Le NavHost fonctionne désormais même si l'OnBackPressedDispatcherOwner est introuvable, par exemple, lors de la prévisualisation du NavHost. (I7d8b4)

Correction de bugs

• Désormais, le BackHandler intercepte correctement les appuis sur le bouton "Retour" si Activity est STOPPED, puis à nouveau STARTED. Des rappels supplémentaires ont également été ajoutés avec un "LifecycleOwner". (I71de6, b/182284739)
• L'utilisation de l'extension de méthode launch() avec un ActivityResultContract personnalisé ayant une entrée Unit n'entraînera plus de NullPointerException. (I76282, b/183837954)

Version 1.3.0-alpha05

24 mars 2021

Publication d'androidx.activity:activity:1.3.0-alpha05, androidx.activity:activity-compose:1.3.0-alpha05 et androidx.activity:activity-ktx:1.3.0-alpha05. Liste des commits de la version 1.3.0-alpha05.

Correction de bugs

• À partir de Activity 1.2.2 : correction d'un problème lié à la vérification lint InvalidFragmentVersionForActivityResult provoquant un faux positif lors de l'utilisation de Fragment 1.3.1 ou version ultérieure. (I54da1, b/182388985)
• À partir de Activity 1.2.2 : ComponentActivity évite désormais une ClassNotFoundException lors du lancement d'une Intent à partir d'un ActivityResultContract précédemment considéré comme un élément supplémentaire dans une autre Intent. (Ieff05, b/182906230)

Mises à jour des dépendances

• À partir de Activity 1.2.2 : Activity dépend désormais de Lifecycle 2.3.1.

Version 1.3.0-alpha04

10 mars 2021

Publication d'androidx.activity:activity:1.3.0-alpha04, androidx.activity:activity-compose:1.3.0-alpha04 et androidx.activity:activity-ktx:1.3.0-alpha04. Liste des commits de la version 1.3.0-alpha04.

Correction de bugs

• À partir de Activity 1.2.1 : RequestMultiplePermissions renvoient désormais toujours les résultats pour toutes les autorisations demandées, et non plus seulement pour celles qui n'ont pas été précédemment accordées. (I50bc3, b/180884668)
• À partir d'Activity 1.2.1 : ActivityResultRegistry vous permet désormais de vous assurer que les demandes launch() en cours renvoient leurs résultats même si vous exécutez une action unregister(), puis une action register() à nouveau avec la même clé. (I9ef34, b/181267562)
• Activity Compose n'ajoute plus de dépendances de test au chemin de classe d'exécution. (Ifd8b3)
• Correction d'un problème lié à BackHandler dans lequel le lambda onBack précédemment défini était encore utilisé après la recomposition. (8eb5eb)

Version 1.3.0-alpha03

24 février 2021

Publication d'androidx.activity:activity:1.3.0-alpha03, d'androidx.activity:activity-compose:1.3.0-alpha03 et d'androidx.activity:activity-ktx:1.3.0-alpha03. Liste des commits de la version 1.3.0-alpha03

Nouvelles fonctionnalités

• Il existe désormais une fonction registerForActivityResult modulable permettant d'obtenir les résultats des activités au sein des composables. (Ia7851, b/172690553)

Modifications apportées à l'API

• LocalOnBackPressedDispatcherOwner dispose désormais d'une fonction provides pouvant être utilisée avec CompositionLocalProvider, en remplacement de l'API asProvidableCompositionLocal(). (I45d24)

Version 1.3.0-alpha02

10 février 2021

Publication d'androidx.activity:activity:1.3.0-alpha02, androidx.activity:activity-compose:1.3.0-alpha02 et androidx.activity:activity-ktx:1.3.0-alpha02. Liste des commits de la version 1.3.0-alpha02.

Correction de bugs

• Correction d'un problème dans Activity Compose 1.3.0-alpha01 qui entraînait une exception NoSuchMethodError: No static method setContent lors de l'utilisation de Compose 1.0.0-alpha12. Tous les utilisateurs de Compose doivent dépendre de la version 1.3.0-alpha02 ou ultérieure. (b/179911234)

Modifications apportées à l'API

• L'API BackHandler peut être utilisée pour permettre à un composable d'intercepter le bouton "Retour" du système. (I58ed5, b/172154006)

Version 1.3.0-alpha01

10 février 2021

Publication d'androidx.activity:activity:1.3.0-alpha01, androidx.activity:activity-compose:1.3.0-alpha01 et androidx.activity:activity-ktx:1.3.0-alpha01. Liste des commits de la version 1.3.0-alpha01.

Nouvelles fonctionnalités

• Le nouvel artefact activity-compose fournit des assistants spécifiques à Jetpack Compose pour des API androidx.activity spécifiques.
  • ComponentActivity.setContent a été déplacé de androidx.compose.ui.platform.setContent vers androidx.activity.compose.setContent. (Icf416)

Problèmes connus

• L'utilisation d'Activity Compose 1.3.0-alpha01 et des bibliothèques qui en dépendent, telles que androidx.compose.ui:ui-test-junit4:1.0.0-alpha12, entraînera une exception NoSuchMethodError: No static method setContent. (b/179911234)

Version 1.2.4

Version 1.2.4

21 juillet 2021

Publication d'androidx.activity:activity:1.2.4 et d'androidx.activity:activity-ktx:1.2.4. Liste des commits de la version 1.2.4.

Correction de bugs

• À partir de Activity 1.3.0-rc02 : les rappels "ActivityResultRegistry" sont maintenant correctement enregistrés et restaurés. Les rappels ne sont donc pas dupliqués dans le "savedState". (I97816, b/191893160)

Version 1.2.3

Version 1.2.3

5 mai 2021

Publication d'androidx.activity:activity:1.2.3 et d'androidx.activity:activity-ktx:1.2.3. Liste des commits de la version 1.2.3.

Correction de bugs

• L'utilisation de l'extension de méthode launch() avec un ActivityResultContract personnalisé ayant une entrée Unit n'entraînera plus de NullPointerException. (I76282, b/183837954)
• Correction d'une erreur de lint faux positif vous indiquant d'utiliser Fragment 1.3.0 lors de l'exécution d'un instantané, d'une version alpha, bêta ou finale d'une nouvelle version de Fragment. (f4a57e, b/184847092)

Version 1.2.2

Version 1.2.2

24 mars 2021

Publication d'androidx.activity:activity:1.2.2 et d'androidx.activity:activity-ktx:1.2.2. Liste des commits de la version 1.2.2.

Correction de bugs

• Correction d'un problème lié à la vérification lint InvalidFragmentVersionForActivityResult provoquant un faux positif lors de l'utilisation de Fragment 1.3.1 ou version ultérieure. (I54da1, b/182388985)
• ComponentActivity évite désormais une ClassNotFoundException lors du lancement d'une Intent à partir d'un ActivityResultContract précédemment considéré comme un élément supplémentaire dans une autre Intent. (Ieff05, b/182906230)

Mises à jour des dépendances

• Activity dépend désormais de Lifecycle 2.3.1.

Version 1.2.1

Version 1.2.1

10 mars 2021

Publication d'androidx.activity:activity:1.2.1 et d'androidx.activity:activity-ktx:1.2.1. Liste des commits de la version 1.2.1

Correction de bugs

• RequestMultiplePermissions renvoient désormais toujours les résultats pour toutes les autorisations demandées, et non plus seulement pour celles qui n'ont pas été précédemment accordées. (I50bc3, b/180884668)
• ActivityResultRegistry vous permet désormais de vous assurer que les demandes launch() en cours renvoient leurs résultats même si vous unregister(), puis register() à nouveau avec la même clé. (I9ef34, b/181267562)

Version 1.2.0

Version 1.2.0

10 février 2021

Publication d'androidx.activity:activity:1.2.0 et d'androidx.activity:activity-ktx:1.2.0. Liste des commits de la version 1.2.0

Principales modifications depuis la version 1.1.0

• API Activity Result : ComponentActivity fournit désormais un ActivityResultRegistry qui vous permet de gérer les flux startActivityForResult()+onActivityResult() et requestPermissions()+onRequestPermissionsResult() sans remplacer les méthodes de votre Activity ou Fragment. En outre, il fournit un type de sécurité renforcée via ActivityResultContract et des hooks pour tester ces flux. Consultez la section Obtenir un résultat depuis Activity mise à jour.

• ContextAware : ComponentActivity implémente désormais ContextAware, ce qui vous permet d'ajouter une ou plusieurs instances de OnContextAvailableListener qui recevront un rappel avant la base Activity.onCreate().

  • Une extension Kotlin withContextAvailable() de suspension vous permet d'exécuter un bloc sans suspension lorsque le contexte devient disponible et de renvoyer un résultat.
  • Cette API est utilisée par FragmentActivity dans Fragment 1.3.0 pour restaurer l'état de FragmentManager. Tous les écouteurs ajoutés aux sous-classes de FragmentActivity s'exécutent après cet écouteur.
  • Cette API est utilisée par AppCompatActivity dans AppCompat 1.3.0-alpha02 ou version ultérieure. Tous les écouteurs ajoutés aux sous-classes de AppCompatActivity s'exécutent après cet écouteur.

• Compatibilité de ViewTree : ComponentActivity est désormais compatible avec les API ViewTreeLifecycleOwner.get(View), ViewTreeViewModelStoreOwner.get(View) et ViewTreeSavedStateRegistryOwner ajoutées à Lifecycle 2.3.0 et SavedState 1.1.0 de sorte qu'il renvoie Activity en tant que LifecycleOwner, ViewModelStoreOwner et SavedStateRegistryOwner pour chaque View directement ajoutée à ComponentActivity.

• reportFullyDrawn() backport : la méthode Activity de reportFullyDrawn() a été rétroportée dans ComponentActivity pour fonctionner à tous les niveaux d'API. Elle a permis de corriger un plantage de l'API 19 et d'ajouter un traçage de cette méthode pour tous les niveaux d'API.

Version 1.2.0-rc01

16 décembre 2020

Publication d'androidx.activity:activity:1.2.0-rc01 et d'androidx.activity:activity-ktx:1.2.0-rc01. Liste des commits de la version 1.2.0-rc01.

Correction de bugs

• Le ActivityResultRegistry restaure désormais toujours l'état exact enregistré. (Idd56b)
• Ajout d'un traçage à ComponentActivity.reportFullyDrawn. (Ic7632)

Contribution externe

• ComponentActivity remplace désormais reportFullyDrawn(), ce qui lui permet d'être appelé à tous les niveaux d'API et de corriger un plantage lors de l'appel de cette méthode sans les autorisations système appropriées sur les appareils utilisant l'API 19. Nous remercions Simon Schiller. (b/163239764, #103)

Version 1.2.0-beta02

2 décembre 2020

Publication d'androidx.activity:activity:1.2.0-beta02 et d'androidx.activity:activity-ktx:1.2.0-beta02. Liste des commits de la version 1.2.0-beta02.

Correction de bugs

• Correction d'un problème dans lequel l'API Activity Result n'attendait pas que Lifecycle soit STARTED avant d'afficher les résultats lors de l'enregistrement avec un Lifecycle. (I109ea)

Contribution externe

• Mise à jour de la documentation sur launch() pour indiquer explicitement qu'elle peut générer une ActivityNotFoundException. Nous remercions Michał Zieliński. (aosp/1493580)

Version 1.2.0-beta01

1er octobre 2020

Publication d'androidx.activity:activity:1.2.0-beta01 et d'androidx.activity:activity-ktx:1.2.0-beta01. Liste des commits de la version 1.2.0-beta01

Correction de bugs

• Le ActivityResultRegistry génère désormais des entiers de manière aléatoire jusqu'à ce qu'il en trouve un qui n'est pas assigné à register() comme code de requête, ce qui permet d'éviter un éventuel dépassement des entiers causé par l'incrémentation des codes de requête. (b/168779518)

• Les observateurs de Lifecycle sont correctement supprimés lors de l'appel de unregister() sur un ActivityResultLauncher. (b/165608393)

Nouveaux comportements

• Le ActivityResultRegistry génère maintenant une IllegalStateException lors d'une tentative d'appel de register() avec un LifecycleOwner dont le Lifecycle a déjà atteint STARTED. (b/165435866)

Documentation mise à jour

• La documentation de ContextAware contient un lien vers LifecycleOwner pour mettre en évidence que les rappels de Lifecycle conviennent parfaitement pour les événements de création et de destruction. (aosp/1414152)

Version 1.2.0-alpha08

19 août 2020

Publication d'androidx.activity:activity:1.2.0-alpha08 et d'androidx.activity:activity-ktx:1.2.0-alpha08. Liste des commits de la version 1.2.0-alpha08.

Nouvelles fonctionnalités

• ComponentActivity implémente maintenant ContextAware, ce qui vous permet d'ajouter une ou plusieurs instances de OnContextAvailableListener qui recevront un rappel avant la base Activity.onCreate(). (b/161390636)
  • Une extension Kotlin withContextAvailable() de suspension vous permet d'exécuter un bloc sans suspension lorsque le contexte devient disponible et de renvoyer un résultat. (I8290c)
  • Cette API est utilisée par FragmentActivity dans Fragment 1.3.0-alpha08 pour restaurer l'état de FragmentManager. Tous les écouteurs ajoutés aux sous-classes de FragmentActivity s'exécutent après cet écouteur. (I513da)
  • Cette API est utilisée par AppCompatActivity dans AppCompat 1.3.0-alpha02. Tous les écouteurs ajoutés aux sous-classes de AppCompatActivity s'exécutent après cet écouteur. (I513da)

Correction de bugs

• Correction d'un problème lié à la vérification lint ActivityResultFragmentVersionDetector entraînant un dysfonctionnement lors de l'utilisation de Lint 27.1.0 ou version ultérieure. (b/162155191)

Version 1.2.0-alpha07

22 juillet 2020

Publication d'androidx.activity:activity:1.2.0-alpha07 et d'androidx.activity:activity-ktx:1.2.0-alpha07. Liste des commits de la version 1.2.0-alpha07.

Nouvelles fonctionnalités

• Ajout d'une vérification lint InvalidFragmentVersionForActivityResult qui vérifie que vous utilisez Fragment 1.3.0-alpha07 lorsque vous utilisez l'API Activity Result, ce qui permet d'éviter les plantages de l'environnement d'exécution dus à des problèmes de "code de requête non valide" et le dysfonctionnement des demandes d'autorisation en raison de l'utilisation d'anciennes versions de Fragment. (b/152554847)

Contribution externe

• Correction d'une ArrayIndexOutOfBoundsException lors de l'analyse des résultats du contrat Activity Result de RequestPermission. (I8f9e3, b/161057605)

Version 1.2.0-alpha06

10 juin 2020

Publication d'androidx.activity:activity:1.2.0-alpha06 et d'androidx.activity:activity-ktx:1.2.0-alpha06. Liste des commits de la version 1.2.0-alpha06.

Nouvelles fonctionnalités

• Vous pouvez maintenant déstructurer la classe ActivityResult en Kotlin pour accéder directement à requestCode et intent. (b/157212935)
• ActivityResultLauncher vous permet maintenant d'obtenir le ActivityResultContract qui a été utilisé pour enregistrer le lanceur d'applications. (b/156875743)

Modifications apportées à l'API

• Modification destructive : Remplacement du nom de la méthode invoke() par onLaunch() dans ActivityResultRegistry. (b/157496491)
• Le contrat OpenMultipleDocuments renvoie désormais une liste vide au lieu de null au rappel enregistré si aucun résultat n'est renvoyé. (b/157348014)

Version 1.2.0-alpha05

20 mai 2020

Publication d'androidx.activity:activity:1.2.0-alpha05 et d'androidx.activity:activity-ktx:1.2.0-alpha05. Liste des commits de la version 1.2.0-alpha05

Nouvelles fonctionnalités

• Ajout de la prise en charge de ViewTreeViewModelStoreOwner à partir de Lifecycle 2.3.0-alpha03 et de ViewTreeSavedStateRegistryOwner à partir de SavedState 1.1.0-alpha01 lorsque vous utilisez une View dans une ComponentActivity. (aosp/1297993, aosp/1300264)

Modifications apportées à l'API

• Le contrat TakePicture renvoie désormais une boolean indiquant la réussite de l'opération plutôt qu'un Bitmap miniature, car cela n'était que très rarement compatible avec les applications d'appareil photo lors de l'écriture de l'image dans le Uri fourni. (b/154302879)
• Suppression des extensions invoke() dans ActivityResultLauncher. Elles ont été explicitement remplacées par l'utilisation de launch() pour mieux indiquer qu'il s'agit d'opérations asynchrones. Les extensions de Kotlin pour launch ont été ajoutées au package androidx.activity.result pour ActivityResultLauncher<Void> et ActivityResultLauncher<Unit>, éliminant ainsi la nécessité de transmettre respectivement null ou Unit, ce qui reproduit le comportement des extensions invoke() précédentes. (aosp/1304674, aosp/1304675)
• Les méthodes IntentSenderRequest.Builder pour setFlagsMask() et setFlagsValues() ont été combinées en une seule méthode setFlags(). (aosp/1302111)

Correction de bugs

• Correction d'un problème, lors de l'enregistrement d'un ActivityResultCallback avec un LifecycleOwner, qui entraînait le déclenchement du rappel avant que l'état n'atteigne STARTED. (aosp/1309744)

Nouveaux comportements

• Le ActivityResultRegistry génère désormais des codes de requête commençant par 0xFFFF et non plus par 0, ce qui évite les chevauchements lorsque vous utilisez startActivityForResult() ou requestPermissions() dans une activité. (aosp/1302324)

Version 1.2.0-alpha04

29 avril 2020

Publication d'androidx.activity:activity:1.2.0-alpha04 et d'androidx.activity:activity-ktx:1.2.0-alpha04. Liste des commits de la version 1.2.0-alpha04

Nouvelles fonctionnalités

• Ajout d'un contrat pouvant appeler "startIntentSenderForResult" pour les API ActivityResult. (b/153007517)

Modifications apportées à l'API

• La méthode prepareCall() a été renommée registerForActivityResult(), à la fois dans ComponentActivity et dans Fragment 1.3.0-alpha04. (aosp/1278717)
• Les contrats GetContents, OpenDocuments et RequestPermissions ont été renommés GetMultipleContents, OpenMultipleDocuments et RequestMultiplePermissions, respectivement. (aosp/1280161)
• ComponentActivity implémente maintenant l'interface ActivityResultRegisteryOwner. (aosp/1290888)
• Abandon des API startActivityForResult()/onActivityResult() et onRequestPermissionsResult() dans ComponentActivity. Veuillez utiliser les API Activity Result. (b/154751887)

Correction de bugs

• Lorsque vous utilisez les contrats GetMultipleContents et OpenMultipleDocuments et que vous sélectionnez un seul élément, il est désormais correctement renvoyé à votre rappel. (b/152941153)

Version 1.2.0-alpha03

1er avril 2020

Publication d'androidx.activity:activity:1.2.0-alpha03 et d'androidx.activity:activity-ktx:1.2.0-alpha03. Liste des commits de la version 1.2.0-alpha03.

Nouvelles fonctionnalités

• Ajout des contrats TakeVideo, PickContact, GetContent, GetContents, OpenDocument, OpenDocuments, OpenDocumentTree et CreateDocument à l'ensemble des contrats prédéfinis contrats fournis par ActivityResultContracts. (aosp/1262482, aosp/1266916, aosp/1268960)
• Les API Activity Result permettent désormais de lancer une activité pour le résultat avec un ActivityOptionsCompat facultatif. (b/151860054)

Modifications apportées à l'API

• Le contrat TakePicture prend désormais en charge une entrée Uri pour l'emplacement de stockage de l'image. Le contrat précédent qui ne nécessite aucune entrée a été renommé TakePicturePreview. (aosp/1262482)
• La méthode registerActivityResultCallback() dans ActivityResultRegistry a été renommée register(). (aosp/1267621)
• La méthode dispose() dans ActivityResultLauncher a été renommée unregister(). Le unregisterResultCallback() dans ActivityResultRegistry a été supprimé. (aosp/1267621)
• La méthode createIntent() de ActivityResultContact prend désormais en charge un Context en plus de l'entrée pour permettre la création d'intents explicites. (aosp/1238800)
• Un ActivityResultContract peut désormais ignorer getSynchronousResult() pour obtenir un résultat sans appeler de startActivityForResult. Les contrats RequestPermission et RequestPermissions l'utilise pour transmettre correctement l'état "accordé" si les autorisations demandées sont déjà accordées. (b/151110799)
• Le contrat Dial précédemment disponible a été supprimé, car Intent n'est pas censé être utilisé avec startActivityForResult(). (aosp/1266916)
• De nombreuses API Activity Result qui ne sont pas destinées à être étendues sont désormais final. Cela inclut getActivityResultRegistry(), les méthodes prepareCall(), toutes les méthodes de ActivityResultRegistry à l'exception de invoke() et un certain nombre de contrats par défaut qui ne sont pas compatibles avec les éléments supplémentaires facultatifs. (b/152439361)

Correction de bugs

• Correction d'une NullPointerException dans ActivityResultRegistry lors de la tentative de transmission des résultats à un rappel qui n'a pas encore été enregistré à nouveau après une modification de configuration. ActivityResultRegistry conserve désormais ces résultats en attente et les transmet lorsque le rappel est à nouveau enregistré. (b/152137004)

Version 1.2.0-alpha02

18 mars 2020

Publication d'androidx.activity:activity:1.2.0-alpha02 et d'androidx.activity:activity-ktx:1.2.0-alpha02. Liste des commits de la version 1.2.0-alpha02.

Nouvelles fonctionnalités

• ActivityResultRegistry : ComponentActivity fournit désormais un ActivityResultRegistry qui vous permet de gérer les flux startActivityForResult()+onActivityResult() et requestPermissions()+onRequestPermissionsResult() sans remplacer les méthodes de votre Activity ou Fragment. En outre, il fournit un type de sécurité renforcée via ActivityResultContract et des hooks pour tester ces flux. Consultez la section Obtenir un résultat depuis Activity mise à jour. (b/125158199)

Version 1.2.0-alpha01

4 mars 2020

Publication d'androidx.activity:activity:1.2.0-alpha01 et d'androidx.activity:activity-ktx:1.2.0-alpha01. Liste des commits de la version 1.2.0-alpha01

Nouvelles fonctionnalités

• Ajout de la prise en charge de l'API ViewTreeLifecycleOwner.get(View) ajoutée à Lifecycle 2.3.0-alpha01, qui permet de renvoyer Activity en tant que LifecycleOwner pour chaque View directement ajoutée à Activity. (aosp/1182955)

Correction de bugs

• Correction d'une régression introduite dans Activity 1.1.0 lors de son exécution sur des versions précédentes de la plate-forme dans laquelle onBackPressed() entraînait une IllegalStateException en raison d'un bug dans android.app.FragmentManager. (b/146290338)

Version 1.1.0

Version 1.1.0

22 janvier 2020

Publication d'androidx.activity:activity:1.1.0. Liste des commits de la version 1.1.0.

Changements importants depuis la version 1.0.0

• Intégration de Lifecycle ViewModel SavedState : SavedStateViewModelFactory est désormais la fabrique par défaut utilisée lorsque vous utilisez by viewModels(), le constructeur ViewModelProvider ou ViewModelProviders.of() avec une ComponentActivity ou ses sous-classes.

Version 1.1.0-rc03

4 décembre 2019

Publication d'androidx.activity:activity:1.1.0-rc03 et d'androidx.activity:activity-ktx:1.1.0-rc03. Liste des commits de la version 1.1.0-rc03

Modifications de la dépendance

• Activity dépend désormais de Lifecycle 2.2.0-rc03 et de Lifecycle ViewModel SavedState 1.0.0-rc03.

Version 1.1.0-rc02

7 novembre 2019

Publication d'androidx.activity:activity:1.1.0-rc02 et d'androidx.activity:activity-ktx:1.1.0-rc02. Liste des commits de la version 1.1.0-rc02

Modifications de la dépendance

• Activity dépend désormais de Lifecycle 2.2.0-rc02.

Version 1.1.0-rc01

23 octobre 2019

Publication d'androidx.activity:activity:1.1.0-rc01 et d'androidx.activity:activity-ktx:1.1.0-rc01 sans aucune modification par rapport à la version 1.1.0-beta01. Liste des commits de la version 1.1.0-rc01

Version 1.1.0-beta01

9 octobre 2019

Publication d'androidx.activity:activity:1.1.0-beta01 et d'androidx.activity:activity-ktx:1.1.0-beta01. Liste des commits de la version 1.1.0-beta01.

Modifications de la dépendance

• Activity dépend désormais de la version SavedState 1.0.0 stable.

Version 1.1.0-alpha03

5 septembre 2019

Publication d'androidx.activity:activity:1.1.0-alpha03 et d'androidx.activity:activity-ktx:1.1.0-alpha03. Les commits inclus dans cette version sont disponibles sur cette page.

Nouvelles fonctionnalités

• Activity dépend désormais de la version Core 1.1.0 stable.

Correction de bugs

• Activity dépend désormais de Lifecycle 2.2.0-alpha04.

Version 1.1.0-alpha02

7 août 2019

Publication d'androidx.activity:activity:1.1.0-alpha02 et d'androidx.activity:activity-ktx:1.1.0-alpha02. Les commits inclus dans cette version sont disponibles sur cette page.

Nouvelles fonctionnalités

• SavedStateViewModelFactory est désormais la fabrique par défaut utilisée lorsque vous utilisez by viewModels(), le constructeur ViewModelProvider ou ViewModelProviders.of() avec une ComponentActivity. (b/135716331)

Version 1.1.0-alpha01

2 juillet 2019

Publication d'androidx.activity:activity:1.1.0-alpha01 et d'androidx.activity:activity-ktx:1.1.0-alpha01. Les commits inclus dans cette version sont disponibles sur cette page.

Nouvelles fonctionnalités

• activity dépend désormais de Lifecycle 2.2.0-alpha02. (aosp/1007817)
• activity-ktx a ajouté une dépendance à lifecycle-runtime-ktx. Vous n'avez plus besoin de l'ajouter explicitement à vos dépendances lorsque vous utilisez activity-ktx ou des bibliothèques qui dépendent de activity-ktx (comme fragment-ktx). (aosp/987162)

Version 1.0.0

Version 1.0.0

5 septembre 2019

Publication d'androidx.activity:activity:1.0.0 et d'androidx.activity:activity-ktx:1.0.0. Les commits inclus dans cette version sont disponibles sur cette page.

Principales fonctionnalités de la version 1.0.0

• ComponentActivity : ComponentActivity sert de nouvelle classe de base pour FragmentActivity dans Fragment 1.1.0 et, par extension, AppCompatActivity dans AppCompat 1.1.0.
• activity-ktx : le module activity-ktx comprend une extension de propriété Kotlin by viewModels permettant d'accéder à ViewModels. Ce module est automatiquement inclus lorsque vous incluez fragment-ktx dans Fragment 1.1.0.
• OnBackPressedDispatcher : comme alternative composable au remplacement de onBackPressed(), vous pouvez désormais enregistrer un OnBackPressedCallback depuis n'importe quel LifecycleOwner (un fragment, par exemple) pour intercepter les événements du bouton "Retour" du système. Un lambda ayant la version de récepteur addCallback a été ajouté à activity-ktx. Pour en savoir plus, consultez la documentation Fournir une navigation vers l'arrière personnalisée.
• Abandon de onRetainCustomNonConfigurationInstance : les API onRetainCustomNonConfigurationInstance() et getLastCustomNonConfigurationInstance() associées ont été abandonnées. Il est vivement recommandé d'utiliser ViewModels pour stocker des états de non-configuration, car ils offrent une solution composable adaptée à tout ViewModelStoreOwner qui clarifie la propriété des objets conservés et fournit un rappel onCleared(), afin de nettoyer les ressources lorsque l'activité est finalement détruite.

Version 1.0.0-rc01

2 juillet 2019

Publication d'androidx.activity:activity:1.0.0-rc01 et d'androidx.activity:activity-ktx:1.0.0-rc01 sans aucune modification par rapport à la version 1.0.0-beta01. Les commits inclus dans cette version sont disponibles sur cette page.

Version 1.0.0-beta01

5 juin 2019

Publication d'androidx.activity::activity:1.0.0-beta01 et d'androidx.activity:activity-ktx:1.0.0-beta01 sans aucune modification par rapport à la version 1.0.0-alpha08. Les commits inclus dans cette version sont disponibles sur cette page.

Version 1.0.0-alpha08

7 mai 2019

Publication d'androidx.activity:activity:1.0.0-alpha08 et d'androidx.activity:activity-ktx:1.0.0-alpha08. Les commits inclus dans cette version sont disponibles sur cette page.

Modifications apportées à l'API

• Modification destructive : Les méthodes addOnBackPressedCallback et removeOnBackPressedCallback précédemment abandonnées dans ComponentActivity ont été supprimées. aosp/953857
• Les méthodes setEnabled() et isEnabled() de OnBackPressedCallback sont maintenant finales. b/131416833
• La méthode remove() de OnBackPressedCallback est maintenant finale. aosp/952720
• OnBackPressedDispatcher dispose désormais de constructeurs publics, ce qui vous permet de créer vos propres instances pour les tests, etc. aosp/953431
• onBackPressed() pour ComponentActivity est maintenant explicitement marqué comme @MainThread. aosp/952721

Corrections de bugs

• Correction d'une ConcurrentModificationException lors de l'appel de remove() depuis la méthode handleOnBackPressed() d'un OnBackPressedCalback ajouté avec un LifecycleOwner. b/131765095

Version 1.0.0-alpha07

25 avril 2019

Publication d'androidx.activity:activity:1.0.0-alpha07 et d'androidx.activity:activity-ktx:1.0.0-alpha07. Les commits inclus dans cette version sont disponibles sur cette page.

Modifications apportées à l'API

Cette version apporte des modifications importantes à la gestion de onBackPressed(). Pour en savoir plus, consultez la documentation mise à jour sur les retours personnalisés.

• Les méthodes pour OnBackPressedCallback et OnBackPressedDispatcher ont été marquées comme @MainThread. (aosp/943813)
• La méthode handleOnBackPressed() ne renvoie plus de valeur boolean. En revanche, OnBackPressedCallback est désormais une classe abstraite qui peut être activée ou désactivée, ce n'est que lorsque la nouvelle méthode isEnabled() renvoie la valeur "true" que handleOnBackPressed() sera appelé, où vous devrez gérer le bouton "Retour". (aosp/944518)
• Les méthodes addCallback de OnBackPressedDispatcher ne renvoient plus d'instance Cancellable. OnBackPressedCallback contient désormais une méthode remove() qui remplit cette fonctionnalité, ce qui vous permet d'appeler remove() pendant handleOnBackPressed(). (aosp/944519) (aosp/946316)
• activity-ktx contient désormais un rappel limité au récepteur pour addCallback qui accepte un lambda implémentant handleOnBackPressed() et ayant accès à isEnabled et remove(). (aosp/944520)

Version 1.0.0-alpha06

3 avril 2019

Publication d'androidx.activity:activity:1.0.0-alpha06 et d'androidx.activity:activity-ktx:1.0.0-alpha06. Les commits inclus dans cette version sont disponibles sur cette page.

Modifications apportées à l'API

• "ComponentActivity" contient désormais un deuxième constructeur utilisant un @LayoutRes int, qui remplace le comportement précédent d'annotation de votre classe "AppCompatActivity" par @ContentView. Cette approche fonctionne dans les modules d'application et de bibliothèque. (b/128352521)
• Les API associées à OnBackPressedCallback dans "ComponentActivity" ont été remplacées par le nouveau OnBackPressedDispatcher, que vous pouvez récupérer via getOnBackPressedDispatcher(). (aosp/922523)
• Les méthodes permettant d'ajouter un nouveau OnBackPressedCallback au OnBackPressedDispatcher renvoient désormais un objet Cancellable, ce qui permet de supprimer le rappel sans avoir besoin d'une référence explicite au OnBackPressedDispatcher. (aosp/922523)
• Désormais, l'ajout d'un OnBackPressedCallback associé à un LifecycleOwner entraîne l'ajout et la suppression de ce OnBackPressedCallback au moment du démarrage et de l'arrêt de Lifecycle, respectivement. (aosp/922523)

Version 1.0.0-alpha05

13 mars 2019

Publication d'androidx.activity:activity:1.0.0-alpha05 et d'androidx.activity:activity-ktx:1.0.0-alpha05. La liste complète des commits inclus dans cette version est disponible sur cette page.

Nouvelles fonctionnalités

• Les recherches d'annotations de @ContentView sont désormais mises en cache. (b/123709449)

Version 1.0.0-alpha04

30 janvier 2019

Publication de androidx.activity:activity 1.0.0-alpha04 et androidx.activity:activity-ktx 1.0.0-alpha04.

Nouvelles fonctionnalités

• Ajout de la prise en charge de l'annotation de classe @ContentView, qui vous permet d'indiquer le fichier XML de mise en page à augmenter à la place de setContentView(). (aosp/837619)

Modifications apportées à l'API

• Ajout d'une remarque indiquant que getViewModelStore() ne doit pas être remplacé et sera final dans une prochaine version. Veuillez envoyer une demande de fonctionnalité si vous remplacez actuellement cette méthode. (aosp/837619)

Correction de bugs

• Le module activity dépend désormais de la version 2.1.0-alpha02 de ViewModel pour correspondre à la dépendance du module activity-ktx.

Version 1.0.0-alpha03

17 décembre 2018

Publication d'androidx.activity 1.0.0-alpha03.

Nouvelles fonctionnalités

• "ComponentActivity" implémente désormais BundleSavedStateRegistryOwner et dépend de la nouvelle bibliothèque SavedState. [aosp/815133]
• "ComponentActivity" contourne maintenant un bug du framework Android, qui entraînerait la fuite de la dernière vue sélectionnée par "InputMethodManager". [b/37122102]

Version 1.0.0-alpha02

3 décembre 2018

Modifications apportées à l'API

• Ajout d'une remarque indiquant que getLifecycle() ne doit pas être remplacé et sera final dans une prochaine version. Veuillez envoyer une demande de fonctionnalité si vous remplacez actuellement cette méthode. (aosp/815834)

Version 1.0.0-alpha01

5 novembre 2018

androidx.activity 1.0.0-alpha01 comprend ComponentActivity, une nouvelle classe de base des FragmentActivity et AppCompatActivity existants.

Nouvelles fonctionnalités

• Vous pouvez maintenant enregistrer un OnBackPressedCallback via addOnBackPressedCallback pour recevoir des rappels onBackPressed() sans avoir à remplacer la méthode dans votre activité.
• Ajout d'un nouveau délégué de propriété Kotlin by viewModels() pour la récupération des ViewModel à partir d'un ComponentActivity.
• Les événements d'entrée en attente (tels que les clics) sont maintenant annulés dans onStop().

Modifications apportées à l'API

• L'implémentation de LifecycleOwner et de ViewModelStoreOwner a été déplacée de FragmentActivity vers ComponentActivity.
• onRetainCustomNonConfigurationInstance est maintenant obsolète. Utilisez un ViewModel pour stocker les objets qui doivent survivre aux modifications de configuration.