mirror of
https://github.com/apache/poi.git
synced 2026-02-27 20:40:08 +08:00
281 lines
9.5 KiB
HTML
281 lines
9.5 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™ - 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> > <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 – 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">
|
|
<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">
|
|
|
|
|
|
</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="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™ - Versioning</h1>
|
|
<div id="front-matter"></div>
|
|
|
|
<a name="Versioning"></a>
|
|
<h2 class="boxed">Versioning</h2>
|
|
<div class="section">
|
|
<p>
|
|
Apache POI™ 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>
|
|
<p>
|
|
We typically only release new versions and don't usually patch old releases.
|
|
We may consider patching old releases in exceptional circumstances.
|
|
It is recommended to always use the latest version of Apache POI.
|
|
</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>
|
|
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 PJ Fanning</font>
|
|
</p>
|
|
</div>
|
|
<!--+
|
|
|end content
|
|
+-->
|
|
<div class="clearboth"> </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 ©
|
|
2001-2025 <a href="https://www.apache.org/">The Apache Software Foundation</a>
|
|
<br>
|
|
Apache, Apache POI, the Apache feather logo, and the Apache POI
|
|
logos 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>
|