3 Votre premier projet Android Maintenant que le SDK Android est installé, il est temps de créer votre premier projet. La bonne nouvelle est qu il n exige aucune ligne de code les outils Android créent pour vous une application "Hello, world!" lorsque vous créez un nouveau projet. Il vous suffit de la compiler, de l installer et de l ouvrir dans l émulateur ou votre terminal. Étape 1 : création d un nouveau projet Les outils d Android peuvent créer pour vous un squelette de projet complet, avec tout ce qu il faut pour disposer d une application Android opérationnelle (bien que d un intérêt limité). La procédure n est évidemment pas la même si vous utilisez Eclipse ou la ligne de commande. Eclipse À partir du menu principal, sélectionnez File Æ New Æ Project pour ouvrir la boîte de dialogue New Project, qui vous proposera une liste d assistants pour différents types de projets. Ouvrez l option Android et cliquez sur Android Project, comme le montre la Figure 3.1. Figure 3.1 Choix d un assistant dans la boîte de dialogue New Project d Eclipse.
24 L'Art du développement Android Cliquez sur le bouton Next pour aller sur la première page de l assistant New Android Project, présentée à la Figure 3.2. Figure 3.2 Assistant New Android Project d Eclipse, prêt à être rempli. Remplissez les champs suivants et laissez les valeurs par défaut des autres (l assistant totalement rempli est présenté à la Figure 3.3) : Project name, le nom du projet (Now, par exemple) ; Build Target, le SDK Android que vous allez utiliser pour compiler le projet (Google APIs pour Android 2.3.3, par exemple) ; Application name, le nom de votre application, qui sera celui affiché sous son icône dans le lanceur (Now, par exemple) ; Package name, le nom du paquetage Java auquel appartient ce projet (com. commonsware.android.skeleton, par exemple) ; Create Activity, le nom de l activité initiale (Now, par exemple). Il suffit ensuite de cliquer sur le bouton Finish pour créer votre projet Eclipse.
Chapitre 3 Votre premier projet Android 25 Figure 3.3 Assistant New Android Project d Eclipse rempli. Ligne de commande Voici un exemple de commande qui crée un projet Android à partir de l invite du shell : android create project --target "Google Inc.:Google APIs:10" \ --path Skeleton/Now \ --activity Now \ --package com.commonsware.android.skeleton Cette instruction crée un squelette d application complet avec tout ce qu il faut pour construire votre première application Android : le code source Java, les instructions de compilation, etc. ; mais vous devrez sûrement l adapter un peu. Voici ce que signifient les options de cette commande : --target. Indique la version d Android que vous visez pour votre application. Vous devez fournir l identifiant d une cible installée sur votre machine de développement. Pour connaître les cibles disponibles, utilisez la commande android list targets. Généralement, la procédure de compilation aura pour cible la version d Android la plus récente. --path. Précise le nom du répertoire où seront stockés les fichiers du projet. Android créera un répertoire si le nom que vous donnez n existe pas. Avec cette commande, par exemple, le répertoire Skeleton/Now/ sera créé (ou utilisé s il existe déjà) sous le répertoire courant et les fichiers du projet y seront stockés.
26 L'Art du développement Android --activity. Donne le nom de la classe Java de votre première activité pour ce projet. N incluez pas de nom de paquetage et assurez-vous que ce nom respecte les conventions de nommage des classes Java. --package. Indique le paquetage Java dans lequel se trouvera votre première activité. Ce nom identifie de façon unique votre projet sur chaque terminal où vous l installerez et il doit également être unique sur l Android Market si vous comptez y distribuer votre application. Généralement, on construit donc le nom d un paquetage à partir d un nom de domaine que l on possède (com. commonsware.android.skeleton, par exemple) afin de réduire les risques d une collision avec le nom d un paquetage de quelqu un d autre. Pour votre machine de développement, choisissez une cible adaptée et modifiez éventuellement le path. Pour l instant, vous pouvez vous contenter des noms donnés à l activité et au paquetage. Étape 2 : compilation, installation et exécution de l application Créer un projet est un bon début, mais il faut maintenant le compiler et l exécuter sur l émulateur ou sur votre propre terminal Android. Là encore, la procédure sera différente selon que vous utilisez Eclipse ou la ligne de commande. Eclipse Pour exécuter votre projet, sélectionnez-le dans le panneau Package Explorer d Eclipse et cliquez sur le bouton de lecture vert qui se trouve dans la barre d outils. La première fois, vous devez passer par un certain nombre d étapes pour mettre en place la configuration d exécution, afin qu Eclipse sache ce que vous souhaitez faire. Dans la boîte de dialogue Run As choisissez Android Application, comme à la Figure 3.4. Figure 3.4 Boîte de dialogue Run As d Eclipse.
Chapitre 3 Votre premier projet Android 27 Cliquez sur le bouton OK. Si plusieurs AVD ou terminaux sont disponibles, vous devrez choisir celui sur lequel vous voulez lancer l application. Puis Eclipse installera l application sur le terminal ou sur l émulateur et lancera son exécution. Ligne de commande Si vous n utilisez pas Eclipse, placez-vous dans le répertoire Skeleton/Now puis exécutez la commande suivante : ant clean install Vous devriez voir apparaître la liste des étapes de la procédure d installation, qui devrait être de la forme : Buildfile: /home/jaco/projects/skeleton/now/build.xml Android SDK Tools Revision 11 Project Target: Google APIs Vendor: Google Inc. Platform Version: 2.3.3 API level: 10 ------------------ Resolving library dependencies: No library dependencies. ------------------ WARNING: No minsdkversion value set. Application will install on all Android versions. Importing rules file: tools/ant/main_rules.xml clean: [delete] Deleting directory /home/jaco/projects/skeleton/now/bin -debug-obfuscation-check: -set-debug-mode: -compile-tested-if-test: -pre-build: -dirs: [echo] Creating output directories if needed... [mkdir] Created dir: /home/jaco/projects/skeleton/now/bin [mkdir] Created dir: /home/jaco/projects/skeleton/now/gen [mkdir] Created dir: /home/jaco/projects/skeleton/now/bin/classes -aidl: [echo] Compiling aidl files into Java classes...
28 L'Art du développement Android -renderscript: [echo] Compiling RenderScript files into Java classes and RenderScript bytecode... -resource-src: [echo] Generating R.java / Manifest.java from the resources... -pre-compile: compile: [javac] /opt/android-sdk/tools/ant/main_rules.xml:384: warning: includeantruntime was not set, defaulting to build. sysclasspath=last; set to false for repeatable builds [javac] Compiling 2 source files to /home/jaco/projects/skeleton/now/ bin/classes -post-compile: -obfuscate: -dex: [echo] Converting compiled files and external libraries into /home/ jaco/projects/skeleton/now/bin/classes.dex... -package-resources: [echo] Packaging resources [aapt] Creating full resource package... -package-debug-sign: [apkbuilder] Creating Now-debug-unaligned.apk and signing it with a debug key... debug: [echo] Running zip align on final apk... [echo] Debug Package: /home/jaco/projects/skeleton/now/bin/now-debug. apk install: [echo] Installing /home/jaco/projects/skeleton/now/bin/now-debug.apk onto default emulator or device... [exec] 248 KB/s (13225 bytes in 0.052s) [exec] pkg: /data/local/tmp/now-debug.apk [exec] Success BUILD SUCCESSFUL Total time: 9 seconds Notez la ligne BUILD SUCCESSFUL en bas de cette liste c est elle qui vous indique que l application est compilée correctement.
Chapitre 3 Votre premier projet Android 29 Lorsque cette étape est réalisée, ouvrez le lanceur d applications sur l émulateur ou sur votre terminal Android (voir Figure 3.5). Généralement, le lanceur se trouve en bas de l écran d accueil. Figure 3.5 Lanceur d application de l émulateur Android. Vous remarquerez la présence d une icône pour l application Now. Cliquez dessus pour l ouvrir et contempler votre première activité en action. Pour la quitter et revenir au lanceur, appuyez sur le bouton Back (la flèche de retour en arrière), qui se trouve à droite du bouton Menu. Il est recommandé de ne pas fermer l émulateur entre chaque lancement d application : ceci vous évitera d attendre patiemment le chargement du système d exploitation au sein de l émulateur.