Are the config options for the 'generation2' plugin documented?

1 view
Skip to first unread message

matthias

unread,
Nov 4, 2009, 10:18:35 AM11/4/09
to Maven Android Developers
There's certain config options supplied to the plugin in your sample
POM. Is there a reference for those already, or can someone give a
quick rundown of what you can specify there?

Thanks for this project guys, very cool.

Hugo Josefson

unread,
Nov 4, 2009, 10:31:28 AM11/4/09
to Maven Android Developers
Hi Matthias.

Yes, the plugin documentation is automatically generated from maven-
android-plugin source code whenever we perform a release. Maven
provides that :) You can find it via the Documentation page. There
should be a link labeled "Plugin goals reference". After following
that link, you should see the automatically generated documentation,
where all configuration parameters are on a separate page for each
goal.

Here is the Documentation page:
http://code.google.com/p/maven-android-plugin/wiki/Documentation

Thanks,
Hugo

matthias

unread,
Nov 4, 2009, 10:49:20 AM11/4/09
to Maven Android Developers
Hey Hugo,

what I actually meant was the configuration options you can pass to
the plugin tag in the POM, e.g.:

<build>
<!--<finalName>${artifactId}</finalName>-->
<plugins>
<plugin>
<groupId>com.jayway.maven.plugins.android.generation2</
groupId>
<artifactId>maven-android-plugin</artifactId>
<version>2.2.0</version>
<configuration>
<sdk>
<path>${env.ANDROID_HOME}</path>
<platform>1.5</platform>
</sdk>
<deleteConflictingFiles>true</
deleteConflictingFiles>
</configuration>
<extensions>true</extensions>
</plugin>

...
</plugins>
</build>

what does deleteConflictingFiles=true do for instance? What kind of
conflicts are we talking about?

Thanks!

Hugo Josefson

unread,
Nov 4, 2009, 12:12:18 PM11/4/09
to Maven Android Developers
Ah, the auto-generated plugin documentation page is not very easy to
read. Unfortunately, you would have to browse through all of its goals
to find all config parameters...

I found the particular config parameter <deleteConflictingFiles>
behind the link android:generate-sources, found on the auto-generated
plugin documentation page. Direct link:
http://maven-android-plugin-m2site.googlecode.com/svn/generate-sources-mojo.html

Basically, conflicts in this case refer to the R.java and similar
files which the Eclipse Android plugin (did?) create in the source
directory of the project. Come to think of it, it should probably not
be needed anymore, because it apparently creates those files in the
"gen" folder instead nowadays. It shouldn't cause any trouble being
left enabled though.

Thanks,
Hugo

matthias

unread,
Nov 4, 2009, 1:36:05 PM11/4/09
to Maven Android Developers
Hey cool, thanks!

I actually was about to post that I found a generic way of finding out
what parameters are there to each plugin goal:

mvn help:describe -
Dplugin=com.jayway.maven.plugins.android.generation2:maven-android-
plugin -Ddetail

the -Ddetail argument does the trick; it then lists all parameters
plus description for each goal, very cool.

Pretty weird tho that it says "Deprecated" for each and every goal and
parameter... I guess that's not actually true?

Cheers,
Matthias

On Nov 4, 6:12 pm, Hugo Josefson <h...@josefson.org> wrote:
> Ah, the auto-generated plugin documentation page is not very easy to
> read. Unfortunately, you would have to browse through all of its goals
> to find all config parameters...
>
> I found the particular config parameter <deleteConflictingFiles>
> behind the link android:generate-sources, found on the auto-generated
> plugin documentation page. Direct link:http://maven-android-plugin-m2site.googlecode.com/svn/generate-source...

Hugo Josefson

unread,
Nov 5, 2009, 2:44:37 AM11/5/09
to maven-androi...@googlegroups.com

Thanks for sharing that help tip. I didn't know :)

About the "deprecated" goals: it shouldn't be like that. Would you please file that as an Issue? Just so we don't forget to fix it sometime...

Thanks,
Hugo

On Nov 4, 2009 7:36 PM, "matthias" <m.kae...@googlemail.com> wrote:


Hey cool, thanks!

I actually was about to post that I found a generic way of finding out
what parameters are there to each plugin goal:

mvn help:describe -
Dplugin=com.jayway.maven.plugins.android.generation2:maven-android-
plugin -Ddetail

the -Ddetail argument does the trick; it then lists all parameters
plus description for each goal, very cool.

Pretty weird tho that it says "Deprecated" for each and every goal and
parameter... I guess that's not actually true?

Cheers,
Matthias

On Nov 4, 6:12 pm, Hugo Josefson <h...@josefson.org> wrote: > Ah, the auto-generated plugin documen...

> > Basically, conflicts in this case refer to the R.java and similar > files which the Eclipse Andr...

matthias

unread,
Nov 5, 2009, 3:48:18 PM11/5/09
to Maven Android Developers
sure thing, filed as issue 40:
http://code.google.com/p/maven-android-plugin/issues/detail?id=40

cheers,
Matthias

On Nov 5, 8:44 am, Hugo Josefson <h...@josefson.org> wrote:
> Thanks for sharing that help tip. I didn't know :)
>
> About the "deprecated" goals: it shouldn't be like that. Would you please
> file that as an Issue? Just so we don't forget to fix it sometime...
>
> Thanks,
> Hugo
>
Reply all
Reply to author
Forward
0 new messages