Challenge : Créer un premier projet

Temps : 4h.
Difficulté : * à ***

Le challenge Créer un premier projet Android, avec le langage Kotlin, se fait en 7 étapes :
> Installer l'environnement de développement
> Créer un premier projet Android : étape 3 et 4
> Explorer l'univers Android : étape 5 à 7

> Installer l'environnement de développement

L'installation se fait en 2 étapes :

• Téléchargement d'Android Studio
• Configuration avec la dernière version d'Android

Étape 1 : Télécharger Android Studio

Il s'agit de télécharger Android Studio depuis le site developper.android.com.

1. Allez sur le site de référence Android : developper.android.com
2. Dans la partie Android Studio, DOWNLOAD, téléchargez Android Studio :
   DOWNLOAD ANDROID STUDIO
3. Acceptez les Terms and Conditions (I have read and agree with the above terms and conditions) puis téléchargez :
   DOWNLOAD ANDROID STUDIO FOR ...
4. Dézipez le fichier téléchargé et suivez les instructions d’installation propre à votre plateforme Mac, Linux ou Windows
5. Choisissez la configuration par défaut.

Étape 2 : Installer Android Studio

Il s'agit d'installer, télécharger, la dernière version du SDK Android.

1. Lancez le logiciel Android Studio, suivez les instructions d'installation.
2. Choisissez une installation Standard.
3. Acceptez les licences et cliquez sur Finish : le téléchargement des derniers paquetages (ici relatifs à la dernière version 11.0, API Level 30) est lancé et peut prendre quelques dizaines de minutes.
4. Allez prendre un café ☕.
5. Allez dans Configure > SDK Manager et remarquez les paquetages installés, SDK Platforms, en cochant Show Package Details. Ici, pour l'API 30 :
   • Android SDK Platform 30
   • Sources for Android 30
   • Google APIs Intel x86 Atom System Image (cela correspond à l'émulateur)

Note : Il est également possible d’accéder au SDK Manager via l’icône avec la flèche bleu :

> Créer un premier projet Android

Le premier projet est abordé en 2 étapes :

• Création
• Déploiement

Étape 3 : Créer un projet avec Android Studio

Il s'agit de créer un premier projet avec l’utilitaire Android Studio.
Note : il est également possible de créer un projet en ligne de commande.

1. Créez un nouveau Projet d’Application Android :
   + Create New Project.
2. Choisissez un modèle d’activité vide :
   Select a Project Template > Phone and Tablet > Empty Activity.
3. Configurez le projet : Configure Your Project
   Name: Hello You
   Package name: com.chillcoding
   Language: Kotlin
   Minimum SDK: API 16: Android 4.1 (Jelly Bean)
   Puis Finish
4. Remarquez le nom par défaut pour une Activity MainActivity, c’est l’une des conventions de nommage adoptée par les développeurs Android.

Lors de la création d'un projet, Android Studio génére et charge tous les éléments nécéssaires (génération des fichiers de bases, chargement des bibliothèques, etc.).
Cela peut prendre du temps.

Étape 4 : Déployer une application

Le déploiement d’une application peut se faire soit sur émulateur, soit sur appareil Android.

Sur émulateur

1. Ouvrez l’AVD Manager (Android Virtual Device Manager), icône d'un smartphone.
2. Créez un émulateur : + Create Virtual Device...
3. Choisissez un modèle de téléphone en fonction de votre résolution d’ordinateur, par exemple le 5.1" WVGA.
4. Sélectionnez un System Image, gardez celui recommandé, par exemple API 30.
5. Nommez votre AVD, optez pour un nom éloquent, toto, et cliquez sur Finish.
6. Lancez l’émulateur ainsi créé via l’icône “flèche verte” situé a côté de celui-ci, depuis la fenêtre AVD Manager.

Note : L'AVD Manager est disponible via l’icône d’un téléphone avec la tête de la mascotte verte :

Remarque : le lancement de l’émulateur prend quelques minutes. Vous pouvez le laisser ouvert durant toute la séance et le fermer seulement quand vous avez terminé de développer. Le fermer après chaque test d’application reviendrait à éteindre votre téléphone après l’utilisation d’une application...

Sur appareil Android

Il est possible d’exécuter l’application d’un projet Android Studio directement sur un appareil Android, téléphone ou tablette.
En effet, il suffit d’installer les drivers sur le PC. De plus, depuis l'appareil Android, il s'agit :

• d’autoriser le débogage USB
• d'activer le mode développeur

1. Placez vous dans le menu A propos de votre téléphone.
2. Cliquez plusieurs fois sur le Numéro de build ou le numéro de Version d’Android (selon la marque du téléphone).
3. Allez dans le menu Paramètres > Options pour les développeurs de votre téléphone et cochez Débogage USB.
4. Branchez le téléphone à votre ordinateur via le câble USB.
5. A présent, vous pouvez directement exécuter votre projet via Android Studio, sur votre téléphone.

> Explorer l'univers Android

L'exploration se fait en 3 étapes :

• Arborescence
• Cycle de vie d'une Activity
• Clique sur un bouton

Étape 5 : Explorer l'arborescence d'un projet

L'objectif est d'explorer un projet afin de se familiariser avec l'arborescence des fichiers, les conventions Android, les packages, une Activity, un fichier XML, etc.

1. Observez le contenu du dossier app/ :
   app/
-manifests
-java
-res
--drawable
--layout
--values
--menu
Gradle Scripts

2. Remarquez le lien avec l’interface graphique, dans le fichier d'entrée MainActivity.kt.
3. Quel fichier modifier pour changer le texte affiché à l’écran ? Modifiez pour afficher « Hello Kotlin! ».
4. Remplacez l’agencement principale (situé à la racine du fichier activity_main.xml) ConstraintLayout par un LinearLayout.
5. Quel fichier modifier pour ajouter des éléments graphiques à l’écran ? Ajoutez du texte.
6. Dans le dossier des ressources relatif aux images, res/drawable, ajoutez une image vectorielle (clique droit > New > Vector Asset).
7. Ajoutez l’image en dessous du texte.
8. Personnalisez les couleurs de l’application (fichiers themes.xml et colors.xml du dossier res/values).
9. Personnalisez brièvement le logo (clique droit > New > Image Asset > Launcher Icons).

Remarques : les fichiers XMLs placés dans le dossier layout/, peuvent être édités manuellement ou bien avec l’éditeur graphique. communément ces fichiers XMLs, contiennent les éléments graphiques d’un écran les dossiers drawable-ldpi (mdpi | hdpi) contiennent les images adaptés aux 3 types d’écrans. Par exemple :

• hdpi : images pour smartphone,
• xhdpi : images pour tablette,
• mdpi : images pour petit écran, lecteur mp3

Note : Le fichier de projet R est un index contenant tous les identifiants des ressources du projet. Il est automatiquement généré par Android Studio.
Cette classe est utilisée dans le code source pour faire référence aux ressources incluses dans le projet.

Fichiers clés à retenir

Dans l'arborescence d'un projet, voici les fichiers et dossiers importants :

• Manifeste : Déclare les autorisations, les Activity et leur comportement
• java/ : le dossier des fichiers source, code Kotlin organisé dans des package
• res/ : le dossier des ressources
• drawable/ : le dossier des images
• mipmap/ : le dossier des icônes
• layout/ : le dossier des interfaces graphiques
• values/ : le dossier des variables couleur, chaine de caractères, dimension, style, ...
• gen/R : fichier auto-généré contenant les identifiants des ressources
• Gradle Scripts : contient deux fichiers de configurations, l'un pour le projet, l'autre pour le module app/

Étape 6 : Expérimenter le cycle de vie d'une Activity

Cet exercice permet de mettre en pratique le cycle de vie d'une Activity présenté dans la partie Principes de programmation.

1. Affichez un premier message d’information depuis la méthode onCreate() dans la console Logcat.

   
     Log.i(MainActivity::class.simpleName,
     getString(R.string.text_oncreate))
   
   

2. Surchargez la méthode onStart() (Ctrl + O) :
   

   
     override fun onStart() {
         super.onStart()
         Log.i(MainActivity::class.simpleName,
         getString(R.string.text_onstart))
     }
   
   

3. Surchargez, les autres méthodes du cycle de vie d’une Activity afin qu’elles affichent des messages d’informations dans la console Logcat.
4. Analysez les messages de votre application lors de son exécution via la console Logcat.
5. Décrivez un scénario utilisateur permettant de mettre en évidence un maximum de méthode du cycle de vie.
   Exemple : L'utilisateur ouvre l'application (méthode onCreate()).

Étape 7 : Gérer le clique sur un bouton

Cet exercice permet de mettre en pratique la fonction lambda .setOnClickListener { }.

1. Ajoutez un bouton dans l’écran principal.
2. Affichez un message rapide lorsque l’utilisateur clique sur le bouton.

  Toast.makeText(this, "hi",
  Toast.LENGTH_LONG).show()

</> Solution du challenge

Obtenez les codes sources dans les Ressources supplémentaires de l'ABCD Android.