apache-poi/content/versioning.html
2026-02-16 20:14:18 +01:00

316 lines
11 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="Apache Forrest" name="Generator">
<meta name="Forrest-version" content="0.9">
<meta name="Forrest-skin-name" content="pelt">
<title>Apache POI&trade; - Versioning</title>
<link type="text/css" href="skin/basic.css" rel="stylesheet">
<link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
<link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
<link type="text/css" href="skin/profile.css" rel="stylesheet">
<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
<link rel="shortcut icon" href="images/favicon.ico">
</head>
<body onload="init()">
<script type="text/javascript">ndeSetTextSize();</script>
<div id="top">
<!--+
|breadtrail
+-->
<div class="breadtrail">
<a href="https://www.apache.org">Apache Software Foundation</a> &gt; <a href="https://poi.apache.org">Apache POI</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
</div>
<!--+
|header
+-->
<div class="header">
<!--+
|start group logo
+-->
<div class="grouplogo">
<a href="https://www.apache.org"><img class="logoImage" alt="Apache Software Foundation" src="images/asflogo_horizontal_color.svg" title="The Apache Software Foundation is a cornerstone of the modern Open Source software ecosystem &ndash; supporting some of the most widely used and important software solutions powering today's Internet economy."></a>
</div>
<!--+
|end group logo
+-->
<!--+
|start Project Logo
+-->
<div class="projectlogo">
<a href="https://poi.apache.org"><img class="logoImage" alt="Apache POI" src="images/project-header.png" title="Apache POI is well-known in the Java field as a library for reading and writing Microsoft Office file formats, such as Excel, PowerPoint, Word, Visio, Publisher and Outlook. It supports both the older (OLE2) and new (OOXML - Office Open XML) formats."></a>
</div>
<!--+
|end Project Logo
+-->
<!--+
|start Search
+-->
<div class="searchbox">
<form action="https://www.google.com/search" method="get" class="roundtopsmall">
<input value="poi.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp;
<input name="Search" value="Search" type="submit">
</form>
</div>
<!--+
|end search
+-->
<!--+
|start Tabs
+-->
<ul id="tabs">
<li class="current">
<a class="selected" href="index.html">Home</a>
</li>
<li>
<a class="unselected" href="help/index.html">Help</a>
</li>
<li>
<a class="unselected" href="components/index.html">Component APIs</a>
</li>
<li>
<a class="unselected" href="devel/index.html">Getting Involved</a>
</li>
</ul>
<!--+
|end Tabs
+-->
</div>
</div>
<div id="main">
<div id="publishedStrip">
<!--+
|start Subtabs
+-->
<div id="level2tabs"></div>
<!--+
|end Endtabs
+-->
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<!--+
|breadtrail
+-->
<div class="breadtrail">
&nbsp;
</div>
<!--+
|start Menu, mainarea
+-->
<!--+
|start Menu
+-->
<div id="menu">
<div onclick="SwitchMenu('menu_selected_1.1', 'skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Overview</div>
<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
<div class="menuitem">
<a href="index.html">Home</a>
</div>
<div class="menuitem">
<a href="download.html">Download</a>
</div>
<div class="menupage">
<div class="menupagetitle">Versioning</div>
</div>
<div class="menuitem">
<a href="changes.html">Changelog</a>
</div>
<div class="menuitem">
<a href="apidocs/index.html">Javadocs</a>
</div>
<div class="menuitem">
<a href="text-extraction.html">Text Extraction</a>
</div>
<div class="menuitem">
<a href="encryption.html">Encryption support</a>
</div>
<div class="menuitem">
<a href="security.html">Secure processing</a>
</div>
<div class="menuitem">
<a href="casestudies.html">Case Studies</a>
</div>
<div class="menuitem">
<a href="related-projects.html">Related projects</a>
</div>
<div class="menuitem">
<a href="commercial-support.html">Commercial Support</a>
</div>
<div class="menuitem">
<a href="legal.html">Legal</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.2', 'skin/')" id="menu_1.2Title" class="menutitle">Apache Wide</div>
<div id="menu_1.2" class="menuitemgroup">
<div class="menuitem">
<a href="https://www.apache.org/">Apache Software Foundation</a>
</div>
<div class="menuitem">
<a href="https://www.apache.org/licenses/">License</a>
</div>
<div class="menuitem">
<a href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
</div>
<div class="menuitem">
<a href="https://www.apache.org/foundation/thanks.html">Thanks</a>
</div>
<div class="menuitem">
<a href="https://www.apache.org/security/">Security</a>
</div>
<div class="menuitem">
<a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy</a>
</div>
</div>
<div id="credit"></div>
<div id="roundbottom">
<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
<!--+
|alternative credits
+-->
<div id="credit2">
<a href="https://donate.apache.org/"><img border="0" title="Support Apache" alt="Support Apache - logo" src="images/support-asf.png" style="width: 125px;height: 125px;"></a><a href="https://www.apache.org/foundation/press/kit/#poweredby"><img border="0" title="powered by POI" alt="powered by POI - logo" src="images/poweredby-poi-logo.png" style="width: 125px;height: 125px;"></a>
</div>
</div>
<!--+
|end Menu
+-->
<!--+
|start content
+-->
<div id="content">
<h1>Apache POI&trade; - Versioning</h1>
<div id="front-matter"></div>
<a name="Versioning"></a>
<h2 class="boxed">Versioning</h2>
<div class="section">
<p>
Apache POI&trade; releases are available under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0.</a>
from the <a href="download.html">Download</a> page.
</p>
<p>
The versioning scheme for Apache POI is based on the principles of
<a href="https://semver.org/">Semantic Versioning 2.0.0</a>.
</p>
<p>
We started using this versioning scheme in Apache POI 4.0.0. Versions prior
to this did not follow exactly the same principles with the numbers typically being of the form
X.Y. X indicated the major version but there may in some cases, have been big changes between
minor versions.
</p>
</div>
<a name="Version+Support"></a>
<h2 class="boxed">Version Support</h2>
<div class="section">
<p>
Work on 6.0.0 has started in the trunk branch. Java 8 support is being removed.
Some deprecated APIs are being removed. The exact scope of changes will be
determined as development progresses.
</p>
<p>
5.5.x releases will continue to be made for critical bug fixes and security issues.
When 6.0.0 is released, 5.5.x will be supported for a limited time after that.
The exact duration of support will be determined at that time.
</p>
<p>
There is no longer any support for POI releases 4.x and earlier. Users
are strongly encouraged to upgrade to the latest version of POI.
</p>
</div>
<a name="Commercial+Support"></a>
<h2 class="boxed">Commercial Support</h2>
<div class="section">
<p>
<a href="https://www.herodevs.com/support?utm_source=Referral&amp;utm_medium=link&amp;utm_campaign=PoiReferralLink&amp;utm_id=Poi">HeroDevs</a>
offers security and compatibility support for EOL versions of Apache POI. Find out more about their
<a href="https://www.herodevs.com/support?utm_source=Referral&amp;utm_medium=link&amp;utm_campaign=PoiReferralLink&amp;utm_id=Poi">Never Ending Support options</a>.
</p>
<p>
Please see our dedicated <a href="commercial-support.html">Commercial Support</a> page for more information and our Vendor Neutrality statement.
</p>
</div>
<a name="Migrating+from+older+versions"></a>
<h2 class="boxed">Migrating from older versions</h2>
<div class="section">
<p>
Typically, migrating from one major version to the next should be straightforward.
Before migrating, you should check if you are using any deprecated APIs and try to update
your code by following the deprecation notices.
</p>
<p>
If you are migrating across multiple major versions, it is recommended to do this
step by step, i.e. first migrate to the next major version, test your application
and then continue to the next major version. A method might have been deprecated
in one major version and then removed in the next major version.
</p>
<p>
Minor versions may introduce new features and deprecate existing APIs.
They might also contain bug fixes that could potentially affect existing functionality.
</p>
<p>
POI 5.0.0 renamed the ooxml-schemas jar to poi-ooxml-full and
poi-ooxml-schemas jar to poi-ooxml-lite. Please check your dependencies
when migrating from POI 4.x to POI 5.x.
</p>
<p>
Please check the <a href="changes.html">Change Log</a> for details about
what has changed in each version.
</p>
<p>
You can also check the <a href="apidocs/index.html">Javadocs</a> online for
various releases.
</p>
<p>
The <a href="https://poi.apache.org/help/faq.html">FAQ</a> may also contain
useful information.
</p>
<p>
If you encounter any issues when migrating, please report them to the
<a href="https://poi.apache.org/help/index.html">mailing list</a>.
</p>
</div>
<p align="right">
<font size="-2">by&nbsp;PJ Fanning</font>
</p>
</div>
<!--+
|end content
+-->
<div class="clearboth">&nbsp;</div>
</div>
<div id="footer">
<!--+
|start bottomstrip
+-->
<div class="lastmodified">
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<div class="copyright">
Copyright &copy;
2001-2026 <a href="https://www.apache.org/">The Apache Software Foundation</a>
<br>
Apache POI, POI, Apache, the Apache logo, and the Apache
POI project logo are trademarks of The Apache Software Foundation.
</div>
<div id="feedback">
Send feedback about the website to:
<a id="feedbackto" href="mailto:dev@poi.apache.org?subject=Feedback%C2%A0versioning.html">dev@poi.apache.org</a>
</div>
<!--+
|end bottomstrip
+-->
</div>
</body>
</html>