Installation des outils de Xamarin avec des configurations exotiques – partie 2

Si ce n’est déjà fait, je vous recommande fortement la lecture du 1^er billet de cette série : https://nicolasclerc.wordpress.com/2013/12/26/installation-des-outils-de-xamarin-avec-des-configurations-exotiques-partie-1/

Et comme promis, la deuxième partie de cette série de billet concernera l’utilisation d’une tablette exotique (‘marque de distributeur’, made in china et 100% low cost) sur un poste de développement Xamarin/Microsoft.

La tablette utilisée dans ce billet a été acheté dans un magasin Carrefour lors d’une promo de rentrée en 2012.

Elle est équipée avec :

• Android 4.0.3 ICS sans le playstore (elle ne respecte pas les préconisations hardware de Google pour ICS)
• CPU Rockchip Cortex A8 à 1ghz
• Ecran 7pouces 800×480
• 512Mo RAM, 4Go de stockage

Il s’agit donc d’une tablette bas de gamme, dont le principal avantage est le prix.

Connexion au PC

La première étape est donc de s’assurer que le PC reconnait bien le device lorsqu’il est connecté.

Au préalable, la tablette a été configuré en mode ‘débogage USB’.

Lors de la connexion de la tablette, Windows identifie un périphérique ‘CT705FR’ mais n’arrive pas à trouver les pilotes de périphériques. Pour installer les pilotes, je vous renvoi à la 1ere partie de cette série de billet (https://nicolasclerc.wordpress.com/2013/12/26/installation-des-outils-de-xamarin-avec-des-configurations-exotiques-partie-1/)

Après cette étape la tablette est bien identifiée comme un ‘Android phone’ par Windows.

Mais …

(ben oui, il faut bien justifié ce 2^e billet ),

Si je lance mon Visual Studio (avec les outils Xamarin installés) et que je rouvre le projet créé dans le billet précédent, ma liste des cibles de débogage ne mentionne pas la tablette comme on aurait pu s’y attendre.

Vous pouvez tenter des reboots du PC, de la tablette, essayez de rooter la tablette, faire bruler des cierges ou installer votre tablette à côté d’une corbeille de fruit, rien n’y fera. 70€ de perdu … que neni ! Il suffit de continuer à lire J

Le rôle d’ADB

ADB (Android Debug Bridge) est un utilitaire faisant partie du SDK Android qui a été installé par l’installeur Xamarin. Cet utilitaire fait la passerelle entre vos outils de développement et le périphérique Android sur lequel le débogage USB est activé.

ADB peut être interrogé en ligne de commande. On va vérifier les périphériques détectés par ADB :

Ouvrir une fenêtre de ‘ligne de commande’, et positionnez-vous dans le dossier du SDK Android (dans mon cas, il se trouve dans le dossier : C:\Users\Nicolas\AppData\Local\Android\android-sdk , à adapter en fonction de votre installation)

Adb.exe se trouve dans le sous-dossier platform-tools (ou le sous-dossier tools si votre sdk est ancien)

Exécuter la commande ‘adb devices –l’ pour obtenir la liste des devices reconnus par adb.

Le résultat est sans appel : rien !

Donc : bien que Windows ait reconnu notre tablette, que le driver système ait été chargé, adb continue à ne pas aimer notre tablette comme cible de débogage.

En fait, par défaut ADB reconnait uniquement un certain nombre de devices (ceux vendus par Google et les principaux fabricants, ce qui explique que notre téléphone HTC est été reconnu d’emblée mais pas notre tablette exotique)

Je vais vous décrire la marche à suivre totalement générique pour configurer ADB pour supporter votre device. Cette démarche est la même quel que soit le périphérique Android du moment que Windows le reconnait. Il faut la réitérer pour chaque device non reconnu par ADB. Cette méthode est aussi utilisable pour ceux qui font du développement natif (java) pour Android.

Pour se faire, il vous faut connaitre l’identifiant USB du fabricant de votre device. Dans le cas des grandes marques s’est assez simple, dans le cas des périphérique noname ou MDD (Marque De Distributeur) ce n’est pas facile.

Récupérer l’identifiant du fabricant de votre device

Le plus simple est de le récupérer dans le gestionnaire de périphériques Windows :

• Lancer l’outil de gestion l’ordinateur,
• Sélectionnez la section « Gestionnaire de périphériques »,
• Ouvrez le nœud « Android Phone »
• Faites un clic droit sur votre device et sélectionner « Propriétés »

• Allez dans l’onglet ‘détails’
• Dans la liste déroulante ‘Propriété’, sélectionnez ‘Numéro d’identification du périphérique’

La valeur qui nous intéresse est celle qui suit ‘USB\VID_’, soit 2207 (en hexadecimal), il s’agit de l’identifiant du fabricant du périphérique USB.

 

Forcer ADB à accepter notre ‘fabricant’

Une fois l’identifiant du fabricant de notre device connu, il ‘suffit’ maintenant de l’ajouter dans un obscure fichier de configuration qui se trouve dans le dossier ‘.android’ dans votre dossier utilisateur. Sur mon poste, il s’agit donc du dossier C:\Users\Nicolas\.android

Dans ce dossier, éditez (ou créez) le fichier ‘adb_usb.ini’ avec votre éditeur de texte préféré (notepad++ ou même Visual Studio). Le notepad.exe de Windows ne gère pas correctement les retours à la ligne ‘sauce Unix’, à éviter donc.

Ajoutez une ligne de texte ‘0x2207’ (2207 étant à remplacer par l’identifiant de votre fabricant que vous aurez relevé à l’étape précédente. Dans mon cas, 0x2207 est l’identifiant du fabricant de la tablette Carrefour CT705).

Il faut ensuite redémarrer le serveur ‘adb’ pour qu’il prenne en compte le nouveau fichier de configuration : exécutez la commande ‘adb kill-server’ puis ‘adb start-server’, puis vérifiez la détection de votre device  avec la commande ‘adb devices –l’:

Ça marche !!! ADB accepte notre tablette maintenant. Dernière vérification avec Visual Studio (relancer le pour rafraichir la liste des devices de debug) :

A vous le débogage Android sans vous ruiner en device !

Néanmoins, un panel significatif des différents types de devices (puissance CPU, version OS, résolution écran) est fortement recommandé afin de tester vos applications dans différents cas d’utilisation. L’utilisation de périphérique low cost permet d’équiper une équipe complète à moindre cout, tout en mutualisant des périphériques plus couteux pour les phases de test et de validation.

Et puis, commencer avec une cible de faible puissance pousse à optimiser son code dès le début.

Voilà : ces 2 billets vous permettent de commencer sereinement le développement .Net sur Android avec les outils de Xamarin , Visual Studio et les périphériques exotiques qui pullulent en cette fin d’année connectée et high-tech ; que vous les ayez reçu en cadeau ou que vous comptiez en offrir à vos collaborateurs.

 

Je profite de ce dernier billet de 2013 pour vous souhaiter un bon réveillon, et tous mes meilleurs vœux pour cette nouvelle année 2014 qui débutera dans quelques heures.

Installation des outils de Xamarin avec des configurations exotiques – partie 1

Après quelques mois de silence blogistique (mais pas d’inactivité professionnelle, rassurez-vous), je suis de retour sur mon blog technique.

Et comme cadeau pour les fêtes de fin d’année, j’ai décidé de compiler les solutions à différents tracas rencontrés lors de la configuration d’un poste de développement pour utiliser les outils de Xamarin (http://www.xamarin.com).

Pour ceux qui ne connaîtraient pas Xamarin, cette société s’est spécialisée dans l’édition d’outils de développement .Net (éditeur, framework, clr) visant les plateformes sur lesquelles Microsoft ne propose pas de solutions officielles .Net :

• iOs (iPhone, iPad, iPod)
• Mac OS
• Android

La relation entre Xamarin et Microsoft a été fluctuante aux fils des années, mais en 2013 un partenariat officiel a ‘enfin’ été signé entre les 2 sociétés : http://blog.xamarin.com/microsoft-and-xamarin-partner-globally/

Tout d’abord, soyons honnête, la plupart des tracas rencontrés ne concernent pas les outils de Xamarin mais les frameworks, sdk, outils tiers nécessaires ou device de développement.

Dans cette première série de billets, je vais me concentrer sur la configuration pour du développement ciblant Android. La configuration logicielle initiale (entièrement à jour au niveau des correctifs et updates) est :

• Windows 8.1 FR 64 bits
• Visual Studio 2013
• Visual Studio 2010

L’installeur de Xamarin se charge d’installer l’ensemble des dépendances logicielles nécessaires :

• JDK
• Android SDK
• MonoDroid (.Net pour Android)
• MonoTouch (.Net pour iOs)
• Xamarin Studio (environnement de développement ‘Visual Studio like’, disponible aussi sur Mac)
• Extension de développement pour Visual Studio (développement Android & iOs)

L’utilisation d’un device physique quand on fait du développement Android sous Windows est importante. En effet, l’émulateur Android fournit par Google n’a jamais été réellement optimisé pour Windows et les émulations sont catastrophique de lenteur.

Les devices de développement

Précision utile : l’utilisation de device physique (téléphone ou tablette) pour le développement avec les outils de Xamarin nécessite une licence, la version d’évaluation ou gratuite ne permet que l’utilisation des émulateurs fournit par les SDKs, et ne permet pas le packaging pour le déploiement sur la différentes place de marché mobile.

Actuellement, j’utilise 2 périphériques physiques Android (un téléphone ‘ancien’, une tablette ‘grand public’ et ‘bas de gamme’) non rooté. Dans le cadre de développement grand public, il est néanmoins judicieux d’avoir un échantillon plus fournit à cause du foisonnement des systèmes tournant sous Android et leur grand variété. Ces 2 devices ne sont pas des bêtes de courses, mais l’avantage c’est qu’ils sont ‘représentatifs’ de la tranche basse (puissance ou version d’os) de ce que l’on peut trouver sur le marché grand public. Dans mon cas, il s’agit :

• téléphone HTC Wildfire S A510e (équipe d’Android 2.3.5) certifié Google avec le PlayStore officiel
• tablette ‘Carrefour’ CT705 (Android 4.0.3) sans Google Playstore mais avec le store GetJar

Les 2 devices sont configurés pour permettre le développement : le débogage est activé (option dans la configuration de votre device Android), le port USB est configuré pour la charge uniquement.

L’installation des outils de Xamarin s’étant déroulée sans soucis (prévoir quelques 2go de téléchargement si vous partez d’une machine vierge). Un petit projet de test pour Android est créé et lancé dans l’émulateur Android. Tout marche bien.

C’est lorsque j’ai tenté un debug sur le device que les soucis ont commencé : non reconnaissance des devices par Windows malgré le SDK Android installé. De fait, adb (l’outils du sdk Android utilisé en arrière-plan pour dialoguer avec un device Android pour du debug) ne voit pas les devices.

Driver Android pour le développement

Symptôme et explication :

Dans le cas du HTC Wildfire S, Windows 8.1 détecte bien un ‘Android Phone’ mais ne trouve pas le driver correspondant, y compris en effectuant une recherche sur Windows Update.

Résolution :

Apres plusieurs tentatives, la solution la plus fiable et la seule systématiquement reproductible consiste à installer les drivers Intel pour les périphériques Android. Bien que décrit comme ciblant les plateformes Android à base de processeur Atom, ces drivers fonctionnent très bien avec les architectures Arm (cas du Wildfire et de la tablette).

Autre soucis, l’installation de ces drivers sous Windows 8.1 échoue car l’installation ne reconnait pas la version de Windows. La solution consiste à lancer l’installation en forcant la compatibilité avec Windows XP SP3.

Marche à suivre :

• téléchargez les drivers Intel pour Android : http://software.intel.com/en-us/articles/intel-usb-driver-for-android-devices
• décompressez le .zip.
• faites un clic-droit sur le fichier « IntelAndroidDrvSetup1.1.5.exe », ‘Propriété’, sélectionnez le mode de compatibilité Windows XP SP3

• Lancez ensuite l’installation en mode Administrateur
• L’installation doit se dérouler sans soucis.
• Connectez maintenant votre périphérique Android en USB. Windows le détecte mais le driver n’est toujours pas chargé.
• Ouvrez le gestionnaire d’ordinateur (Explorateur de fichiers, puis bouton « Gérer » dans le ruban) et sélectionnez « Gestionnaire de périphérique » dans l’arborescence), votre périphérique doit apparaitre dans la branche « Autres périphériques » :

• Faites un clic droit sur « Android Phone », sélectionnez « Mettre à jour le pilote »
• Dans la fenêtre qui apparait, sélectionnez la 2^e option « Rechercher un pilote sur mon ordinateur », puis cliquez sur « Choisir parmi une liste de pilotes de périphériques sur mon ordinateur »
• Sélectionnez « Android Phone », puis « Android Composite ADB Interface », puis « Suivant »

• Confirmez l’installation du driver si Windows vous affiche un « avertissement de mise à jour de pilote » : Windows effectue l’installation.
• Un fois l’installation effectuée, le gestionnaire de périphériques affiche maintenant votre device dans la branche « Android Phone » sous le nom générique du driver.

• Relancez Visual Studio , ouvrez ou créez un projet Android.
• Dans la barre d’outils Xamarin, la liste déroulante des cibles de debug vous proposera maintenant votre device physique en plus des images pour de l’émulateur.

Cette procédure devrait marcher pour la plupart des device Android quelques soit leur fabricant. Néanmoins le marché android étant fortement éclaté entre de multiples acteurs de source et de qualité très variables, il n’est pas rare que l’étape décrite ci-avant ne soit pas suffisante, et Visual Studio ne vous listera pas votre périphérique comme cible d’un débogage. Ce risque est d’autant plus grand que le périphérique est d’origine « exotique » (cas de ma tablette MarqueDeDistributeur, fabriqué en chine et revendu sous la marque du distributeur).

La résolution de ces soucis de détection sera traitée dans le billet suivant qui sortira dans les prochains jours.

Affaire à suivre …