<?xml version="1.0" encoding="UTF-8"?>
<!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
<document>
    <header>
        <title>XMLBeans Download</title>
    </header>
    <body>
        <section>
            <title>Binary or source?</title>
            <p>
                Most users will want to download a
                <a
                        href="https://www.apache.org/dyn/closer.cgi/poi/xmlbeans/release/bin">binary release
                </a>
                of XMLBeans. If you're interested in contributing or like to live on the bleeding edge, you
                may want to compile the source for yourself.
            </p>
            <p>
                XMLBeans 202607305.4.1 requires JDK 1.8+. Last version to work with JDK 1.6 is 3.1.0.
            </p>
            <p>
                Once you've downloaded the distribution or checked out the source,
                you should:
            </p>
            <ul>
                <li>first read the README.txt</li>
                <li>read the
                    <a href="site:documentation/install">installation guide</a>
                </li>
                <li>check out the <a href="site:samples/index">samples</a> page
                </li>
                <li>check out the <a href="site:documentation/index">documentation</a> page
                </li>
            </ul>
        </section>

        <section id="XMLBeans-5.4.1">
            <title>23 Sept 2026 - XMLBeans 5.4.1 available</title>
            <p>The Apache POI team is pleased to announce the release of XMLBeans 5.4.1.
                Featured are a handful of bug fixes and packaging cleanup.
            </p>
            <note>XMLBeans 5.x.x requires Java 8+ and it's recommended to regenerate schema files of earlier versions of
                XmlBeans.
            </note>
            <p>A summary of changes is available in the
                <a href="https://www.apache.org/dyn/closer.lua/poi/xmlbeans/release/RELEASE-NOTES-5.4.1.txt">Release Notes</a>.
                A full list of changes is available in the <a href="site:home/changes">change log</a>
                or the corresponding <a href="https://issues.apache.org/jira/browse/XMLBEANS-673?jql=project%20%3D%20XMLBEANS%20AND%20fixVersion%20%3D%205.4.1">Jira tickets</a>.
                People interested should also follow the <a href="site:community/index">dev list</a> to track progress.
            </p>
            <p>
                The XMLBeans source release as well as the pre-built binary deployment packages are listed below.
                Pre-built versions are available in the central Maven repository under
                Group ID "org.apache.xmlbeans" and Version "5.4.1".
            </p>
            <section id="XMLBeans-5.4.1-Source">
                <title>Source Distribution</title>
                <ul>
                    <li>
                        <a href="https://www.apache.org/dyn/closer.lua/poi/xmlbeans/release/src/apache-xmlbeans-src-5.4.1-20260916.tgz">
                            apache-xmlbeans-src-5.4.1-20260916.tgz
                        </a>
                        (7.0 MB, <a href="https://downloads.apache.org/poi/xmlbeans/release/src/apache-xmlbeans-src-5.4.1-20260916.tgz.asc">
                        signature (.asc)</a>, checksum:
                        <a href="https://downloads.apache.org/poi/xmlbeans/release/src/apache-xmlbeans-src-5.4.1-20260916.tgz.sha512">SHA-512</a>
                        )
                    </li>
                </ul>
            </section>
            <section id="XMLBeans-202607305.4.1-bin">
                <title>Binary Distribution</title>
                <ul>
                    <li>
                        <a href="https://www.apache.org/dyn/closer.lua/poi/xmlbeans/release/bin/apache-xmlbeans-bin-5.4.1-20260916.tgz">
                            apache-xmlbeans-bin-5.4.1-20260916.tgz
                        </a>
                        (22 MB, <a href="https://downloads.apache.org/poi/xmlbeans/release/bin/apache-xmlbeans-bin-5.4.1-20260916.tgz.asc">
                        signature (.asc)</a>, checksum:
                        <a href="https://downloads.apache.org/poi/xmlbeans/release/bin/apache-xmlbeans-bin-5.4.1-20260916.tgz.sha512">SHA-512</a>
                        )
                    </li>
                </ul>
            </section>
        </section>

        <section id="verify">
            <title>Verify</title>
            <p>
                It is essential that you verify the integrity of the downloaded files using the PGP and SHA signatures.
                Please read
                <a href="https://httpd.apache.org/dev/verification.html">Verifying Apache HTTP Server Releases</a>
                for more information on why you should verify our releases. This page provides detailed instructions
                which you can use for POI artifacts.
            </p>
            <p>
                The PGP signatures can be verified using PGP or GPG. First
                <a href="https://downloads.apache.org/poi/KEYS">download the KEYS file</a>
                as well as the .asc signature files for the relevant release packages.
                Make sure you get these files from the main distribution directory, rather than from a mirror.
                Then <a href="https://www.apache.org/info/verification.html">verify the signatures</a>.
            </p>
            <p>
                As an example:
            </p>
            <source>
                % pgpk -a KEYS
                % pgpv xmlbeans-X.Y.Z.jar.asc
            </source>
            <p>or</p>
            <source>
                % pgp -ka KEYS
                % pgp xmlbeans-X.Y.Z.jar.asc
            </source>
            <p>or - <em>it's good practice to <a href="https://www.apache.org/info/verification.html#specify_both">specify both files</a>: (detached) signature and binary</em></p>
            <source>
                % gpg --import KEYS
                % gpg --verify xmlbeans-X.Y.Z.jar.asc xmlbeans-X.Y.Z.jar
            </source>
            <p>Sample verification of xmlbeans-bin-3.1.0.tgz</p>
            <source>
                % gpg --import KEYS
                gpg: key 38DAC8E212DAE9BE: "Glen Stampoultzis &lt;glens at apache.org&gt;" not changed
                gpg: key F5C260164CEED75F: 32 duplicate signatures removed
                gpg: key F5C260164CEED75F: 108 signatures not checked due to missing keys
                gpg: key F5C260164CEED75F: 1 signature reordered
                gpg: key F5C260164CEED75F: "Nick Burch &lt;nick at gagravarr.org&gt;" not changed
                gpg: key 8AAF88D6D84E41AE: 1 duplicate signature removed
                ...

                % gpg --verify xmlbeans-bin-3.1.0.tgz.asc xmlbeans-bin-3.1.0.tgz
                gpg: assuming signed data in `xmlbeans-bin-3.1.0.tgz'
                gpg: Signature made Fri, Mar 22, 2019 3:09:34 PM PDT using RSA key ID D5718BA4
                gpg: Good signature from "Greg Woolsey &lt;gwoolsey@apache.org&gt;"
                gpg: aka "Greg Woolsey (personal) &lt;greg.woolsey@gmail.com&gt;"

                % gpg --fingerprint D5718BA4
                pub 2048R/1556F3A4 2016-10-04
                Key fingerprint = 6072 A0C8 CE08 EAAA BF39 ED4F 2D15 E54A 1556 F3A4
                uid Greg Woolsey &lt;gwoolsey@apache.org&gt;
                uid Greg Woolsey (personal) &lt;greg.woolsey@gmail.com&gt;
                sub 2048R/8CF53C56 2016-10-04
                sub 4096R/D5718BA4 2017-01-09
            </source>
        </section>

        <section id="dependencies">
            <title>Dependencies</title>
            <p>Using XPath/XQuery requires an additional download of Saxon-HE 12.x and placing on
                the classpath. The library is available
                <a href="https://repo1.maven.org/maven2/net/sf/saxon/Saxon-HE/12.10/">here</a>.
            </p>
        </section>

        <section id="source">
            <title>XMLBeans Source</title>
            <p>There are a few ways to get the XMLBeans source code. You can
                download the source for a particular release from this page.
                browse the source using Git.
            </p>

            <p>You can also use Git to clone the source repository but is recommended
                that you use the tags to find releases (e.g. REL_5_4_0).
                The GitHub mirror of the source is available at
                <a href="https://github.com/apache/poi-xmlbeans">https://github.com/apache/poi-xmlbeans</a>.
            </p>
        </section>

        <section id="building">
            <title>Building XMLBeans</title>
            <p>XMLBeans has a mix of Gradle and Ant based builds. The minimum supported JDK in the
                dev version of XMLBeans is Java 8.
            </p>
            <p>Gradle is better supported in recent releases and in dev. Gradle 8.x and Ant 1.10.x are recommended.
            </p>
            <section>
                <title>Windows</title>
                <p>After the steps above you should see an "xmlbeans" directory (or you can choose a
                    different name in the previous step, of course):
                </p>
                <source>
                    cd xmlbeans\
                    gradle clean test jar
                </source>
                <p>This will create a build directory containing the executables. The <code>xmlbeans-&lt;version&gt;.jar</code> is
                    in
                    the <code>xmlbeans\build</code> directory.
                </p>
            </section>
            <section>
                <title>Unix / Linux / Mac</title>
                <p>Building on Unix/Linux/Mac or Cygwin is essentially the same as for Windows:</p>
                <source>
                    cd xmlbeans/
                    gradle clean test jar
                </source>
            </section>
        </section>
    </body>
</document>
