https://sourceforge.net/p/oculix/wiki/Build%2520from%2520Source/Recent changes to Build from SourceenSun, 12 Apr 2026 00:55:55 -0000https://sourceforge.net/p/oculix/wiki/Build%2520from%2520Source/<div class="markdown_content"><h1 id="h-build-from-source">Build from Source</h1> <hr/> <h2 id="h-prerequisites">Prerequisites</h2> <table> <thead> <tr> <th>Requirement</th> <th>Version</th> </tr> </thead> <tbody> <tr> <td><strong>Java JDK</strong></td> <td>17+ (Eclipse Temurin recommended)</td> </tr> <tr> <td><strong>Maven</strong></td> <td>3.8+</td> </tr> <tr> <td><strong>Git</strong></td> <td>any</td> </tr> </tbody> </table> <h2 id="h-clone-and-build">Clone and Build</h2> <div class="codehilite"><pre><span></span><code>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/oculix-org/Oculix.git <span class="nb">cd</span><span class="w"> </span>Oculix mvn<span class="w"> </span>clean<span class="w"> </span>package<span class="w"> </span>-DskipTests </code></pre></div> <h2 id="h-build-outputs">Build Outputs</h2> <div class="codehilite"><pre><span></span><code><span class="nx">API</span><span class="o">/</span><span class="nx">target</span><span class="o">/</span><span class="nx">oculixapi</span><span class="o">-</span><span class="m">3.0.1</span><span class="p">.</span><span class="nx">jar</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">API</span><span class="w"> </span><span class="kn">library</span> <span class="nx">IDE</span><span class="o">/</span><span class="nx">target</span><span class="o">/</span><span class="nx">oculixide</span><span class="o">-</span><span class="m">3.0.1</span><span class="p">.</span><span class="nx">jar</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">IDE</span><span class="w"> </span><span class="p">(</span><span class="nx">thin</span><span class="w"> </span><span class="nx">JAR</span><span class="p">)</span> <span class="nx">IDE</span><span class="o">/</span><span class="nx">target</span><span class="o">/</span><span class="nx">oculixide</span><span class="o">-</span><span class="m">3.0.1</span><span class="o">-</span><span class="nx">complete</span><span class="p">.</span><span class="nx">jar</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">Fat</span><span class="w"> </span><span class="nx">JAR</span><span class="w"> </span><span class="p">(</span><span class="nx">all</span><span class="w"> </span><span class="nx">platforms</span><span class="p">)</span> </code></pre></div> <h2 id="h-platform-specific-fat-jars">Platform-Specific Fat JARs</h2> <div class="codehilite"><pre><span></span><code><span class="c1"># Windows only (smaller)</span> mvn<span class="w"> </span>clean<span class="w"> </span>package<span class="w"> </span>-DskipTests<span class="w"> </span>-Pcomplete-win-jar <span class="c1"># macOS only</span> mvn<span class="w"> </span>clean<span class="w"> </span>package<span class="w"> </span>-DskipTests<span class="w"> </span>-Pcomplete-mac-jar <span class="c1"># Linux only</span> mvn<span class="w"> </span>clean<span class="w"> </span>package<span class="w"> </span>-DskipTests<span class="w"> </span>-Pcomplete-lux-jar </code></pre></div> <h2 id="h-run">Run</h2> <div class="codehilite"><pre><span></span><code><span class="c1"># Launch IDE</span> java<span class="w"> </span>-jar<span class="w"> </span>IDE/target/oculixide-3.0.1-complete-win.jar <span class="c1"># Run script headless</span> java<span class="w"> </span>-jar<span class="w"> </span>IDE/target/oculixide-3.0.1-complete-win.jar<span class="w"> </span>-r<span class="w"> </span>script.py </code></pre></div> <h2 id="h-project-structure">Project Structure</h2> <div class="codehilite"><pre><span></span><code><span class="nx">Oculix</span><span class="o">/</span> <span class="err">├──</span><span class="w"> </span><span class="nx">API</span><span class="o">/</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">Core</span><span class="w"> </span><span class="kn">library</span><span class="w"> </span><span class="p">(</span><span class="nx">sikuli</span><span class="w"> </span><span class="nx">API</span><span class="p">,</span><span class="w"> </span><span class="nx">OpenCV</span><span class="p">,</span><span class="w"> </span><span class="nx">VNC</span><span class="p">,</span><span class="w"> </span><span class="nx">ADB</span><span class="p">,</span><span class="w"> </span><span class="nx">OCR</span><span class="p">)</span> <span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="nx">src</span><span class="o">/</span><span class="nx">main</span><span class="o">/</span><span class="nx">java</span><span class="o">/</span> <span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="nx">org</span><span class="o">/</span><span class="nx">sikuli</span><span class="o">/</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">SikuliX</span><span class="w"> </span><span class="nx">core</span><span class="w"> </span><span class="nx">API</span> <span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="nx">org</span><span class="o">/</span><span class="nx">opencv</span><span class="o">/</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">OpenCV</span><span class="w"> </span><span class="nx">Java</span><span class="w"> </span><span class="nx">bindings</span> <span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="nx">com</span><span class="o">/</span><span class="nx">sikulix</span><span class="o">/</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">OculiX</span><span class="w"> </span><span class="nx">additions</span><span class="w"> </span><span class="p">(</span><span class="nx">VNC</span><span class="p">,</span><span class="w"> </span><span class="nx">OCR</span><span class="p">,</span><span class="w"> </span><span class="nx">SSH</span><span class="p">)</span> <span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="nx">com</span><span class="o">/</span><span class="nx">tigervnc</span><span class="o">/</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">Vendored</span><span class="w"> </span><span class="nx">TigerVNC</span> <span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="nx">com</span><span class="o">/</span><span class="nx">jcraft</span><span class="o">/</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">Vendored</span><span class="w"> </span><span class="nx">JSch</span> <span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">└──</span><span class="w"> </span><span class="nx">se</span><span class="o">/</span><span class="nx">vidstige</span><span class="o">/</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">Vendored</span><span class="w"> </span><span class="nx">JADB</span> <span class="err">│</span><span class="w"> </span><span class="err">└──</span><span class="w"> </span><span class="nx">pom</span><span class="p">.</span><span class="nx">xml</span> <span class="err">├──</span><span class="w"> </span><span class="nx">IDE</span><span class="o">/</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">GUI</span><span class="w"> </span><span class="nx">IDE</span> <span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="nx">src</span><span class="o">/</span><span class="nx">main</span><span class="o">/</span><span class="nx">java</span><span class="o">/</span> <span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">└──</span><span class="w"> </span><span class="nx">org</span><span class="o">/</span><span class="nx">sikuli</span><span class="o">/</span><span class="nx">ide</span><span class="o">/</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">IDE</span><span class="w"> </span><span class="nx">classes</span><span class="w"> </span><span class="p">(</span><span class="nx">SikulixIDE</span><span class="p">,</span><span class="w"> </span><span class="nx">IDEMenuManager</span><span class="p">,</span><span class="w"> </span><span class="nx">etc</span><span class="p">.)</span> <span class="err">│</span><span class="w"> </span><span class="err">└──</span><span class="w"> </span><span class="nx">pom</span><span class="p">.</span><span class="nx">xml</span> <span class="err">├──</span><span class="w"> </span><span class="p">.</span><span class="nx">github</span><span class="o">/</span><span class="nx">workflows</span><span class="o">/</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">CI</span><span class="o">/</span><span class="nx">CD</span> <span class="err">└──</span><span class="w"> </span><span class="nx">pom</span><span class="p">.</span><span class="nx">xml</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="nx">Parent</span><span class="w"> </span><span class="nx">POM</span> </code></pre></div> <h2 id="h-troubleshooting">Troubleshooting</h2> <table> <thead> <tr> <th>Error</th> <th>Solution</th> </tr> </thead> <tbody> <tr> <td><code>UnsupportedClassVersionError</code></td> <td>Use Java 17+, not Java 11 or 8</td> </tr> <tr> <td><code>UnsatisfiedLinkError: opencv_java*</code></td> <td>Check PR <span>[#12]</span> is merged (Core.java version alignment)</td> </tr> <tr> <td>Maven deps not found</td> <td>Apertix is on Maven Central, check network access</td> </tr> </tbody> </table></div>Julien MerSun, 12 Apr 2026 00:55:55 -0000https://sourceforge.netc014b7c365d9c264b2ee3c9881d0e4e49230fecf