Android Guide de développement d’applications Java édition ... · Studio et couvre toutes les...

Dév

elop

pem

ent J

ava

pour

S

mar

tpho

nes

et T

able

ttes

ISB

N :

978-

2-40

9-00

253-

3

39 €

Android - Guide de développement d’applications Java pour Smartphones et Tablettes

Sylvain HEBUTERNE est Architecte Android. Spécialisé dans la programma-tion objet depuis 15 ans, il conçoit des applications Android à titre personnel, pour le compte d’agences de com-munication et de start-up. Ces projets très diversifiés lui permettent d’exploi-ter tout le potentiel de la plate-forme Android ainsi que les fonctionnalités plus avancées proposées par les dernières versions.

Véritable guide d’apprentissage, ce livre accompagne le lecteur dans le développement d’applications Android pour Smartphones et Ta-blettes tactiles. Il s’adresse aux développeurs disposant d’un minimum de connaissances sur la programmation orientée objet, le langage Java et les environnements de développement intégrés type Eclipse ou Android Studio et couvre toutes les versions d’Android jusqu’à la 6 incluse.

Le livre présente l’intégralité du processus de création d’applications, de la mise en place de l’environnement de développement Android Stu-dio jusqu’à la publication de l’application, et décrit une large sélection de fonctionnalités proposées par le système Android.

Vous découvrirez dans un premier temps la plateforme Android, vous installerez l’environnement de développement et vous créerez sans attendre votre première application Android. Vous étudierez ensuite com-ment se construit l’interface utilisateur et prendrez connaissance des composants applicatifs fondamentaux. Vous apprendrez à développer des interfaces complexes qui s’adaptent aux écrans des tablettes et smartphones et à construire vos propres composants réutilisables. Puis, seront présentées la persistance des données, la programmation concurrente, la sécurité et la communication réseau, en intégrant la bibliothèque spécialisée Volley. Un chapitre vous expliquera comment intégrer les réseaux sociaux dans vos applications.

Pour pouvoir proposer des applications les plus qualitatives possibles, vous découvrirez comment ajouter des traces et tester votre applica-tion en utilisant les fonctionnalités dédiées d’Android Studio. Vous serez enfin guidé pas à pas pour publier vos applications vers les utili-sateurs du monde entier.

L’ouvrage se termine en présentant la détermination de la géolocalisa-tion et l’utilisation des capteurs intégrés dans les terminaux Android. Sont également traités en détail des sujets avancés tels que la création d’AppWidget, la protection des applications payantes (LVL), les achats in-app ainsi que les communications NFC et les objets connectés. À l’issue de cette lecture, vous serez capable de développer et publier des applications, de qualité, natives Android (dans ses différentes versions jusqu’à la 6 incluse) pour Smartphones et Tablettes tactiles.

Enfin, en complément et pour illustrer de façon pratique les propos de l’ouvrage, l’auteur propose en téléchargement sur le site www.editions-eni.fr un ensemble de projets reprenant toutes les notions présentées dans le livre : interface utilisateur, listes, traitements asynchrones, géolocalisation, NFC, etc. Tous les modules sont fonctionnels, directe-ment exploitables, et fournissent une solide structure de base pour vos développements.

Téléchargementwww.editions-eni.fr.fr

Sur www.editions-eni.fr :b Le code source de tous

les modules des projets.

Avant-propos • L’univers Android • Pre-miers pas • Découverte de l’interface utilisateur • Les fondations • Complé-ter l’interface utilisateur • Composants applicatifs principaux • La persistance des données • Construire des interfaces complexes • Concurrence, sécurité et réseau • Réseaux sociaux • Tracer, dé-boguer et tester • Publier une applica-tion • Capteurs et géolocalistation • La technologie NFC • Objets connectés • Fonctionnalités avancées

Les chapitres du livre

Pour plus d’informations :

Andr

oid

AndroidGuide de développement d’applications Java

pour Smartphones et Tablettes

Sylvain HEBUTERNE

3e édition

Nouvelle édition

1Table des matières

Avant-propos

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2. À qui s'adresse cet ouvrage ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3. Connaissances nécessaires pour aborder cet ouvrage . . . . . . . . . . . . . 18

4. Objectifs à atteindre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

5. Téléchargements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

6. Informations complémentaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

7. Ressources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Chapitre 1L'univers Android

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

2. Présentation d'Android. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.1 Open Handset Alliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242.2 Historique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242.3 Versions d'Android . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

2.3.1 Chronologie des versions . . . . . . . . . . . . . . . . . . . . . . . . . . 262.3.2 Répartition des distributions Android . . . . . . . . . . . . . . . 30

2.4 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

3. Environnement de développement . . . . . . . . . . . . . . . . . . . . . . . . . . . 323.1 Prérequis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333.2 Android Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

3.2.1 Téléchargement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Les éléments à télécharger sont disponibles à l'adresse suivante : http://www.editions-eni.fr

Saisissez la référence ENI de l'ouvrage EI3AND dans la zone de recherche et validez. Cliquez sur le titre du livre puis sur le bouton de téléchargement.

2Guide de développement d’applications Java

Android

3.2.2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Chapitre 2Premiers pas

1. Premier projet Android. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491.1 Création du projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491.2 Organisation du projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551.3 Compilation de l'application . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561.4 Exécution de l’application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

1.4.1 Sur l'émulateur Android. . . . . . . . . . . . . . . . . . . . . . . . . . . 571.4.2 Sur un appareil Android . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

2. Structure d'un projet Android . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672.1 Structure du projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672.2 Le manifeste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

2.2.1 Balise manifest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712.2.2 Balise uses-sdk. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712.2.3 Balise application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

2.3 Les ressources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Chapitre 3Découverte de l'interface utilisateur

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

2. Écrans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

3. Activités et Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

4. Mode programmatique et mode déclaratif . . . . . . . . . . . . . . . . . . . . . 87

5. Vues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

6. Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 916.1 Création en mode déclaratif. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 926.2 Création en mode programmatique . . . . . . . . . . . . . . . . . . . . . . 94


7. Widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 967.1 Déclaration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 967.2 Utilisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 977.3 Découverte de quelques widgets . . . . . . . . . . . . . . . . . . . . . . . . . 97

7.3.1 TextView (champ de texte) . . . . . . . . . . . . . . . . . . . . . . . . 987.3.2 EditText (champ de texte de saisie) . . . . . . . . . . . . . . . . 1007.3.3 Button (bouton) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027.3.4 Autres widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Chapitre 4Les fondations

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

2. Intention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1082.1 Intention explicite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1102.2 Intention implicite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

2.2.1 Création. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1122.2.2 Filtre d’intention. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

2.3 Intention en attente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

3. Activité . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1163.1 Déclaration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1173.2 Cycle de vie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

3.2.1 onCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1203.2.2 onStart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1213.2.3 onResume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1213.2.4 onPause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1223.2.5 onStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1233.2.6 onRestart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1243.2.7 onDestroy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

3.3 Lancement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1253.4 Sauvegarde et restauration de l'état. . . . . . . . . . . . . . . . . . . . . . 1273.5 Pile d'activités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129


Android

Chapitre 5Compléter l'interface utilisateur

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

2. Styles et thèmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

3. Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1333.1 Déclaration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1333.2 Utilisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1363.3 Menu d'activité . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

3.3.1 Création . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1373.3.2 Utilisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

3.4 Menu contextuel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1393.4.1 Création . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1403.4.2 Utilisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

4. Barre d'action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1414.1 Options de menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1424.2 Icône de l'application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

5. Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1445.1 Toast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1445.2 Boîte de dialogue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

5.2.1 Tour d'horizon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1465.2.2 Boîte de dialogue d'alerte . . . . . . . . . . . . . . . . . . . . . . . . . 146

5.3 Barre de notification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1515.3.1 Création d'une notification . . . . . . . . . . . . . . . . . . . . . . . 1525.3.2 Envoi d'une notification. . . . . . . . . . . . . . . . . . . . . . . . . . 155

6. Internationalisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156


Chapitre 6Composants applicatifs principaux

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

2. Fragment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1592.1 Intégration du fragment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

2.1.1 Mode déclaratif. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1612.1.2 Mode programmatique . . . . . . . . . . . . . . . . . . . . . . . . . . 162

2.2 Fragments et mise en page adaptative . . . . . . . . . . . . . . . . . . . 1652.3 Cycle de vie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

2.3.1 onAttach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1662.3.2 onCreateView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1672.3.3 onActivityCreated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1682.3.4 onDestroyView. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1682.3.5 onDetach. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

2.4 Sauvegarde et restauration de l'état. . . . . . . . . . . . . . . . . . . . . . 1692.5 Pile de fragments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

3. Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1723.1 Déclaration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1723.2 Utilisation directe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1733.3 Utilisation en établissant une connexion . . . . . . . . . . . . . . . . . 1753.4 Cycle de vie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

3.4.1 onCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1773.4.2 onStartCommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1783.4.3 onBind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1783.4.4 onUnbind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1793.4.5 onDestroy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

4. Récepteur d'évènements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1804.1 Évènement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1814.2 Déclaration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1824.3 Cycle de vie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184


Android

5. Liste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1855.1 Implémentation standard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

5.1.1 Layout des éléments de la liste . . . . . . . . . . . . . . . . . . . . 1865.1.2 Adaptateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1875.1.3 Implémentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

5.2 Implémentation spécifique . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1915.2.1 Layout des éléments de la liste . . . . . . . . . . . . . . . . . . . . 1915.2.2 Adaptateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

5.3 Sélection d’un élément . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Chapitre 7La persistance des données

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

2. Fichiers de préférences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1972.1 Cibler le fichier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1982.2 Lecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1992.3 Écriture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2002.4 Suppression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

3. Fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2033.1 Stockage interne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

3.1.1 Écriture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2033.1.2 Lecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2043.1.3 Supprimer un fichier . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

3.2 Stockage externe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2053.2.1 Disponibilité du support . . . . . . . . . . . . . . . . . . . . . . . . . 2063.2.2 Accès et emplacements . . . . . . . . . . . . . . . . . . . . . . . . . . 2073.2.3 Fichiers communs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

3.3 Fichiers temporaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2093.3.1 Stockage interne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2093.3.2 Stockage externe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210


4. Bases de données SQLite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2114.1 Création d'une base de données. . . . . . . . . . . . . . . . . . . . . . . . . 2114.2 Traitements et requêtes SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

4.2.1 Navigation dans les résultats . . . . . . . . . . . . . . . . . . . . . . 2144.2.2 Lecture de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

4.3 Mises à jour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2164.4 Optimisation pour la recherche textuelle . . . . . . . . . . . . . . . . . 219

4.4.1 Création et peuplement de la table . . . . . . . . . . . . . . . . . 2194.4.2 Interrogation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

5. Fournisseur de contenus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2225.1 Interface et URI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2225.2 Requêtes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2235.3 Ajout d'un enregistrement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2255.4 Suppression d'enregistrements . . . . . . . . . . . . . . . . . . . . . . . . . 226

6. Sauvegarde dans les nuages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2276.1 Souscrire à l'Android Backup Service. . . . . . . . . . . . . . . . . . . . . 2286.2 Configuration de la clé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2306.3 Agent de sauvegarde . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

6.3.1 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2316.3.2 BackupAgentHelper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

6.4 Gestionnaire de sauvegarde . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2356.4.1 Demander une sauvegarde . . . . . . . . . . . . . . . . . . . . . . . . 2356.4.2 Tester le service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

7. Prise en charge du JSON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2377.1 Présentation du format JSON . . . . . . . . . . . . . . . . . . . . . . . . . . 2377.2 Interprétation du format JSON. . . . . . . . . . . . . . . . . . . . . . . . . 238


Android

Chapitre 8Construire des interfaces complexes

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

2. Créer ses propres composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2442.1 Surcharger un composant existant . . . . . . . . . . . . . . . . . . . . . . 244

2.1.1 Étendre une classe du package android.widget . . . . . . . 2442.1.2 Intégrer le nouveau composant dans un layout . . . . . . . 2452.1.3 Ajouter des attributs personnalisés . . . . . . . . . . . . . . . . . 246

2.2 Réunir un ensemble de composants . . . . . . . . . . . . . . . . . . . . . 2492.3 Construire entièrement un composant. . . . . . . . . . . . . . . . . . . 250

2.3.1 Implémenter onDraw() . . . . . . . . . . . . . . . . . . . . . . . . . . 2502.3.2 Implémenter onMeasure() . . . . . . . . . . . . . . . . . . . . . . . . 2512.3.3 Obtenir les dimensions de l'écran . . . . . . . . . . . . . . . . . . 252

3. Utiliser le Navigation Drawer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2533.1 Mettre en place le panneau de navigation . . . . . . . . . . . . . . . . 2543.2 Utiliser le panneau de navigation . . . . . . . . . . . . . . . . . . . . . . . 256

3.2.1 Détecter les évènements d'ouverture/fermeture . . . . . . 2573.2.2 Navigation Drawer et ActionBar. . . . . . . . . . . . . . . . . . . 2573.2.3 Intégrer le bouton d'ouverture/fermeture . . . . . . . . . . . 2593.2.4 Forcer l'ouverture du panneau

au lancement de l'activité. . . . . . . . . . . . . . . . . . . . . . . . . 260

4. Créer des images redimensionnables . . . . . . . . . . . . . . . . . . . . . . . . . 2614.1 Les images 9-patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

4.1.1 Présentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2614.1.2 Créer des images 9-patch . . . . . . . . . . . . . . . . . . . . . . . . . 264

4.2 Les drawables XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2674.2.1 Définir une forme en XML . . . . . . . . . . . . . . . . . . . . . . . 2674.2.2 Modifier la forme initiale . . . . . . . . . . . . . . . . . . . . . . . . . 2704.2.3 Combiner plusieurs formes . . . . . . . . . . . . . . . . . . . . . . . 275

5. Mise en page complexe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2765.1 Choix du layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2765.2 Positionnement relatif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277


5.3 Utiliser les poids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2795.4 Un dernier point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284

Chapitre 9Concurrence, sécurité et réseau

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

2. Processus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2872.1 android:process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2882.2 Partage de processus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289

3. Programmation concurrente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2913.1 AsyncTask. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2923.2 Thread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

3.2.1 Création. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2963.2.2 runOnUIThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2973.2.3 Communication interthread . . . . . . . . . . . . . . . . . . . . . . 298

4. Sécurité et droits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3014.1 Les droits avant MarshMallow . . . . . . . . . . . . . . . . . . . . . . . . . 3024.2 Les droits sous MarshMallow . . . . . . . . . . . . . . . . . . . . . . . . . . 3024.3 Déclaration de droits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3054.4 Restriction d'utilisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

5. Réseau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3075.1 Agent utilisateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3085.2 AndroidHttpClient. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3115.3 Utilisation de la bibliothèque Volley. . . . . . . . . . . . . . . . . . . . . 314

5.3.1 Intégration de Volley . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3145.3.2 Requêtes de type chaîne de caractères . . . . . . . . . . . . . . 3195.3.3 Ajouter des paramètres . . . . . . . . . . . . . . . . . . . . . . . . . . 3225.3.4 Requêtes au format JSON . . . . . . . . . . . . . . . . . . . . . . . . 3225.3.5 Requêtes au format Image . . . . . . . . . . . . . . . . . . . . . . . . 3245.3.6 Autres requêtes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325


Android

Chapitre 10Réseaux sociaux

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

2. Intégration standard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3282.1 Sous Android 2.x et 3.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3282.2 Sous Android 4.x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

3. Intégration complète . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3333.1 Récupérer les clés d'API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333

3.1.1 Créer une application Facebook . . . . . . . . . . . . . . . . . . . 3343.1.2 Autres réseaux sociaux. . . . . . . . . . . . . . . . . . . . . . . . . . . 337

3.2 Installer le SDK SocialAuth-Android . . . . . . . . . . . . . . . . . . . . 3373.2.1 Intégration des bibliothèques dans le projet. . . . . . . . . . 3383.2.2 Utilisation de l'API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

Chapitre 11Tracer, déboguer et tester

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347

2. Journal d'évènements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3482.1 Consultation des évènements . . . . . . . . . . . . . . . . . . . . . . . . . . 3492.2 Écriture des évènements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

3. Débogage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3523.1 Débogage pas à pas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3523.2 Android Device Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

3.2.1 Vue Devices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3553.2.2 Vue Emulator Control . . . . . . . . . . . . . . . . . . . . . . . . . . . 3573.2.3 Vue Threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3583.2.4 Vue Heap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3593.2.5 Vue Allocation Tracker . . . . . . . . . . . . . . . . . . . . . . . . . . 3603.2.6 Vue File Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361


4. Tests unitaires et fonctionnels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3614.1 Création d'un projet de tests . . . . . . . . . . . . . . . . . . . . . . . . . . . 3624.2 Création d'une classe de tests unitaires locaux. . . . . . . . . . . . . 3634.3 Création d’un test pour une activité . . . . . . . . . . . . . . . . . . . . . 365

5. Test du singe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368

Chapitre 12Publier une application

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

2. Préliminaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3732.1 Version de l'application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

2.1.1 android:versionCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3732.1.2 android:versionName . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3742.1.3 Surcharge par Gradle . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

2.2 Filtres pour le marché. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3752.2.1 uses-feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3762.2.2 uses-configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

3. Signature de l'application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3783.1 Compilation en mode débogage . . . . . . . . . . . . . . . . . . . . . . . . 3793.2 Compilation en mode final . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379

3.2.1 Protection du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3803.2.2 Signer l'application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3823.2.3 Installer l'application . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384

4. Production de plusieurs versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

5. Publication de l'application sur le Play Store . . . . . . . . . . . . . . . . . . 3895.1 Inscription. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3905.2 Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399

5.2.1 Fichier .apk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4015.2.2 Fiche Google Play Store . . . . . . . . . . . . . . . . . . . . . . . . . . 4015.2.3 Tarifs et disponibilité . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4035.2.4 Coordonnées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404


Android

5.2.5 Accepter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4045.3 Et après ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

Chapitre 13Capteurs et géolocalisation

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

2. Fondamentaux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408

3. Détecter un capteur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408

4. Obtenir les valeurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

5. Localisation géographique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4145.1 Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4155.2 Gestionnaire de localisation. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4165.3 Récupérer les données de localisation . . . . . . . . . . . . . . . . . . . . 417

5.3.1 En cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4205.3.2 Une seule fois . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4205.3.3 Périodiquement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4215.3.4 Stopper les mises à jour . . . . . . . . . . . . . . . . . . . . . . . . . . 422

6. Google Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4236.1 Mise en place. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

6.1.1 Installation du SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4236.1.2 Configuration de l'application . . . . . . . . . . . . . . . . . . . . . 4246.1.3 Obtenir une clé d'utilisation . . . . . . . . . . . . . . . . . . . . . . 425

6.2 Utilisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4286.2.1 Déclaration de la vue . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4296.2.2 MapActivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4296.2.3 Géolocalisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431


Chapitre 14La technologie NFC

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435

2. La technologie NFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4352.1 Les scénarios d'utilisation du NFC . . . . . . . . . . . . . . . . . . . . . . 4362.2 Les tags NFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436

3. Prise en charge du NFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4383.1 Utiliser avec un émulateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4383.2 Détecter si l'appareil est compatible NFC. . . . . . . . . . . . . . . . . 439

3.2.1 Filtrer les appareils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4393.2.2 Tester à l'exécution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4403.2.3 Activation par l'utilisateur . . . . . . . . . . . . . . . . . . . . . . . . 440

4. Découverte d'un tag NFC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4404.1 Prise en charge d'un intent ACTION_NDEF_DISCOVERED. 4414.2 Prise en charge d'un intent ACTION_TECH_DISCOVERED 4434.3 Prise en charge d'un intent ACTION_TAG_DISCOVERED. . 4454.4 Android Application Records. . . . . . . . . . . . . . . . . . . . . . . . . . . 4454.5 Foreground dispatch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446

5. Lire un tag NFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4485.1 Déterminer le contenu d'un tag NDEF . . . . . . . . . . . . . . . . . . . 4495.2 Lire une URI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4505.3 Lire une chaîne de caractères . . . . . . . . . . . . . . . . . . . . . . . . . . . 4525.4 Lire un Type MIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4535.5 Lire un tag de type TNF_WELL_KNOWN . . . . . . . . . . . . . . . . 453

6. Écrire un tag NFC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4546.1 Définir un enregistrement NdefRecord avec l'API 9 . . . . . . . . 455

6.1.1 Construire un payload de type texte. . . . . . . . . . . . . . . . 4566.1.2 Construire un payload de type URI . . . . . . . . . . . . . . . . 457

6.2 Définir un enregistrement NdefRecord avec les API 14 et 16 . 458


Android

Chapitre 15Objets connectés

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

2. Détection et connexion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4622.1 Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4622.2 Initialisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4632.3 Recherche d’appareil BLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

2.3.1 Recherche sous Jelly Bean . . . . . . . . . . . . . . . . . . . . . . . . 4642.3.2 Recherche sous Lollipop . . . . . . . . . . . . . . . . . . . . . . . . . . 4662.3.3 Appliquer des filtres lors de la recherche. . . . . . . . . . . . . 467

2.4 Connexion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470

3. Échange de données/interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . 4733.1 Découvrir les services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4733.2 Lire une caractéristique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4763.3 Écrire une valeur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478

Chapitre 16Fonctionnalités avancées

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481

2. App Widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4812.1 Création . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4822.2 Déclaration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4832.3 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4842.4 Cycle de vie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486

2.4.1 onEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4872.4.2 onDisabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4872.4.3 onUpdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4882.4.4 onDeleted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488

2.5 RemoteViews . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489


2.6 Activité de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4922.6.1 Déclaration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4922.6.2 Création. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

3. Protéger les applications payantes . . . . . . . . . . . . . . . . . . . . . . . . . . . 4953.1 Installation de la LVL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496

3.1.1 Téléchargement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4963.1.2 Intégration de la LVL dans le code source. . . . . . . . . . . . 498

3.2 Utilisation de la LVL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4983.2.1 Politique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4983.2.2 Obfuscation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4993.2.3 Vérification de la licence . . . . . . . . . . . . . . . . . . . . . . . . . 500

3.3 Tester. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5033.3.1 Tester sur un appareil Android . . . . . . . . . . . . . . . . . . . . 5083.3.2 Tester sur un émulateur. . . . . . . . . . . . . . . . . . . . . . . . . . 508

4. Proposer des achats intégrés. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5084.1 Préparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5094.2 Utilisation du paiement intégré. . . . . . . . . . . . . . . . . . . . . . . . . 511

4.2.1 Initier la communication avec le Play Store . . . . . . . . . . 5114.2.2 Obtenir la liste des produits. . . . . . . . . . . . . . . . . . . . . . . 5124.2.3 Vérifier qu’un produit a été commandé . . . . . . . . . . . . . 5144.2.4 Commander un produit . . . . . . . . . . . . . . . . . . . . . . . . . . 515

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519

197

Chapitre 7

La persistance des données

La pers istance des données1. Introduction

Ce chapitre a pour but de présenter la persistance des données sous Android.

Les données persistantes d'une application sont les données sauvegardéesavant la fermeture de l'application de telle sorte qu'elles puissent être restau-rées ultérieurement.

Android propose plusieurs mécanismes permettant de gérer la persistance dedonnées, selon la nature de ces données. Nous découvrirons les fichiers de pré-férences, les fichiers standard et les bases de données.

Nous terminerons par les fournisseurs de contenus qui, au-delà de la persis-tance des données, proposent un mécanisme de partage de données entre lesapplications.

2. Fichiers de préférences

Android fournit un framework simple pour sauvegarder et restaurer des don-nées de types primitifs. Ces données sont sauvegardées dans des fichiers auformat XML sous la forme d'associations clés-valeurs. Ces fichiers sont appe-lés fichiers de préférences.

© E

dit

ions

EN

I -

All r

ights

rese

rved


Android

Nous allons étudier dans un premier temps comment cibler un fichier de pré-férences, puis comment le lire et y écrire des données. Nous terminerons pardécrire comment supprimer toutes ou partie des données de ces fichiers.

Remarque

Le système Android permet d'afficher et de sauvegarder les préférences gé-nérales de l'utilisateur. Toute application peut adopter la même fonctionnalitéet le même affichage. La hiérarchie des préférences proposées peut être réa-lisée directement dans un fichier XML. L'implémentation d'un tel écran de pré-férences est réalisée en dérivant de la classe PreferenceActivity. DepuisAndroid 3.0 (API 11), cette classe fonctionne de concert avec les fragmentsde type PreferenceFragment afin de pouvoir, entre autres, afficher côte àcôte les titres des sections et les préférences qu'elles proposent.

2.1 Cibler le fichier

Par défaut, un fichier de préférences est associé à l'activité qui le crée. Ce fi-chier porte automatiquement le nom qualifié entier de l'activité concernée,par exemple fr.mondomaine.android.monappli.prefsFic1.xml.

La création et la gestion du fichier de préférences sont réalisées au travers d'unobjet de type SharedPreferences retourné par la méthode getPrefe-rences de la classe Activity.

Syntaxe

public SharedPreferences getPreferences (int mode)

Cette méthode prend en paramètre le mode d'accès à assigner au fichier lorsde sa création. Les valeurs possibles pour ce paramètre sont :

– Context.MODE_PRIVATE : mode privé. C'est le mode par défaut. Le fi-chier ne peut être lu et écrit que par l'application courante, ou une applica-tion partageant le même identifiant utilisateur.

– Context.MODE_WORLD_READABLE : les autres applications peuvent lirele fichier.

– Context.MODE_WORLD_WRITEABLE : les autres applications peuventmodifier le fichier.

199La persistance des donnéesChapitre 7

Exemple

SharedPreferences prefs = getPreferences(Context.MODE_PRIVATE);

Il est également possible de spécifier explicitement un autre nom de fichier.Cela permet de créer plusieurs fichiers de préférences. Pour cela, il faut utiliserla méthode getSharedPreferences en spécifiant le nom du fichier en pre-mier paramètre.

Syntaxe

public abstract SharedPreferences getSharedPreferences (String

name, int mode)

Exemple

SharedPreferences prefs =

getSharedPreferences("nomFichierPrefs1.xml",

Context.MODE_PRIVATE);

2.2 Lecture

Les données contenues dans un fichier de préférences sont enregistrées sousforme d'associations clés-valeurs. Une telle association est composée :

– D'une clé qui est une chaîne de caractères de type String.

– D'une valeur de type primitif : boolean (booléen), float (nombre à vir-gule flottante), int ou long (entiers) ou String (chaîne de caractères).

Pour lire les données contenues dans un fichier de préférences, on utilise l'objetde type SharedPreferences récupéré précédemment. On invoque ensuitecertains de ses accesseurs permettant de lire individuellement une donnée se-lon son type.

Syntaxe

public abstract boolean getBoolean (String key, boolean defValue)

public abstract float getFloat (String key, float defValue)

public abstract int getInt (String key, int defValue)

public abstract long getLong (String key, long defValue)

public abstract String getString (String key, String defValue)

© E

dit

ions

EN

I -

All r

ights

rese

rved


Android

Le premier paramètre est le nom de la clé. Le second paramètre est la valeurpar défaut à retourner si la clé n'existe pas.

Exemple

boolean modeWifi = prefs.getBoolean("modeWifi", false);

int compteur = prefs.getInt("compteur", 0);

String commentaire = prefs.getString("commentaire", "");

On peut aussi récupérer toutes les données d'un seul coup en utilisant la mé-thode getAll.

Syntaxe

public abstract Map<String, ?> getAll ()

Exemple

Map<String, ?> valeurs = prefs.getAll();

Boolean modeWifi = (Boolean)valeurs.get("modeWifi");

La méthode contains de l'objet SharedPreferences permet de vérifierla présence d'une clé donnée qu'on lui spécifie en paramètre.

Syntaxe

public abstract boolean contains (String key)

Exemple

if (prefs.contains("modeWifi")) {

traitement();

}

2.3 Écriture

L'écriture de données dans un fichier de préférences se fait via un objet de typeSharedPreferences.Editor. Cet objet est retourné par la méthodeedit appelée sur l'objet de type SharedPreferences récupéré précédem-ment.

Syntaxe

public abstract SharedPreferences.Editor edit ()

201La persistance des donnéesChapitre 7

Exemple

SharedPreferences.Editor editeur = prefs.edit();

L'objet Editor ci-dessus permet de spécifier les nouvelles données ou de mo-difier les données existantes en les écrasant avec les nouvelles. On invoque sesméthodes permettant d'écrire individuellement une association clé-valeur. Àl'instar des méthodes de lecture, il existe une méthode d’écriture par typeprimitif. Ces méthodes prennent en paramètres le nom de la clé ainsi que lavaleur de la donnée.

Syntaxe

public abstract SharedPreferences.Editor putBoolean (String key,

boolean value)

public abstract SharedPreferences.Editor putFloat (String key,

float value)

public abstract SharedPreferences.Editor putInt (String key,

int value)

public abstract SharedPreferences.Editor putLong (String key,

long value)

public abstract SharedPreferences.Editor putString (String key,

String value)

Exemple

editeur.putBoolean("modeWifi", true);

editeur.putInt("compteur", 42);

editeur.putString("commentaire", "Ceci est un commentaire");

L'écriture des données ne sera effectivement réalisée dans le fichier qu'une foisla méthode commit de l'objet Editor appelée.

Syntaxe

public abstract boolean commit ()

Exemple

editeur.commit();

Remarque

Attention à ne pas oublier d'appeler la méthode commit. Car sans cet appel,l'objet Editor ne sert à rien ; les modifications qu'il contient n'étant pas enre-gistrées.

© E

dit

ions

EN

I -

All r

ights

rese

rved


Android

2.4 Suppression

La suppression des données contenues dans un fichier de préférences se fait enutilisant l'objet Editor de type SharedPreferences.Editor commepour l'écriture des données.

La méthode remove de l'objet Editor permet de supprimer une associationclé-valeur. On spécifie le nom de la clé en paramètre.

Syntaxe

public abstract SharedPreferences.Editor remove (String key)

Exemple

editeur.remove("modeWifi");

La méthode clear permet de supprimer toutes les données, c'est-à-diretoutes les associations clés-valeurs.

Syntaxe

public abstract SharedPreferences.Editor clear ()

Exemple

editeur.clear();

Comme pour l'écriture, il faut appeler la méthode commit pour enregistrer lesmodifications.

Il est également possible d'enchaîner les modifications puisque les méthodesde l'objet Editor retournent cet objet.

Exemple

editeur.clear().putBoolean("modeWifi", modeWifi).commit();

Remarque

Lors de l'appel à la méthode commit, la méthode clear est exécutée enpremier quelle que soit la position de son appel.

On peut donc par exemple réécrire la ligne précédente sans en modifier lerésultat.

Android Guide de développement d’applications Java édition ... · Studio et couvre toutes les...

Documents

Transcript of Android Guide de développement d’applications Java édition ... · Studio et couvre toutes les...