Android How To SDK 1 2 Info ........................................................................................................................................................... 2 Installation................................................................................................................................................. 2 2.1 Java ................................................................................................................................................... 2 2.1.1 Doc............................................................................................................................................ 2 2.2 Eclipse............................................................................................................................................... 2 2.3 ADT Plugin : Android Development Tools. ....................................................................................... 3 2.4 SDK : Android................................................................................................................................... 4 3 Emulateur Android. ................................................................................................................................... 5 4 Utilisation de l’émulateur. ......................................................................................................................... 6 5 Connection Android .................................................................................................................................. 7 5.1 Drivers USB ...................................................................................................................................... 7 5.1.1 USB Android ............................................................................................................................. 7 5.2 USB Archos....................................................................................................................................... 7 5.3 Test connection.................................................................................................................................. 8 5.4 Remarque .......................................................................................................................................... 8 6 ADB : Android Debug Bridge ................................................................................................................... 9 7 Telnet ........................................................................................................................................................ 9 8 Eclipse Perspective.................................................................................................................................. 10 8.1 Sélection de la perspective. .............................................................................................................. 10 8.2 DDM ............................................................................................................................................... 10 8.3 Le Logcat ........................................................................................................................................ 12 8.3.1 Utilisation dans le code ............................................................................................................ 12 8.3.2 Rajout du LogCat dans la perspective Java............................................................................... 12 8.3.3 ADB Logcat............................................................................................................................. 13 8.3.4 Autre info ................................................................................................................................ 13 8.4 Le mode Debug ............................................................................................................................... 14 9 Aide en Ligne.......................................................................................................................................... 15 9.1 JavaDoc........................................................................................................................................... 15 9.2 AutoCompletion .............................................................................................................................. 15 10 Racourcis Claviers............................................................................................................................... 16 11 Tool Overview..................................................................................................................................... 16 12 Application Fundamentals ................................................................................................................... 16 13 The Developer's Guide ........................................................................................................................ 16 14 Le premier Programme : Hello world................................................................................................... 17 14.1 Virtual Machine............................................................................................................................... 17 14.2 New Project ..................................................................................................................................... 17 14.3 Configurer et utiliser un Layout XML.............................................................................................. 19 1 Info Site de l’alliance des constructeurs ⇒ http://www.openhandsetalliance.com/ Site official ⇒ http://www.android.com/ Site des développeurs ⇒ http://developer.android.com/index.html 2 Installation. Il faut tout d’abord installer Eclipse qui est un Ide qui fonctionne sous Linux et Windows. Il faudra aussi avoir le SDK d’Android. 2.1 Java Il faut tout d’abord , avoir Java installé sur son PC. http://www.oracle.com/technetwork/java/javase/downloads/index.html On a besoin uniquement du JDK ⇒ jdk-6u23-windows-i586.exe C:\WINDOWS>java -version java version "1.6.0_23" Java(TM) SE Runtime Environment (build 1.6.0_23-b05) Java HotSpot(TM) Client VM (build 19.0-b09, mixed mode, sharing) 2.1.1 Doc http://download.oracle.com/javase/6/docs/api/ 2.2 Eclipse Eclipse ne s’installe pas, il suffit de décompresser le fichier téléchargé dans un dossier. http://www.eclipse.org/downloads/ For Eclipse 3.5 or newer, the "Eclipse Classic" version is recommended. Otherwise, a Java or RCP version of Eclipse is recommended. Sinon, plus complet ⇒ 2.3 ADT Plugin : Android Development Tools. http://developer.android.com/sdk/eclipse-adt.html#installing Android offers a custom plugin for the Eclipse IDE, called Android Development Tools (ADT), that is designed to give you a powerful, integrated environment in which to build Android applications. It extends the capabilites of Eclipse to let you quickly set up new Android projects, create an application UI, debug your applications using the Android SDK tools, and even export signed (or unsigned) APKs in order to distribute your application. In general, developing in Eclipse with ADT is a highly recommended approach and is the fastest way to get started with Android. https://dl-ssl.google.com/android/eclipse/ Install ADT ⇒ ⇒ Redémarrage Eclipse et des icônes sont maintenant disponible pour Android : Set preference ⇒ et pointer vers le DSK Android : 2.4 SDK : Android. Le SDK Android ne s’installe pas, il suffit de décompresser le fichier téléchargé dans un dossier. http://developer.android.com/sdk/index.html Cliquez sur le lien et téléchargez le dernier SDK pour votre système d'exploitation. 3 Emulateur Android. L’émulateur permet de tester les applications sans avoir besoin d’un appareil réel pour le test. On peut faire ces programmes et les tester dans l’émulateur avant de les installer dans un appareil physique. C’est un outils essentiel dans Android. Cliquer sur l’icones ⇒ Voici un exemple ⇒ ⇒ virtual device ⇒ New ⇒ Create ⇒ Il est possible de démarrer cet émulateur via une ligne de commande ou via le SDK Manager : 1. Créer un Shortcut de votre SDK sur le DeskTop : "C:\Program Files\Android\android-sdkwindows\SDK Manager.exe" Et lancer la VM ⇒ ⇒ 2. Ligne de commande : en dessous de tool du SDK ⇒ c:\Program Files\Android\android-sdk-windows\tools\emulator.exe -avd VAndroid-02 4 Utilisation de l’émulateur. http://developer.android.com/guide/developing/tools/emulator.html 5 Connection Android 5.1 Drivers USB 5.1.1 USB Android Rajout des drivers USB android ? ⇒ Je pense, qu’il ne faut PAS les installer au risque de ne plus pouvoir revenir en arrière (voir remarque) ⇒ uniquement Drivers Archos. 5.2 USB Archos On a besoin des drivers Archos : ADB pour les Développeurs Android (ARCHOS Internet Tablet) ⇒ http://www.archos.com/support/support_tech/updates.html?country=fr&lang=fr Il faut opérer dans l’ordre suivant : • Sur la tablette ⇒ activer le debug USB dans les paramètres Applications ⇒ Développement • Reboot de l’appareil Android parfois nécessaire si Windows ne détecte plus le device correctement . • • ⇒ ⇒ Reboot Android Raccorder L’Archos au PC via l’USB Lorsque Windows demande les drivers, il faut lui donner le PATH des drivers Archos ⇒ Finalement, on a dans device Manager ⇒ ⇒ • • • • • • • • • • USB\VID_0E79&PID_1411&MI_01\6&1EEBAC5F&1&0001 USB\Vid_0e79&Pid_1411&Rev_0216&MI_01 USB\Vid_0e79&Pid_1411&MI_01 USB\Class_ff&SubClass_42&Prot_01 USB\Class_ff&SubClass_42 USB\Class_ff usb\vid_0e79&pid_1411&mi_01 WdfCoInstaller01007.dll,WdfCoInstaller WinUSBCoInstaller.dll 5.3 Test connection On peut voir l’état dans “Remove Hardware” ⇒ En tapant la commande « adb devices » ⇒ C:\Program Files\Android\android-sdk-windows\platform-tools>adb devices List of devices attached A70-54F40001-9FF80000-015D84ED-???╩?╩?Ñ device adb kill-server ⇒ pour libérer la tablette et ainsi pouvoir l’éjecter proprement Après éjection, une détection ne donne plus de device ⇒ il faudra déconnecter et reconnecter l’USB . C:\Program Files\Android\android-sdk-windows\platform-tools>adb devices * daemon not running. starting it now on port 5037 * * daemon started successfully * List of devices attached 5.4 Remarque Si il y a des pbm de reconnaissance dans windows, on peut essayer les actions suivantes dans l’ordre : • • • • Déinstaller le drivers dans dans device Manager. Déinstaller le drivers ⇒ il faut trouver le répertoire ⇒ C:\WINDOWS\$NtUninstallwinusb0100$\spuninst\ Supprimer (après backup) le fichier C:\WINDOWS\inf\ INFCACHE.1 Renommer : C:\WINDOWS\LastGood\ Cela a fonctionner et mon Archos est à nouveau reconnu. 6 ADB : Android Debug Bridge ADB tourne en permanence en arrière plan et se configure en ligne de commande. Faisont un Batch file pour adb ⇒ cd c:"\Program Files\Android\android-sdk-windows\platform-tools"\ c: cmd ADB permet beaucoup de chose comme : - test de l’application via la commande : monkey. ADB va simuler des commande de toutes sorte sur l’application pour la tester ⇒ 7 Telnet Il est aussi possible de se connecter en Telnet sur l’émulateur pour simuler des événements. Comme par exemple simuler le chargement de la batterie : power status charging Toutes les commandes en tapant ? |? print a list of commands event simulate hardware events geo Geo-location commands gsm GSM related commands cdma CDMA related commands kill kill the emulator instance network manage network settings power power related commands quit|exit quit control session redir manage port redirections sms SMS related commands avd manager virtual device state window manage emulator window qemu QEMU-specific commands 8 Eclipse Perspective Eclipse est équipé d’un ensemble de tools puissant. 8.1 Sélection de la perspective. Une perspective, est une vue qui reprends plusieurs fenêtre en fonction de ce que l’on veut faire. Les différente perspectives sont accessible via : La toolbar ⇒ Le menu ⇒ On peut créer sa propre perspective via Show View. 8.2 DDM DDM ⇒ permet de débuguer les application sur l’appareil physique branché en USB ⇒ Screen capture possible ⇒ C’est exactement la copie d’écran de L’archos 70 IT ⇒ Il est possible de voir beaucoup d’info sur l’application en mémoire ⇒ Il est aussi possible de faire exactement la même chose avec la machine virtuelle ⇒ Lorsque l’on lance la machine, on, peut voir tout le log du démarrage ⇒ Possible de simuler des appel ou la géolocalisation de la VM : par exemple, envoie d’un SMS vers la VM ⇒ 8.3 Le Logcat Les boutons permettent de régler le niveau des informations ⇒ c’est un filtre ⇒ 8.3.1 Utilisation dans le code On passe en mode Java et l’on veux afficher une ligne en cas d’erreur de l’application dans le Log. On tape Log.i pour une information ou .e pour une erreur ⇒ Log.e("etape 1", "il y a une erreur"); Ce qui donne dans le Log ⇒ 8.3.2 Rajout du LogCat dans la perspective Java Pour ne plus passer d’une fenêtre à une autre ⇒ ⇒ 8.3.3 ADB Logcat Le Logcat provient de ADB ⇒ il est donc possible de lancer un Tail dans une commande DOS afin d’avoir le Log ⇒ adb Logcat 8.3.4 Autre info http://jsharkey.org/blog/2009/04/22/modifying-the-android-logcat-stream-for-full-color-debugging/ http://adrianvintu.com/blogengine/post/Colored-Logcat-Script-for-Windows.aspx 8.4 Le mode Debug On passe en vue Debug ⇒ on place un BreakPoint ⇒ Run ⇒ Débug ou F11 ⇒ Le programme est arrêté sur la ligne ⇒ souligné en vert et attends. On peut utiliser les bouton de la fenêtre Debug ⇒ Ou les touches de functions F5 Goes to the next step in your program. If the next step is a method / function this command will jump into the associated code. F6 F6 will step over the call, e.g. it will call a method / function without entering the associated code. F7 F7 will go to the caller of the method/ function. So this will leave the current code and go to the calling code. F8 Use F8 to go to the next breakpoint. If no further breakpoint is encountered then the program will normally run. Pour rajouter des analyse de variables ⇒ Ce qui donne ⇒ La vue Variable reprend toutes les variables ⇒ 9 Aide en Ligne 9.1 JavaDoc Rajouter L’aide Java dans la vue ⇒ il est possible de voir l’aide de la fonction en positionant le curseur dessus ou en rajoutant l’aide JavaDOC ⇒ 9.2 AutoCompletion CTRL + espace ⇒ permet d’avoir l’aide sur les fonction. 10 Racourcis Claviers. • CTRL + SHIF + L • Ctrl-F11 ⇒ run your currently visible application CTRL+SHIFT+O ⇒ rajoute les import manquant. CTRL + i ⇒ indentation du code CTRL + SHIFT + c ⇒ met le code en commentaire • • • • ⇒ liste des shortcuts CTRL + SHIF + L 2 X ⇒ modifier la liste des shortcuts 11 Tool Overview http://developer.android.com/guide/developing/tools/index.html 12 Application Fundamentals When you're ready to learn more, read Application Fundamentals for an introduction to all the elements that make Android applications work : http://developer.android.com/guide/topics/fundamentals.html 13 The Developer's Guide http://developer.android.com/guide/index.html 14 Le premier Programme : Hello world http://developer.android.com/resources/tutorials/hello-world.html 14.1 Virtual Machine Créer une machine virtuelle ⇒ 14.2 New Project ⇒ ⇒ 14.3 Configurer et utiliser un Layout XML. Res ⇒ layout ⇒ click main.xml ⇒ Définition des String ⇒ Le code est maintenant changé pour utiliser ce Layout ⇒ Plutôt que de passer un objet à « setContentView », on donne une référence à un layout ⇒