Ce site met a disposition le build journalier de la traduction francaise du Maven: The Definitive Guide
Consultez :
  • Les documents de reference sur le projet original
  • Les sources de la traduction fr sur GitHub
  • maven


    14.3. Développement d'applications Android avec le plugin Maven Android

    14.3.1. Exemple HelloFlashlight

    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 :

    Exemple 14.3. Fichier pom.xml du projet HelloFlashlight

      <?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 est apk

    • la dépendance vers le jar de la plateforme Android cible

    • la configuration du build avec les plugins Maven Android et Compiler

    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.