mirror of
https://github.com/jlengrand/jreleaser.github.io.git
synced 2026-03-10 08:31:25 +00:00
493 lines
18 KiB
HTML
493 lines
18 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>Java Binary :: JReleaser</title>
|
|
<link rel="canonical" href="https://jreleaser.org/guide/latest/distributions/java-binary.html">
|
|
<meta name="generator" content="Antora 2.3.4">
|
|
<link rel="stylesheet" href="../../../_/css/site.css">
|
|
<link rel="stylesheet" href="../../../_/css/admonitions.css">
|
|
<link rel="stylesheet" href="../../../_/css/fontawesome.css">
|
|
<link rel="stylesheet" href="../../../_/css/all.css">
|
|
<script>var uiRootPath = '../../../_'</script>
|
|
</head>
|
|
<body class="article">
|
|
<header class="header">
|
|
<nav class="navbar">
|
|
<div class="navbar-brand">
|
|
<a class="navbar-item" href="https://jreleaser.org">JReleaser</a>
|
|
<button class="navbar-burger" data-target="topbar-nav">
|
|
<span></span>
|
|
<span></span>
|
|
<span></span>
|
|
</button>
|
|
</div>
|
|
</nav>
|
|
</header>
|
|
<div class="body">
|
|
<div class="nav-container" data-component="guide" data-version="latest">
|
|
<aside class="nav">
|
|
<div class="panels">
|
|
<div class="nav-panel-menu is-active" data-panel="menu">
|
|
<nav class="nav-menu">
|
|
<h3 class="title"><a href="../index.html">JReleaser</a></h3>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="0">
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<a class="nav-link" href="../install.html">Install</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="0">
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="../quick-start/index.html">Quick Start</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../quick-start/cli.html">Command Line</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../quick-start/maven.html">Apache Maven</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../quick-start/gradle.html">Gradle</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../quick-start/ant.html">Apache Ant</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="0">
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<a class="nav-link" href="../workflow.html">Workflow</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="0">
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="index.html">Distributions</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item is-current-page" data-depth="2">
|
|
<a class="nav-link" href="java-binary.html">Java Binary</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="single-jar.html">Single JAR</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="jlink.html">Jlink</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="native-image.html">Native Image</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="0">
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<a class="nav-link" href="../artifacts.html">Artifacts & Globs</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="0">
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="../configuration/index.html">Configuration</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../configuration/environment.html">Environment</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../configuration/project.html">Project</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../configuration/signing.html">Signing</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="../configuration/release/index.html">Release</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/release/github.html">GitHub</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/release/gitlab.html">GitLab</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/release/gitea.html">Gitea</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="../configuration/assemble/index.html">Assemble</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/assemble/jlink.html">Jlink</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/assemble/native-image.html">Native Image</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="../configuration/packagers/index.html">Packagers</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/packagers/chocolatey.html">Chocolatey</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/packagers/docker.html">Docker</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/packagers/homebrew.html">Homebrew</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/packagers/jbang.html">Jbang</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/packagers/scoop.html">Scoop</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/packagers/snap.html">Snap</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="../configuration/upload/index.html">Upload</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/upload/artifactory.html">Artifactory</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../configuration/distributions.html">Distributions</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../configuration/files.html">Files</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="../configuration/announce/index.html">Announce</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/announce/discord.html">Discord</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/announce/discussions.html">GitHub Discussions</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/announce/gitter.html">Gitter</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/announce/mail.html">Mail</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/announce/sdkman.html">Sdkman</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/announce/slack.html">Slack</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/announce/teams.html">Teams</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/announce/twitter.html">Twitter</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="3">
|
|
<a class="nav-link" href="../configuration/announce/zulip.html">Zulip</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../configuration/name-templates.html">Name Templates</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="0">
|
|
<button class="nav-item-toggle"></button>
|
|
<span class="nav-text">Templates</span>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<a class="nav-link" href="../templates/templates.html">Template Basics</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="1">
|
|
<a class="nav-link" href="../templates/mustache.html">Mustache Primer</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="0">
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="../continuous-integration/index.html">Continuous Integration</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../continuous-integration/github-actions.html">GitHub Actions</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../continuous-integration/jenkins.html">Jenkins</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../continuous-integration/circle-ci.html">Circle CI</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../continuous-integration/codefresh.html">Codefresh</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../continuous-integration/gitlab-ci.html">GitLab CI</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../continuous-integration/cirrus-ci.html">Cirrus CI</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../continuous-integration/drone.html">Drone</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="0">
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="../tools/index.html">Tools</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../tools/jreleaser-cli.html">JReleaser CLI</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../tools/jreleaser-maven.html">JReleaser Maven Plugin</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../tools/jreleaser-gradle.html">JReleaser Gradle Plugin</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../tools/jreleaser-ant.html">JReleaser Ant Tasks</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../tools/jreleaser-tool-provider.html">JReleaser Tool Provider</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../tools/jreleaser-docker.html">JReleaser Docker Image</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../tools/jdks-maven.html">JDKs Maven Plugin</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../tools/jdks-gradle.html">JDKs Gradle Plugin</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="0">
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<button class="nav-item-toggle"></button>
|
|
<a class="nav-link" href="../examples/index.html">Examples</a>
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../examples/jreleaser.html">JReleaser’s Release</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../examples/simple-release.html">Simple Release</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../examples/auto-config-release.html">AutoConfig Release</a>
|
|
</li>
|
|
<li class="nav-item" data-depth="2">
|
|
<a class="nav-link" href="../examples/cross-platform-jlink.html">Cross Platform Jlink</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="nav-item" data-depth="0">
|
|
<ul class="nav-list">
|
|
<li class="nav-item" data-depth="1">
|
|
<a class="nav-link" href="../links.html">Links</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</nav>
|
|
</div>
|
|
<div class="nav-panel-explore" data-panel="explore">
|
|
<div class="context">
|
|
<span class="title">JReleaser</span>
|
|
<span class="version">latest</span>
|
|
</div>
|
|
<ul class="components">
|
|
<li class="component is-current">
|
|
<a class="title" href="../index.html">JReleaser</a>
|
|
<ul class="versions">
|
|
<li class="version is-current is-latest">
|
|
<a href="../index.html">latest</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</aside>
|
|
</div>
|
|
<main class="article">
|
|
<div class="toolbar" role="navigation">
|
|
<button class="nav-toggle"></button>
|
|
<a href="../index.html" class="home-link"></a>
|
|
<nav class="breadcrumbs" aria-label="breadcrumbs">
|
|
<ul>
|
|
<li><a href="../index.html">JReleaser</a></li>
|
|
<li><a href="index.html">Distributions</a></li>
|
|
<li><a href="java-binary.html">Java Binary</a></li>
|
|
</ul>
|
|
</nav>
|
|
<div class="edit-this-page"><a href="https://github.com/jreleaser/jreleaser.github.io/edit/main/docs/modules/ROOT/pages/distributions/java-binary.adoc">Edit this Page</a></div>
|
|
</div>
|
|
<div class="content">
|
|
<aside class="toc sidebar" data-title="Contents" data-levels="2">
|
|
<div class="toc-menu"></div>
|
|
</aside>
|
|
<article class="doc">
|
|
<h1 class="page">Java Binary</h1>
|
|
<div id="preamble">
|
|
<div class="sectionbody">
|
|
<div class="paragraph">
|
|
<p>Distributions of this type conform to the following file structure:</p>
|
|
</div>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre class="highlightjs highlight"><code>.
|
|
├── LICENSE
|
|
├── README
|
|
├── bin
|
|
│ ├── app
|
|
│ └── app.bat
|
|
└── lib
|
|
└── app-1.0.0.jar</code></pre>
|
|
</div>
|
|
</div>
|
|
<div class="paragraph">
|
|
<p>Where:</p>
|
|
</div>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>the <code>bin</code> folder contains executable launcher scripts.</p>
|
|
</li>
|
|
<li>
|
|
<p>the <code>lib</code> folder contains all required JARs.</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="paragraph">
|
|
<p>Java binary distributions <strong>require</strong> a suitable Java runtime to be installed on the consumer side; they are usually
|
|
packaged as Zip or Tar files.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_creating_a_distribution"><a class="anchor" href="#_creating_a_distribution"></a>Creating a Distribution</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph">
|
|
<p>We recommend using the following plugins to create suitable Java binary distributions:</p>
|
|
</div>
|
|
<div class="ulist">
|
|
<div class="title">Maven</div>
|
|
<ul>
|
|
<li>
|
|
<p><a href="https://www.mojohaus.org/appassembler/appassembler-maven-plugin/">appassembler-maven-plugin</a>: generates distribution
|
|
files that follow the expected structure.</p>
|
|
</li>
|
|
<li>
|
|
<p><a href="http://maven.apache.org/plugins/maven-assembly-plugin/">maven-assembly-plugin</a>: packages the distribution as a Zip
|
|
or Tar.</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="ulist">
|
|
<div class="title">Gradle</div>
|
|
<ul>
|
|
<li>
|
|
<p><a href="https://docs.gradle.org/current/userguide/application_plugin.html">application</a> plugin: generates distribution
|
|
files that follow the expected structure. Also, packages the distribution as a Zip or Tar.</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_packager_support"><a class="anchor" href="#_packager_support"></a>Packager Support</h2>
|
|
<div class="sectionbody">
|
|
<table class="tableblock frame-all grid-all stretch">
|
|
<colgroup>
|
|
<col style="width: 50%;">
|
|
<col style="width: 50%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Packager</th>
|
|
<th class="tableblock halign-center valign-top">Supported</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../configuration/packagers/chocolatey.html" class="page">Chocolatey</a></p></td>
|
|
<td class="tableblock halign-center valign-top"><p class="tableblock"><span class="icon green"><i class="fa fa-check"></i></span></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../configuration/packagers/docker.html" class="page">Docker</a></p></td>
|
|
<td class="tableblock halign-center valign-top"><p class="tableblock"><span class="icon green"><i class="fa fa-check"></i></span></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../configuration/packagers/homebrew.html" class="page">Homebrew</a></p></td>
|
|
<td class="tableblock halign-center valign-top"><p class="tableblock"><span class="icon green"><i class="fa fa-check"></i></span></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../configuration/packagers/jbang.html" class="page">Jbang</a></p></td>
|
|
<td class="tableblock halign-center valign-top"><p class="tableblock"><span class="icon green"><i class="fa fa-check"></i></span></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../configuration/packagers/scoop.html" class="page">Scoop</a></p></td>
|
|
<td class="tableblock halign-center valign-top"><p class="tableblock"><span class="icon green"><i class="fa fa-check"></i></span></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../configuration/packagers/snap.html" class="page">Snap</a></p></td>
|
|
<td class="tableblock halign-center valign-top"><p class="tableblock"><span class="icon green"><i class="fa fa-check"></i></span></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</article>
|
|
</div>
|
|
</main>
|
|
</div>
|
|
<footer class="footer">
|
|
<p>Copyright (C) 2021 Andres Almiray. This page was built using an adapted version of the Antora default UI.</p>
|
|
<p>The source code for this UI is licensed under the <a href="https://www.mozilla.org/en-US/MPL/2.0/">Mozilla Public License Version 2.0</a> (MPL-2.0).</p>
|
|
</footer>
|
|
<!--script src="../../../_/js/fontawesome.js"></script>
|
|
<script src="../../../_/js/all.js"></script-->
|
|
<script src="../../../_/js/site.js"></script>
|
|
<script async src="../../../_/js/vendor/highlight.js"></script>
|
|
|
|
</body>
|
|
</html>
|