Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Activity

Accédez à des API modulables basées sur Activity.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
11 janvier 2023 1.6.1 - - 1.7.0-alpha03

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 des artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou module :

Groovy

dependencies {
    def activity_version = "1.6.1"

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

Kotlin

dependencies {
    val activity_version = "1.6.1"

    // 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 problème

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

Version 1.7

Version 1.7.0-alpha03

11 janvier 2023

Publication d'androidx.activity:activity:1.7.0-alpha03, d'androidx.activity:activity-compose:1.7.0-alpha03 et d'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, androidx.activity:activity-compose:1.7.0-alpha02 et 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, androidx.activity:activity-compose:1.7.0-alpha01 et 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 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 de ActivityResultContracts.PickVisualMedia et 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 de 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

Version 1.6.0-rc01

24 août 2022

Publication d'androidx.activity:activity:1.6.0-rc01, androidx.activity:activity-compose:1.6.0-rc01 et 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 de androidx.activity:activity:1.6.0-beta01, androidx.activity:activity-compose:1.6.0-beta01 et 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 de 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 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 de 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 de ActivityResultContracts.PickVisualMedia et 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 de OnBackInvokedCallback dans la version Dev bêta 1 d'Android 13 dans le 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 de androidx.activity:activity:1.6.0-alpha01, androidx.activity:activity-compose:1.6.0-alpha01 et 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 de 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

Version 1.5.0

Version 1.5.0

29 juin 2022

Publication de 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 de androidx.activity:activity:1.5.0-rc01, androidx.activity:activity-compose:1.5.0-rc01 et 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 de 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

Version 1.5.0-alpha05

6 avril 2022

Publication de 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 de 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 de 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 de 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 de 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, androidx.activity:activity-compose:1.4.0-rc01 et 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 de 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, androidx.activity:activity-compose:1.4.0-alpha01 et 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 de androidx.activity:activity:1.3.1, androidx.activity:activity-compose:1.3.1 et 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 de androidx.activity:activity:1.3.0, androidx.activity:activity-compose:1.3.0 et 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 de androidx.activity:activity:1.3.0-rc02, androidx.activity:activity-compose:1.3.0-rc02 et 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 de androidx.activity:activity:1.3.0-rc01, androidx.activity:activity-compose:1.3.0-rc01 et 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 de 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 de 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 de androidx.activity:activity:1.3.0-alpha08, androidx.activity:activity-compose:1.3.0-alpha08 et 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 de 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 de androidx.activity:activity:1.3.0-alpha06, androidx.activity:activity-compose:1.3.0-alpha06 et 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. NavHost fonctionne désormais même si le OnBackPressedDispatcherOwner est introuvable, par exemple, lors de la prévisualisation de 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 de 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

Version 1.3.0-alpha04

10 mars 2021

Publication de 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 de androidx.activity:activity:1.3.0-alpha03, androidx.activity:activity-compose:1.3.0-alpha03 et 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 de 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 de 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 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 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 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

Version 1.2.1

Version 1.2.1

10 mars 2021

Publication d'androidx.activity:activity:1.2.1 et 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 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 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 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 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 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 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 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 androidx.activity:activity-ktx:1.2.0-alpha05. Liste des commits de la version 1.2.0-alpha05.

Nouvelles fonctionnalités

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

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

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

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

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.