Maven: The definitive Guide FR

L'exemple HelloFlashlight va nous servir de point de départ pour présenter le plugin Maven Android. Vous pouvez suivre les mêmes étapes pour utiliser le plugin Maven Android Plugin afin de construire vos applications Android. Une fois que votre environnement est correctement configuré (tel que nous venons de le décrire dans les paragraphes précédents), créez un nouveau projet Android en utilisant les Android Development Tools (ADT) http://developer.android.com/sdk/eclipse-adt.html.

Pour activer le build Maven d'un tel projet, ajoutez le fichier pom.xml ci-dessous dans le dossier principal de votre projet :

  <?xml version="1.0" encoding="UTF-8"?>
  <project xmlns="http://maven.apache.org/POM/4.0.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                               http://maven.apache.org/maven-v4_0_0.xsd">
      <modelVersion>4.0.0</modelVersion>
      <groupId>com.simpligility.android</groupId>
      <artifactId>helloflashlight</artifactId>
      <version>0.1-SNAPSHOT</version>
      <packaging>apk</packaging>
      <name>HelloFlashlight</name>

      <dependencies>
          <dependency>
              <groupId>android</groupId>
              <artifactId>android</artifactId>
              <version>2.1_r1</version>
              <scope>provided</scope>
          </dependency>
      </dependencies>

      <build>
          <sourceDirectory>src</sourceDirectory>
          <plugins>
              <plugin>
                  <groupId>
                    com.jayway.maven.plugins.android.generation2
                  </groupId>
                  <artifactId>maven-android-plugin</artifactId>
                  <version>2.2.3-SNAPSHOT</version>
                  <configuration>
                      <sdk>
                          <platform>2.1</platform>
                      </sdk>
                      <deleteConflictingFiles>
                        true
                      </deleteConflictingFiles>
                  </configuration>
                  <extensions>true</extensions>
              </plugin>
              <plugin>
                  <artifactId>maven-compiler-plugin</artifactId>
                  <configuration>
                      <source>1.5</source>
                      <target>1.5</target>
                  </configuration>
              </plugin>
          </plugins>
      </build>
  </project>
        

Veuillez noter les points suivants dans ce fichier pom.xml :

Le type de packaging apk permet d'activer le cycle de vie spécifique à Android. Il gère tous les appels aux outils du SDK Android pour traiter les ressources, convertir le bytecode Java, etc.

La dépendance vers le JAR de la plateforme doit utiliser la version de la cible telle qu'elle a été publiée dans le dépôt Maven par l'Android SDK Deployer. Il récupère les versions à partir des valeurs Platform.Version et Pkg.Revision renseignées dans le fichier de propriétés source.properties qui se trouve dans le dossier de la plateforme du SDK Android. Les valeurs possibles sont à ce jour : 1.1_r1, 1.5_r3, 1.6_r2, 2.0_r1, 2.0.1_r1 et 2.1_r1. Naviguez simplement dans votre dépôt pour connaître la liste exacte de ces versions.

La configuration du plugin Maven Compiler dans la balise build est nécessaire car Android utilise les fonctionnalités de Java 5 comme les annotations ou les boucles simplifiées. La configuration principale du plugin Maven Android est également effectuée dans la section build du fichier pom.xml, mais dans la plupart des cas, très peu de configuration est nécessaire.

Pour construire l'application et l'exécuter dans un émulateur déjà lancé, vous pouvez utiliser la commande

mvn clean install android:deploy

Le code de l'application d'exemple est disponible dans les maven-android-plugin-samples que vous trouverez à cette adresse : http://code.google.com/p/maven-android-plugin/wiki/Samples.