Mac OS X Port

In order to be able to edit pages in this wiki, please read the blog post explaining how to become an editor.

Goals

• Pass all appropriate certification tests for Java SE 7
• Include a complete, native Cocoa-based UI Toolkit
• Provide excellent performance
• Integrate into main-line OpenJDK 8

Minimum requirements to run

• An Intel Mac
• RAM: 2GB
• Mac OS X 10.7.2
  • Java for Mac OS X 10.7 Update 1

Note that only Mac OS X 10.7 will be an Oracle-supported platform. It should continue to run on 10.6.8 + Java for Mac OS X 10.6 Update 6 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
• Mac OS X 10.7.2
  • Xcode: 4.1 or later from the Mac App Store (free download)
  • Java for Mac OS X 10.7 Update 1 (open /Applications/Utilities/Java Preferences.app to trigger install)
• Mercurial: http://mercurial.berkwood.com/
• Jtreg: http://openjdk.java.net/jtreg/

1. Get the code

hg clone http://hg.openjdk.java.net/jdk7u/jdk7u-osx
cd jdk7u-osx
chmod 755 get_source.sh
./get_source.sh

2. Build

make ALLOW_DOWNLOADS=true SA_APPLE_BOOT_JAVA=true ALWAYS_PASS_TEST_GAMMA=true ALT_BOOTDIR=`/usr/libexec/java_home -v 1.6` HOTSPOT_BUILD_JOBS=`sysctl -n hw.ncpu`

• Steps for incremental building

3. Smoke Test

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

4. Install

mkdir -p ~/Library/Java/JavaVirtualMachines
cp -R build/macosx-universal/j2sdk-image/1.7.0.jdk ~/Library/Java/JavaVirtualMachines

5. Run

export JAVA_HOME=`/usr/libexec/java_home --version 1.7`
$JAVA_HOME/bin/java -version
$JAVA_HOME/bin/java -jar /Developer/Extras/Java/JFC/SwingSet2/SwingSet2.jar

On Mac OS X 10.7 use the alternate location for the SwingSet2.jar 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

TL;DR

1. Download an official or unofficial build
2. Open /Applications/Utilities/Java Preferences.app
3. Drag both "OpenJDK 7" entries to the top of the list
4. Run "java -version" in /Applications/Utilities/Terminal.app