API Android 5.0

Niveau d'API : 21

Android 5.0 (LOLLIPOP) offre de nouvelles fonctionnalités pour les utilisateurs et les développeurs d'applications. Ce document présente les nouvelles API les plus importantes.

Si vous avez publié une application, assurez-vous de consulter les modifications de comportement d'Android 5.0 dont vous devez tenir compte dans votre application. Ces changements de comportement peuvent affecter votre application sur les appareils Android 5.0, même si vous n'utilisez pas de nouvelles API ou ne ciblez pas de nouvelles fonctionnalités.

Pour en savoir plus sur les nouvelles fonctionnalités de la plate-forme, consultez plutôt les points forts d'Android Lollipop.

Premiers pas en tant que développeur

Pour commencer à créer des applications pour Android 5.0, vous devez d'abord télécharger le SDK Android. Utilisez ensuite SDK Manager pour télécharger la plate-forme du SDK Android 5.0 et les images système.

Mettre à jour votre niveau d'API cible

Pour mieux optimiser votre application pour les appareils équipés d'Android 5.0, définissez targetSdkVersion sur "21", installez votre application sur une image système Android 5.0, testez-la, puis publiez l'application mise à jour avec cette modification.

Vous pouvez utiliser les API Android 5.0 tout en prenant en charge les versions antérieures en ajoutant à votre code des conditions qui vérifient le niveau d'API du système avant d'exécuter les API non compatibles avec votre minSdkVersion. Pour en savoir plus sur la maintenance de la rétrocompatibilité, consultez la page Assurer la compatibilité avec différentes versions de plate-forme.

Pour en savoir plus sur le fonctionnement des niveaux d'API, consultez Qu'est-ce que le niveau d'API ?

Modifications importantes de comportement

Si vous avez déjà publié une application pour Android, sachez qu'elle peut être concernée par des modifications apportées à Android 5.0.

Pour en savoir plus, consultez Modifications apportées à Android 5.0.

Interface utilisateur

Compatibilité avec Material Design

Android 5.0 est compatible avec le nouveau style Material Design d'Android. Vous pouvez créer des applications avec Material Design qui sont visuellement dynamiques et dont les transitions d'éléments d'interface utilisateur semblent naturelles pour les utilisateurs. Cette assistance inclut les fonctionnalités suivantes:

  • Thème Material
  • Afficher les ombres
  • Widget RecyclerView
  • Animation drawable et effets de style
  • Animation Material Design et effets de transition d'activité
  • Animateurs pour les propriétés de vue en fonction de l'état de la vue
  • Widgets d'interface utilisateur et barres d'application personnalisables avec des palettes de couleurs que vous contrôlez
  • Drawables animés et non animés basés sur des graphiques vectoriels XML

Pour en savoir plus sur l'ajout de la fonctionnalité Material Design à votre application, consultez la page Material Design.

Documents et activités simultanés sur l'écran "Recents" (Éléments récents)

Dans les versions précédentes, l'écran "Recents" (Éléments récents) ne pouvait afficher qu'une seule tâche pour chaque application avec laquelle l'utilisateur avait interagi le plus récemment. Votre application peut désormais ouvrir plus de tâches si nécessaire pour des activités simultanées supplémentaires pour les documents. Cette fonctionnalité facilite le multitâche en permettant aux utilisateurs de basculer rapidement entre des activités et des documents individuels depuis l'écran "Recents" (Éléments récents), avec une expérience de bascule cohérente dans toutes les applications. Ces tâches simultanées peuvent inclure des onglets ouverts dans une application de navigateur Web, des documents dans une application de productivité, des parties simultanées dans un jeu ou des discussions dans une application de messagerie. Votre application peut gérer ses tâches via la classe ActivityManager.AppTask.

Pour insérer une coupure logique afin que le système traite votre activité comme une nouvelle tâche, utilisez FLAG_ACTIVITY_NEW_DOCUMENT lorsque vous lancez l'activité avec startActivity(). Vous pouvez également obtenir ce comportement en définissant l'attribut documentLaunchMode de l'élément <activity> sur "intoExisting" ou "always" dans votre fichier manifeste.

Pour éviter d'encombrer l'écran "Récents", vous pouvez définir le nombre maximal de tâches de votre application pouvant apparaître sur cet écran. Pour ce faire, définissez l'attribut <application> android:maxRecents. Le nombre maximal actuel pouvant être spécifié est de 50 tâches par utilisateur (25 pour les appareils à faible RAM).

Les tâches de l'écran "Recents" (Éléments récents) peuvent être configurées pour persister lors des redémarrages. Pour contrôler le comportement de persistance, utilisez l'attribut android:persistableMode. Vous pouvez également modifier les propriétés visuelles d'une activité sur l'écran "Recents" (Éléments récents), telles que la couleur, le libellé et l'icône de l'activité, en appelant la méthode setTaskDescription().

Mises à jour de WebView

Android 5.0 met à jour l'implémentation WebView vers Chromium M37, ce qui permet d'améliorer la sécurité et la stabilité, ainsi que de corriger des bugs. La chaîne user-agent par défaut d'un WebView exécuté sur Android 5.0 a été mise à jour pour inclure 37.0.0.0 comme numéro de version.

Cette version introduit la classe PermissionRequest, qui permet à votre application d'accorder l'autorisation WebView à des ressources protégées telles que la caméra et le micro, via des API Web telles que getUserMedia(). Votre application doit disposer des autorisations Android appropriées pour ces ressources afin d'accorder les autorisations au WebView.

Avec la nouvelle méthode onShowFileChooser(), vous pouvez désormais utiliser un champ de formulaire de saisie dans WebView et lancer un sélecteur de fichiers pour sélectionner des images et des fichiers sur l'appareil Android.

De plus, cette version est compatible avec les normes ouvertes WebAudio, WebGL et WebRTC. Pour en savoir plus sur les nouvelles fonctionnalités incluses dans cette version, consultez WebView pour Android.

Capture et partage d'écran

Android 5.0 vous permet d'ajouter des fonctionnalités de capture et de partage d'écran à votre application avec les nouvelles API android.media.projection. Cette fonctionnalité est utile, par exemple, si vous souhaitez activer le partage d'écran dans une application de visioconférence.

La nouvelle méthode createVirtualDisplay() permet à votre application de capturer le contenu de l'écran principal (l'écran par défaut) dans un objet Surface, que votre application peut ensuite envoyer sur le réseau. L'API permet uniquement de capturer le contenu d'écran non sécurisé, et non l'audio du système. Pour commencer la capture d'écran, votre application doit d'abord demander l'autorisation de l'utilisateur en lançant une boîte de dialogue de capture d'écran à l'aide d'un Intent obtenu via la méthode createScreenCaptureIntent().

Pour obtenir un exemple d'utilisation des nouvelles API, consultez la classe MediaProjectionDemo dans l'exemple de projet.

Notifications

Notifications sur l'écran de verrouillage

Les écrans de verrouillage d'Android 5.0 peuvent présenter des notifications. Dans Paramètres, les utilisateurs peuvent choisir d'autoriser ou non l'affichage du contenu sensible des notifications sur un écran de verrouillage sécurisé.

Votre application peut contrôler le niveau de détail visible lorsque ses notifications s'affichent sur l'écran de verrouillage sécurisé. Pour contrôler le niveau de visibilité, appelez setVisibility() et spécifiez l'une des valeurs suivantes :

  • VISIBILITY_PRIVATE : affiche des informations de base, telles que l'icône de la notification, mais masque le contenu complet de la notification.
  • VISIBILITY_PUBLIC : affiche le contenu complet de la notification.
  • VISIBILITY_SECRET : rien n'est affiché, même pas l'icône de la notification.

Lorsque le niveau de visibilité est VISIBILITY_PRIVATE, vous pouvez également fournir une version masquée du contenu de la notification qui masque les informations personnelles. Par exemple, une application de SMS peut afficher la notification "Vous avez trois nouveaux SMS", mais masquer le contenu et les expéditeurs du message. Pour fournir cette notification de remplacement, créez d'abord la notification de remplacement à l'aide de Notification.Builder. Lorsque vous créez l'objet de notification privée, associez-y la notification de remplacement via la méthode setPublicVersion().

Métadonnées des notifications

Android 5.0 utilise les métadonnées associées aux notifications de votre application pour les trier de manière plus intelligente. Pour définir les métadonnées, appelez les méthodes suivantes dans Notification.Builder lorsque vous créez la notification:

  • setCategory(): indique au système comment gérer les notifications de votre application lorsque l'appareil est en mode priorité (par exemple, si une notification représente un appel entrant, un message instantané ou une alarme).
  • setPriority() : indique si la notification est plus ou moins importante que les notifications normales. Les notifications dont le champ de priorité est défini sur PRIORITY_MAX ou PRIORITY_HIGH s'affichent dans une petite fenêtre flottante si elles sont également accompagnées d'un son ou d'une vibration.
  • addPerson(): vous permet d'ajouter une ou plusieurs personnes pertinentes pour une notification. Votre application peut l'utiliser pour signaler au système qu'il doit regrouper les notifications des personnes spécifiées ou classer les notifications de ces personnes comme étant plus importantes.

Graphiques

Compatibilité avec OpenGL ES 3.1

Android 5.0 ajoute des interfaces Java et la prise en charge native d'OpenGL ES 3.1. Voici les principales nouvelles fonctionnalités d'OpenGL ES 3.1 :

  • Calculer les nuanceurs
  • Objets de nuanceur distincts
  • Commandes de dessin indirect
  • Textures multiéchantillon et trame
  • Améliorations apportées au langage d'ombrage
  • Extensions pour les modes de fusion avancés et le débogage
  • Rétrocompatibilité avec OpenGL ES 2.0 et 3.0

L'interface Java pour OpenGL ES 3.1 sur Android est fournie avec GLES31. Lorsque vous utilisez OpenGL ES 3.1, veillez à le déclarer dans votre fichier manifeste avec la balise <uses-feature> et l'attribut android:glEsVersion. Exemple :

<manifest>
    <uses-feature android:glEsVersion="0x00030001" />
    ...
</manifest>

Pour en savoir plus sur l'utilisation d'OpenGL ES, y compris en ce qui concerne la vérification de la version compatible au moment de l'exécution, consultez le guide de l'API OpenGL ES.

Android Extension Pack

En plus d'OpenGL ES 3.1, cette version fournit un pack d'extensions avec des interfaces Java et une prise en charge native des fonctionnalités graphiques avancées. Ces extensions sont traitées comme un package unique par Android. (Si l'extension ANDROID_extension_pack_es31a est présente, votre application peut supposer que toutes les extensions du package sont présentes et activer les fonctionnalités de langage de nuance avec une seule instruction #extension.)

Le pack d'extensions est compatible avec les éléments suivants :

  • Compatibilité garantie du nuanceur de fragments avec les tampons de stockage, les images et l'atomique du nuanceur (la compatibilité avec le nuanceur de fragments est facultative dans OpenGL ES 3.1)
  • Nuanceurs de tessellation et de géométrie
  • Format de compression de texture ASTC (LDR)
  • Interpolation et ombrage par échantillon
  • Différents modes de mélange pour chaque attachement de couleur dans un tampon d'image

L'interface Java du pack d'extensions est fournie avec GLES31Ext. Dans le fichier manifeste de votre application, vous pouvez déclarer que celle-ci ne doit être installée que sur les appareils compatibles avec le pack d'extensions. Exemple :

<manifest>
    <uses-feature android:name=“android.hardware.opengles.aep”
        android:required="true" />
    ...
</manifest>

Contenus multimédias

API Camera pour des fonctionnalités avancées de caméra et de caméra

Android 5.0 introduit la nouvelle API android.hardware.camera2 pour faciliter la capture photo fine et le traitement des images. Vous pouvez désormais accéder de manière programmatique aux appareils photo disponibles pour le système avec getCameraIdList() et vous connecter à un appareil spécifique avec openCamera(). Pour commencer à capturer des images, créez un CameraCaptureSession et spécifiez les objets Surface auxquels envoyer les images capturées. Le CameraCaptureSession peut être configuré pour prendre des photos uniques ou plusieurs images en rafale.

Pour être averti lorsque de nouvelles images sont capturées, implémentez l'écouteur CameraCaptureSession.CaptureCallback et définissez-le dans votre requête de capture. Une fois que le système traite la requête de capture d'image, votre écouteur CameraCaptureSession.CaptureCallback reçoit un appel à onCaptureCompleted(), qui vous fournit les métadonnées de capture d'image dans un élément CaptureResult.

La classe CameraCharacteristics permet à votre application de détecter les fonctionnalités de l'appareil photo disponibles sur un appareil. La propriété INFO_SUPPORTED_HARDWARE_LEVEL de l'objet représente le niveau de fonctionnalité de la caméra.

  • Tous les appareils sont compatibles avec au moins le niveau de matériel INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY, qui offre des fonctionnalités à peu près équivalentes à celles de l'API Camera, désormais obsolète.
  • Les appareils compatibles avec le niveau matériel INFO_SUPPORTED_HARDWARE_LEVEL_FULL peuvent contrôler manuellement la capture et le post-traitement, et capturer des images haute résolution à des fréquences d'images élevées.

Pour savoir comment utiliser l'API Camera mise à jour, consultez les exemples d'implémentation Camera2Basic et Camera2Video de cette version.

Lecture audio

Cette version inclut les modifications suivantes apportées à AudioTrack:

  • Votre application peut désormais fournir des données audio au format à virgule flottante (ENCODING_PCM_FLOAT). Cela permet d'obtenir une plage dynamique plus large, une précision plus cohérente et une plage dynamique plus élevée. L'arithmétique à virgule flottante est particulièrement utile lors des calculs intermédiaires. Les points de terminaison de lecture utilisent le format entier pour les données audio, avec une profondeur de bits inférieure. (Dans Android 5.0, certaines parties du pipeline interne ne sont pas encore à virgule flottante.)
  • Votre application peut désormais fournir des données audio sous forme de ByteBuffer, au même format que celui fourni par MediaCodec.
  • L'option WRITE_NON_BLOCKING peut simplifier le tamponnement et le multithreading pour certaines applications.

Commandes de lecture multimédias

Utilisez les nouvelles API de notification et multimédia pour vous assurer que l'UI du système connaît votre lecture multimédia et peut extraire et afficher la pochette de l'album. Le contrôle de la lecture multimédia dans une UI et un service est désormais plus facile grâce aux nouvelles classes MediaSession et MediaController.

La nouvelle classe MediaSession remplace la classe RemoteControlClient obsolète et fournit un ensemble unique de méthodes de rappel pour gérer les commandes de transport et les boutons multimédias. Si votre application fournit la lecture multimédia et s'exécute sur la plate-forme Android TV ou Wear, utilisez la classe MediaSession pour gérer vos commandes de transport à l'aide des mêmes méthodes de rappel.

Vous pouvez maintenant créer votre propre application de contrôleur multimédia avec la nouvelle classe MediaController. Cette classe fournit un moyen sécurisé de surveiller et de contrôler la lecture multimédia à partir du processus d'UI de votre application. Lorsque vous créez un contrôleur, spécifiez un objet MediaSession.Token afin que votre application puisse interagir avec le MediaSession donné. À l'aide des méthodes MediaController.TransportControls, vous pouvez envoyer des commandes telles que play(), stop(), skipToNext() et setRating() pour contrôler la lecture des contenus multimédias sur cette session. Avec le contrôleur, vous pouvez également enregistrer un objet MediaController.Callback pour écouter les métadonnées et les changements d'état de la session.

De plus, vous pouvez créer des notifications riches qui permettent de contrôler la lecture associée à une session multimédia avec la nouvelle classe Notification.MediaStyle.

Navigation multimédia

Android 5.0 permet aux applications de parcourir la bibliothèque de contenu multimédia d'une autre application via la nouvelle API android.media.browse. Pour exposer le contenu multimédia dans votre application, étendez la classe MediaBrowserService. Votre implémentation de MediaBrowserService doit fournir un accès à un MediaSession.Token afin que les applications puissent lire le contenu multimédia fourni via votre service.

Pour interagir avec un service de navigateur multimédia, utilisez la classe MediaBrowser. Spécifiez le nom du composant pour un MediaSession lorsque vous créez une instance MediaBrowser. À l'aide de cette instance de navigateur, votre application peut ensuite se connecter au service associé et obtenir un objet MediaSession.Token pour lire le contenu exposé via ce service.

Stockage

Sélection de l'annuaire

Android 5.0 étend le Storage Access Framework pour permettre aux utilisateurs de sélectionner un sous-répertoire entier, ce qui donne aux applications un accès en lecture/écriture à tous les documents qu'il contient sans qu'il soit nécessaire de confirmer chaque élément.

Pour sélectionner une sous-arborescence de répertoires, créez et envoyez un intent OPEN_DOCUMENT_TREE. Le système affiche toutes les instances DocumentsProvider compatibles avec la sélection de sous-arborescence, ce qui permet à l'utilisateur de parcourir et de sélectionner un répertoire. L'URI renvoyé représente l'accès au sous-arbre sélectionné. Vous pouvez ensuite utiliser buildChildDocumentsUriUsingTree() et buildDocumentUriUsingTree() avec query() pour explorer le sous-arbre.

La nouvelle méthode createDocument() vous permet de créer des documents ou des répertoires n'importe où sous le sous-arbre. Pour gérer des documents existants, utilisez renameDocument() et deleteDocument(). Vérifiez COLUMN_FLAGS pour vérifier que le fournisseur prend en charge ces appels avant de les émettre.

Si vous implémentez un DocumentsProvider et que vous souhaitez prendre en charge la sélection de sous-arbres, implémentez isChildDocument() et incluez FLAG_SUPPORTS_IS_CHILD dans votre COLUMN_FLAGS.

Android 5.0 introduit également de nouveaux répertoires spécifiques au package sur le stockage partagé, dans lesquels votre application peut placer des fichiers multimédias à inclure dans MediaStore. Le nouveau getExternalMediaDirs() renvoie les chemins d'accès à ces répertoires sur tous les appareils de stockage partagés. Comme pour getExternalFilesDir(), votre application n'a pas besoin d'autorisations supplémentaires pour accéder aux chemins renvoyés. La plate-forme recherche régulièrement les nouveaux contenus multimédias dans ces répertoires, mais vous pouvez également utiliser MediaScannerConnection pour rechercher explicitement de nouveaux contenus.

Connectivité et sans fil

Connexions réseau multiples

Android 5.0 fournit de nouvelles API multiréseau qui permettent à votre application de rechercher dynamiquement les réseaux disponibles avec des fonctionnalités spécifiques et d'établir une connexion avec eux. Cette fonctionnalité est utile lorsque votre application nécessite un réseau spécialisé, tel qu'un réseau SUPL, MMS ou de facturation par opérateur, ou si vous souhaitez envoyer des données à l'aide d'un type de protocole de transport particulier.

Pour sélectionner et vous connecter à un réseau de manière dynamique depuis votre application, procédez comme suit :

  1. Créez un élément ConnectivityManager.
  2. Utilisez la classe NetworkRequest.Builder pour créer un objet NetworkRequest et spécifier les fonctionnalités réseau et le type de transport qui intéressent votre application.
  3. Pour rechercher les réseaux appropriés, appelez requestNetwork() ou registerNetworkCallback(), puis transmettez l'objet NetworkRequest et une implémentation de ConnectivityManager.NetworkCallback. Utilisez la méthode requestNetwork() si vous souhaitez passer activement à un réseau approprié une fois qu'il a été détecté. Pour ne recevoir que des notifications pour les réseaux scannés sans passer activement, utilisez plutôt la méthode registerNetworkCallback().

Lorsque le système détecte un réseau approprié, il se connecte au réseau et appelle le rappel onAvailable(). Vous pouvez utiliser l'objet Network du rappel pour obtenir des informations supplémentaires sur le réseau ou pour diriger le trafic afin qu'il utilise le réseau sélectionné.

Bluetooth à basse consommation

Android 4.3 a introduit la prise en charge de la plate-forme pour le rôle central du Bluetooth à basse consommation (Bluetooth LE). Sous Android 5.0, un appareil Android peut désormais servir de périphérique Bluetooth LE. Les applications peuvent utiliser cette fonctionnalité pour signaler leur présence aux appareils à proximité. Par exemple, vous pouvez créer des applications qui permettent à un appareil de fonctionner comme podomètre ou moniteur de santé, et qui communiquent ses données avec un autre appareil Bluetooth LE.

Les nouvelles API android.bluetooth.le permettent à vos applications de diffuser des annonces, de rechercher des réponses et de créer des connexions avec des appareils Bluetooth LE à proximité. Pour utiliser les nouvelles fonctionnalités de publicité et de numérisation, ajoutez l'autorisation BLUETOOTH_ADMIN dans votre fichier manifeste. Lorsque les utilisateurs mettent à jour ou téléchargent votre application à partir du Play Store, ils sont invités à lui accorder l'autorisation suivante : "Informations de connexion Bluetooth: permet à l'application de contrôler le Bluetooth, y compris la diffusion sur les appareils Bluetooth à proximité ou l'obtention d'informations à leur sujet".

Pour lancer la publicité Bluetooth LE afin que d'autres appareils puissent détecter votre application, appelez startAdvertising() et transmettez une implémentation de la classe AdvertiseCallback. L'objet de rappel reçoit un rapport sur la réussite ou l'échec de l'opération publicitaire.

Android 5.0 introduit la classe ScanFilter afin que votre application ne puisse rechercher que les types d'appareils spécifiques qui l'intéressent. Pour commencer à rechercher des appareils Bluetooth LE, appelez startScan() et transmettez une liste de filtres. Dans l'appel de méthode, vous devez également fournir une implémentation de ScanCallback pour signaler lorsqu'une annonce Bluetooth LE est détectée.

Améliorations NFC

Android 5.0 ajoute ces améliorations pour permettre une utilisation plus large et plus flexible de la technologie NFC :

  • Android Beam est désormais disponible dans le menu Partager.
  • Votre application peut appeler Android Beam sur l'appareil de l'utilisateur pour partager des données en appelant invokeBeam(). L'utilisateur n'a donc pas besoin de placer manuellement l'appareil contre un autre appareil compatible avec la technologie NFC pour effectuer le transfert de données.
  • Vous pouvez utiliser la nouvelle méthode createTextRecord() pour créer un enregistrement NDEF contenant des données textuelles au format UTF-8.
  • Si vous développez une application de paiement, vous pouvez désormais enregistrer dynamiquement un ID d'application NFC (AID) en appelant registerAidsForService(). Vous pouvez également utiliser setPreferredService() pour définir le service d'émulation de carte à utiliser de préférence lorsqu'une activité spécifique est au premier plan.

Projet Volta

En plus de ses nouvelles fonctionnalités, Android 5.0 met l'accent sur l'amélioration de l'autonomie de la batterie. Utilisez les nouveaux outils et API pour comprendre et optimiser la consommation d'énergie de votre application.

Planifier des tâches

Android 5.0 fournit une nouvelle API JobScheduler qui vous permet d'optimiser l'autonomie de la batterie en définissant des tâches pour que le système s'exécute de manière asynchrone à une date ultérieure ou dans des conditions spécifiées (par exemple, lorsque l'appareil est en charge). La planification des tâches est utile dans les situations suivantes:

  • L'application comporte des tâches non visibles par l'utilisateur que vous pouvez différer.
  • L'application doit effectuer des tâches que vous préférez effectuer lorsque l'appareil est branché.
  • L'application comporte une tâche qui nécessite un accès au réseau ou une connexion Wi-Fi.
  • L'application comporte un certain nombre de tâches que vous souhaitez exécuter par lot de manière régulière.

Une unité de travail est encapsulée par un objet JobInfo. Cet objet spécifie les critères de planification.

Utilisez la classe JobInfo.Builder pour configurer le mode d'exécution de la tâche planifiée. Vous pouvez planifier l'exécution de la tâche dans des conditions spécifiques, par exemple :

  • Démarrer lorsque l'appareil est en charge
  • Démarrer lorsque l'appareil est connecté à un réseau illimité
  • Démarrer lorsque l'appareil est inactif
  • Terminer avant une certaine date limite ou avec un délai minimal

Par exemple, vous pouvez ajouter du code comme suit pour exécuter votre tâche sur un réseau illimité :

Kotlin

val uploadTask: JobInfo = JobInfo.Builder(
        jobId,
        serviceComponent /* JobService component */
).run {
    setRequiredNetworkType(JobInfo.NETWORK_TYPE_UNMETERED)
    build()
}
val jobScheduler = context.getSystemService(Context.JOB_SCHEDULER_SERVICE) as JobScheduler
jobScheduler.schedule(uploadTask)

Java

JobInfo uploadTask = new JobInfo.Builder(jobId,
                                         serviceComponent /* JobService component */)
        .setRequiredNetworkCapabilities(JobInfo.NETWORK_TYPE_UNMETERED)
        .build();
JobScheduler jobScheduler =
        (JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);
jobScheduler.schedule(uploadTask);

Si l'alimentation de l'appareil est stable (c'est-à-dire s'il est branché depuis plus de deux minutes et que la batterie est à un niveau sain), le système exécute toute tâche planifiée prête à être exécutée, même si le délai de la tâche n'a pas expiré.

Pour voir un exemple d'utilisation de l'API JobScheduler, consultez l'exemple d'implémentation JobSchedulerSample de cette version.

Outils de développement pour l'utilisation de la batterie

La nouvelle commande dumpsys batterystats génère des données statistiques intéressantes sur l'utilisation de la batterie sur un appareil, organisées par ID utilisateur unique (UID). Les statistiques comprennent les éléments suivants:

  • Historique des événements liés à la batterie
  • Statistiques globales de l'appareil
  • Consommation énergétique approximative par UID et composant système
  • Nombre de ms pour mobile par application par paquet
  • Statistiques agrégées de l'UID du système
  • Statistiques agrégées de l'UID de l'application

Utilisez l'option --help pour découvrir les différentes options de personnalisation du résultat. Par exemple, pour imprimer les statistiques d'utilisation de la batterie pour un package d'application donné depuis la dernière recharge de l'appareil, exécutez la commande suivante : 

$ adb shell dumpsys batterystats --charged <package-name>

Vous pouvez utiliser l'outil Battery Historian sur la sortie de la commande dumpsys pour générer une visualisation HTML des événements liés à l'alimentation à partir des journaux. Ces informations vous permettent de comprendre et de diagnostiquer plus facilement les problèmes liés à la batterie.

Android au travail et dans l'enseignement

Configuration gérée

Android 5.0 propose de nouvelles fonctionnalités pour exécuter des applications dans un environnement d'entreprise. Un administrateur de l'appareil peut lancer un processus de provisionnement géré pour ajouter un profil géré coprésent mais distinct à un appareil, si l'utilisateur dispose d'un compte personnel existant. Les applications associées à des profils gérés s'affichent à côté des applications non gérées dans le lanceur, l'écran "Récents" et les notifications de l'utilisateur.

Pour démarrer le processus de provisionnement géré, envoyez ACTION_PROVISION_MANAGED_PROFILE dans un Intent. Si l'appel aboutit, le système déclenche le rappel onProfileProvisioningComplete(). Vous pouvez ensuite appeler setProfileEnabled() pour activer ce profil géré.

Par défaut, seul un petit sous-ensemble d'applications est activé dans le profil géré. Vous pouvez installer des applications supplémentaires dans le profil géré en appelant enableSystemApp().

Si vous développez une application de lanceur, vous pouvez utiliser la nouvelle classe LauncherApps pour obtenir une liste des activités pouvant être lancées pour l'utilisateur actuel et les profils gérés associés. Votre lanceur d'applications peut mettre en avant les applications gérées en ajoutant un badge professionnel au drawable de l'icône. Pour récupérer l'icône avec badge, appelez getUserBadgedIcon().

Pour savoir comment utiliser cette nouvelle fonctionnalité, consultez l'exemple d'implémentation BasicManagedProfile de cette version.

Propriétaire de l'appareil

Android 5.0 permet de déployer une application de propriétaire d'appareil. Un propriétaire d'appareil est un type spécialisé d'administrateur d'appareil qui peut également créer et supprimer des utilisateurs secondaires, et configurer les paramètres généraux de l'appareil. L'application du propriétaire de l'appareil peut utiliser les méthodes de la classe DevicePolicyManager pour contrôler précisément la configuration, la sécurité et les applications sur les appareils gérés. Un appareil ne peut avoir qu'un seul propriétaire actif à la fois.

Pour déployer et activer un propriétaire d'appareil, vous devez effectuer un transfert de données NFC depuis une application de programmation vers l'appareil lorsqu'il est dans son état non provisionné. Ce transfert de données envoie les mêmes informations que dans l'intent de provisionnement décrit dans la section Provisionnement géré.

Épinglage d'écran

Android 5.0 introduit une nouvelle API d'épinglage d'écran qui vous permet d'empêcher temporairement les utilisateurs de quitter votre tâche ou d'être interrompus par des notifications. Cela peut être utilisé, par exemple, si vous développez une application éducative répondant à des exigences d'évaluation à enjeux élevés sur Android, ou une application kiosque ou à usage unique. Une fois que l'épinglage d'écran est activé dans votre application, les utilisateurs ne peuvent pas voir les notifications, accéder à d'autres applications ni revenir à l'écran d'accueil tant que l'application n'a pas quitté le mode.

Il existe deux façons d'activer l'épinglage d'écran :

  • Manuellement : les utilisateurs peuvent activer l'épinglage d'écran dans Paramètres > Sécurité > Épinglage d'écran, puis sélectionner les tâches qu'ils souhaitent épingler en appuyant sur l'icône en forme de punaise verte sur l'écran "Recents" (Éléments récents).
  • De manière programmatique : pour activer l'épinglage d'écran de manière programmatique, appelez startLockTask() depuis votre application. Si l'application à l'origine de la demande n'est pas propriétaire de l'appareil, l'utilisateur est invité à confirmer. Une application propriétaire de l'appareil peut appeler la méthode setLockTaskPackages() pour permettre aux applications d'être épinglées sans l'étape de confirmation de l'utilisateur.

Lorsque le verrouillage des tâches est activé, le comportement suivant se produit:

  • La barre d'état est vide, et les notifications et informations d'état de l'utilisateur sont masquées.
  • Les boutons "Accueil" et "Applications récentes" sont masqués.
  • Les autres applications ne peuvent pas lancer de nouvelles activités.
  • L'application actuelle peut démarrer de nouvelles activités, à condition que cela ne crée pas de nouvelles tâches.
  • Lorsqu'un propriétaire d'appareil appelle l'épinglage d'écran, l'utilisateur reste verrouillé sur votre application jusqu'à ce qu'elle appelle stopLockTask().
  • Si l'épinglage d'écran est activé par une autre application qui n'est pas le propriétaire de l'appareil ou directement par l'utilisateur, l'utilisateur peut quitter l'application en appuyant de manière prolongée sur les boutons "Retour" et "Récents".

Framework d'impression

Afficher le PDF au format bitmap

Vous pouvez désormais convertir les pages de documents PDF en images bitmap à imprimer à l'aide de la nouvelle classe PdfRenderer. Vous devez spécifier un ParcelFileDescriptor accessible via la recherche (c'est-à-dire que le contenu est accessible de manière aléatoire) sur lequel le système écrit le contenu imprimable. Votre application peut obtenir une page à afficher avec openPage(), puis appeler render() pour transformer le PdfRenderer.Page ouvert en bitmap. Vous pouvez également définir des paramètres supplémentaires si vous ne souhaitez convertir qu'une partie du document en image bitmap (par exemple, pour implémenter le affichage en mosaïque afin de faire un zoom avant sur le document).

Pour obtenir un exemple d'utilisation des nouvelles API, consultez l'exemple PdfRendererBasic.

Système

Statistiques utilisation de l'appli

Vous pouvez désormais accéder à l'historique d'utilisation des applications sur un appareil Android avec la nouvelle API android.app.usage. Cette API fournit des informations d'utilisation plus détaillées que la méthode getRecentTasks() obsolète. Pour utiliser cette API, vous devez d'abord déclarer l'autorisation "android.permission.PACKAGE_USAGE_STATS" dans votre fichier manifeste. L'utilisateur doit également activer l'accès à cette application dans Settings > Security > Apps (Paramètres > Sécurité > Applications) avec un accès à l'utilisation.

Le système collecte les données d'utilisation pour chaque application, en les agrégeant sur des intervalles quotidiens, hebdomadaires, mensuels et annuels. La durée maximale pendant laquelle le système conserve ces données est la suivante :

  • Données quotidiennes : 7 jours
  • Données hebdomadaires : 4 semaines
  • Données mensuelles : 6 mois
  • Données annuelles : 2 ans

Pour chaque application, le système enregistre les données suivantes:

  • Dernière utilisation de l'application
  • Durée totale pendant laquelle l'application était exécutée en premier plan pour cet intervalle de temps (par jour, semaine, mois ou année)
  • Code temporel de capture lorsqu'un composant (identifié par un package et un nom d'activité) est déplacé au premier plan ou en arrière-plan au cours d'une journée
  • Capture du code temporel lorsqu'une configuration de l'appareil a changé (par exemple, lorsque l'orientation de l'appareil a changé en raison d'une rotation)

Tests et accessibilité

Améliorations des tests et de l'accessibilité

Android 5.0 prend en charge les tests et l'accessibilité suivants:

  • Les nouvelles méthodes getWindowAnimationFrameStats() et getWindowContentFrameStats() capturent les statistiques de frame pour les animations de fenêtre et le contenu. Ces méthodes vous permettent d'écrire des tests d'instrumentation pour évaluer si une application effectue le rendu de frames à une fréquence d'actualisation suffisante pour offrir une expérience utilisateur fluide.
  • La nouvelle méthode executeShellCommand() vous permet d'exécuter des commandes shell à partir de votre test d'instrumentation. L'exécution de la commande est semblable à l'exécution de adb shell à partir d'un hôte connecté à l'appareil, ce qui vous permet d'utiliser des outils basés sur un shell tels que dumpsys, am, content et pm.
  • Les services d'accessibilité et les outils de test qui utilisent les API d'accessibilité (telles que UiAutomator) peuvent désormais récupérer des informations détaillées sur les propriétés des fenêtres de l'écran avec lesquelles les utilisateurs voyants peuvent interagir. Pour récupérer une liste d'objets AccessibilityWindowInfo, appelez la nouvelle méthode getWindows().
  • La nouvelle classe AccessibilityNodeInfo.AccessibilityAction vous permet de définir des actions standards ou personnalisées à effectuer sur un AccessibilityNodeInfo. La nouvelle classe AccessibilityNodeInfo.AccessibilityAction remplace les API liées aux actions précédemment trouvées dans AccessibilityNodeInfo.
  • Android 5.0 offre un contrôle plus précis sur la synthèse vocale dans votre application. La nouvelle classe Voice permet à votre application d'utiliser des profils vocaux associés à des paramètres régionaux spécifiques, à des niveaux de qualité et de latence, ainsi qu'à des paramètres spécifiques au moteur de synthèse vocale.

IME

Passer plus facilement d'une langue de saisie à une autre

À partir d'Android 5.0, les utilisateurs peuvent plus facilement basculer entre tous les éditeurs de mode de saisie (IME) compatibles avec la plate-forme. L'action de basculement désignée (toucher généralement une icône en forme de globe sur le clavier virtuel) parcourt tous ces IME. Ce changement de comportement est implémenté par la méthode shouldOfferSwitchingToNextInputMethod().

De plus, le framework vérifie désormais si l'IME suivant inclut un mécanisme de commutation (et, par conséquent, si cet IME est compatible avec le passage à l'IME suivant). Un IME avec un mécanisme de commutation ne passera pas à un IME sans celui-ci. Ce changement de comportement est mis en œuvre par la méthode switchToNextInputMethod().

Pour voir un exemple d'utilisation des API de commutation IME mises à jour, consultez l'exemple d'implémentation du clavier virtuel mis à jour dans cette version. Pour en savoir plus sur l'implémentation du basculement entre les IME, consultez la page Créer un mode de saisie.

Déclarations de fichier manifeste

Fonctionnalités obligatoires pouvant être déclarées

Les valeurs suivantes sont désormais compatibles avec l'élément <uses-feature>. Vous pouvez ainsi vous assurer que votre application n'est installée que sur les appareils qui fournissent les fonctionnalités dont elle a besoin.

Autorisations utilisateur

L'autorisation suivante est désormais prise en charge dans l'élément <uses-permission> pour déclarer les autorisations requises par votre application pour accéder à certaines API.

  • BIND_DREAM_SERVICE: lorsque vous ciblez le niveau d'API 21 ou supérieur, cette autorisation est requise par un service Daydream pour garantir que seul le système peut s'y associer.