Add build instructions for OpenJDK8 Windows 64-bit #857
+119
−13
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,5 +1,5 @@ | ||
| <!-- | ||
| Copyright (c) 2017, 2018 IBM Corp. and others | ||
|
|
||
| This program and the accompanying materials are made available under | ||
| the terms of the Eclipse Public License 2.0 which accompanies this | ||
|
|
@@ -17,7 +17,7 @@ OpenJDK Assembly Exception [2]. | |
| [1] https://www.gnu.org/software/classpath/license.html | ||
| [2] http://openjdk.java.net/legal/assembly-exception.html | ||
|
|
||
| SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 OR LicenseRef-GPL-2.0 WITH Assembly-exception | ||
| --> | ||
|
|
||
| Building OpenJDK Version 8 with OpenJ9 | ||
|
|
@@ -167,19 +167,19 @@ make all | |
| :warning: If you just type `make`, rather than `make all` your build will fail, because the default `make` target is `exploded-image`. If you want to specify `make` instead of `make all`, you must add `--default-make-target=images` when you run the configure script. For more information, read this [issue](https://github.com/ibmruntimes/openj9-openjdk-jdk9/issues/34). | ||
|
|
||
| Two Java builds are produced: a full developer kit (jdk) and a runtime environment (jre) | ||
| - **build/linux-x86_64-normal-server-release/images/j2sdk-image** | ||
| - **build/linux-x86_64-normal-server-release/images/j2re-image** | ||
|
|
||
| :whale: If you built your binaries in a Docker container, copy the binaries to the containers **/root/hostdir** directory so that you can access them on your local system. You'll find them in the directory you set for `<host_directory>` when you started your Docker container. See [Setting up your build environment with Docker](#setting-up-your-build-environment-with-docker). | ||
|
|
||
| :pencil: On other architectures the **/j2sdk-image** and **/j2re-image** directories are in **build/linux-ppc64le-normal-server-release/images** (Linux on 64-bit Power systems) and **build/linux-s390x-normal-server-release/images** (Linux on 64-bit z Systems) | ||
|
|
||
| ### 5. Test | ||
| :penguin: | ||
| For a simple test, try running the `java -version` command. | ||
| Change to the **/j2re-image** directory: | ||
| ``` | ||
| cd build/linux-x86_64-normal-server-release/images/j2re-image | ||
| ``` | ||
| Run: | ||
| ``` | ||
|
|
@@ -270,18 +270,18 @@ make all | |
| :warning: If you just type `make`, rather than `make all` your build will fail, because the default `make` target is `exploded-image`. If you want to specify `make` instead of `make all`, you must add `--default-make-target=images` when you run the configure script. For more information, read this [issue](https://github.com/ibmruntimes/openj9-openjdk-jdk9/issues/34). | ||
|
|
||
| Two Java builds are produced: a full developer kit (jdk) and a runtime environment (jre) | ||
| - **build/aix-ppc64-normal-server-release/images/j2sdk-image** | ||
| - **build/aix-ppc64-normal-server-release/images/j2re-image** | ||
|
|
||
| :pencil: A JRE binary is not currently generated due to an OpenJDK bug. | ||
|
|
||
|
|
||
| ### 5. Test | ||
| :blue_book: | ||
| For a simple test, try running the `java -version` command. | ||
| Change to the **/j2sdk-image** directory: | ||
| ``` | ||
| cd build/aix-ppc64-normal-server-release/images/j2sdk-image | ||
| ``` | ||
| Run: | ||
| ``` | ||
|
|
@@ -304,9 +304,114 @@ OpenJDK - 27f5b8f based on jdk8u152-b03) | |
|
|
||
| ## Windows | ||
| :ledger: | ||
| The following instructions guide you through the process of building a Windows 64-bit OpenJDK V8 binary that contains Eclipse OpenJ9. This process can be used to build binaries for Windows 7, 8, and 10. | ||
|
|
||
| ### 1. Prepare your system | ||
| :ledger: | ||
| You must install a number of software dependencies to create a suitable build environment on your system: | ||
|
|
||
| - [Cygwin for 64-bit versions of Windows](https://cygwin.com/install.html), which provides a Unix-style command line interface. Install all packages in the `Devel` category. In the `Archive` category, install the packages `zip`, `unzip`, and `cpio`. Install any further package dependencies that are identified by the installer. More information about using Cygwin can be found [here](https://cygwin.com/docs.html). | ||
| - [Windows JDK 7](http://www.oracle.com/technetwork/java/javase/downloads/java-archive-downloads-javase7-521261.html), which is used as the boot JDK. | ||
| - [Windows SDK 7 Debugging tools](https://www.microsoft.com/download/confirmation.aspx?id=8279). | ||
| - [Microsoft Visual Studio Professional 2010](https://www.visualstudio.com/vs/older-downloads/). | ||
| - [Microsoft Visual Studio 2010 Service Pack 1](https://support.microsoft.com/en-us/help/983509/description-of-visual-studio-2010-service-pack-1) | ||
| - [Freemarker V2.3.8](https://sourceforge.net/projects/freemarker/files/freemarker/2.3.8/freemarker-2.3.8.tar.gz/download) | ||
| - [Freetype2 V2.3 or newer](https://www.freetype.org/download.html) | ||
|
|
||
| Update your `LIB` and `INCLUDE` environment variables to provide a path to the Windows debugging tools with the following commands: | ||
|
|
||
| ``` | ||
| set INCLUDE ="C:\Program Files\Debugging Tools for Windows (x64)\sdk\inc";%INCLUDE% | ||
| set LIB="C:\Program Files\Debugging Tools for Windows (x64)\sdk\lib";%LIB%; | ||
| ``` | ||
|
|
||
| You can download Freemarker and Freetype manually or obtain them using the [wget](http://www.gnu.org/software/wget/faq.html#download) utility. If you choose to use `wget`, follow these steps: | ||
|
|
||
| - Open a cygwin64 terminal and change to the `/temp` directory: | ||
| ``` | ||
| cd /cygdrive/c/temp | ||
| ``` | ||
|
|
||
| - Run the following commands: | ||
| ``` | ||
| wget https://sourceforge.net/projects/freemarker/files/freemarker/2.3.8/freemarker-2.3.8.tar.gz/download -O freemarker.tgz | ||
| wget http://download.savannah.gnu.org/releases/freetype/freetype-2.5.3.tar.gz | ||
| ``` | ||
|
|
||
| - To unpack the Freemarker and Freetype compressed files, run: | ||
| ``` | ||
| tar -xzf freemarker.tgz freemarker-2.3.8/lib/freemarker.jar --strip=2 | ||
| tar --one-top-level=/cygdrive/c/temp/freetype --strip-components=1 -xzf freetype-2.5.3.tar.gz | ||
| ``` | ||
|
|
||
| - To build the Freetype dynamic and static libraries, open the Visual Studio Command Prompt (VS2010) (see C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Microsoft Visual Studio 2010\Visual Studio Tools) and run: | ||
| ``` | ||
| cd c:\temp | ||
| msbuild.exe C:/temp/freetype/builds/windows/vc2010/freetype.vcxproj /p:PlatformToolset=v100 /p:Configuration="Release Multithreaded" /p:Platform=x64 /p:ConfigurationType=DynamicLibrary /p:TargetName=freetype /p:OutDir="C:/temp/freetype/lib64/" /p:IntDir="C:/temp/freetype/obj64/" > freetype.log | ||
| msbuild.exe C:/temp/freetype/builds/windows/vc2010/freetype.vcxproj /p:PlatformToolset=v100 /p:Configuration="Release Multithreaded" /p:Platform=x64 /p:ConfigurationType=StaticLibrary /p:TargetName=freetype /p:OutDir="C:/temp/freetype/lib64/" /p:IntDir="C:/temp/freetype/obj64/" >> freetype.log | ||
| ``` | ||
|
There was a problem hiding this comment. I noticed that this is how OpenJDK9 builds freetype as well, but it doesn't really do what was intended. This is building both a dynamic library and a static library, and later linking against the static library; the DLL is completely unused. The intention seems to be to build a DLL and the corresponding import library, not a static library. The MSVC linker produces import libraries for DLLs automatically when DLLs export things, but this version of freetype doesn't export any symbols. Looks like it's fixed in later versions and the public API is declared with There was a problem hiding this comment. Hi @ymanton. The build process has moved from using VisualStudio to mingw, which would change this part, but I've yet to get input on how mingw builds the Freetype stuff. There's more discussion in the pull request. There was a problem hiding this comment. The build process did not move from using VisualStudio to mingw. The build still uses VisualStudio but mingw must be present because its used to compile ~3 files. There was a problem hiding this comment. @ymanton do the instructions work, even if not perfect, or are changes to the instructions required to make it work? There was a problem hiding this comment. Aside from the quotes issue mentioned above that should be changed, yes they work. There's a bug in the OMR build files that bit me, but it depends on what your |
||
| :pencil: Check the `freetype.log` for errors. | ||
|
|
||
| ### 2. Get the source | ||
| :ledger: | ||
| First you need to clone the Extensions for OpenJDK for OpenJ9 project. This repository is a git mirror of OpenJDK without the HotSpot JVM, but with an **openj9** branch that contains a few necessary patches. | ||
|
|
||
| Run the following command in the Cygwin terminal: | ||
| ``` | ||
| git clone https://github.com/ibmruntimes/openj9-openjdk-jdk8 | ||
| ``` | ||
| Cloning this repository can take a while because OpenJDK is a large project! When the process is complete, change directory into the cloned repository: | ||
| ``` | ||
| cd openj9-openjdk-jdk8 | ||
| ``` | ||
| Now fetch additional sources from the Eclipse OpenJ9 project and its clone of Eclipse OMR: | ||
|
|
||
| ``` | ||
| bash ./get_source.sh | ||
| ``` | ||
| ### 3. Configure | ||
| :ledger: | ||
| When you have all the source files that you need, run the configure script, which detects how to build in the current build environment. | ||
| ``` | ||
| bash configure --disable-ccache --with-boot-jdk=/cygdrive/c/temp/jdk7 --with-freemarker-jar=/cygdrive/c/temp/freemarker.jar --with-freetype-include=/cygdrive/c/temp/freetype/include --with-freetype-lib=/cygdrive/c/temp/freetype/lib64 | ||
| ``` | ||
|
|
||
| :pencil: Modify the paths for freemarker and freetype if you manually downloaded and unpacked these dependencies into different directories. | ||
|
|
||
| ### 4. build | ||
| :ledger: | ||
| Now you're ready to build OpenJDK with OpenJ9: | ||
| ``` | ||
| make all | ||
| ``` | ||
|
|
||
| Two Java builds are produced: a full developer kit (jdk) and a runtime environment (jre) | ||
| - **build/windows-x86_64-normal-server-release/images/j2sdk-image** | ||
| - **build/windows-x86_64-normal-server-release/images/j2re-image** | ||
|
|
||
| ### 5. Test | ||
| :ledger: | ||
| For a simple test, try running the `java -version` command. | ||
| Change to the **/j2sdk-image** directory: | ||
| ``` | ||
| cd build/windows-x86_64-normal-server-release/images/j2sdk-image | ||
| ``` | ||
| Run: | ||
| ``` | ||
| ./bin/java -version | ||
| ``` | ||
|
|
||
| Here is some sample output: | ||
|
|
||
| ``` | ||
| OpenJDK Runtime Environment (build 1.8.0-internal-Administrator_2017_12_14_15_20-b00) | ||
| Eclipse OpenJ9 VM (build 2.9, JRE 1.8.0 Windows 10 amd64-64 Compressed References 20171214_000000 (JIT enabled, AOT enabled) | ||
| OpenJ9 - b8ac7e1747 | ||
| OMR - 101e793f | ||
| OpenJDK - 2597cd5c6f based on jdk8u152-b16) | ||
| ``` | ||
|
|
||
| :ledger: *Congratulations!* :tada: | ||
|
|
||
| ---------------------------------- | ||
|
|
||
|
|
||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
When I tried to follow these instructions having quotes here, either around just the path being prepended or around the whole thing made OpenJDK's
configurefail. Getting rid of the quotes made it happy.