Page History

Goals

• Pass all appropriate certification tests for Java SE 7
• Include a complete, native Cocoa-based UI Toolkit
  • DONE.
• Provide excellent performance
• Integrate into main-line OpenJDK 8 
  • DONE. OS X is now 'just another platform' in OpenJDK 8

Minimum requirements to run

• An Intel Mac
• RAM: 2GB
• Mac OS X 10.7.3

Note that only Mac OS X 10.7.3 and higher will be an Oracle-supported platform. It should continue to run on 10.6.8+ but that is not guaranteed. As of 1-Jan-2012 there are no plans to introduce 10.7-only APIs into the codebase.

Prerequisites to build

• Hardware: Any 64-bit capable Intel Mac
  • RAM: 4GB, 2GB min
• Minimum OS version: Mac OS X 10.6, run Software Update to get to at least 10.6.57.3 Lion
• Xcode Command Line Tools

• Mercurial: Xcode: 3.2.5 or later from http://developermercurial.appleberkwood.com (Mac Dev Center section)Java: "Java for Mac /

• X11
  • On OS X 10.8 Mountain Lion: XQuartz
  • On OS X 10.
  6 Update 3 Developer Package" or later from http://connect.apple.com (Java section)
  • 7 Lion: Run /Applications/Utilities/X11.app to install as an additional download

JTReg is not required to build but useful for running regression tests

• Jtreg:
• Mercurial: http://mercurial.berkwood.com/
• Jtreg: http://openjdk.java.net/jtreg/

Setup

...

1. Get the code

cd /tmp
hg clone http://bitbucket.org/pmezard/hgforest-crew/
cp hgforest-crew/forest.py ~/.forest.py

Add the following lines to your: ~/.hgrc

[extensions]
hgext.forest=~/.forest.py

Source

hg fclone http://hg.openjdk.java.net/macosx-port/macosx-port
cd macosx-port

Build

hg.openjdk.java.net/jdk8/jdk8
cd jdk8
chmod 755 get_source.sh
./get_source.sh

2. Build

CPATH="/usr/X11/include" LANG=C make ALLOW_DOWNLOADS=true ALT_BOOTDIR=`/usr/libexec/java_home -v 1.7+` HOTSPOT_BUILD_JOBS=`sysctl -n hw.ncpu`

CPATH="/usr/X11/include" LANG=C make

CC=/Developer/usr/bin/llvm-gcc-4.2 CXX=/Developer/usr/bin/llvm-g++-4.2 ALLOW_DOWNLOADS=true SA_APPLE_BOOT_JAVA=true ALWAYS_PASS_TEST_GAMMA=true ALT_BOOTDIR=`/usr/libexec/java_home -v 1.6` make

If you get errors warning about environmental variables that are set you can prefix the build command above unsetting these variables.

Example:

unset LC_ALL LANG CLASSPATH JAVA_HOME LD_LIBRARY_PATH; <command line to build JDK 1.7>

HOTSPOT_BUILD_JOBS=`sysctl -n hw.ncpu`

* Steps for incremental building

3. Smoke Test

$ build/macosx-universal/j2sdk-bundle/1.7.0.jdk/Contents/Home/image/bin/java -version

4. Install

mkdir -p ~/Library/Java/JavaVirtualMachines
cp -R build/macosx-universal/j2sdk-bundle/1jdk1.78.0.jdk ~/Library/Java/JavaVirtualMachines

jdk ~/Library/Java/JavaVirtualMachines

5. Run

export JAVA_HOME=`/usr/libexec/java_home home --version 1.7`7+`
$JAVA_HOME/bin/java -version

Test

jtreg is the test harness used by the OpenJDK test framework. The script linux/jtreg is a shell script that runs fine on Mac OS X. It will run all the tests under $SRC/jdk/.

By default jtreg will use the current jvm for running both the test harness and the tests themselves.

The examples below use the jtreg option -jdk to specify the JDK compiled in the macosx-port source directory.

Example: running all the jdk tests (takes a long time):

cd <path-to-macosx-port-source>/jdk/
<path to jtreg>/linux/bin/jtreg -jdk:../build/macosx-universal/j2sdk-bundle/1.7.0.jdk/Contents/Home/ -v:summary test

Example: running just the jdk java/lang tests (approximately 340 tests; completes in about 6 minutes):

cd <path-to-macosx-port-source>/jdk/
<path to jtreg>/linux/bin/jtreg -jdk:../build/macosx-universal/j2sdk-bundle/1.7.0.jdk/Contents/Home/ -v:summary test/java/lang

If you run jtreg by making a symbolic link to linux/jtreg in another directory already on your PATH you will need to export a JT_HOME environmental variable.

Caveats

If you have the Java Developer Package installed:

$JAVA_HOME/bin/java -jar /Library/Java/Demos/JFC/SwingSet2/SwingSet2.jar

6. Test

Download jtreg to run the tests in the /jdk/test directory.

Bugs!

File new bugs at http://bugreport.sun.com/bugreport/. Please check out the bug reporting guidelines if you haven't filed against the project before.

Questions?

Please join the macosx-port-dev mailing list and ask!

See something wrong on this page? Fix it!

• Join the web-discuss@openjdk.java.net mailing list
• Send an e-mail to the web-discuss@openjdk.java.net mailing list:
  • Request editor rights to the "OpenJDK Mac OS X Port" wiki
  • Include your Oracle SSO Username

 If your version of Xcode is older than 3.2.5, the 32-bit build won't run, but the 64-bit build will.