Formation Android

TP 0 - Introduction

Mise en place

Avant le premier cours, vérifiez que votre poste de travail est opérationnel:

Installez - sur un disque où vous avez de la place - la dernière version d’Android Studio, ou mettez le à jour si vous l’avez déjà
Créez un projet vide (laissez l’api minimale proposée)
L’IDE va prendre un moment à télécharger des dépendances et à se configurer
Si vous avez un appareil Android physique et un cable qui fonctionne, passez le en mode développeur (en tapant 7 fois sur le numéro de build dans les paramètres) et prenez le avec vous en cours, ce sera plus simple.
Sinon: Dans Device Manager > Create virtual device choisissez un device avec le triangle du PlayStore, puis une version d’OS Android récente
Essayez de le lancer le projet (en cliquant sur le triangle vert)

Paramétrage

Prenez en main l’IDE: vous pouvez aller dans les paramètres (File > Settings ou Android Studio > Preferences) et personnalisez l’IDE, je vous conseille notamment ceci:

Activez tout dans Editor > Inlay Hints
Activez les imports automatiques: Editor > General > Auto Import > Kotlin (en bas) > cocher les 2 cases
Personnalisez la coloration syntaxique dans Settings > Editor > Color Scheme (vous pouvez utiliser ma config avec ⚙ > Import Scheme et ce fichier)
Personnalisez les raccourcis clavier: par ex “comment block” et “rename” ne sont pas très pratiques par défaut surtout en clavier AZERTY

Android Studio

🚀 Aidez vous de l’IDE: Android Studio fait beaucoup de travail pour vous donc utilisez l’autocompletion et les raccourcis:

CTRL/CMD + click pour voir les usages ou la définition d’un élément
Alt + Enter pour des “💡 QuickFix” (suggestions de l’IDE)
Clic droit pour plus d’actions: notamment “Refactor” qui contient pas mal de fonctions pratiques comme par exemple “rename” qui va renommer partout où l’élément est utilisé (il y a parfois des raccourcis existant ou alors vous pouvez en définir)
Shift, Shift + "recherche" pour tout le reste (variable, fonction, classe, actions, options, …)
CMD + alt + L ou Alt + shift + L pour reformater correctement tout le code (ou la sélection)

Cliquez sur `Sync Now` (dans la barre bleue en haut) quand l'IDE vous le propose: ça arrive par exemple quand on édite des fichiers de config (`.gradle`) pour ajouter des dépendances. Vous pouvez aussi le faire avec le bouton "éléphant" ressemblant à ceci: ![width=20px](/assets/gradle_sync.png) 🧑‍🏫 C'est le logo de **Gradle**, le système de build de projets Android: il y a un fichier gradle par module (ici vous avez un seul module `app`) et un fichier pour le projet dans son ensemble (il y a d'autres fichiers de configs mais ceux là sont les principaux) ## Vocabulaire ```kotlin val text: String = "hello" val user: User? = null class MutableList : List { // ... val count: String override fun add(element: E): Boolean } ``` Dans cet exemple: - `text` est une **variable** de **type** `String` - `user` est une **instance** de la **Class** `User?` - `User?` est une classe **nullable** - une **instance** d'une classe **nullable** est soit une **instance** de `User` soit `null` - `MutableList` est une **classe** qui prend un **type parameter** (ou **generic**) - `MutableList` **hérite** de `List` - `List` est une **interface**: on dit que `Array` **implémente** `List` - `count` est une **variable** définie dans une **classe**: on dit que c'est une **propriété** - `add()` est une **fonction** qui **surcharge** une **fonction** ayant la même **signature** dans une des ses **classes mère** - `add()` est une **fonction** définie dans une **classe**: on dit que c'est une **méthode** ## Kotlin Basics Pour prendre en main les bases du langage, avec qq indices: - [Nullable types](https://play.kotlinlang.org/koans/Introduction/Nullable%20types/Task.kt) ```kotlin // on peut "chaîner" les appels nullable avec `?.`: val email = client?.personalInfo?.email ``` - [String templates](https://play.kotlinlang.org/koans/Introduction/String%20templates/Task.kt) ```kotlin // pour "interpoler" une variable dans une string on utilise '$' fun getPattern(): String = """<pattern qui match 2 digits> $month <pattern qui match 4 digits>""" ``` - [Lambdas](https://play.kotlinlang.org/koans/Introduction/Lambdas/Task.kt) ```kotlin val isEven = number % 2 == 0 // check division par 2 val lambdaWithExplicitParam = { explicitParam -> explicitParam == 42 } val lambdaWithImplicitParam = { it == 42 } ``` - [Data classes](https://play.kotlinlang.org/koans/Classes/Data%20classes/Task.kt) ```kotlin data class Person( val ... val ... ) ``` ## Jetpack Compose Basics [Codelab: Jetpack Compose Basics](https://developer.android.com/codelabs/jetpack-compose-basics) Pour continuer voir [les autres codelabs Google](https://developer.android.com/get-started/codelabs) ## Projet Pendant les prochains TP, vous allez créer un projet en binôme que vous compléterez au fil des TPs. On prends comme base une simple Todo app, mais vous choisirez ensuite un autre sujet que l'on intégrera dans le même projet pour simplifier le rendu. L'objectif est d'utiliser les briques de base suivantes: - Avoir une UI correcte en Jetpack compose - Naviguer entre plusieurs écrans: Liste/Détail a minima avec `Navigation3` - Interaction avec une API distante (avec `Retrofit`, `kotlinx.serialization` et `kotlinx.coroutines`) - Afficher des images locales et/ou distantes avec `Coil` - Respecter une architecture minimale (`ViewModel`, `Repository`) - écrire un minimum de tests unitaires Et selon le sujet choisi, vous pourrez aussi implémenter: - Une mécanique de login - Demander une ou plusieurs permissions - Stocker des données localement (avec `DataStore` ou `Room`) si l'API permet seulement de GET par exemple - Gérer des tâches en arrière plan (avec `WorkManager`) - Gérer l'accessibilité (via `TalkBack`) - ... Quelques idées d'applications: - Affichage d'horaires de trains - Client alternatif pour Twitch, Twitter, Bluesky, ... - Traqueur de films, séries, jeux, etc - Jeux à UI simple: Quiz, Memory, Wordle, Food Guessr, etc Si vous avex un mac et/ou un iPhone (ou juste si ça vous intéresse) on fera du Kotlin Mutliplatform afin de pouvoir lancer votre app également sur iOS ! Exemples d'années précédentes: - Cémantix - Reigns-like - Jukebox Spotify Exemples d'API gratuites: - <https://trakt.docs.apiary.io> - <https://imgflip.com/api> - <https://developer.themoviedb.org/v4/reference/> - <https://dev.splitwise.com/> - <https://developer.atlassian.com/cloud/trello/rest/> - <https://docs.github.com/en/rest> - <https://www.file.io/developers> - <https://developers.google.com/books/docs/v1/reference> - <https://spoonacular.com/food-api/docs> - <https://openfoodfacts.github.io/openfoodfacts-server/api/ref-v3> Moins permissives (pas de POST par ex): - <https://pokeapi.co/docs/v2> - <https://lyricsovh.docs.apiary.io> - <http://numbersapi.com/#random/trivia> - <https://openweathermap.org/api> - <https://api.nasa.gov/> - <https://www.thecocktaildb.com> - <https://api.watchmode.com/docs> - autres: <https://rapidapi.com/collection/list-of-free-apis> Ne perdez pas de temps et passez au TP1 !