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: 1GB2GB
• OS: Mac OS X 10.67.7 or laterJava: "Java for 3

Note that only Mac OS X 10

...

TL;DR

...

.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 ~jdk ~/Library/Java/JavaVirtualMachines

5. Run

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

Testing the Cocoa-based AWT

$JAVA_HOME/bin/java -jar /Developer/Extras/Java/JFC/SwingSet2/SwingSet2.jar

Iterative development of a particular module, AWT for example (avoid having to build whole JDK)

export JDK7_BASE=/Volumes/Data/src/JDK7/macosx-port
export JDK7_BUILD=$JDK7_BASE/build
export ALT_BOOTDIR=$JDK7_BUILD/macosx-universal/j2sdk-image/
export ALT_JDK_IMPORT_PATH=$JDK7_BUILD/macosx-universal/j2sdk-image/
export ALT_OUTPUTDIR=$JDK7_BUILD/macosx-universal
cd $JDK7_BASE/jdk/make/sun/awt/
make

Settting bootclasspath, DYLD_LIBRARY_PATH and debugging with your changes:

If you have the Java Developer Package installed:

compilation
export _JAVA_OPTIONS=-Xbootclasspath/p:$JDK7_BUILD/macosx-universal/classes/
export DYLD_LIBRARY_PATH=$JDK7_BUILD/macosx-universal/lib/

$JAVA_HOME/bin/java -jar /DeveloperLibrary/ExtrasJava/JavaDemos/JFC/SwingSet2/SwingSet2.jar

6. Test

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

Bugs!

File them at java.net/jira/browse/MACOSX_PORTnew 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 away!!

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