- Apple Mac OS X system
- Latest version of Xcode
- Apache Maven
- (Recommended but not required) Google Protocol Buffer source
To build from a command-line in a Terminal window, run:
# Build just the translator and libraries
# Build the full distribution (including frameworks)
# Build the protocol buffer compiler and runtime for J2ObjC
# Build everything that is included in the project's distribution bundles
Optional Setup for Protocol Buffers
The J2ObjC Protocol Buffers compiler and runtime require that Protocol Buffers 3.3.0 be installed:
- Download the source code from the Protocol Buffers 3.3.0 release.
- Follow the C++ installation instructions from the README. Pay attention to the
--prefixoption to specify your install location.
- Define the
PROTOBUF_ROOT_DIRenvironment variable to point to your Protocol Buffers install location.
To test from a command-line in a Terminal window, run:
# Run translator and library unit tests
# Run all unit tests, including for protocol buffers
Cleaning/Resetting a Build
# Remove all files generated by the build
The J2ObjC build supports parallel builds, which are specified using the
-j<n> flag, where n is
the maximum number of concurrent tasks. The maximum depends on how fast/powerful your system is; we
suggest starting with
-j4. Increase the number to shorten build times if your system can handle
it, and decrease it if make fails with system errors.