README.md

Gradle IKVM Plugin

This plugin allows to compile the project jar into a .Net assembly using IKVM. It supports various IKVM flags, and also allows for .Net API documentation generation.

Main Features

• Command line wrapper around IKVM.
• Supports all IKVM flags.
• Easy way to include 3rd party DLLs into the build process.
• No need to install IKVM locally as it can be downloaded during the build process. Handy for CI Enviroments.
• Works also on Unix & Mac by using Mono.

Below tasks are provided by the plugin:

ikvm

This task depend on standard jar task, and builds the corresponding assembly. It can be configured by a usual gradle convention.

Simplest usage:

Build script snippet can be used in all Gradle versions:

buildscript {
    repositories {
        mavenCentral()
    }

    dependencies {
        classpath "com.ullink.gradle:gradle-ikvm-plugin:2.3"
    }
}

apply plugin:'java'
apply plugin:'ikvm'

repositories {
    mavenCentral()
}

Build script snippet can be used instead with Gradle 2.1+

plugins {
  id "com.ullink.ikvm" version "2.3"
}

More options:

// ikvmCompile allows to provide 3rd Party DLLs to the process (provided the dlls are available in some repository of yours)
dependencies {
    ikvmCompile group: 'foo', name: 'bar', version: '1.0', type: '.dll'
}

ikvm {
    // If defined, the plugin will use IKVM_HOME environment variable ...
    // ... otherwise it will download (& cache) Ikvm release zip from official download links (sourceforge & www.frijters.net) ...
    ikvmVersion = '7.2.4630.4'

    // ... but you can also specify the Ikvm folder yourself then this will be used.
    ikvmHome = '../ikvm-0.46.0.1'


    // Below values have sensible __defaults__ but can be overriden

    // Where will the assembly be generated
    destinationDir = jar.destinationDir

    // Assembly name
    assemblyName = project.name

    // Assembly version
    version = project.version

    // KeyFile for assembly signing
    keyFile = null

    // Generates PDB file for debugging purposes
    debug = true

    // Generates XML documentation file (from javadoc through custom DocLet)
    generateDoc = false

    // Whether to handle warnings as errors - not compatible with all IKVM versions
    // as it was introduced in IKVM 7. If necessary, use the code specific one
    warnAsError = true

    // Warning codes that should be considered as errors
    warnAsError = [105, 110, 120]

    // Other ikvmc options can be set:
    // fileVersion, target, main, classloader, delaySign, compressResources, removeAssertions, srcPath ...
}

Usage

When everything is setup correctly just run gradle ikvm.

ikvmDoc

This task extends standard javadoc task, and allows XML documentation to be generated for the assembly. It depends on ikvm task, and uses a custom DocLet to generate the documentation. Note: you can also have the documentation generated by ikvm task, using generateDoc = true.

Sample usage: either invoke gradle ikvmDoc or customize it:

task myDoc(type: IkvmDoc) {
    // customize javadoc options here
}

License

All these plugins are licensed under the Apache License, Version 2.0 with no warranty (expressed or implied) for any purpose.