TP 0 - Introduction

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)

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

🚀 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

🧑‍🏫 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

val text: String = "hello"

val user: User? = null

class MutableList<T> : List<T> {
  // ...
  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

  // on peut "chaîner" les appels nullable avec `?.`:
  val email = client?.personalInfo?.email

String templates

 // pour "interpoler" une variable dans une string on utilise '$'
 fun getPattern(): String = """<pattern qui match 2 digits> $month <pattern qui match 4 digits>"""

Lambdas

val isEven = number % 2 == 0 // check division par 2
val lambdaWithExplicitParam = { explicitParam -> explicitParam == 42 }
val lambdaWithImplicitParam = { it == 42 }

Data classes

data class Person(
  val ...
  val ...
)

Jetpack Compose Basics

Codelab: Jetpack Compose Basics

Pour continuer voir les autres codelabs Google

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:

Moins permissives (pas de POST par ex):

Ne perdez pas de temps et passez au TP1 !