Skip to content
A Java to iOS Objective-C translation tool and runtime.
Java Objective-C C Makefile C++ Objective-C++ Other
Branch: master
Clone or download
j2objc-copybara and Copybara-Service Clean up potential unaligned reads issue due to use of OSRead*.
Also fixes issue where it appears that values where not actually being read in the fallback cases.

PiperOrigin-RevId: 270295379
Latest commit 6006d64 Sep 20, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
annotations Merge pull request #1047 from don-vip/patch-1 May 17, 2019
cycle_finder Change only for testing sync to repo. Aug 15, 2019
doc External annotations: promote flag -Xexternal-annotation-file to -ext… Jun 21, 2019
examples Change only for testing sync to repo. Aug 29, 2019
guava Project health: build guava with --swift-friendly. Jun 21, 2019
inject/javax_inject Merged compiler warnings build refs, added -Wmissing-field-initialize… Dec 14, 2015
java_deps Change only for testing sync to repo. Aug 15, 2019
jre_emul Rewrote initialization code to avoid null class or method names, Sep 18, 2019
jsr305 JDK 11: remove javax.annotation package from JRE. May 7, 2019
junit Change only for testing sync to repo. Aug 15, 2019
make Change only for testing sync to repo. Aug 15, 2019
protobuf Clean up potential unaligned reads issue due to use of OSRead*. Sep 20, 2019
scripts Change only for testing sync to repo. Aug 15, 2019
testing Change only for testing sync to repo. Aug 15, 2019
translator Keep reflection metadata for classes with JUnit 4 tests. Sep 5, 2019
tree_shaker Change only for testing sync to repo. Aug 15, 2019
xalan Android Q: add DuplicateFormatFlagsExceptionTest. Aug 15, 2019
.gitattributes Include git config files in public source. Jun 23, 2017
.gitignore Ignore IntelliJ IDEA files Dec 29, 2016
AUTHORS Deleted plain-text README. Feb 5, 2014
BUILD.dist Bazel support: add references to files needed when transpiling with J… Jul 15, 2019
CONTRIBUTING.md Updated README, added CONTRIBUTING page. Feb 5, 2014
INSTALL Update build requirements and tool links Dec 7, 2015
LICENSE java.time: adding classes with android.icu dependencies removed. Nov 19, 2018
Makefile Change only for testing sync to repo. Aug 15, 2019
README.md Fix a very small typo Jun 24, 2019
WORKSPACE.dist Bazel support: add rules_java repo to examples/Contacts/WORKSPACE. Jul 15, 2019

README.md

J2ObjC: Java to Objective-C Translator and Runtime

Project site: https://j2objc.org
J2ObjC blog: https://j2objc.blogspot.com
Questions and discussion: https://groups.google.com/group/j2objc-discuss

What J2ObjC Is

J2ObjC is an open-source command-line tool from Google that translates Java source code to Objective-C for the iOS (iPhone/iPad) platform. This tool enables Java source to be part of an iOS application's build, as no editing of the generated files is necessary. The goal is to write an app's non-UI code (such as application logic and data models) in Java, which is then shared by web apps (using GWT), Android apps, and iOS apps.

J2ObjC supports most Java language and runtime features required by client-side application developers, including exceptions, inner and anonymous classes, generic types, threads and reflection. JUnit test translation and execution is also supported.

J2ObjC is currently beta quality. Several Google projects rely on it, but when new projects first start working with it, they usually find new bugs to be fixed. If you run into issues with your project, please report them!

What J2ObjC isn't

J2ObjC does not provide any sort of platform-independent UI toolkit, nor are there any plans to do so in the future. We believe that iOS UI code needs to be written in Objective-C, Objective-C++ or Swift using Apple's iOS SDK (Android UIs using Android's API, web app UIs using GWT, etc.).

J2ObjC cannot convert Android binary applications. Developers must have source code for their Android app, which they either own or are licensed to use.

Requirements

  • JDK 1.8 or higher
  • Mac workstation or laptop
  • OS X 10.12 or higher
  • Xcode 8 or higher

License

This library is distributed under the Apache 2.0 license found in the LICENSE file. The protocol buffers library is distributed under the same BSD license as Google's protocol buffers. See its README and LICENSE.

Running on GNU/Linux

To build and run on GNU/Linux, install the Darling project, then following its Compile and Run a Program example. Please note that j2objc is only supported on iOS/macOS.

You can’t perform that action at this time.