File: JogAmpPlatforms.html

package info (click to toggle)
gluegen2 2.6.0%2Bdfsg-1
links: PTS, VCS
area: main
in suites: forky, sid
size: 9,320 kB
sloc: java: 55,357; ansic: 3,758; xml: 3,328; sh: 1,565; pascal: 591; asm: 162; makefile: 76
file content (852 lines) | stat: -rw-r--r-- 21,267 bytes
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
<head>
  <meta charset="utf-8" />
  <meta name="generator" content="pandoc" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
  <title>JogAmpPlatforms.md</title>
  <style>
        div#header, header
            {

            border-bottom: 1px solid #aaa;
            margin-bottom: 0.5em;
            }

        .title
            {
            text-align: center;
            }

        .author, .date
            {
            text-align: center;
            }

        div#TOC, nav#TOC
            {

            border-bottom: 1px solid #aaa;
            margin-bottom: 0.5em;
            }

        nav#TOC {
          margin-bottom: var(--line-height);

          padding-bottom: 0.5rem;
        }

        nav#TOC input {
          display: none;
        }

        nav#TOC label {
          color: var(--color-link);
          cursor: pointer;
        }

        nav#TOC > ul {
          display: none;
        }

        nav#TOC > input:checked + ul {
          display: block;
        }

        @media print
            {
            div#TOC, nav#TOC
                {

                display: none;
                }
            }

        div.content
            {
                color: #111111;
                font-size: 14px;
                line-height: 1.6;
            }

        div#cgit a
            {
                color: #1212a0;
            }

        div#cgit a.sourceLine
            {
                color: #111111;
            }

        h1, h2, h3, h4, h5, h6
        {
            font-family: "Helvetica Neue", Helvetica, "Liberation Sans", Calibri, Arial, sans-serif;

            page-break-after: avoid;

            margin: 20px 0 10px;
            padding: 0;
        }

        h2 {
            border-bottom: 1px solid #ccc;
        }

        div div
            {

            }

        section section
            {
            margin-left: 2em;
            }

        p {}

        blockquote
            {
            font-style: italic;
            }

        li
            {
            }

        li > p
            {
            margin-top: 1em;
            }

        ul
            {
            }

        ul li
            {
            }

        ol
            {
            }

        ol li
            {
            }

        hr {}

        sub
            {
            }

        sup
            {
            }

        em
            {
            }

        em > em
            {
            font-style: normal;
            }

        strong
            {
            }

        a
            {

            text-decoration: none;
            }

        @media screen
            {
            a:hover
                {

                text-decoration: underline;
                }
            }

        @media print
            {
            a {

                color: black;
                background: transparent;
                }

            a[href^="http://"]:after, a[href^="https://"]:after
                {

                content: " (" attr(href) ") ";
                font-size: 90%;
                }
            }

        img
            {

            vertical-align: middle;
            }

        div.figure
            {

            margin-left: auto;
            margin-right: auto;
            text-align: center;
            font-style: italic;
            }

        p.caption
            {

            }

        pre, code
            {
            background-color: #f8f8f8;

            white-space: pre-wrap;
            white-space: -moz-pre-wrap !important;
            white-space: -pre-wrap;
            white-space: -o-pre-wrap;
            word-wrap: break-word;

            }

        pre
            {

            padding: 0.5em;
            border-radius: 5px;

            background-color: #f8f8f8;
            border: 1px solid #ccc;
            font-size: 13px;
            line-height: 19px;
            overflow: auto;
            padding: 6px 10px;

            margin-left: 0.5em;
            margin-right: 0.5em;
            }

        @media screen
            {
            pre
                {

                white-space: pre;
                overflow: auto;

                border: 1px dotted #777;
                }
            }

        code
            {
            }

        p > code, li > code
            {

            padding-left: 2px;
            padding-right: 2px;
            }

        li > p code
            {

            padding: 2px;
            }

        span.math
            {

            }

        div.math
            {
            }

        span.LaTeX
            {
            }

        eq
            {
            }

        table
            {
            border-collapse: collapse;
            border-spacing: 0;

            margin-left: auto;
            margin-right: auto;
            }

        thead
            {
            border-bottom: 1pt solid #000;
            background-color: #eee;
            }

        tr.header
            {
            }

        tbody
            {
            }

        tr {
            }
        tr.odd:hover, tr.even:hover
            {
            background-color: #eee;
            }

        tr.odd {}
        tr.even {}

        td, th
            {
            vertical-align: top;
            vertical-align: baseline;
            padding-left: 0.5em;
            padding-right: 0.5em;
            padding-top: 0.2em;
            padding-bottom: 0.2em;
            }
        th
            {
            font-weight: bold;
            }

        tfoot
            {
            }

        caption
            {
            caption-side: top;
            border: none;
            font-size: 0.9em;
            font-style: italic;
            text-align: center;
            margin-bottom: 0.3em;
            padding-bottom: 0.2em;
            }

        dl
            {
            border-top: 2pt solid black;
            padding-top: 0.5em;
            border-bottom: 2pt solid black;
            }

        dt
            {
            font-weight: bold;
            }

        dd+dt
            {
            border-top: 1pt solid black;
            padding-top: 0.5em;
            }

        dd
            {
            margin-bottom: 0.5em;
            }

        dd+dd
            {
            border-top: 1px solid black;
            }

        a.footnote, a.footnoteRef {
            font-size: small;
            vertical-align: text-top;
        }

        a[href^="#fnref"], a.reversefootnote
            {
            }

        @media print
            {
            a[href^="#fnref"], a.reversefootnote
                {

                display: none;
                }
            }

        div.footnotes
            {
            }

        div.footnotes li[id^="fn"]
            {
            }

        @media print
            {
            .noprint
                {
                display:none;
                }
            }
      </style>
</head>
<body>
<nav id="TOC" role="doc-toc">
    <strong>Contents</strong><label for="contents">⊕</label>
  <input type="checkbox" id="contents">
  <ul>
  <li><a href="#jogamps-supported-platforms">JogAmp’s Supported
  Platforms</a>
  <ul>
  <li><a href="#by-jogamp-version">By JogAmp Version</a></li>
  <li><a href="#unit-testing">Unit Testing</a></li>
  <li><a href="#bring-up-testing">Bring-up Testing</a>
  <ul>
  <li><a href="#non-android">Non Android</a></li>
  <li><a href="#android">Android</a></li>
  </ul></li>
  <li><a href="#java-openjdk">Java / OpenJDK</a></li>
  <li><a href="#windows">Windows</a>
  <ul>
  <li><a href="#current-architectures">Current Architectures:</a></li>
  <li><a href="#offline-architectures">Offline Architectures</a></li>
  <li><a href="#potential-architectures">Potential
  Architectures</a></li>
  </ul></li>
  <li><a href="#freebsd">FreeBSD</a>
  <ul>
  <li><a href="#distributions">Distributions</a></li>
  <li><a href="#current-architectures-1">Current Architectures:</a></li>
  <li><a href="#offline-architectures-1">Offline Architectures</a></li>
  </ul></li>
  <li><a href="#gnulinux">GNU/Linux</a>
  <ul>
  <li><a href="#dependencies">Dependencies</a></li>
  <li><a href="#distributions-1">Distributions</a></li>
  <li><a href="#current-architectures-2">Current Architectures:</a></li>
  <li><a href="#offline-architectures-2">Offline Architectures</a></li>
  </ul></li>
  <li><a href="#androidlinux">Android/Linux</a>
  <ul>
  <li><a href="#current-architectures-3">Current Architectures:</a></li>
  <li><a href="#offline-architectures-3">Offline Architectures</a></li>
  </ul></li>
  <li><a href="#opensolaris-illumus">OpenSolaris / Illumus</a>
  <ul>
  <li><a href="#current-architectures-4">Current Architectures:</a></li>
  <li><a href="#offline-architectures-4">Offline Architectures</a></li>
  </ul></li>
  <li><a href="#macos">MacOS</a>
  <ul>
  <li><a href="#overview">Overview</a></li>
  <li><a href="#openjdk">OpenJDK</a></li>
  <li><a href="#jogamp-build-and-test-setup">JogAmp Build and Test
  Setup</a></li>
  </ul></li>
  <li><a href="#change-history">Change History</a></li>
  </ul></li>
  </ul>
</nav>
<!---
We convert markdown using pandoc using `markdown+lists_without_preceding_blankline` as source format
and `html5+smart` with a custom template as the target.

Recipe:
```
  ~/pandoc-buttondown-cgit/pandoc_md2html_local.sh GlueGen_Mapping.md > GlueGen_Mapping.html
```

Git repos:
- https://jausoft.com/cgit/users/sgothel/pandoc-buttondown-cgit.git/about/
- https://github.com/sgothel/pandoc-buttondown-cgit
-->
<style>
table, th, td {
   border: 1px solid black;
}
</style>
<h1 id="jogamps-supported-platforms">JogAmp’s Supported Platforms</h1>
<p>Jogamp 2.6.x runtime is supported on the described platforms
below.</p>
<p>Please ask for contracting options to have support added for your
desired platform.</p>
<h2 id="by-jogamp-version">By JogAmp Version</h2>
<ul>
<li><a
href="https://jogamp.org/gluegen/doc/JogAmpPlatforms-2.6.0.html">Version
2.6.0</a></li>
</ul>
<h2 id="unit-testing">Unit Testing</h2>
<p>Thorough unit testing is performed on all our <a
href="https://jogamp.org/chuck/job/jogl/">jenkins build nodes</a>.</p>
<h2 id="bring-up-testing">Bring-up Testing</h2>
<h3 id="non-android">Non Android</h3>
<p>A quick bring-up testing covers <code>gluegen</code>,
<code>joal</code> and <code>jogl</code> and is performed on non Android
platforms:</p>
<pre><code>#!/bin/sh

type=archive/rc
version=v2.6.0-rc-20250721
folder=${type}/${version}

mkdir ${version}
cd ${version}

curl --silent --output jogamp-fat.jar  https://jogamp.org/deployment/${folder}/fat/jogamp-fat.jar
curl --silent --output jogl-demos.jar https://jogamp.org/deployment/${folder}/fat/jogl-demos.jar
curl --silent --output jogl-fonts-p0.jar https://jogamp.org/deployment/${folder}/fat/jogl-fonts-p0.jar

echo &quot;Fetched from ${folder} to ${version}&quot;

java -cp jogamp-fat.jar:jogl-demos.jar com.jogamp.opengl.demos.graph.ui.UISceneDemo20</code></pre>
<p>However, you can also use the locally produced fat jar file for the
building platform, e.g.</p>
<pre><code>cd jogl/build-x86_64/jar
java -cp jogl-fat-linux-amd64.jar:jogl-demos.jar com.jogamp.opengl.demos.graph.ui.UISceneDemo20</code></pre>
<h3 id="android">Android</h3>
<p>For Android, the fat demo APK
<code>jogl-demos-fat-android-${arch}.apk</code> inside the jogl build
folder can be directly installed and tested on your device w/ developer
mode enabled.</p>
<h2 id="java-openjdk">Java / OpenJDK</h2>
<p>Current runtime requirements</p>
<ul>
<li>Java 8 (class file 52)</li>
<li><a href="http://openjdk.java.net/">OpenJDK</a> &gt;= 8, tested on <a
href="https://adoptium.net/temurin/releases/">Adoptium Builds</a>
<ul>
<li>OpenJDK 21</li>
<li>OpenJDK 17</li>
<li>OpenJDK 11</li>
<li>Following <a href="http://openjdk.java.net/">OpenJDK</a> versions
are no more tested, but may work
<ul>
<li>OpenJDK 10</li>
<li>OpenJDK 9</li>
<li>OpenJDK 8</li>
</ul></li>
</ul></li>
<li><a href="https://www.azul.com/downloads/zulu-community/">Azul’s
Zulu</a> (untested)</li>
<li><a href="https://github.com/ReadyTalk/avian">Avian</a>
(untested)</li>
</ul>
<p>Future versions may use</p>
<ul>
<li>Java 11 (class file 55)</li>
<li>Android SDK API level 32 (Version 12 Snow Cone, released 2022)
<ul>
<li>Supposed to be <a
href="https://developer.android.com/build/jdks">Java 11 API
compliant</a></li>
</ul></li>
</ul>
<p><em>See contracting options above</em></p>
<h2 id="windows">Windows</h2>
<ul>
<li>Windows &gt;= 10</li>
<li>Windows 2000 (should work)</li>
<li>Windows 8 (should work)</li>
<li>Windows 7 (patched, should work)</li>
</ul>
<h3 id="current-architectures">Current Architectures:</h3>
<ul>
<li><code>x86_64</code></li>
</ul>
<h3 id="offline-architectures">Offline Architectures</h3>
<p>Currently not tested anymore, code may exist.</p>
<ul>
<li><code>x86</code></li>
</ul>
<h3 id="potential-architectures">Potential Architectures</h3>
<ul>
<li><code>arm64</code> (<code>aarch64</code>)</li>
</ul>
<p><em>See contracting options above</em></p>
<h2 id="freebsd">FreeBSD</h2>
<h3 id="distributions">Distributions</h3>
<ul>
<li>FreeBSD <a href="https://www.freebsd.org/releases/">Releases</a>
<ul>
<li>FreeBSD 14.3</li>
</ul></li>
</ul>
<h3 id="current-architectures-1">Current Architectures:</h3>
<ul>
<li><code>x86_64</code></li>
</ul>
<h3 id="offline-architectures-1">Offline Architectures</h3>
<p>Currently not yet supported</p>
<ul>
<li><code>x86</code></li>
<li><code>arm64</code> (<code>aarch64</code>)</li>
<li>…</li>
</ul>
<p><em>See contracting options above</em></p>
<h2 id="gnulinux">GNU/Linux</h2>
<h3 id="dependencies">Dependencies</h3>
<p>GNU/Linux builds’ <em>GNU libc</em> dependencies are relaxed by
utilizing lower or no versioning to the few existing versioned library
entries used. Therefor it is expected to be able to run on older and
newer distributions.</p>
<h3 id="distributions-1">Distributions</h3>
<ul>
<li>Debian <a href="https://wiki.debian.org/LTS">LTS</a> and <a
href="https://www.debian.org/releases/">Releases</a>
<ul>
<li>Debian 11 <em>Bullseye</em> LTS until 2026-08-31</li>
<li>Debian 12 <em>Bookworm</em> (future LTS on 2026-06-11)</li>
<li>Debian 13 <em>Trixie</em></li>
</ul></li>
<li><a href="https://www.releases.ubuntu.com/">Ubuntu</a>
<ul>
<li>Ubuntu 24.04.2 LTS (2025-02-20)</li>
<li>Ubuntu 22.04.5 LTS (2024-09-12)</li>
<li>Ubuntu 20.04.6 LTS (2023-03-22)</li>
</ul></li>
</ul>
<h3 id="current-architectures-2">Current Architectures:</h3>
<ul>
<li><code>x86_64</code></li>
<li><code>arm64</code> (<code>aarch64</code>)</li>
<li><code>armv6/armv7</code> (hardfloat)</li>
</ul>
<h3 id="offline-architectures-2">Offline Architectures</h3>
<p>Currently not tested anymore, code may exist.</p>
<ul>
<li><code>x86</code></li>
<li><code>ia64</code></li>
<li><code>riscv64</code></li>
<li><code>mipsel</code></li>
<li><code>ppc64le</code></li>
<li><code>sparcv9</code></li>
<li><code>alpha</code></li>
<li><code>hppa</code></li>
</ul>
<p><em>See contracting options above</em></p>
<h2 id="androidlinux">Android/Linux</h2>
<ul>
<li>Android Version 8.0 Oreo, API Level 26 or later
<ul>
<li><em>minSdkVersion</em>: 26 (Android 8, Oreo)</li>
<li><em>targetSdkVersion</em>: 35 (Android 15), as required as of
2025-08-31</li>
</ul></li>
</ul>
<p>On 2025-07-20 we have tested
<code>jogl-demos-fat-android-${arch}.apk</code> using an
<code>x86</code> and <code>x86_64</code> emulator for</p>
<ul>
<li>Android 8, API 26</li>
<li>Android 14, API 34</li>
<li>Android 15, API 35</li>
</ul>
<h3 id="current-architectures-3">Current Architectures:</h3>
<ul>
<li><code>x86_64</code></li>
<li><code>arm64</code> (<code>aarch64</code>)</li>
</ul>
<h3 id="offline-architectures-3">Offline Architectures</h3>
<p>Currently not tested regularly, code may exist.</p>
<ul>
<li><code>x86</code></li>
<li><code>armv6/armv7</code> (hardfloat)</li>
</ul>
<p><em>See contracting options above</em></p>
<h2 id="opensolaris-illumus">OpenSolaris / Illumus</h2>
<p>Currently not tested anymore, code may exist.</p>
<h3 id="current-architectures-4">Current Architectures:</h3>
<h3 id="offline-architectures-4">Offline Architectures</h3>
<p>Currently not tested anymore, code may exist.</p>
<ul>
<li><code>x86_64</code></li>
<li><code>x86</code></li>
<li><code>sparcv9</code></li>
</ul>
<p><em>See contracting options above</em></p>
<h2 id="macos">MacOS</h2>
<p>References</p>
<ul>
<li><a href="https://en.wikipedia.org/wiki/MacOS_version_history">Mac OS
Version History (wiki)</a>.</li>
<li><a
href="https://en.wikipedia.org/wiki/Xcode#Version_comparison_table">Xcode
Version Comparison Table (wiki)</a></li>
</ul>
<h3 id="overview">Overview</h3>
<table>
<colgroup>
<col style="width: 16%" />
<col style="width: 15%" />
<col style="width: 17%" />
<col style="width: 49%" />
</colgroup>
<thead>
<tr class="header">
<th style="text-align: left;">MacOS Version</th>
<th style="text-align: left;">Release Name</th>
<th style="text-align: left;">Darwin Version</th>
<th style="text-align: left;">JogAmp Relation</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">10.7</td>
<td style="text-align: left;">Lion</td>
<td style="text-align: left;">11</td>
<td style="text-align: left;">Min deployment target</td>
</tr>
<tr class="even">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr class="odd">
<td style="text-align: left;">10.13</td>
<td style="text-align: left;">High Sierra</td>
<td style="text-align: left;">17</td>
<td style="text-align: left;">Test node 10.13.6, <code>x86_64</code>
(retired)</td>
</tr>
<tr class="even">
<td style="text-align: left;">10.14</td>
<td style="text-align: left;">Mojave</td>
<td style="text-align: left;">18</td>
<td style="text-align: left;"></td>
</tr>
<tr class="odd">
<td style="text-align: left;">10.15</td>
<td style="text-align: left;">Catalina</td>
<td style="text-align: left;">19</td>
<td style="text-align: left;"></td>
</tr>
<tr class="even">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr class="odd">
<td style="text-align: left;">11</td>
<td style="text-align: left;">Big Sur</td>
<td style="text-align: left;">20</td>
<td style="text-align: left;"></td>
</tr>
<tr class="even">
<td style="text-align: left;">12</td>
<td style="text-align: left;">Monterey</td>
<td style="text-align: left;">21</td>
<td style="text-align: left;">Build node 12.6.5, w/ Xcode 14.2,
<code>x86_64</code></td>
</tr>
<tr class="odd">
<td style="text-align: left;">13</td>
<td style="text-align: left;">Ventura</td>
<td style="text-align: left;">22</td>
<td style="text-align: left;">Test node 13.1, <code>arm64</code>
(retired)</td>
</tr>
<tr class="even">
<td style="text-align: left;">15</td>
<td style="text-align: left;">Sequoia</td>
<td style="text-align: left;">24</td>
<td style="text-align: left;">Test node 15.5, <code>arm64</code></td>
</tr>
</tbody>
</table>
<p>Exceptions:</p>
<ul>
<li>JOAL’s build-in OpenAL-Soft requires MacOS 10.13</li>
</ul>
<h3 id="openjdk">OpenJDK</h3>
<p>Available Java(tm) VMs</p>
<ul>
<li><a href="http://openjdk.java.net/">OpenJDK</a> build @ <a
href="https://adoptium.net/temurin/releases/">Adoptium</a>
<ul>
<li><a href="https://adoptium.net/supported-platforms/">Adoptium
Supported MacOS Versions</a>
<ul>
<li>MacOS 10.15, 11, 12, 13, 15 for <code>x86_64</code> and
<code>arm64</code></li>
</ul></li>
</ul></li>
</ul>
<h3 id="jogamp-build-and-test-setup">JogAmp Build and Test Setup</h3>
<h4 id="macos-12.6.5-monterey-darwin-21-x86_64">MacOS 12.6.5 (Monterey),
Darwin 21, <code>x86_64</code></h4>
<ul>
<li>Build and main test machine</li>
<li>XCode 14.2 w/ SDK 11.3
<ul>
<li><code>export SDKROOT=macosx11.3</code> (<em>MacOS SDK</em>)</li>
<li><code>-mmacosx-version-min=10.7</code> (<em>Miniumum deployment
target</em>)</li>
</ul></li>
<li>OpenJDK Temurin 21.0.7+6-LTS</li>
</ul>
<h4 id="macos-15.5-sequoia-darwin-24-arm64">MacOS 15.5 (Sequoia), Darwin
24, <code>arm64</code></h4>
<ul>
<li>Test machine</li>
<li>OpenJDK Temurin 21.0.7+6-LTS</li>
</ul>
<h4 id="retired">Retired</h4>
<p>Currently not tested anymore, but should still work.</p>
<h5 id="macos-10.13.6-high-sierra-darwin-17-x86_64">MacOS 10.13.6 (High
Sierra), Darwin 17, <code>x86_64</code></h5>
<ul>
<li>Test machine</li>
<li>OpenJDK Temurin 17.0.5+8</li>
<li>Retired</li>
</ul>
<h5 id="macos-13.1-ventura-darwin-22-arm64">MacOS 13.1 (Ventura), Darwin
22, <code>arm64</code></h5>
<ul>
<li>Test machine</li>
<li>OpenJDK Temurin 17.0.5+8</li>
<li>Retired</li>
</ul>
<h2 id="change-history">Change History</h2>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Date</th>
<th style="text-align: left;">Note</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">2023-05-06</td>
<td style="text-align: left;">Initial Version for JogAmp Release
2.5.0</td>
</tr>
<tr class="even">
<td style="text-align: left;">2025-06-21</td>
<td style="text-align: left;">JogAmp Release 2.6.0</td>
</tr>
</tbody>
</table>
</body>
</html>