monotouch-maven-plugin
This Maven plugin invokes mdtool
and 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.
Usage
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 <build><plugins>
section:
<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:
mvn monotouch:deploy-device
or to the simulator
mvn monotouch:deploy-sim
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 .dll
during the 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 ios-sim
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 ios-sim
binary in <configuration>
:
<configuration>
<iossimPath>/usr/local/bin/ios-sim</iossimPath>
</configuration>
Advanced Usage
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 <plugin>
tag.
License
monotouch-maven-plugin is released under the New BSD License, which can be found in the LICENSE file.