Installation d`un serveur AppInventor sous Windows

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/WEBINF/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