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!

Bonnes méthodes de nommage des packages en Java

Lorsque vous développez et que vous structurez les différentes parties de votre code dans des packages, il faut respecter une convention d’écriture de ces packages.

Ci-dessous, les critères à respecter :

– le nom du package doit être en minuscule
– le nom du package ne doit pas reprendre des noms déjà utilisés dans le JDK utilisé

Pour faire simple, voilà à quoi doivent correspondre les 3 parties du nom de votre package :

– Le premier mot doit correspondre au suffixe du nom de domaine (.fr, .com, .net, .info, etc…).
– Le deuxième mot doit correspondre au nom de la société.
– Le troisième mot doit correspondre au descriptif du contenu du package.

Bon nommage:

nommage_package_ok_java

Ne surtout pas faire:

nommage_package_nok_java

Pensez à nommer votre package de façon à pouvoir identifier son contenu rapidement…

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.

[Android] Passer d’une vue à une autre en cliquant sur un bouton

Quand on débute en développement Android, on crée notre première application, on ajoute du texte, un bouton, etc… Et après ? Comment créer une nouvelle page et passer à cette page en cliquant sur le bouton ? 

C’est ce que je vais essayer d’expliquer aujourd’hui dans ce tutoriel.

Création du bouton

On va partir d’une page vide, où nous allons ajouter un bouton. Jusque-là, rien de bien compliqué.

Il vous suffit de déplacer le bouton à partir de la palette sur votre vue.

vueavecboutonsimple

  • Modifiez l’identifiant du bouton par : “buttonSuivant”

Ajout d’une deuxième vue

La deuxième étape consite à ajouter une seconde vue (ou activité) à notre projet.

Cette étape va se départager en 3 étapes.

Etape 1 : Création de la classe qui va contrôler la vue

Nous allons créer cette classe sous : src –> com.example.tutopassagevue

Faites un clic droit puis :

  • New
  • Class
  • Nommez-là

L’arborescence de votre projet doit ressembler à ça :

nouvelle_vue_projet_android

Le code de la classe “Vue2.java” est presque vide.

Remplacez le par celui-là :

[java]
public class Vue2 extends Activity {

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.vue2);
}

@Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu; this adds items to the action bar if it is present.
getMenuInflater().inflate(R.menu.main, menu);
return true;
}

}
[/java]

Etape 2 : Création de la vue

Maintenant, nous allons créer la vue dans le projet. Ajoutez simplement un nouveau “Android XML File” sous : res –> layout

  • Clic droit
  • New
  • Other…
  • Android XML File

new_android_xml_file

  • Nommez votre fichier XML “vue2”
  • Validez par “Finish

new_android_xml_file2

Etape 3 : Déclaration de la nouvelle vue dans le AndroidManifest.xml

Pour déclarer correctement cette nouvelle vue dans notre projet, il faut ajouter l’activité dans le fichier “AndroidManifest.xml“.

  • Ouvrez le code du fichier “AndroidManifest.xml”
  • Sélectionnez l’onglet où se trouve le code (voir ci-dessous)

androidmanifestxml

  • Sous la balise fermante “</activity>” ajoutez le code ci-dessous qui correspond à la nouvelle vue :

[xml]
<activity android:name=".Vue2" />
[/xml]

Le code de votre fichier AndroidManifest.xml doit être identique à ça :

[xml]
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.tutopassagevue"
android:versionCode="1"
android:versionName="1.0" >

<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="17" />

<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
android:name="com.example.tutopassagevue.MainActivity"
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />

<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<activity android:name=".Vue2" />
</application>

</manifest>
[/xml]

Voilà. Si après enregistrement du projet il n’y a pas d’erreur bloquante, c’est que tout a bien été déclaré.

Passons à la dernière étape : le code du bouton!

La gestion du clic sur le bouton “suivant”

Maintenant que tout est en place, il faut gérer l’effet du clic de l’utilisateur sur le bouton suivant pour passer à la seconde vue.

Cette gestion se fait dans le code de notre classe Java (“MainActivity.java”).

[java]
public class MainActivity extends Activity {

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

final Button buttonsuiv = (Button) findViewById(R.id.buttonSuivant);
buttonsuiv.setOnClickListener(new View.OnClickListener() {

@Override
public void onClick(View v) {
Intent intent = new Intent(MainActivity.this, Vue2.class);
startActivity(intent);
}
});
}

@Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu; this adds items to the action bar if it is present.
getMenuInflater().inflate(R.menu.main, menu);
return true;
}

}
[/java]

Enregistrez, compilez et testez!

Si vous avez suivi les étapes dans l’ordre, le passage d’une vue à l’autre doit se faire sans soucis.

Installation et configuration de metaioSDK pour développer vos applications de RA

1. Téléchargement du metaioSDK

Pour utiliser leur outil de développement de réalité augmentée, il faut télécharger le Metaio SDK qui est proposé sur leur site officiel, rubrique « Products » : http://www.metaio.com/products/

metaio1

  • Cliquez sur l’onglet « SDK » en haut à gauche

metaio2

  • Ici, complétez avec votre nom, prénom et adresse email (obligatoire pour télécharger le logiciel)

metaio3Sur cette page il ne vous restera plus qu’à cliquer sur le bouton « Download » qui vous téléchargera une archive ZIP contenant un fichier .exe (Windows) et un fichier .dmg (Mac)

2. Installation de metaioSDK

Maintenant que le fichier est téléchargé, il va falloir l’exécuter (selon votre OS)

Dans l’exemple ci-dessous, nous utiliserons le .exe puisque nous allons installer sous Windows.

  • Double-cliquez sur « metaioSDK_4.1.2_Windows.exe »

metaio4

  • « Next »
  • Acceptez les conditions d’utilisation puis « Next »

metaio5

  • Choisissez le dossier de destination pour l’installation metaio SDK

metaio6

  • Lancez l’installation en cliquant sur « Install »

metaio7

  • Attendez que l’installation se termine et cliquez sur « Finish »

Ci-dessous, les fichiers générés lors de l’installation et qui nous serviront à l’utilisation et aux tests de metaio :

metaio8

3. Importation du metaioSDK dans Eclipse

Metaio propose de tester leurs exemples en ajoutant le SDK et un projet d’exemple à l’environnement Eclipse. Dans cette étape, nous allons importer le « metaioSDK ».

Pour commencer, démarrez Eclipse.

metaio9

Dans le panneau de gauche « Package Explorer », faites un clic droit puis :

  • « New »
  • « Project »
  • « Android » à « Android Application Project »

metaio10

Après avoir cliqué sur le bouton « Browse… », allez chercher le metaioSDK qui se trouve sous :

  • <Votre dossier d’installation metaioSDK> /SDK_Android/metaioSDK

metaio11

  • Cliquez sur « Finish »

Vous devriez avoir un nouveau projet intitulé « metaioSDK » avec l’arborescence suivante :

metaio12

4. Importation d’un projet d’exemple dans Eclipse

Nous allons maintenant tester la première application de réalité augmentée proposée par Metaio.

Pour ça, nous allons devoir ajouter un nouveau projet à notre environnement Eclipse :

Dans le panneau de gauche « Package Explorer », faites un clic droit puis :

  • « New »
  • « Project »
  • « Android » à « Android Application Project »

metaio10

Après avoir cliqué sur le bouton « Browse… », allez chercher le projet d’exemple qui se trouve sous :

  • <Votre dossier d’installation metaioSDK> /SDK_Android/Example

metaio13

 

Vous disposez maintenant d’un un nouveau projet intitulé « SDK_Example ».

A partir de là vous pouvez brancher votre smartphone, lancer l’application “SDK_Example” et tester leurs différents tutoriels!