Android,
A Complete Course, From
Basics to Enterprise Edition
Android, A Complete Course, From Basics to Enterprise
Edition
Construire et Déployer son application.
1 Ajouter des Jars à votre application
2 Construire et déployer votre application
2.3 Retrouver sa clef pour MapView
Cet
article est extraie du livre « Android, A Complete Course »,
disponible sur Android2ee.com.
Les
exemples ou les programmes présents dans cet ouvrage sont fournis pour
illustrer les descriptions théoriques. Ce code est libre de toute utilisation
mais n'est pas distribuable.
La
distribution du code est reservée au site :
La
propriété intellectuelle du code appartient à :
L’utilisation
de ces codes est sous votre unique responsabilité et personne d’autre que vous
ne pourra être tenu responsable des préjudices ou dommages de quelques natures
que ce soit pouvant résulter de son utilisation.
Tous
les noms de produits ou marques cités dans cet ouvrage sont des marques déposés
par leurs propriétaires respectifs.
Publié par http://android2ee.com
Titre Original : Android, A Complete Course, From
Basics to Enterprise Edition. Édition Française.
ISBN : 979-10-90388-00-0
Copyright © 2011 by Mathias Séguy
Aucune
représentation ou reproduction, même partielle, autre que celles prévues à
l’article L. 122-5 2° et 3° a) du code de la propriété intellectuelle ne peut
être faite sans l’autorisation expresse de Mathias Seguy ou, le cas échéant,
sans le respect des modalités prévues à l’article L. 122-10 dudit code
Cela s’effectue assez simplement, il suffit de rajouter à votre projet le jar dans le répertoire libs\ et de l’ajouter à votre build path.
Cependant, les choses peuvent s’envenimer car même si votre application compile, il n’est en aucun cas évident que votre application se lance. En effet, Android possède une JVM légère, Dalvik, qui a été expurgée d’un certains nombres de composants usuels pour le JSE, le JME ou le J2EE (typiquement Swing et AWT). Ainsi, votre Jar peut être dépendant de certains composants Java natifs qui n’existent pas dans la JVM Dalvik d’Android… et là… il n’y a pas de solutions clef en main.
La construction et le déploiement de l’application peut se faire en ligne de commande, nous expliquons ici comment le faire en utilisant Eclipse.
Avant tout, il faut que vous définissiez l’emplacement d’un KeyStore dans votre espace de travail (votre ordinateur ou sur votre réseau). Ce KeyStore servira à centraliser l’ensemble de vos clefs pour signer vos applications. Vous devez vous assurer de la sécurisation de ce dossier et de sa persistance. En effet, un tiers ne doit pas pouvoir vous voler vos clefs car il serait en mesure d’utiliser la même signature que vous et pirater vos applications (pour mettre un malware par exemple). Ensuite, vous devez toujours être capable de résigner votre application, notamment dans le cas où celle-ci évolue. En effet, si la version 1 et la version 2 de votre application ne sont pas signées avec la même clef, l’utilisateur ne pourra pas faire d’update de la version 1 et sera obligé d’installer la version 2 comme si celle-ci était une nouvelle application.
Le KeyStore possède un mot de passe que vous devez conserver aussi précieusement que le KeyStore lui-même.
Au moyen d’Eclipse, rien de plus simple : Clic droit sur votre projet Android -> Android Tool -> Export Signed Application Package…
La première fenêtre du wizard vérifie que votre projet ne comporte pas d’erreurs, cliquez sur next.
La seconde fenêtre, elle, vous demande où se trouve votre KeyStore, si vous n’en avez pas encore, définissez le dossier qui vous servira à stocker vos clefs[1], sinon retrouvez votre KeyStore et remplissez le champ mot de passe.
La troisième fenêtre, elle vous permet de créer une clef. Une clef possède les informations suivantes :
· Alias : Un alias vers la clef, son petit nom. Seuls les 8 premiers caractères sont utilisés
· Password : Le mot de passe associé à cette clef
· Confirm : Le mot de passe associé à cette clef
· Validity (years): La validité (Android préconise au moins 25, vous pouvez mettre un siècle)
· First and Last Name : Votre nom et prénom (ou le nom de votre équipe)
· Organizational Unit : Le service de votre entreprise qui a développé l’application
· Organization : Le nom de votre entreprise
· City or locality : Votre ville
· State or Province : Votre état, votre région, votre département
· Country code : Le code de votre pays[2], celui-ci est le même que celui utilisé pour l’internationalisation (US pour USA, FR pour France, UK pour Angleterre…) .
La dernière fenêtre vous demande où le fichier apk doit-il être enregistré.
Cette méthode est à utiliser uniquement si vous n’avez pas Eclipse sur votre machine.
Pour créer votre KeyStore en ligne de commande en utilisant la commande keytool (dans votre JAVA_HOME/bin) et la tâche genkeypair :
-genkeypair
[-v] [-protected]
[-alias <alias>]
[-keyalg <keyalg>] [-keysize <taille_clé>]
[-sigalg <sigalg>] [-dname <nomd>]
[-validity <joursVal>] [-keypass <mot_passe_clé>]
[-keystore <keystore>] [-storepass <mot_passe_store>]
[-storetype <storetype>] [-providername <name>]
[-providerclass <provider_class_name> [-providerarg <arg>]]
...
[-providerpath <pathlist>]
Ce qui donne :
keytool -genkeypair -v -keystore myReleaseKeystorePath.jks -storepass myKeystorePassword -alias myKey
-keypass myKeyPassWord -keyalg RSA
-validity 36500
Où:
· myReleaseKeyStorePath est le chemin complet de votre KeyStore (/home/myStores/myKeyStore.jks),
· myKeystorePassword est le mot de passe de votre KeyStore,
· myKey est le nom de votre clef et
· myKeyPassWord est le mot de passe de cette clef.
Le système vous posera une suite de questions : nom, prénom, organisation,…
Pour déployer votre application, vous pouvez utiliser l’un des marchands suivants:
http://market.android.com/publish/signup
Il vous suffira de payer 25$ et vous pourrez déployer vos applications sur l’Android Market.
Pas de paiement pour le développeur, l’enregistrement est gratuit.
Leur credo : « Si l’Android Market a refusé votre application, venez chez nous ».
http://appoke.com/info/developers
S’appuie sur la notion de réseau social pour que votre application soit visible le plus vite possible.
Cette dernière manière de déployer correspond à la problématique du déploiement au sein d’une entreprise sur un ensemble restreint d’appareils.
L’idée est simple, il faut pouvoir télécharger l’application puis l’installer. Pour télécharger l’application, il suffit de mettre en place une servlet sécurisée (user et password) qui permet de télécharger le fichier apk sur l’appareil cible. Pour installer l’application, vous trouverez sur l’Android Market une application nommée « Apps Installer » qui lance l’installation d’un fichier apk enregistré sur la carte SD. Il vous suffit d’utiliser cette application pour réaliser vos installations.
Pour autoriser ce genre d’installation, il faut que l’appareil cible autorise l’installation d’application non issue du marché. Pour modifier ce paramètre : Menu->Setting->Applications-> Sélectionnez « Unknown Sources ».
Enfin, si vous souhaitez avoir un programme qui automatiquement télécharge et installe la nouvelle version de votre application sur les appareils, l’article suivant dresse les grandes lignes de la mise en place d’un tel service : http://blog.excilys.com/2009/12/07/android-pour-lentreprise-3-deploiement-hors-market/.
Tout d’abord, vous devez avoir en tête que votre application possède deux clefs, l’une pour le développement, l’autre pour la production.
Nous avons vu pour la production où se trouve cette clef.
Pour le développement, votre KeyStore se trouve :
· Pour Windows Vista et 7 sous \Users\<user>\.android\debug.keystore
·
Pour
Windows XP sous \Documents and Setting\<user>\.android\debug.keystore
· Pour linux ou Mac sous ~/.android/debug.keystore
Ensuite, il vous faut, à partir de cette clef, retrouver l’empreinte MD5 associée. Cela se fait par ligne de commande.
Dans le cas de votre clef de production, il faut taper:
$ keytool
-list -alias alias_name -keystore my-release-key.keystore
Où alias_name est l’alias que vous avez donné pour signer votre application et my-release-key.keystore est le chemin vers votre KeyStore.
Dans le cas de votre clef de développement, il faut taper :
$keytool -list -alias androiddebugkey -keystore <path_to_debug_keystore>.keystore -storepass android -keypass android
Il est important de savoir que l’outil keytool est un outil Java, s’il ne s’exécute en ligne de commande, il faut vous déplacer dans le répertoire <JDK>\bin et ré-exécuter la commande (le mien se trouve sous C:\Program Files\Java\jdk1.6.0_18\bin) où <JDK> est le répertoire où vous avez installé votre JDK.
Ce qui donne sur mon poste (et oui je suis sous Seven):
C:\Program Files\Java\jdk1.6.0_18\bin>keytool -list -alias
androiddebugkey -keystore
C:\Users\mathias1\.android\debug.keystore
-storepass android -keypass android
androiddebugkey, 25 nov. 2010, PrivateKeyEntry,
Empreinte du certificat (MD5) :
5B:A4:EE:FD:D8:88:CC:98:83:88:B9:81:72:C3:F3:7B
Une fois muni de votre empreinte MD5, allez vous inscrire pour obtenir votre clef auprès de Google : http://code.google.com/intl/fr/android/maps-api-signup.html
Qui me donne une clef du type : 04Lug61_seB50108nRCRX1hjzGs95Pk86niGvow
Il ne vous reste plus qu’à mettre à jour votre layout.xml dans lequel vous déclarez votre objet MapView avec cette clef.
[1] N’oubliez pas que ce Keystore doit être sécurisé et persistant, ainsi que son mot de passe.
[2] Vous trouverez la liste complète ici : http://en.wikipedia.org/wiki/ISO_3166-2