Skip to content
This plugin is no longer actively maintained. J2ObjC Gradle Plugin: enables Java source to be part of an iOS application's build so you can write an app's non-UI code (such as application logic and data models) in Java, which is then shared by Android apps (natively Java) and iOS apps (using J2ObjC), all as part of your usual Android Gradle build.
Groovy Swift Java Shell Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea Fix XcodeTask not being able to find podspec Jun 5, 2015
gradle/wrapper Embed BuildInfo in plugin. Aug 24, 2015
systemTests Merge pull request #434 from madvay/guava19rc1 Jan 12, 2016
.gitignore allPlatforms system test for Xcode and Android Studio Oct 21, 2015
AUTHORS Convert AUTHORS to NOTICE Aug 26, 2015 Changelog link to release page Jan 16, 2016 Customization of Xcode build configuration names Jan 22, 2016
NOTICE It is a new year! Jan 20, 2016 Build links fixed by replacing spaces with "%20" Mar 24, 2017
build.gradle v0.6.1-alpha-SNAPSHOT Jan 13, 2016 madvay -> j2objc-contrib Oct 29, 2015
gradlew Skeleton for empty Gradle plugin build, issue #55 Jun 3, 2015
gradlew.bat Initial AppVeyor CI config. Aug 24, 2015 Use JDK 7 on Travis on OS X Oct 7, 2015

Hey! We are looking for new developers to maintain the plugin. Let us know on j2objc-discuss if you are interested. Active development on this plugin is otherwise currently suspended.

J2ObjC Gradle Plugin

The J2ObjC Gradle plugin enables Java source to be part of an iOS application's build so you can write an app's non-UI code (such as application logic and data models) in Java, which is then shared by Android apps (natively Java) and iOS apps (using J2ObjC).

The plugin:

  • Translates your Java source code to Objective-C for iOS (iPhone/iPad) using J2ObjC, an open-source tool from Google
  • Builds Objective-C static libraries and headers ready-to-use in Xcode
  • Runs translated versions of your JUnit tests to ensure your code works in Objective-C form
  • Handles multiple Java projects, external Java libraries [1], and existing Objective-C code you'd like to link in
  • Configures Xcode projects to use your translated libraries, using CocoaPods (optionally)

The plugin is not affiliated with Google but was developed by former Google Engineers and others. Note that the plugin is currently in alpha; we may need to make breaking API changes before the 1.0 release.

License OSX and Linux Build Status Windows Build Status

Home Page:

Quick Start Guide

You should start with a clean Java only project without any Android dependencies. It is suggested that the project is named shared. It must be buildable using the standard Gradle Java plugin. Starting with an empty project allows you to gradually shift over code from an existing Android application. This is beneficial for separation between the application model and user interface. It also allows the shared project to be easily used server-side as well.

The Android app, shared Java project and Xcode project should be sibling directories, i.e children of the same root level folder. Suggested folder names are 'android', 'shared' and 'ios' respectively. See the FAQ section on recommended folder structure.

Configure shared/build.gradle for your Java-only project:

// File: shared/build.gradle
plugins {
    id 'java'
    id 'com.github.j2objccontrib.j2objcgradle' version '0.5.0-alpha'

dependencies {
    // Any libraries you depend on, like Guava or JUnit
    compile ''
    testCompile 'junit:junit:4.11'

// Plugin settings; put these at the bottom of the file.
j2objcConfig {
    // Sets up libraries you depend on
    autoConfigureDeps true
    // Omit these two lines if you don't configure your Xcode project with CocoaPods
    xcodeProjectDir '../ios'  //  suggested directory name
    xcodeTargetsIos 'IOS-APP', 'IOS-APPTests'  // replace with your iOS targets

    finalConfigure()          // Must be last call to configuration

Finally, make the Android application's android/build.gradle depend on the shared project:

// File: android/build.gradle
dependencies {
    compile project(':shared')

For more complex situations like:

, check the FAQ table of contents or see all of the j2objcConfig settings in J2objcConfig.groovy.

Minimum Requirements

The plugin requries modern versions of Gradle and J2ObjC, and assumes the J2ObjC Requirements:

  • Gradle 2.4
  • J2ObjC or higher
  • JDK 1.7 or higher
  • Mac workstation or laptop
  • Mac OS X 10.9 or higher
  • Xcode 7 or higher

Applications built with the plugin may target

  • iOS 6.0 or higher
  • OS X 10.6 or higher

J2ObjC Installation

If J2ObjC is not detected when the plugin is first run, on-screen instructons will guide you through installation from your Terminal.

Alternatively: Download the latest version from the J2ObjC Releases. Find (or add) the in your root folder and add the path to the unzipped folder:

# File:

Build Commands

The plugin will output the generated source and libaries to the build/j2objcOutputs directory, run all unit tests, and configure your Xcode project (if you specified one).

It is integrated with Gradle's Java build plugin and may be run as follows:

./gradlew shared:build


Having issues with the plugin? Please first check the Frequently Asked Questions.

Next, search the Issues for a similar problem. If your issue is not addressed, please file a new Issue, including the following details:

  • build.gradle file(s)
  • contents of Gradle build errors if any
  • version of J2ObjC you have installed

If you are not comfortable sharing these, the community may not be able to help as much. Please note your bug reports will be treated as "Contribution(s)" per the LICENSE.

Mozilla's Bug writing guidelines may be helpful. Having public, focused, and actionable Issues helps the maximum number of users and also lets the maximum number of people help you. Please do not email the authors directly.


Please see




This library is distributed under the Apache 2.0 license found in the LICENSE file. J2ObjC and libraries distributed with J2ObjC are under their own licenses.


[1] where source is appropriately licensed and available

You can’t perform that action at this time.