Page History

Goals

• See main project page: http://openjdk.java.net/projects/macosx-port/

• 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.77.3 Lion
• Xcode Command Line Tools

• Mercurial: Xcode: 3.2.6 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 4" or later from http://connect.apple.com (Java section)Mercurial: http://mercurial.berkwood.com/
  • 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: http://openjdk.java.net/jtreg/

...

1. Get the code

hg clone http://hg.openjdk.java.net/macosx-port/macosx-portjdk8/jdk8
cd macosx-portjdk8
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 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-bundle/1.7.0.jdk/Contents/Homeimage/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 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 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.