Android Kotlin Fundamentals 01.1: premiers pas

Cet atelier de programmation fait partie du cours Android Kotlin Fundamentals. Vous tirerez le meilleur parti de ce cours si vous suivez les ateliers de programmation dans l'ordre. Tous les ateliers de programmation du cours sont répertoriés sur la page de destination des ateliers de programmation Android Kotlin Fundamentals.

Introduction

Dans cet atelier de programmation, vous allez créer et exécuter votre première application Android, HelloWorld, sur un émulateur et sur un appareil physique. Vous allez également découvrir à quoi ressemble un projet Android.

Ce que vous devez déjà savoir

  • Vous devez comprendre le processus général de développement logiciel pour les applications orientées objets à l'aide d'un IDE (environnement de développement intégré), comme Android Studio.
  • Vous devez avoir au moins un an d'expérience en programmation orientée objet, et avoir au minimum une connaissance de Java et Kotlin.

Points abordés

  • Créer une application Android de base dans Android Studio
  • Créer un projet Android à partir d'un modèle
  • Découvrez les principaux composants d'un projet Android.
  • Exécuter une application Android sur un émulateur ou un appareil physique

Objectifs de l'atelier

  • Créez un projet Android et une application par défaut appelée HelloWorld.
  • Créez un émulateur (appareil virtuel) pour exécuter votre application sur votre ordinateur.
  • Exécutez l'application HelloWorld sur des appareils virtuels et physiques.
  • Explorez la mise en page du projet.
  • Explorez le fichier AndroidManifest.xml.

L'application HelloWorld affiche la chaîne "Hello World" à l'écran d'un appareil virtuel Android ou d'un appareil physique. Voici à quoi ressemble l'application:

Dans cette tâche, vous allez créer un projet d'application pour vérifier qu'Android Studio est correctement installé.

  1. Ouvrez Android Studio, si ce n'est pas déjà fait.
  2. Dans la boîte de dialogue principale Welcome to Android Studio (Bienvenue sur Android Studio), cliquez sur Start a new Android Studio project (Démarrer un nouveau projet Android Studio).

  3. La boîte de dialogue Choose your project (Choisir votre projet) s'affiche. Sélectionnez Empty Activity (Activité vide) comme indiqué ci-dessous, puis cliquez sur Next (Suivant).



    Un Activity est un élément unique et ciblé que l'utilisateur peut faire. Chaque application doit avoir au moins une activité comme point d'entrée. Considérez cette activité de point d'entrée comme la fonction main() dans d'autres programmes. Une activité est généralement associée à une mise en page qui définit la manière dont les éléments de l'interface utilisateur s'affichent à l'écran. Android Studio fournit plusieurs modèles Activity pour vous aider à démarrer.
  4. Dans la boîte de dialogue Configure your project (Configurer votre projet), saisissez "HelloWorld&quot pour le nom.

  5. Acceptez le paramètre par défaut android.example.com pour le domaine de l'entreprise ou créez un domaine d'entreprise unique. Cette valeur, suivie du nom de l'application, correspond à son nom de package. Si vous ne prévoyez pas de la publier, acceptez la valeur par défaut. Vous pourrez modifier le nom de package de votre application par la suite, mais cela représente un effort supplémentaire.
  6. Vérifiez que l'emplacement par défaut où vous souhaitez stocker votre application est enregistré dans le dossier Enregistrer le lieu. Si ce n'est pas le cas, remplacez-le par votre répertoire préféré.
  7. Assurez-vous que le langage est Kotlin.
  8. Assurez-vous que le niveau minimal d'API est API 19: Android 4.4 (KitKat). Au moment de la rédaction de cet atelier de programmation, Android Studio a indiqué qu'avec ce niveau d'API, l'application s'exécutait sur environ 95,3% des appareils.
    (Vous en saurez plus sur les niveaux d'API minimaux dans un prochain atelier de programmation.) Pour en savoir plus, cliquez sur M'aider à choisir pour ouvrir une fenêtre contenant des informations sur les niveaux d'API.
  9. Cochez la case Utiliser les artefacts AndroidX.
  10. Laissez toutes les autres cases décochées, puis cliquez sur Finish (Terminer). Si votre projet nécessite plus de composants pour le SDK cible que vous avez choisi, Android Studio les installe automatiquement et peut prendre un certain temps. Suivez les instructions qui s'affichent et acceptez les options par défaut.

Android Studio crée maintenant votre projet, ce qui peut prendre du temps. Vous ne devriez pas recevoir d'erreurs. Si vous recevez des avertissements, ignorez-les.

Dans cette tâche, vous allez découvrir le projet HelloWorld dans Android Studio et apprendre les bases du développement avec Android Studio.

Étape 1: Parcourez le volet Projet

  1. Si l'onglet Project (Projet) n'est pas déjà sélectionné, sélectionnez-le. L'onglet Projet se trouve dans la colonne "Onglet vertical" située à gauche de la fenêtre Android Studio. Le volet de projet s'ouvre.


  2. Pour afficher le projet sous la forme d'une hiérarchie de projet Android standard, sélectionnez Android dans le menu déroulant en haut du volet de projet. (Android est l'option par défaut). Vous pouvez afficher les fichiers du projet de différentes manières, y compris en visualisant la façon dont ils apparaissent dans la hiérarchie du système de fichiers. Cependant, l'utilisation de la vue Android est plus facile à utiliser avec ce projet.

Étape 2: Explorez le dossier de l'application

L'ensemble du code et des ressources de votre application se trouvent dans le dossier app.

  1. Dans le volet Projet > Android, développez le dossier app. Le dossier app contient quatre sous-dossiers: manifests, java, generatedJava et res.
  2. Développez le dossier java, puis le dossier com.example.android.HelloWorld pour afficher le fichier Kotlin MainActivity.



    Le dossier java contient tout le code Kotlin principal d'une application Android. Il existe des raisons historiques pour lesquelles votre code Kotlin apparaît dans le dossier Java. Cette convention permet à Kotlin d'interagir facilement avec le code écrit en langage de programmation Java, même dans le même projet et la même application.

    Les fichiers de classe de votre application sont contenus dans trois sous-dossiers, comme illustré dans la figure ci-dessus. Le dossier com.example.hello.helloworld (ou le nom de domaine que vous avez indiqué) contient tous les fichiers d'un package d'application. La classe MainActivity est le point d'entrée principal de votre application. Vous en apprendrez plus sur MainActivity dans le prochain atelier de programmation. Les deux autres dossiers du dossier java sont utilisés pour le code lié aux tests, tels que les tests unitaires.
  1. Notez le dossier GeneratedJava. Ce dossier contient des fichiers générés par Android Studio lors de la création de l'application. Ne modifiez rien dans ce dossier, car vos modifications risquent d'être ignorées lors de la recompilation de l'appli. Cependant, il est utile de savoir ce dossier lorsque vous devez les examiner lors du débogage.

Étape 3: Explorez le dossier Res

  1. Dans le volet Projet > Android, développez le dossier res.

    Le dossier res contient des ressources. Les ressources dans Android sont des contenus statiques utilisés dans vos applications. Les ressources incluent des images, des chaînes de texte, des mises en page, des styles et des valeurs (comme des couleurs hexadécimales ou des dimensions standards).

    Les applications Android séparent autant que possible le code et les ressources Kotlin. Il est ainsi beaucoup plus facile de trouver toutes les chaînes ou icônes utilisées dans l'interface utilisateur de l'application. De plus, lorsque vous modifiez l'un de ces fichiers de ressources, la modification prend effet partout où le fichier est utilisé dans l'application.
  2. Dans le dossier res, développez le dossier layout pour afficher le fichier activity_main.xml.


Activity est généralement associé à un fichier de mise en page d'interface utilisateur (défini en tant que fichier XML dans le répertoire res/layout). Ce fichier de mise en page porte généralement le nom de son activité. Dans ce cas, le nom de l'activité est MainActivity. La mise en page associée est donc activity_main.

Étape 4: Parcourez le dossier des fichiers manifestes et le fichier AndroidManifest.xml

Le dossier manifests contient des fichiers qui fournissent des informations essentielles sur votre application au système Android.

  1. Développez le dossier manifests et cliquez deux fois sur le fichier AndroidManifest.xml pour l'ouvrir. Le fichier AndroidManifest.xml contient des informations dont le système Android a besoin pour exécuter votre application, y compris les activités qui y sont incluses.


  2. Notez que MainActivity est référencé dans l'élément <activity>. Toute Activity dans votre application doit être déclarée dans le fichier manifeste. Voici un exemple pour MainActivity:
<activity android:name=".MainActivity">
   <intent-filter>
       <action android:name="android.intent.action.MAIN"/>

       <category android:name="android.intent.category.LAUNCHER"/>
   </intent-filter>
</activity>
  1. Notez l'élément <intent-filter> dans <activity>. Les éléments <action> et <category> de ce filtre d'intent indiquent à Android où démarrer l'application lorsque l'utilisateur clique sur l'icône du lanceur d'applications. Vous en saurez plus sur les filtres d'intent dans la suite de cet atelier.

C'est dans le fichier AndroidManifest.xml que vous définissez les autorisations dont votre application a besoin. Les autorisations permettent à votre appli de lire les contacts enregistrés sur le téléphone, d'envoyer des données via Internet ou d'accéder à du matériel tel que l'appareil photo.

Gradle est un système d'automatisation de compilation qui utilise un langage spécifique à un domaine pour décrire la structure, la configuration et les dépendances du projet de l'application. Lorsque vous compilez et exécutez votre application, des informations s'affichent concernant l'exécution de la compilation Gradle. Des informations sur l'installation d'Android Package Kit (APK) sont également disponibles. (APK est le format de fichier du package que le système d'exploitation Android utilise pour distribuer et installer les applications mobiles.)

Explorez le système Gradle:

  1. Développez le dossier Gradle Scripts (Scripts Gradle). Dans le volet Project > Android (Projet et Android), ce dossier contient tous les fichiers dont le système de compilation a besoin.


  2. Recherchez le fichier build.gradle(Project: HelloWorld).

    Ce fichier contient les options de configuration communes à tous les modules qui composent votre projet. Chaque projet Android Studio contient un seul fichier de compilation Gradle de premier niveau. Ce fichier définit les dépôts et dépendances Gradle communs à tous les modules du projet.
  3. Recherchez le fichier build.gradle(Module:app).

    Outre le fichier build.gradle au niveau du projet, chaque module dispose de son propre fichier build.gradle. Le fichier build.gradle au niveau du module vous permet de configurer les paramètres de compilation de chaque module. L'application HelloWorld ne comporte qu'un seul module, celui de l'application elle-même. Ce fichier build.gradle est celui que vous modifiez le plus souvent lorsque vous modifiez les configurations de compilation au niveau de l'application. Par exemple, vous modifiez ce fichier build.gradle lorsque vous modifiez le niveau de SDK compatible avec votre application ou lorsque vous déclarez de nouvelles dépendances dans la section dependencies. Vous en saurez plus sur ces deux aspects dans un prochain atelier de programmation.

Dans cette tâche, vous allez utiliser l'appareil virtuel Android (Manager) pour créer un appareil virtuel (émulateur). L'appareil virtuel simule la configuration d'un type d'appareil Android particulier. Vous utiliserez ensuite cet appareil virtuel pour exécuter l'application.

Android Emulator est une application indépendante qui possède sa propre configuration système. Les appareils virtuels peuvent utiliser beaucoup d'espace disque. Si vous rencontrez des problèmes, consultez la section Run apps on the Android Emulator (Exécuter des applications sur l'émulateur Android).

Étape 1: Créez un appareil virtuel Android

Pour exécuter un émulateur sur votre ordinateur, vous devez créer une configuration décrivant l'appareil virtuel.

  1. Dans Android Studio, sélectionnez Outils > AVD Manager ou cliquez sur l'icône AVD Manager Icône AVD Manager dans la barre d'outils. La boîte de dialogue Vos appareils virtuels s'affiche. Si vous avez déjà créé des appareils virtuels, la boîte de dialogue les affiche (comme illustré dans la figure ci-dessous). Sinon, une liste vide s'affiche.

    Le gestionnaire d&#39;appareils virtuels Android (AVD) affiche la liste des appareils virtuels déjà créés.
  2. Cliquez sur +Create Virtual Device (+Créer un appareil virtuel) en bas à gauche de la boîte de dialogue. La boîte de dialogue Select Hardware (Sélectionner le matériel) s'affiche avec la liste des appareils matériels préconfigurés. Pour chaque appareil, le tableau fournit une colonne pour sa taille de diagonale (Taille), sa résolution en pixels (Résolution) et sa densité en pixels (Densité).

    Sélection du matériel
  3. Sélectionnez un appareil tel que Nexus 5x ou Pixel XL, puis cliquez sur Suivant. La boîte de dialogue System Image (Image système) s'affiche.
  4. Cliquez sur l'onglet Recommandations, puis choisissez la version du système Android à exécuter sur l'appareil virtuel (par exemple, Pie).


  1. Après avoir choisi une image système, cliquez sur Suivant. La boîte de dialogue Android Virtual Device (AVD) (Appareil virtuel Android) s'ouvre. Vérifiez votre configuration et cliquez sur Finish (Terminer).

Étape 2: Exécutez l'application sur l'appareil virtuel

Dans cette tâche, vous allez enfin exécuter votre nouvelle application.

  1. Dans Android Studio, sélectionnez Run > Run app (Exécuter et exécuter l'application). Vous pouvez également cliquer sur l'icône Run (Exécuter) choisir &quot;Run > Run app&quot; (Exécuter l&#39;application), ou cliquer sur l&#39;icône &quot;Run&quot; (Exécuter) [ICON HERE] dans la barre d&#39;outils. [IMAGEINFO]: ic_run.png, icône Exécution d&#39;Android Studio dans la barre d'outils. La boîte de dialogue Select Deployment Target (Sélectionner une cible de déploiement) s'affiche et vous avertit qu'aucun appareil n'est disponible. Cet avertissement s'affiche si aucun appareil physique n'est connecté à votre ordinateur de développement, ou si vous n'avez pas encore lancé d'appareil virtuel.
  2. Dans la boîte de dialogue Select Deployment Target (Sélectionner une cible de déploiement), sous Available Virtual Devices (Appareils virtuels disponibles), sélectionnez l'appareil virtuel créé. Cliquez sur OK.



    L'émulateur démarre et démarre comme un appareil physique. Selon la vitesse de votre ordinateur, ce processus peut prendre un certain temps. Votre application est créée, et lorsque l'émulateur est prêt, Android Studio importe l'APK de l'application dans l'émulateur et l'exécute.

    Vous devriez voir l'application HelloWorld comme illustré ci-dessous.

Dans cette tâche, vous allez exécuter votre application sur un appareil mobile physique tel qu'un téléphone ou une tablette, le cas échéant. Testez toujours vos applications sur des appareils virtuels et physiques.

Ce qu'il vous faut :

  • Un appareil Android tel qu'un téléphone ou une tablette
  • Un câble de données USB pour connecter votre appareil Android à votre ordinateur via le port USB
  • Si vous utilisez un système Linux ou Windows, vous devrez peut-être effectuer des étapes supplémentaires. Consultez la documentation Exécuter des applications sur un appareil matériel. Vous devrez peut-être également installer le pilote USB correspondant à votre appareil. Pour les pilotes USB Windows, consultez Installer des pilotes USB OEM.

Étape 1: Activez le débogage USB

Pour permettre à Android Studio de communiquer avec votre appareil Android, vous devez activer le débogage USB dans les paramètres Options pour les développeurs de l'appareil.

Sur Android 4.2 (Jellybean) ou version ultérieure, les paramètres Options pour les développeurs sont masqués par défaut. Pour afficher les options pour les développeurs et activer le débogage USB:

  1. Sur votre appareil, ouvrez l'application Paramètres, recherchez À propos du téléphone, appuyez sur À propos du téléphone, puis appuyez sur Numéro de build à sept reprises.
  2. Revenez à la page précédente (Paramètres/Système). Les options pour les développeurs apparaissent dans la liste. Appuyez sur Options pour les développeurs.
  3. Sélectionnez Débogage USB.

Étape 2: Exécutez votre application sur l'appareil Android

Vous pouvez désormais connecter votre appareil et exécuter l'application depuis Android Studio.

  1. Connectez votre appareil Android à votre ordinateur de développement à l'aide d'un câble USB. Une boîte de dialogue devrait s'afficher sur l'appareil pour demander le débogage USB.


  2. Sélectionnez l'option Toujours autoriser pour mémoriser cet ordinateur. Appuyez sur OK.
  3. Sur votre ordinateur, cliquez sur le bouton Exécuter Icône d&#39;exécution d&#39;Android Studio dans la barre d'outils d'Android Studio. La boîte de dialogue Select Deployment Target (Sélectionner une cible de déploiement) s'ouvre avec la liste des émulateurs et des appareils connectés disponibles. Vous devriez voir votre appareil physique avec tous les émulateurs.


  4. Sélectionnez votre appareil, puis cliquez sur OK. Android Studio installe l'application sur votre appareil et l'exécute.

Dépannage

Si Android Studio ne reconnaît pas votre appareil, essayez les solutions suivantes:

  1. Débranchez le câble USB, puis rebranchez-le.
  2. Redémarrez Android Studio.

Si votre ordinateur ne trouve toujours pas l'appareil ou le déclare "non autorisé", procédez comme suit:

  1. Débranchez le câble USB.
  2. Sur l'appareil, ouvrez l'application Options pour les développeurs, sous Paramètres.
  3. Appuyez sur Révoquer les autorisations de débogage USB.
  4. Reconnectez l'appareil à votre ordinateur.
  5. Lorsque vous y êtes invité, accordez les autorisations nécessaires.

Vous devrez peut-être installer le pilote USB correspondant à votre appareil. Consultez Exécuter des applications sur un appareil matériel.

Défi: Maintenant que vous êtes prêt à vous familiariser avec le workflow de développement de base, procédez comme suit:

  1. Créez un projet dans Android Studio.
  2. Remplacez le message "Bonjour le monde" par "Joyeux anniversaire" et le nom d'une personne ayant un anniversaire récent.
  • Pour installer Android Studio, accédez à Android Studio, puis suivez les instructions pour télécharger et installer l'application.
  • Pour afficher la hiérarchie d'une application Android dans le volet Projet, cliquez sur l'onglet Projet dans la colonne de l'onglet vertical. Sélectionnez ensuite Android dans le menu déroulant en haut de l'écran.
  • Lorsque vous devez ajouter de nouvelles dépendances à votre projet ou modifier des versions de dépendances, modifiez le fichier build.gradle(Module:app).
  • L'ensemble du code et des ressources d'une application se trouvent dans les dossiers app et res. Le dossier java inclut des activités, des tests et d'autres composants dans le code source Kotlin ou Java (ou les deux). Le dossier res contient des ressources telles que des mises en page, des chaînes et des images.
  • Pour ajouter des fonctionnalités, des composants et des autorisations à votre application Android, modifiez le fichier AndroidManifest.xml. Tous les composants d'application, tels que les activités supplémentaires, doivent être déclarés dans ce fichier XML.
  • Pour créer un appareil virtuel Android (un émulateur) pour exécuter votre application, utilisez AVD Manager.
  • Pour exécuter votre application sur un appareil Android physique à l'aide d'Android Studio, activez le débogage USB sur l'appareil. Pour ce faire, ouvrez Paramètres > À propos du téléphone et appuyez sept fois sur Numéro de build. Ouvrez ensuite Paramètres, puis Options pour les développeurs et sélectionnez Débogage USB.

Cours Udacity:

Documentation Android Studio:

Autre :

Cette section répertorie les devoirs possibles pour les élèves qui effectuent cet atelier de programmation dans le cadre d'un cours animé par un enseignant. C'est à l'enseignant de procéder comme suit:

  • Si nécessaire, rendez-les.
  • Communiquez aux élèves comment rendre leurs devoirs.
  • Notez les devoirs.

Les enseignants peuvent utiliser ces suggestions autant qu'ils le souhaitent, et ils n'ont pas besoin d'attribuer les devoirs de leur choix.

Si vous suivez vous-même cet atelier de programmation, n'hésitez pas à utiliser ces devoirs pour tester vos connaissances.

Créer et exécuter une application

  • Créez un projet Android à partir du modèle vide.
  • Ouvrez le fichier res/strings.xml.
  • Remplacez la valeur de la chaîne app_name par &My Dice Roller". Ce nom apparaît dans la barre de titre.
  • Créez un émulateur pour un appareil en ciblant n'importe quelle version d'Android, puis exécutez l'application. Notez comment le titre de l'application a changé.

Répondez à ces questions.

Question 1

Quel est le nom du fichier de mise en page pour l'activité principale ?

  • MainActivity.java
  • AndroidManifest.xml
  • activity_main.xml
  • build.gradle

Question 2

Quel est le nom de la ressource de chaîne qui spécifie le nom de l'application ?

  • app_name
  • xmlns:app
  • android:name
  • applicationId

Question 3

Quel outil utilisez-vous pour créer un émulateur ?

  • Moniteur d'appareil Android
  • AVD Manager
  • SDK Manager
  • Éditeur de thème

Envoyer l'application pour qu'elle soit notée

Assurez-vous que l'application:

  • Activity qui affiche"Hello World"à l'écran.
  • une barre de titre indiquant "Mon coup de dés";

Démarrez la leçon suivante: 1.2: Anatomie d'application de base.

Pour obtenir des liens vers d'autres ateliers de programmation dans ce cours, consultez la page de destination des ateliers de programmation Android Kotlin Fundamentals.