Using Maven to build Java & Android program

Preview:

Click to see full reader

DESCRIPTION

 

Citation preview

Using Maven to build Java & Android program

Kewang

2

Install Maven

● Download from [HERE](http://maven.apache.org/download.cgi)– Or apt-get / yum / brew ......

● Add env.– M2_HOME=/opt/maven– M2=$M2_HOME/bin

● Run mvn --version– verify mvn is installed correctly.

http://maven.apache.org/download.cgi

3

About me

● 王慕羣 (Kewang)● Skills

– Android– AWS (EC2, S3, DynamoDB)– Hadoop (HBase, MapReduce)– Node.js, Rails

● Company– Mitake Inc.

● Others– Google Play, GitHub, slideshare, Scribd

https://play.google.com/store/apps/developer?id=kewang
https://github.com/kewangtw
http://www.slideshare.net/kewang
http://zh.scribd.com/kewang

Maven

5

Maven's objectives

● Making the build process easy● Providing a uniform build system● Providing quality project information● Providing guidelines for best practices development● Allowing transparent migration to new features

6

Maven can manage ...

● Builds● Documentation● Reporting● Dependencies● SCMs● Releases● Distribution

7

Maven's concepts

● Project Object Model● Convention over Configuration (CoC)● Dependency management● Plugin-based architecture

8

Project Object Model

9

Project Object Model

<project> <modelVersion>4.0.0</modelVersion> <groupId>com.mycompany.app</groupId> <artifactId>my-app</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <name>my-app</name> <url>http://maven.apache.org</url> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> </dependencies></project>

10

Convention over Configuration

11

Convention over Configuration

<sourceDirectory>/tmp/tts/src</sourceDirectory><scriptSourceDirectory>/tmp/tts/src/main/scripts</scriptSourceDirectory><testSourceDirectory>/tmp/tts/src/test/java</testSourceDirectory><outputDirectory>/tmp/tts/target/classes</outputDirectory><testOutputDirectory>/tmp/tts/target/test-classes</testOutputDirectory><resources> <resource> <directory>/tmp/tts/src/main/resources</directory> </resource></resources><testResources> <testResource> <directory>/tmp/tts/src/test/resources</directory> </testResource></testResources>

mvn help:effective-pom

12

Convention over Configuration

<sourceDirectory>/tmp/tts/src</sourceDirectory><scriptSourceDirectory>/tmp/tts/src/main/scripts</scriptSourceDirectory><testSourceDirectory>/tmp/tts/src/test/java</testSourceDirectory><outputDirectory>/tmp/tts/target/classes</outputDirectory><testOutputDirectory>/tmp/tts/target/test-classes</testOutputDirectory><resources> <resource> <directory>/tmp/tts/src/main/resources</directory> </resource></resources><testResources> <testResource> <directory>/tmp/tts/src/test/resources</directory> </testResource></testResources>

mvn help:effective-pom

13

Dependency management

14

Dependency management

<dependencies> <dependency> <groupId>android</groupId> <artifactId>android</artifactId> <version>2.3.3_r2</version> <scope>provided</scope> </dependency></dependencies>

15

Dependency management

<dependencies> <dependency> <groupId>android</groupId> <artifactId>android</artifactId> <version>2.3.3_r2</version> <scope>provided</scope> </dependency> <dependency> <groupId>com.squareup.picasso</groupId> <artifactId>picasso</artifactId> <version>2.2.0</version> </dependency></dependencies>

16

Plugin-based architecture

17

Plugin-based architecture

<plugins> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>exec-maven-plugin</artifactId> <version>1.2.1</version> <configuration> <mainClass>com.mycompany.example.App</mainClass> </configuration> </plugin> <plugin> <artifactId>maven-compiler-plugin</artifactId> <version>3.0</version> <configuration> <source>1.6</source> <target>1.6</target> </configuration> </plugin></plugins>

Maven lifecycle & commands

19

Maven lifecycle

20

Maven commands

● mvn clean– Remove all previous build generated files.

● mvn compile– Compile the source code of the project.

● mvn test– Run tests using a suitable unit testing framework.

● mvn package– Package compiled code to distributable format.

● mvn install– Install the package into the local repository.

● mvn deploy– Copy the final package to the remote repository.

Build a simple Java project

22

Step by step

● Normalize directory structure● Write pom.xml● Run it

23

Normalize directory structure

24

Or maven-archetype-quickstart

mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

25

Write pom.xml

<project> <modelVersion>4.0.0</modelVersion> <groupId>com.mycompany.app</groupId> <artifactId>my-app</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <name>my-app</name> <url>http://maven.apache.org</url> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> </dependencies></project>

26

mvn clean compile

27

mvn clean compile

only compiled class

28

mvn clean package

29

mvn clean package

include test file, jar file...

but it can't run ...

31

mvn clean compile exec:java

<build> <plugins> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>exec-maven-plugin</artifactId> <version>1.2.1</version> <configuration> <mainClass>com.mycompany.example.App</mainClass> </configuration> </plugin> </plugins></build>

32

mvn clean compile exec:java

<build> <plugins> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>exec-maven-plugin</artifactId> <version>1.2.1</version> <configuration> <mainClass>com.mycompany.example.App</mainClass> </configuration> </plugin> </plugins></build>

remember assign <mainClass/>

Live DEMO

Apply Maven to Android

35

Project directory structure

36

Step by step

● Install Android SDK● Run Maven Android SDK Deployer● Write pom.xml● Run it

37

Install Android SDK, at least ...

● All versions SDK Platform● All versions Google APIs● All Extra items (including obsoleted)● Glass Development Kit Sneak Peek

38

Run Maven Android SDK Deployer

● Checkout mosabua/maven-android-sdk-deployer● mvn install

https://github.com/mosabua/maven-android-sdk-deployer

39

Run Maven Android SDK Deployer

● Checkout mosabua/maven-android-sdk-deployer● mvn install

copy all jar files to maven repository

https://github.com/mosabua/maven-android-sdk-deployer

40

Use Android libraries like ...

<dependency> <groupId>android</groupId> <artifactId>android</artifactId> <version>4.4_r1</version> <scope>provided</scope></dependency>

41

Use Android libraries like ...

<dependency> <groupId>android</groupId> <artifactId>android</artifactId> <version>4.4_r1</version> <scope>provided</scope></dependency>

"provided" stands for only compile, not package itself

42

Use Android libraries like ...

<dependency> <groupId>com.google.android.maps</groupId> <artifactId>maps</artifactId> <version>19_r1</version> <scope>provided</scope></dependency>

43

Use Android libraries like ...

<dependency> <groupId>android.support</groupId> <artifactId>compatibility-v13</artifactId> <version>19.0.1</version></dependency>

Write pom.xml

45

<project> tags

<packaging>apk</packaging>

46

<dependencies> tags

<dependency> <groupId>android</groupId> <artifactId>android</artifactId> <version>4.0_r3</version> <scope>provided</scope></dependency><dependency> <groupId>android.support</groupId> <artifactId>compatibility-v4</artifactId> <version>19.0.1</version></dependency>

47

<plugins> tags

<plugin> <groupId>com.jayway.maven.plugins.android.generation2</groupId> <artifactId>android-maven-plugin</artifactId> <version>3.8.1</version> <extensions>true</extensions> <configuration> <sdk> <platform>14</platform> </sdk> </configuration></plugin>

48

mvn clean package

49

mvn clean package

generates R.java

50

mvn android:deploy android:run

● mvn android:deploy– Install app to device

● mvn android:run– Run app at device

Live DEMO

52

android-maven-plugin FAQ

53

android-maven-plugin FAQ

● No Android SDK path could be found.

54

android-maven-plugin FAQ

● No Android SDK path could be found.– no ANDROID_HOME env., or value is incorrect

● set ANDROID_HOME env. to Android SDK path

55

android-maven-plugin FAQ

● No Android SDK path could be found.– no ANDROID_HOME env., or value is incorrect

● set ANDROID_HOME env. to Android SDK path

● Unknown packaging: apk

56

android-maven-plugin FAQ

● No Android SDK path could be found.– no ANDROID_HOME env., or value is incorrect

● set ANDROID_HOME env. to Android SDK path

● Unknown packaging: apk– no extensions tag, or value is not "true"

● <extensions>true</extensions>

57

android-maven-plugin FAQ

● No Android SDK path could be found.– no ANDROID_HOME env., or value is incorrect

● set ANDROID_HOME env. to Android SDK path

● Unknown packaging: apk– no extensions tag, or value is not "true"

● <extensions>true</extensions>

● package R does not exist

58

android-maven-plugin FAQ

● No Android SDK path could be found.– no ANDROID_HOME env., or value is incorrect

● set ANDROID_HOME env. to Android SDK path

● Unknown packaging: apk– no extensions tag, or value is not "true"

● <extensions>true</extensions>

● package R does not exist– <packaging>jar</packaging>

● <packaging>apk</packaging>

59

android-maven-plugin FAQ

● No Android SDK path could be found.– no ANDROID_HOME env., or value is incorrect

● set ANDROID_HOME env. to Android SDK path

● Unknown packaging: apk– no extensions tag, or value is not "true"

● <extensions>true</extensions>

● package R does not exist– <packaging>jar</packaging>

● <packaging>apk</packaging>

● Ill-advised or mistaken usage of a core class

60

android-maven-plugin FAQ

● No Android SDK path could be found.– no ANDROID_HOME env., or value is incorrect

● set ANDROID_HOME env. to Android SDK path

● Unknown packaging: apk– no extensions tag, or value is not "true"

● <extensions>true</extensions>

● package R does not exist– <packaging>jar</packaging>

● <packaging>apk</packaging>

● Ill-advised or mistaken usage of a core class– no scope tag, or value is not "provided"

● <scope>provided</scope>

Eclipse tipsIMPORTANT !!!

62

Tips - How to use src folder ?

63

Tips - How to use src folder ?

<build> <sourceDirectory>src</sourceDirectory></build>

64

Tips - How to use libs folder ?

65

Tips - How to use libs folder ?

● mvn install:install-file– -Dfile=<path-to-file>– -DgroupId=<group-id>– -DartifactId=<artifact-id>– -Dversion=<version>– -Dpackaging=jar

66

Tips - How to use libs folder ?

● mvn install:install-file– -Dfile=<path-to-file>– -DgroupId=<group-id>– -DartifactId=<artifact-id>– -Dversion=<version>– -Dpackaging=jar

● mvn install:install-file -Dfile=flappybird.jar -DgroupId=tw.kewang -DartifactId=flappybird -Dversion=1.0 -Dpackaging=jar

67

Tips - How to use libs folder ?

● mvn install:install-file– -Dfile=<path-to-file>– -DgroupId=<group-id>– -DartifactId=<artifact-id>– -Dversion=<version>– -Dpackaging=jar

● mvn install:install-file -Dfile=flappybird.jar -DgroupId=tw.kewang -DartifactId=flappybird -Dversion=1.0 -Dpackaging=jar

copy jar file to maven repository

68

Tips - How to use gen folder ?

69

Tips - How to use gen folder ?<plugin> <groupId>com.jayway.maven.plugins.android.generation2</groupId> <artifactId>android-maven-plugin</artifactId> <configuration> <genDirectory>gen</genDirectory> </configuration></plugin>

70

Tips - How to use gen folder ?<plugin> <groupId>com.jayway.maven.plugins.android.generation2</groupId> <artifactId>android-maven-plugin</artifactId> <configuration> <genDirectory>gen</genDirectory> </configuration></plugin>

<plugin> <artifactId>maven-clean-plugin</artifactId> <version>2.5</version> <configuration> <filesets> <fileset> <directory>gen</directory> </fileset> </filesets> </configuration></plugin>

71

Tips - How to use gen folder ?<plugin> <groupId>com.jayway.maven.plugins.android.generation2</groupId> <artifactId>android-maven-plugin</artifactId> <configuration> <genDirectory>gen</genDirectory> </configuration></plugin>

<plugin> <artifactId>maven-clean-plugin</artifactId> <version>2.5</version> <configuration> <filesets> <fileset> <directory>gen</directory> </fileset> </filesets> </configuration></plugin>

remember clean gen folder

72

Tips - How to clean bin folder ?

<plugin> <artifactId>maven-clean-plugin</artifactId> <version>2.5</version> <configuration> <filesets> <fileset> <directory>bin</directory> </fileset> </filesets> </configuration></plugin>

73

Tips - How to use library project ?

74

Tips - How to use library project ?

● Write pom.xml at library project as general Android project

75

Tips - How to use library project ?

● Write pom.xml at library project as general Android project

● mvn clean android:apklib– Apklib file includes src/main/java, libs & res directory

76

Tips - How to use library project ?

● Write pom.xml at library project as general Android project

● mvn clean android:apklib– Apklib file includes src/main/java, libs & res directory

● Use install goal to copy apklib to maven repository

77

Tips - How to use library project ?

● Write pom.xml at library project as general Android project

● mvn clean android:apklib– Apklib file includes src/main/java, libs & res directory

● Use install goal to copy apklib to maven repository● Add dependency at main project

<dependency> <groupId>tw.kewang.ui.captchaview</groupId> <artifactId>CaptchaView</artifactId> <version>1.0.0</version> <type>apklib</type></dependency>

78

Tips - How to use non-maven library ?

● Compress non-maven library to zip file

79

Tips - How to use non-maven library ?

● Compress non-maven library to zip file● Use install goal to copy zip to maven repository

– packaging=apklib

80

Tips - How to use non-maven library ?

● Compress non-maven library to zip file● Use install goal to copy zip to maven repository

– packaging=apklib● Add dependency at main project

<dependency> <groupId>tw.kewang.ui.captchaview</groupId> <artifactId>CaptchaView</artifactId> <version>1.0.0</version> <type>apklib</type></dependency>

Show Timegithub://kewangtw

https://github.com/kewangtw

82

Show Time - google-tts

tts.say(sentence, true, new OnFinishListener() { @Override public void onFinish() { Toast.makeText(this, sentence, Toast.LENGTH_SHORT).show(); }});

83

Show Time - map-controller

mc.startTrackMyLocation(new ChangeMyLocation() { @Override public void changed(GoogleMap map, Location location) { Log.d("TRACK", location.toString()); }});

mc.whenMapClick(new ClickCallback() { @Override public void clicked(GoogleMap map, LatLng latLng) { Log.d("CLICK", latLng.toString()); }});

84

Show Time - CaptchaView

captcha.setPattern("1234567890");captcha.setLength(6);captcha.refresh();

if (captcha.getCaptcha().equals(check)) { Log.d("CAPTCHA", "Success");} else { Log.d("CAPTCHA", "Fail");}

85

Show Time - tile<tw.kewang.tile.Tile> <tw.kewang.tile.TileGroup tile:maxCells="3" tile:x="450dp" tile:y="50dp" > <tw.kewang.tile.TileCell tile:x="50dp" tile:y="50dp" /> <tw.kewang.tile.TileCell tile:x="100dp" tile:y="150dp" /> </tw.kewang.tile.TileGroup></tw.kewang.tile.Tile>

tile2.setOnCellLongClickListener(new OnLongClickListener() { @Override public void onLongClick(TileGroup group, TileCell cell) { tile2.startDrag(); }});

86

References

● Apache Maven Project● Android Application Development with Maven● Android Maven Plugin● Maven Android SDK Deployer

http://maven.apache.org/
http://books.sonatype.com/mvnref-book/reference/android-dev.html
http://jayway.github.io/maven-android-plugin/
https://github.com/mosabua/maven-android-sdk-deployer

87

Recommended

Installing java, eclipse and maven
Education
Java pour android
Documents
Android Application Development with Maven - Sample Chapter
Documents
Migrating Java, Spring, Hibernate, and Maven …jo2220.free.fr/Docs/Autres/Prog/Beginning_Java_and_Flex_Migrating...Migrating Java, Spring, Hibernate, and Maven ... Migrating Java,
Documents
Java Day-2013 Maven Partii
Documents
Overview of Android Frameworks (Part 1) · Overview of Frameworks in Android & Java • Android & Java provide many frameworks, e.g. • Android • Android’s Activity framework
Documents
Java is evolving rapidly: Maven helps you staying on track
Software
Apache Maven and Android
Documents
Maven for building Java applications By Nalin De Zoysa
Documents
Apache Maven and Android at - simpligility · Apache Maven and Android at ... apk android:dex ... Robotium Like Selenium for Android Add dependency to pom.xml and start coding tests
Documents
Java 9 and the impact on Maven Projects (Devoxx 2016)
Technology
Modul Java Android
Documents
Open Source Android Development Tools · 2014-01-22 · Development Tools Build Tools Maven Android Plugin - Example deploy to multiple devices and run tests reuse of other Maven
Documents
Android&for&Java Developers OSCON2010 - O'Reilly Mediaassets.en.oreilly.com/1/event/45/Android for Java Developers... · Android&for&Java Developers OSCON2010. ... Trained over 1,000
Documents
android - OIO-Die Java-Experten von Trivadis-Schulung ... · Google Android - Google Mobile für Java Entwickler Android Werkzeuge • Android Emulator (emulator) • Dalvik Debug
Documents
Maven and Java Generics - cvut.cz · PDF fileMaven and Java Generics Jan Jusko jan.jusko@fel.cvut.cz 24.2.2014
Documents
API Android, Java
Documents
Apache Maven and Android at - simpligility
Documents
Spring, Mule, Maven: Lightweight SOA with Java (2) - Andrew Cooke
Documents
Java Maven Eclipse JSF Tutorial
Documents