X-Ray, visualiser l’architecture et les dépendances d’un projet sous Eclipse

Pour présenter ou tout simplement avoir une vue globale de l’architecture d’un projet, il existe un plugin Eclipse très pratique : X-Ray.

X-Ray c’est quoi ?

X-Ray est un plugin open-source destiné à Eclipse.

Il permet de visualiser :

  • la compléxité d’un projet
  • les dépendances entre les classes
  • les dépendances entre les packages

Etape 1 : Téléchargement

Deux archives sont à télécharger pour utiliser ce plugin.

La première est l’archive “GEF framework plug-in and metadata” utilisée pour générer les graphiques : Télécharger.
Prenez la dernière version disponible et télécharger l’archive “All-In One Update Site”.
xray_download_1

La seconde est l’archive “X-Ray plug-in” : Télécharger.
xray_download_2

Etape 2 : Installation

Pour l’installer, il suffit d’ajouter les différentes fichiers des deux archives téléchargées, aux sources de votre Eclipse.

Pour “GEF framework plug-in and metadata” :

x_ray_gef_content

  • Copiez-Collez les deux fichiers “artifacts.jar” et “content.jar” à la racine de votre eclipse (eclipse/)
  • Copiez-Collez tous les fichiers du dossier plugins dans le dossier plugins de votre eclipse (eclipse/plugins/)
  • Copiez-Collez tous les fichiers du dossier features dans le dossier features de votre eclipse (eclipse/features/)

Pour “X-Ray plug-in” :

xray_plugin_content

  • Copiez-Collez le fichier “org.malnatij.SVPlugin_X.X.jar” dans le dossier plugins de votre eclipse (eclipse/plugins/)

Voilà, le plugin est prêt pour l’utilisation.

Pensez à fermer et ré-ouvrir Eclipse pour voir les changements.

Etape 3 : Utilisation

Ce plugin dispose de quelques fonctionnalités intéressantes que vous découvrirez au fur et à mesure de son utilisation.

La première consiste à analyser l’état d’un projet (Clique droit sur le projet > Analyse with X-Ray)

On obtient une nouvelle vue “X-Ray” avec les infos globales du projet :

xray_recap_packages_classes_methods_lines

  • 3 packages
  • 9 classes
  • 58 méthodes
  • 1021 lignes

Accompagné d’un graphique bien sympa : La complexité du projet

xray_complexity_project

En cliquant sur le petit logo encadré en rouge, on peut modifier le type d’analyse et donc choisir d’analyser:

xray_analyse

  • Les dépendances entre les classes
  • Les dépendances entre les packages
  • La complexité du projet (actuel)

Autre graphique sympa : Les dépendances entre les classes

xray_class_dependency

Si vous avez d’autres plugins utiles, n’hésitez pas à les partager, merci!

Développement Android – Installation et configuration de Vuforia SDK

Vuforia est un framework de réalité augmentée pour les plateformes mobiles (iOS et Android exclusivement). Il permet d’intégrer de la réalité augmentée à ses applications.

Présentation : ICI (source lesmobiles.com)

1. Téléchargement de Vuforia SDK

Pour le téléchargement de la version Android de l’outil de développement qui sera intégré à votre EDI (Eclipse par exemple), cliquez ICI.

vuforia_download

(vous devez créer un compte au préalable)

  • Acceptez les conditions d’utilisation et le téléchargement se lance

vuforia_agree

Une fois téléchargé, faites l’extraction de ce dossier vers le dossier de votre choix (vous devrez y faire référence un peu plus loin dans Eclipse)

2. Ajout de l’environnement dans Eclipse

Dans Eclipse, ouvrez la fenêtre des préférences :

  • Window
  • Préférences

preferences_eclipse

Puis ajoutez une variables à cette liste (voir ci-dessus)

  • Java
  • Build Path
  • Classpath Variables

et sélectionnez “New…”

new_variable_vuforia

Complétez les variables selon l’endroit où vous avez extrait Vuforia.
Name: QCAR_SDK_ROOT
Path: (cliquez sur folder et localisez le dossier que vous avez extrait dans la partie 1)

3. Utilisation d’un exemple

Voilà, Vuforia est maintenant correctement ajouté à Eclipse, vous pouvez maintenant commencer par tester un projet d’exemple qui est proposé sur leur site.

Allez sur : https://developer.vuforia.com/resources/sample-apps

exemple_vuforia

Sélectionnez “Android” et le fichier contenant tous les exemples se télécharge.

Une fois téléchargé, exportez un ou plusieurs projets que vous souhaitez tester vers votre répertoire de travail (workspace).

(ci-dessous, la liste des exemples fournis par Vuforia)

vuforia_ex

Pour le tutoriel, je vais prendre le projet “VuforiaSamples-2-8-8

Faites simplement un import de ce projet dans Eclipse :

  • File
  • New
  • Other…
  • Android Project from Existing Code

add_vuforia_project

  • Choisissez le dossier “VuforiaSamples-2-8-8
  • Cliquez sur “Finish

Le projet est importé, il ne vous reste plus qu’à le compiler et le tester sur votre téléphone.