Field Detail

• protected boolean finalConfigured

• protected NativeCompilation nativeCompilation

• protected final org.gradle.api.Project project

Property Detail

• boolean UNSAFE_incrementalBuildClosure

• boolean autoConfigureDeps

  Experimental functionality to automatically configure dependencies. Consider you have dependencies like:

   dependencies {
       compile project(':peer1')                  // type (1)
       compile 'com.google.code.gson:gson:2.3.1'  // type (3)
       compile 'com.google.guava:guava:18.0'      // type (2)
       testCompile 'junit:junit:4.11'             // type (2)
   }
   

  Project dependencies (1) will be added as a `j2objcLink` dependency. Libraries already included in j2objc (2) will be ignored. External libraries in Maven (3) will be added in source JAR form to `j2objcTranslate`, and translated using `--build-closure`. Dependencies must be fully specified before you call finalConfigure().

  This will become the default when stable in future releases.

• java.util.List<java.lang.String> cycleFinderArgs

  Command line arguments for j2objc cycle_finder.

  A list of all possible arguments can be found here: http://j2objc.org/docs/cycle_finder.html

• int cycleFinderExpectedCycles

  Expected number of cycles, defaults to all those found in JRE.

  This is an exact number rather than minimum as any change is significant.

• java.lang.String destLibDir

  Where to assemble generated main libraries.

  Defaults to $buildDir/j2objcOutputs/lib

• java.lang.String destSrcMainDir

  Where to assemble generated main source and resources files.

  Defaults to $buildDir/j2objcOutputs/src/main/objc

• java.lang.String destSrcTestDir

  Where to assemble generated test source and resources files.

  Can be the same directory as destDir Defaults to $buildDir/j2objcOutputs/src/test/objc

• java.lang.String[] extraLinkerArgs

  Additional arguments to pass to the native linker.

• java.util.List<java.util.Map> extraNativeLibs

  Additional native libraries to link to.

• java.lang.String[] extraObjcCompilerArgs

  Additional arguments to pass to the native compiler.

• java.lang.String[] extraObjcSrcDirs

  Directories of Objective-C source to compile in addition to the translated source.

• boolean filenameCollisionCheck

  Makes sure that the translated filenames don't collide.

  Recommended if you choose to use --no-package-directories.

• java.util.List<java.lang.String> generatedSourceDirs

  Generated source files directories, e.g. from dagger annotations.

  The plugin will ignore changes in this directory so they must be limited to files generated solely from files within your main and/or test sourceSets.

• java.util.List<java.lang.String> linkJ2objcLibs

  Additional native libraries that are part of the j2objc distribution.

  For example:

   linkJ2objcLibs = ["guava", "jsr305"]
   

• java.util.List<java.lang.String> supportedArchs

  Which architectures will be built and supported in packed ('fat') libraries.

  The three ios_arm* architectures are for iPhone and iPad devices, while ios_i386 and ios_x86_64 are for their simulators.

  By default, only common modern iOS architectures will be built: ios_arm64, ios_armv7, ios_x86_64. You may choose to add any of the remaining entries from NativeCompilation.ALL_SUPPORTED_ARCHS (ios_i386 and ios_armv7s) to support all possible iOS architectures. Listing any new architectures outside of ALL_SUPPORTED_ARCHS will fail the build.

  Removing an architecture here will cause that architecture not to be built and corresponding gradle tasks to not be created.

   supportedArchs = ['ios_arm64']  // Only build libraries for 64-bit iOS devices
   

  The options are:
  • 'ios_arm64' => iPhone 5S, 6, 6 Plus
  • 'ios_armv7' => iPhone 4, 4S, 5
  • 'ios_i386' => iOS Simulator on 32-bit OS X
  • 'ios_x86_64' => iOS Simulator on 64-bit OS X

  See Also:

  NativeCompilation.ALL_SUPPORTED_ARCHS

• java.util.List<java.lang.String> testArgs

  Command line arguments for j2objcTest task.

• int testMinExpectedTests

  j2objcTest will fail if it runs less than the expected number of tests; set to 0 to disable.

  It is a minimum so adding a unit test doesn't break the j2objc build.

• org.gradle.api.tasks.util.PatternSet testPattern

  Filter on files to test. Note this has no effect on which tests are translated, just which tests are executed by the j2objcTest task.

  If no pattern is specified, all files within the 'test' sourceSet are translated.

  This filter is applied on top of all files within the 'main' and 'test' java sourceSets. Use testPattern(groovy.lang.Closure) to configure.

• java.util.List<java.lang.String> translateArgs

  Command line arguments for j2objc translate.

  A list of all possible arguments can be found here: http://j2objc.org/docs/j2objc.html

• java.util.List<java.lang.String> translateClasspaths

  Local jars for translation e.g.: "lib/json-20140107.jar", "lib/somelib.jar". This will be added to j2objc as a '-classpath' argument.

• java.util.List<java.lang.String> translateJ2objcLibs

  Additional Java libraries that are part of the j2objc distribution.

  For example:

   translateJ2objcLibs = ["j2objc_junit.jar", "jre_emul.jar"]
   

• boolean translateOnlyMode

  True iff only translation (and cycle finding, if applicable) should be attempted, skipping all compilation, linking, and testing tasks.

• org.gradle.api.tasks.util.PatternSet translatePattern

  Sets the filter on files to translate.

  If no pattern is specified, all files within the sourceSets are translated.

  This filter is applied on top of all files within the 'main' and 'test' java sourceSets. Use translatePattern(groovy.lang.Closure) to configure.

• java.util.Map<java.lang.String, java.lang.String> translateSourceMapping

  A mapping from source file names (in the project Java sourcesets) to alternate source files. Both before and after names (keys and values) are evaluated using project.file(...).

  Mappings can be used to have completely different implementations in your Java jar vs. your Objective-C library. This can be especially useful when compiling a third-party library and you need to provide non-trivial OCNI implementations in Objective-C.

• java.util.List<java.lang.String> translateSourcepaths

  Source jars for translation e.g.: "lib/json-20140107-sources.jar"

• java.lang.String xcodeProjectDir

  Directory of the target Xcode project. Suggested location is '../ios' See J2ObjC Plugin Folder Structure

• java.lang.String xcodeTarget

  Xcode app target the generated library should be linked to. This will automatically add linkage for any target that starts with the same name. This should include any Test and Watch targets. For the example of xcodeTarget == 'IOS-APP', it will add targets for 'IOS-APPTests', 'IOS-APP WatchKit App' & 'IOS-APP WatchKit Extension' (if they exist).

Constructor Detail

• J2objcConfig(org.gradle.api.Project project)

Method Detail

• @com.google.common.annotations.VisibleForTesting static void appendArgs(java.util.List<java.lang.String> listArgs, java.lang.String nameArgs, java.lang.String... args)

• protected void configureNativeCompilation()

• protected void configureTaskState()

• protected void convertDeps()

• void cycleFinderArgs(java.lang.String... cycleFinderArgs)

  Add command line arguments for j2objc cycle_finder.

  A list of all possible arguments can be found here: http://j2objc.org/docs/cycle_finder.html

  Parameters:

  cycleFinderArgs - add args for 'cycle_finder' tool

• @java.lang.Deprecated void dependsOnJ2objcLib(java.lang.String beforeProjectName)

  deprecated:

  Use `dependencies { j2objcLinkage project(':beforeProjectName') }` or `autoConfigureDeps = true` instead.

  See Also:

  dependsOnJ2objcLib(org.gradle.api.Project)

• @groovy.transform.CompileStatic(TypeCheckingMode.SKIP) @java.lang.Deprecated void dependsOnJ2objcLib(org.gradle.api.Project beforeProject)

  Uses the generated headers and compiled j2objc libraries of the given project when compiling this project.

  Generally every cross-project 'compile' dependency should have a corresponding call to dependsOnJ2objcLib.

  It is safe to use this in conjunction with --build-closure.

  Do not also include beforeProject's java source or jar in the translateSourcepaths or translateClasspaths, respectively. Calling this method is preferable and sufficient.

  deprecated:

  Use `dependencies { j2objcLinkage project(':beforeProjectName') }` or `autoConfigureDeps=true` instead.

• void enableBuildClosure()

  Enables --build-closure, which translates classes referenced from the list of files passed for translation, using the translateSourcepaths.

• void extraLinkerArgs(java.lang.String... extraLinkerArgs)

  Add arguments to pass to the native linker.

  Parameters:

  extraLinkerArgs - add arguments to pass to the native linker.

• void extraNativeLib(java.util.Map spec)

  Add additional native library to link to.

  For example, if you built native library 'utils' in project 'common':

   extraNativeLib project: 'common', library: 'utils', linkage: 'static'
   

• void extraObjcCompilerArgs(java.lang.String... extraObjcCompilerArgs)

  Add arguments to pass to the native compiler.

  Parameters:

  extraObjcCompilerArgs - add arguments to pass to the native compiler.

• void extraObjcSrcDirs(java.lang.String... extraObjcSrcDirs)

  Add directories of Objective-C source to compile in addition to the translated source.

  Parameters:

  extraObjcSrcDirs - add directories for Objective-C source to be compiled

• @com.google.common.annotations.VisibleForTesting void finalConfigure()

  Configures the j2objc build. Must be called at the very end of your j2objcConfig block.

• static J2objcConfig from(org.gradle.api.Project project)

• void generatedSourceDirs(java.lang.String... generatedSourceDirs)

  Add generated source files directories, e.g. from dagger annotations.

  The plugin will ignore changes in this directory so they must be limited to files generated solely from files within your main and/or test sourceSets.

  Parameters:

  generatedSourceDirs - adds generated source directories for j2objc translate

• java.util.List<java.lang.String> getActiveArchs()

  An architecture is active if it is both supported (supportedArchs) and enabled in the current environment via the comma-separated j2objc.enabledArchs value in local.properties.

  If no j2objc.enabledArchs value is specified in local.properties, all supported architectures are also active, otherwise the intersection of supportedArchs and j2objc.enabledArchs is used.

• java.io.File getDestLibDirFile()

• java.io.File getDestSrcDirFile(java.lang.String sourceSetName, java.lang.String fileType)

• boolean isFinalConfigured()

• protected void resolveDeps()

• void testArgs(java.lang.String... testArgs)

  Add command line arguments for j2objcTest task.

  Parameters:

  testArgs - add args for the 'j2objcTest' task

• org.gradle.api.tasks.util.PatternSet testPattern(@groovy.lang.DelegatesTo(strategy = Closure.DELEGATE_FIRST, value = PatternSet) groovy.lang.Closure cl)

  Configures the testPattern

  Calling this method repeatedly further modifies the existing testPattern, and will create an empty testPattern if none exists.

  For example:

   translatePattern {
       exclude 'CannotTranslateFileTest.java'
       exclude '**/CannotTranslateDir/*.java'
       include '**/CannotTranslateDir/AnExceptionToIncludeTest.java'
   }
   

  See Also:

  Gradle User Guide

• @com.google.common.annotations.VisibleForTesting void testingOnlyPrepConfigurations()

• void translateArgs(java.lang.String... translateArgs)

  Add command line arguments for j2objc translate.

  A list of all possible arguments can be found here: http://j2objc.org/docs/j2objc.html

  Parameters:

  translateArgs - add args for the 'j2objc' tool

• void translateClasspaths(java.lang.String... translateClasspaths)

  Local jars for translation e.g.: "lib/json-20140107.jar", "lib/somelib.jar". This will be added to j2objc as a '-classpath' argument.

  Parameters:

  translateClasspaths - add libraries for -classpath argument

• org.gradle.api.tasks.util.PatternSet translatePattern(@groovy.lang.DelegatesTo(strategy = Closure.DELEGATE_FIRST, value = PatternSet) groovy.lang.Closure cl)

  Configures the translatePattern.

  Calling this method repeatedly further modifies the existing translatePattern, and will create an empty translatePattern if none exists.

  For example:

   translatePattern {
       exclude 'CannotTranslateFile.java'
       exclude '**/CannotTranslateDir/*.java'
       include '**/CannotTranslateDir/AnExceptionToInclude.java'
   }
   

  See Also:

  Gradle User Guide

• void translateSourceMapping(java.lang.String before, java.lang.String after)

  Adds a new source mapping.

  See Also:

  translateSourceMapping

• void translateSourcepaths(java.lang.String... translateSourcepaths)

  Source jars for translation e.g.: "lib/json-20140107-sources.jar"

  Parameters:

  translateSourcepaths - args add source jar for translation

• protected void validateConfiguration()

• @com.google.common.annotations.VisibleForTesting static void verifyNoSpaceArgs(java.lang.String nameArgs, java.lang.String... args)