This Maven plugin invokes
mtouch to build and deploy a MonoTouch project to the iOS
simulator or to a device. It was created to make life easier for PlayN projects, but there's
nothing particularly PlayN-specific about it.
The plugin provides two main goals, one to build and deploy to the simulator and one to build and
deploy to a device. The only required configuration for the plugin is the solution (or csproj).
Adding this in your
<plugin> <groupId>com.samskivert</groupId> <artifactId>monotouch-maven-plugin</artifactId> <version>1.1</version> <configuration> <solution>YOUR.sln</solution> </configuration> </plugin>
will allow you to deploy to device with this simple command line:
or to the simulator
Additional configuration will probably be needed such as the device family or launch orientation. This can be specified in the configuration for the plugin or overridden on the command line as needed.
For a complete description of all the options, look at the source or in the maven help:
mvn help:describe -Dplugin=com.samskivert:monotouch-maven-plugin -Ddetail
This plugin works nicely with ikvm-maven-plugin, which converts your Java code to a
package phase. Thus you can compile your Java code, convert it via IKVM, and then build and
test/deploy your MonoTouch project in a single Maven call, where X is deploy-sim or deploy-device:
mvn package monotouch:deploy-X
NOTE: in older versions, binding to a lifecycle phase was recommended. It is not necessary to do, but if desired, you can add something like this to the plugin tag:
<executions> <execution> <phase>integration-test</phase> <goals> <goal>deploy-sim</goal> </goals> </execution> </executions>
This will run the plugin on every integration test or anything after it in the lifecycle, so you'll almost certainly want to put this in a manually activated profile.
By default, launching to the simulator is done using
mtouch, but you can also use the
app, which is nicer because it sends stdout from your iOS app to stdout on the console (which
mtouch does not). You can enable the use of
ios-sim by providing the path to the
<configuration> <iossimPath>/usr/local/bin/ios-sim</iossimPath> </configuration>
It's also possible to use this plugin to compile and package ios bindings. Said package can then
be included in other ikvm projects. The configruation is similar to the other goals. The solution
or csproj file is required input. When adding the plugin to a bindings build, it is required to add
<extensions>true</extensions> in the body of the
monotouch-maven-plugin is released under the New BSD License, which can be found in the LICENSE file.