|
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
"http://www.FreeBSD.org/XML/share/xml/xhtml10-freebsd.dtd" [
<!ENTITY title "FreeBSD &java; Project">
<!ENTITY url.books "../../doc/en_US.ISO8859-1/books">
]>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>&title;</title>
<cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
</head>
<body class="navinclude.developers">
<a href="https://www.oracle.com/technetwork/java/index.html"><img src="j2j.gif" hspace="10"
border="0" alt="Jump to &java;" align="right"/></a>
<h2>Getting Java</h2>
<p>There are two choices of Java Development Kits on FreeBSD:</p>
<ul>
<li>
<h3>OpenJDK</h3>
<p>The &openjdk; project provides a native open-source
implementation of the &java; SE Platform. It is available for all
currently supported FreeBSD releases in the following combinations
of versions (by architecture):
</p>
<p><b>aarch64</b>: <code>openjdk8</code>, <code>openjdk11</code>, <code>openjdk12</code>, <code>openjdk13</code></p>
<p><b>amd64</b>: <code>openjdk7</code>, <code>openjdk8</code>, <code>openjdk11</code>, <code>openjdk12</code>, <code>openjdk13</code></p>
<p><b>arm6</b>: <code>openjdk8</code></p>
<p><b>arm7</b>: <code>openjdk8</code></p>
<p><b>i386</b>: <code>openjdk7</code>, <code>openjdk8</code>, <code>openjdk11</code>, <code>openjdk12</code>, <code>openjdk13</code></p>
<p><b>powerpc</b>: <code>openjdk8</code></p>
<p><b>powerpc64</b>: <code>openjdk8</code>, <code>openjdk11</code>, <code>openjdk12</code>, <code>openjdk13</code></p>
<p>&openjdk; is frequently updated, and it is suggested to refer to
<a href="https://svnweb.freebsd.org/ports/head/java/">revision logs</a> for
detailed release history. Additionally, one may choose to review more information at
<a href="https://www.freshports.org/search.php?query=openjdk&search=go&num=10&stype=name&method=match&deleted=excludedeleted&start=1&casesensitivity=caseinsensitive">FreshPorts</a>.</p>
<p>To install &openjdk; package use the <a href="&base;/cgi/man.cgi?query=pkg"><tt>pkg</tt></a> utility or the ports system:</p>
<p><code>pkg install openjdk[version]</code></p>
<p>or</p>
<p><code>cd /usr/ports/java/openjdk[version]
<br/>make install clean
</code></p>
<p>where [version] is one of 7, 8, 11, 12, or 13. An example (<code>openjdk11</code>):</p>
<p><code>pkg install openjdk11</code></p>
<p>or</p>
<p><code>cd /usr/ports/java/openjdk11
<br/>make install clean
</code></p>
</li>
<li>
<h3>Oracle JDK for Linux</h3>
<p>This port installs the Java Development Kit from Oracle which was built for Linux. It will run under FreeBSD using the Linux compatibility.</p>
<p><code>pkg install linux-oracle-jdk18</code></p>
<p>or</p>
<p><code>cd /usr/ports/java/linux-oracle-jdk18
<br/>make install clean
</code></p>
<p><b>Note:</b> Please note that due to the current licensing policy the
Oracle JDK on FreeBSD binaries can not be distributed and you are only
permitted to use them personally. For the same reason, the sources
must be fetched manually.</p>
</li>
</ul>
<h2>Documentation</h2>
<ul>
<li><a href="&url.books;/porters-handbook/using-java.html">Creating Ports</a></li>
</ul>
<h2>I want to help by...</h2>
<h3>... fixing bugs or adding new features</h3>
<p>The main repositories for the BSD port of OpenJDK are publically available on Github. Pull requests are welcome. You can find more information on this <a href="https://wiki.freebsd.org/Ports/openjdk_11">Wiki</a></p>
<h3>... testing</h3>
<p>The best thing you can do is download the latest release, install it, and try all your favorite Java applications. If they don't work, see below.</p>
<h3>... reporting a bug</h3>
<p>If you find an application that does not work, or crashes, here are the steps you should follow before reporting it:</p>
<ol>
<li>Try it again.</li>
<li>Check your settings for this application. Check to see if you made a mistake in starting it up.</li>
<li>Try it on a different platform. If you have access to a reference platform, try it there. (We need to determine if it is an application error, a Java bug, or a FreeBSD specific bug.)</li>
<li>Narrow down the problem. If it is your own code, narrow down the bug to the offending code. Otherwise, determine the steps required to reproduce the problem.</li>
<li>Notify the JDK porting team. Send email to <a href="mailto:freebsd-java@FreeBSD.org">freebsd-java@FreeBSD.org</a>. Be sure to include the steps you have followed.</li>
<li>Finally, and most importantly, be willing to work with the team to fix the problem.</li>
</ol>
<h3>...writing documentation</h3>
<p>Everyone can help here. If you have a suggestion to add to the documentation, write it up and send it to <a href="mailto:freebsd-java@FreeBSD.org">freebsd-java@FreeBSD.org</a></p>
</body>
</html>
|
