TUTORIEL: INSTALLATION D'UN SERVEUR LOCAL SOUS WINDOWS 7 POUR APPINVENTOR version du 06/04/2013 1. Téléchargement des sources AppInventor http://appinventor.mit.edu/appinventor-sources/ Télécharger ces ressources (.ZIP), les décompresser, puis les copier dans le répertoire renommé C:\mitv133. 2. Téléchargement de Apache Ant et configuration http://ant.apache.org/bindownload.cgi Copier la version décompressée dans le répertoire renommé c:\apacheant Configurer les variables d'environnement de "ant" sous Windows 7 o Panneau de configuration->système et sécurité->système->paramètres système avancés->variables d'environnement (bouton en bas à droite...) Déclarer une première variable d'environnement ANT_HOME pour "ant". Faire ->Nouvelle puis : et ok Laurent Proust :Version 6/04/2013 : Mise en place d'un serveur local AppInventor sur Windows 7 1
Déclarer (ou modifier si elle existe) une deuxième variable d'environnement PATH pour "ant". Faire ->Nouvelle (ou modifier) puis : et ok 3. Téléchargement de Git Hub pour Windows et configuration https://github.com/ Installer Github Copier le répertoire C:\Users\MON_COMPTE\AppData\Local\GitHub vers c:\github en prenant soin ensuite de renommer le répertoire c:\github\portablegit_93e8418133-série de chiffre-4496c6 en c:\github\portablegit Configurer les variables d'environnement de "GitHub" sous Windows 7 o Panneau de configuration->système et sécurité->système->paramètres système avancés->variables d'environnement Déclarer une variable d'environnement GIT_HOME pour GitHub. Faire ->Nouvelle puis : et ok Laurent Proust :Version 6/04/2013 : Mise en place d'un serveur local AppInventor sur Windows 7 2
Modifier la variable d'environnement PATH pour insérer GitHub. Faire -> modifier puis : et ok 4.Téléchargement de AppEngine SDK https://developers.google.com/appengine/downloads Après le téléchargement, décompresser le fichier puis le copier dans le répertoire renommé suivant : c:\appengine (donc pas sous c:\appengine-java-sdk-1.7...) 5. Télécharger le Android SDK http://developer.android.com/sdk/index.html Télécharger la version avec installateur : Le fichier téléchargé est directement exécutable. Laurent Proust :Version 6/04/2013 : Mise en place d'un serveur local AppInventor sur Windows 7 3
Lancer son installation, puis exécuter le SDK Manager afin de mettre à jour la plateforme Androïd que vous désirez. 6. Télécharger Java JDK http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html (Ici une version 64 bits) Télécharger et installer Ajouter une variable d'environnement JAVA_HOME (Vérifier que le répertoire correspond : ici jdk1.7.0_017, cela peut changer selon les versions...) Laurent Proust :Version 6/04/2013 : Mise en place d'un serveur local AppInventor sur Windows 7 4
A ce stade, l'arborescence sous C:\ devrait contenir : Laurent Proust :Version 6/04/2013 : Mise en place d'un serveur local AppInventor sur Windows 7 5
7. Compiler Appinventor Passer en mode console (cmd depuis la barre d'exécution de windows). Depuis le répertoire c:\mitv133\appinventor : Exécuter la commande c:\mit133\appinventor\ant. La compilation doit avoir lieu et bien se passer... Si tel n'est pas le cas taper la commande :\mit133\appinventor\ant clean et exécuter à nouveau une commande ant. Si la commande n'est pas reconnue cela peut provenir d'un problème de configuration des variables d'environnement. Vérifier par la commande echo %JAVA_HOME% par exemple (cela devrait afficher le nom du répertoire ou se trouve java...) Option : Changer le nombre de connexion maximum sur le buildserveur (par défaut le nombre est illimité) Depuis Windows et à l'aide de Notepad++ ouvrir le fichier : C:\mitv133\appinventor\buildserver\src\com\google\appinventor\buildserver\BuildServer.java Dans : @Option(name = "--maxsimultaneousbuilds", usage = "Maximum number of builds that can run in parallel. O means unlimited.") int maxsimultaneousbuilds = 0; // The default is unlimited. Changer la ligne "int maxsimultaneousbuilds = 0; // The default is unlimited" pour maxsimultaneousbuilds = 10; // The default is unlimited" pour 10 connexions... "int En toute logique, si tout s'est bien passé, il peut être intéressant d'effectuer une copie des répertoires précédents sur un DVD (ou une clef) (apacheant, appengine, GitHub, mitv133), cela permettra de configurer bien plus rapidement un nouveau serveur d'application...si besoin est... 8. Lancer le serveur d'application C'est le serveur qui permettra la gestion des projets Appinventor et qui permettra la création de l'application. Depuis un terminal ouvert avec "cmd" se placer dans le répertoire c:\ appengine : Exécuter la commande : C:\appengine\bin\dev_appserver.cmd --port=8888 --address=0.0.0.0 C:\mitv133\appinventor\appengine\build\war ou sur une seule ligne : C:\appengine\bin\dev_appserver.cmd --port=8888 --address=0.0.0.0 C:\mitv133\appinventor\appengine\build\war (il est possible de créer un batch exécutable depuis le bureau windows, cela simplifie les choses...) Après exécution le serveur fonctionne! Laurent Proust :Version 6/04/2013 : Mise en place d'un serveur local AppInventor sur Windows 7 6
9. Paramétrer et lancer le serveur de construction Le serveur de construction permet de réaliser les fichiers à partir des fichiers projets.zip de Appinventor afin de créer les fichiers.apk. Ce serveur permet également le transfert de l'application sur la tablette ou le téléphone. Il faut cependant configurer le fichier "appinventor/appengine/build/war/web- INF/appengine-web.xml" afin de préciser l'adresse du serveur. Il faut changer la ligne suivante "<property name="build.server.host" value="localhost:9990" />" pour "<property name="build.server.host" value="192.168.1.7:9990" />" ou 192.168.1.7 est la machine serveur. Voici les lignes de commandes nécessaires à l'exécution de ce serveur à saisir depuis un autre terminal "cmd": cd C:\mitv133\appinventor\buildserver ant RunLocalBuildServer 10. Tests et utilisation de puis Google Chrome Depuis son navigateur il suffit de taper l'url "localhost:8888" (depuis un autre poste il faut entrer : "ip_du_serveur:8888") et il apparaît : Il suffit de placer son nom en guise de login, puis Log In (plus besoin de compte gmail) Cliquer... et l'interface web permettant le design de l'application apparaît : Attention: Certaines fonctionnalités _pour le moment_ ne sont pas opérationnelles sous Windows (Construction et téléchargement du.apk vers la tablette/téléphone/pc _BuildServer_). Tout le reste fonctionne bien (test in situ sur tablette). Une installation sous Linux permet d'avoir un "ensemble" serveur d'applications + BuildServer opérationel. Laurent Proust :Version 6/04/2013 : Mise en place d'un serveur local AppInventor sur Windows 7 7
Cependant une solution existe pour s affranchir de cette limite. Il suffit pour cela d installer en lieu et place des répertoires (mit/appinventor/appengine et mit/appinventor/buidserver) les répertoires AppEngine et BuildServer (version V1.4.6) proposés par Gary Frederick sur le site sourceforge.net. Le lancement du serveur d'application se fera alors par : C:\appengine\bin\dev_appserver.cmd --port=8888 --address=0.0.0.0 C:\mitv133\appinventor\appengine\build\war Le lancement du serveur de construction se fera par : le fichier commande /buildserver/launchbuildserver.bat (pour une version 64bits). Le fichier buildserver-apk.bat permettra de gérer des projets AppInventor (fichier.zip) pouvant dépasser les 5Mio. Pour tester complètement appinventor Il faut installer l'application AppInventor si cela n'a pas déjà été fait auparavant lors d'une précédente utilisation de cet outil : http://appinventor.mit.edu/explore/content/windows-installation.html Laurent Proust le 06/04/2013 Laurent Proust :Version 6/04/2013 : Mise en place d'un serveur local AppInventor sur Windows 7 8