README.md

Ceylon language support for Android

This plugin adds support for writing Android applications using the Ceylon language.

This plugin is based on the excellent Groovy Android plugin and on ceylon-gradle-plugin.

Usage

Edit your build.gradle file with the following:

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.5.0'
        classpath 'com.redhat.ceylon.gradle:android:1.0.0'
    }
}

And your app/build.gradle file with:

apply plugin: 'com.android.application'
apply plugin: 'com.athaydes.ceylon'
apply plugin: 'com.redhat.ceylon.gradle.android'

android {
    // ...
    sourceSets {
        main.java.srcDirs += 'src/main/ceylon'
    }
    lintOptions {
        disable 'InvalidPackage' // lint sees references in the Ceylon jar to unavailable java classes
    }
}

ceylon {
    // Optional, needs to point to Ceylon 1.2.3+
    // ceylonLocation "/usr/bin/ceylon"
    module "com.my.module/1.0"
    // Optional: set to true if you have Maven dependencies with broken
    // descriptors or optional dependencies (which Gradle does not support),
    // which will typically cause the import-jar tasks to fail. This will
    // force the import by bypassing checks.
    // forceImports false
}

then use the build task to test.

Should you want to test development versions of the plugin, you can add the snapshot repository and depend on a SNAPSHOT:

buildscript {
    repositories {
        jcenter()
        maven {
            url = 'http://oss.jfrog.org/artifactory/oss-snapshot-local'
        }
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.5.0'
        classpath 'com.redhat.ceylon.gradle:android:0.0.1-SNAPSHOT'
    }
}

Where to put sources?

Ceylon sources may be placed in src/main/ceylon, src/test/ceylon, src/androidTest/ceylon and any src/${buildVariant}/ceylon configured buy default. A default project will have the release and debug variants but these can be configured with build types and flavors. See the android plugin docs for more about configuring different build variants.

Writing Ceylon code

This plugin has been successfully tested with Android Studio and will make no attempts to add support for other IDEs. This plugin will let you write an application in Ceylon.