Android 8.0 (niveau d'API 26) introduit des changements de comportement, ainsi que de nouvelles fonctionnalités et API que vous pouvez exploiter dans vos applications. Ce document présente les étapes à suivre pour migrer vos applications vers Android 8.0 en deux phases clés :
- Assurer la compatibilité avec Android 8.0
Vérifiez que votre application est entièrement fonctionnelle sur la nouvelle version de la plate-forme. À ce stade, vous n'utilisez pas de nouvelles API et ne modifiez pas la valeur
targetSdkVersionde votre application, mais des modifications mineures peuvent être nécessaires. - Mettre à jour votre version cible et utiliser les fonctionnalités d'Android 8.0
Lorsque vous êtes prêt à profiter des nouvelles fonctionnalités de la plate-forme, définissez
targetSdkVersionsur 26, vérifiez que l'application continue de fonctionner comme prévu, puis commencez à utiliser les nouvelles API.
Assurer la compatibilité avec Android 8.0
L'objectif est de s'assurer que votre application existante fonctionne telle quelle sur Android 8.0 (niveau d'API 26). Certaines modifications de la plate-forme pouvant avoir un impact sur le comportement de votre application, des ajustements peuvent être nécessaires. Toutefois, vous n'avez pas besoin d'utiliser de nouvelles API ni de modifier votre targetSdkVersion.
Préparer un appareil équipé d'Android 8.0
- Si vous possédez un appareil compatible (Pixel, Pixel XL, Pixel C, Nexus 5X, Nexus 6P ou Nexus Player), suivez les instructions pour flasher votre appareil.
- Vous pouvez également télécharger l'image système Android 8.0 pour Android Emulator. Elle est listée dans le SDK Manager sous Android 8.0 en tant qu'image système Google APIs Intel x86 Atom.
Remarque : L'image système Android 8.0 est disponible en téléchargement à partir d'Android Studio 3.0 ou version ultérieure. Pour en savoir plus, consultez la section ci-dessous pour obtenir le SDK Android 8.0.
Effectuer des tests de compatibilité
Dans la plupart des cas, les tests de compatibilité avec Android 8.0 (niveau d'API 26) sont semblables aux tests que vous effectuez lorsque vous vous préparez à publier votre application. C'est le moment de consulter les consignes relatives à la qualité des applications et les bonnes pratiques en matière de test.
Toutefois, il existe un autre aspect des tests : Android 8.0 introduit des modifications de la plate-forme Android qui peuvent affecter le comportement de votre application ou l'empêcher de fonctionner, même si vous ne modifiez pas votre targetSdkVersion. C'est pourquoi il est important que vous examiniez les principaux changements du tableau 1 et que vous testiez les correctifs que vous implémentez pour les prendre en compte.
Tableau 1. Principaux changements affectant toutes les applications exécutées sur des appareils Android 8.0.
| Modifier | Résumé | Autres références |
|---|---|---|
| Notifications moins fréquentes de la localisation en arrière-plan | Si votre application reçoit des notifications de position d'un service d'arrière-plan, elle les reçoit moins fréquemment sur Android 8.0 (niveau d'API 26) que sur les versions antérieures d'Android. Plus précisément, un service d'arrière-plan ne peut pas recevoir de notifications de position plus de quelques fois par heure. Toutefois, lorsque votre application est au premier plan, la fréquence des mises à jour de position reste inchangée. | Limites de localisation en arrière-plan |
net.hostname ne sont plus acceptés |
L'interrogation de la propriété système net.hostname produit un résultat nul.
|
Aucun |
Nouvelle exception de send(DatagramPacket) |
La méthode send(DatagramPacket) génère une exception SocketException si la méthode connect(InetAddress, int) précédemment exécutée a échoué.
|
Changements de comportement : connectivité réseau et HTTP(S) |
NullPointerException approprié à partir des méthodes AbstractCollection |
AbstractCollection.removeAll(null) et AbstractCollection.retainAll(null) génèrent désormais toujours une exception NullPointerException. Auparavant, l'exception NullPointerException n'était pas générée lorsque la collection était vide.
Cette modification rend le comportement cohérent avec la documentation.
|
Modifications de comportement : gestion des collections |
NullPointerException approprié de Currency.getDisplayName(null) |
L'appel de Currency.getDisplayName(null) génère une NullPointerException.
|
Nouveaux comportements : paramètres régionaux et internationalisation |
Pour obtenir une liste plus complète des changements de comportement dans Android 8.0 (niveau d'API 26), consultez également Changements de comportement dans Android 8.0.
Mettre à jour votre version cible et utiliser les fonctionnalités d'Android 8.0
Cette section explique comment activer la compatibilité totale avec Android 8.0 (niveau d'API 26) en mettant à jour votre targetSdkVersion vers la version 26 et en ajoutant les nouvelles fonctionnalités disponibles dans Android 8.0.
En plus de vous proposer de nouvelles API, Android 8.0 introduit des changements de comportement lorsque vous mettez à jour votre targetSdkVersion vers la version 26. Étant donné que certaines modifications de comportement peuvent nécessiter des modifications de code pour éviter les dysfonctionnements, vous devez d'abord comprendre comment votre application peut être affectée lorsque vous modifiez le targetSdkVersion en consultant toutes les modifications de comportement pour les applications ciblant Android 8.0.
Remarque : Les étapes décrites ci-dessus pour assurer la compatibilité de la plate-forme sont préalables au ciblage de votre application sur Android 8.0. Veillez donc à les effectuer en premier.
Obtenir le SDK Android 8.0
Vous pouvez obtenir les packages SDK pour créer votre application avec Android 8.0 (niveau d'API 26) à l'aide de la dernière version d'Android Studio (Android Studio 3.0 ou version ultérieure est recommandé). Android Studio 3.0 ou version ultérieure inclut des outils pour vous aider à utiliser les fonctionnalités d'Android 8.0, telles que les icônes adaptatives et les polices téléchargeables. Si vous n'avez pas encore besoin de ces fonctionnalités, vous pouvez utiliser la version stable d'Android Studio 2.3.3 pour créer votre application avec Android 8.0 et utiliser les nouvelles API.
Pour configurer l'une ou l'autre version d'Android Studio, procédez comme suit :
- Lancez Android Studio et ouvrez SDK Manager en cliquant sur Tools > SDK Manager (Outils > SDK Manager).
- Dans l'onglet SDK Platforms (Plates-formes SDK), cochez Show Package Details (Afficher les détails du package). Sous Android 8.0 Preview, vérifiez les éléments suivants :
- SDK Android Platform 26
- Image système Google APIs Intel x86 Atom (requise uniquement pour l'émulateur)
- Accédez à l'onglet SDK Tools et cochez tous les éléments pour lesquels des mises à jour sont disponibles (cliquez sur chaque case à cocher affichant un tiret
). Cela devrait inclure les dernières versions des éléments requis suivants :
- SDK Build-Tools pour Android 26.0.0
- SDK Platform-Tools pour Android 26.0.0
- Android Emulator 26.0.0
- Cliquez sur OK pour installer tous les packages SDK sélectionnés.
Vous êtes maintenant prêt à commencer à développer avec Android 8.0.
Mettre à jour votre configuration de compilation
Mettez à jour compileSdkVersion, targetSdkVersion et la version de la bibliothèque Support vers les dernières révisions disponibles, par exemple :
android {
compileSdkVersion 26
defaultConfig {
targetSdkVersion 26
}
...
}
dependencies {
compile 'com.android.support:appcompat-v7:26.0.0'
}
// REQUIRED: Google's new Maven repo is required for the latest
// support library that is compatible with Android 8.0
repositories {
google()
// If you're using a version of Gradle lower than 4.1, you must instead use:
// maven {
// url 'https://maven.google.com'
// }
}
Supprimer les broadcast receivers de votre fichier manifeste
Comme Android 8.0 (niveau d'API 26) introduit de nouvelles limites pour les broadcast receivers, vous devez supprimer tous les broadcast receivers enregistrés pour les intents de diffusion implicites. Si vous les laissez en place, votre application ne sera pas interrompue au moment de la compilation ou de l'exécution, mais ils n'auront aucun effet lorsque votre application s'exécutera sur Android 8.0.
Les diffusions auxquelles seule votre application peut répondre (les intents de diffusion explicites et les diffusions envoyées spécifiquement au nom de package de votre application) continuent de fonctionner de la même manière sur Android 8.0.
Cette nouvelle restriction comporte des exceptions. Pour obtenir la liste des diffusions implicites qui fonctionnent toujours dans les applications ciblant Android 8.0, consultez Exceptions de diffusion implicite.
Tester votre application Android 8.0
Une fois les préparations précédentes terminées, vous pouvez créer votre application, puis la tester plus en détail pour vous assurer qu'elle fonctionne correctement lorsque vous ciblez Android 8.0 (niveau d'API 26). C'est également le moment de consulter les consignes fondamentales relatives à la qualité des applications et les bonnes pratiques en matière de test.
Lorsque vous compilez votre application avec la valeur targetSdkVersion définie sur 26, vous devez tenir compte de certains changements spécifiques à la plate-forme. Certaines de ces modifications peuvent avoir un impact significatif sur le comportement de votre application, voire l'empêcher de fonctionner, même si vous n'implémentez pas de nouvelles fonctionnalités dans Android 8.0.
Le tableau 2 fournit la liste de ces modifications, avec des liens vers des informations supplémentaires.
Tableau 2. Principaux changements affectant les applications lorsque targetSdkVersion est défini sur 26.
| Modifier | Résumé | Autres références |
|---|---|---|
| Confidentialité | Android 8.0 (niveau d'API 26) n'est pas compatible avec l'utilisation des propriétés système net.dns1, net.dns2, net.dns3 ou net.dns4. | Nouveaux comportements : confidentialité |
| Segments accessibles en écriture et exécutables appliqués | Pour les bibliothèques natives, Android 8.0 (niveau d'API 26) applique la règle selon laquelle les données ne doivent pas être exécutables et le code ne doit pas être accessible en écriture. | Nouveaux comportements : bibliothèques natives |
| Validation de l'en-tête et de la section ELF | L'éditeur de liens dynamique vérifie davantage de valeurs dans l'en-tête ELF et les en-têtes de section, et échoue si elles ne sont pas valides. | Nouveaux comportements : bibliothèques natives |
| Notifications | Les applications ciblant la version Android 8.0 (niveau d'API 26) du SDK doivent implémenter un ou plusieurs canaux de notification pour envoyer des notifications aux utilisateurs. | Présentation de l'API : notifications |
La méthode List.sort()
|
Les implémentations de cette méthode ne peuvent plus appeler Collections.sort(), sinon votre application générera une exception en raison d'un dépassement de pile.
|
Modifications de comportement : gestion des collections |
La méthode Collections.sort()
|
Dans les implémentations de List, Collections.sort() génère désormais une exception ConcurrentModificationException.
|
Modifications de comportement : gestion des collections |
Pour obtenir une liste plus complète des changements de comportement dans Android 8.0 (niveau d'API 26), consultez Changements de comportement dans Android 8.0.
Pour découvrir les nouvelles fonctionnalités et API disponibles avec Android 8.0 (niveau d'API 26), consultez Fonctionnalités et API d'Android 8.0.