This is an automated email from the ASF dual-hosted git repository.
psxjoy pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/fesod.git
The following commit(s) were added to refs/heads/main by this push:
new 7453bef6 feature: update documentation for Apache Fesod
2.0.0-incubating (#826)
7453bef6 is described below
commit 7453bef66d1aba2b68101ed81e75127a5ef303c0
Author: Shuxin Pan <[email protected]>
AuthorDate: Sat Jan 24 12:32:43 2026 +0800
feature: update documentation for Apache Fesod 2.0.0-incubating (#826)
---
README.md | 5 +-
README_CN.md | 5 +-
website/docs/download.md | 75 +++++++++++++++-------
website/docs/migration/from-fastexcel.md | 10 +--
website/docs/quickstart/guide.md | 61 ++++++++++++++----
.../current/download.md | 75 +++++++++++++++-------
.../current/migration/from-fastexcel.md | 10 +--
.../current/quickstart/guide.md | 60 +++++++++++++----
8 files changed, 216 insertions(+), 85 deletions(-)
diff --git a/README.md b/README.md
index cd1d43a7..b2f84266 100644
--- a/README.md
+++ b/README.md
@@ -79,10 +79,9 @@ new features in the latest version will enhance your
experience.
If you are using Maven for project building, add the following configuration
in the `pom.xml` file:
```xml
-
<dependency>
<groupId>org.apache.fesod</groupId>
- <artifactId>fesod</artifactId>
+ <artifactId>fesod-sheet</artifactId>
<version>version</version>
</dependency>
```
@@ -93,7 +92,7 @@ If you are using Gradle for project building, add the
following configuration in
```gradle
dependencies {
- implementation 'org.apache.fesod:fesod:version'
+ implementation 'org.apache.fesod:fesod-sheet:version'
}
```
diff --git a/README_CN.md b/README_CN.md
index 82bbd022..f06ad516 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -63,10 +63,9 @@ Apache Fesod (Incubating) 需要 **Java 1.8** 或更高版本。建议使用最
如果使用 Maven 进行项目构建，请在 `pom.xml` 文件中添加以下配置：
```xml
-
<dependency>
<groupId>org.apache.fesod</groupId>
- <artifactId>fesod</artifactId>
+ <artifactId>fesod-sheet</artifactId>
<version>version</version>
</dependency>
```
@@ -77,7 +76,7 @@ Apache Fesod (Incubating) 需要 **Java 1.8** 或更高版本。建议使用最
```gradle
dependencies {
- implementation 'org.apache.fesod:fesod:version'
+ implementation 'org.apache.fesod:fesod-sheet:version'
}
```
diff --git a/website/docs/download.md b/website/docs/download.md
index 4e7857a5..0c5811eb 100644
--- a/website/docs/download.md
+++ b/website/docs/download.md
@@ -3,56 +3,87 @@ id: 'download'
title: 'Download'
---
-Here is the Apache Fesod (Incubating) official download page. Please choose
version to download from the following tables. It is recommended use the latest.
+Here is the Apache Fesod (Incubating) official download page. Apache Fesod
provides source releases that can be downloaded from the ASF distribution site.
Binary artifacts are available through Maven Central.
-:::tip
+# How to Use Apache Fesod (Incubating)
-We are currently preparing for the first release under the Apache Incubator.
Previous releases were non-Apache releases.
+## Using Maven Central (Recommended)
-:::
+For most users, simply add the dependency to your project:
-## Previous Releases (Non-Apache)
+```xml
+<dependency>
+ <groupId>org.apache.fesod</groupId>
+ <artifactId>fesod-sheet</artifactId>
+ <version>2.0.0-incubating</version>
+</dependency>
+```
+
+Browse all artifacts: [Maven Central
Repository](https://repo1.maven.org/maven2/org/apache/fesod/)
+
+## Available Modules
+
+- **fesod-sheet** - Core module for Excel/CSV processing (recommended for most
users)
+- **fesod-bom** - Bill of Materials for dependency management
+- **fesod-common** - Common utilities (automatically included with fesod-sheet)
+- **fesod-shaded** - Shaded dependencies to avoid conflicts (automatically
included with fesod-sheet)
+
+# Apache Source Releases
+
+## The Latest Release
+
+| Version | Date |
Source Download
| Release Notes
|
+|:-----------------:|:----------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------:|
+| 2.0.0-incubating | 2026-01-24 |
[Source](https://downloads.apache.org/incubator/fesod/2.0.0-incubating/)
([asc](https://downloads.apache.org/incubator/fesod/2.0.0-incubating/apache-fesod-2.0.0-incubating-src.tar.gz.asc),
[sha512](https://downloads.apache.org/incubator/fesod/2.0.0-incubating/apache-fesod-2.0.0-incubating-src.tar.gz.sha512))
| [Release
Notes](https://github.com/apache/fesod/releases/tag/2.0.0-incubating) |
+
+# Previous Releases (Non-Apache)
-### The latest release
+## All archived releases
| Version | Date |
Download
| Release notes |
|:-------:|:----------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------:|
| 1.3.0 | 2025-08-23 |
[fastexcel-1.3.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.3.0/fastexcel-1.3.0.jar)
(
[asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.3.0/fastexcel-1.3.0.jar.asc)
\|
[sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.3.0/fastexcel-1.3.0.jar.sha1))
| [notes](https://github.com/apache/fesod/releases/tag/1.3.0) |
-### All archived releases
-
| Version | Date |
Download
| Release notes |
|:-------:|:----------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------:|
| 1.2.0 | 2025-04-14 |
[fastexcel-1.2.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.2.0.jar)
(
[asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.2.0.jar.asc)
\|
[sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.2.0.jar.sha1))
| [notes](https://github.com/apache/fesod/releases/tag/1.2.0) |
| 1.1.0 | 2025-01-14 |
[fastexcel-1.1.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.1.0/fastexcel-1.1.0.jar)
(
[asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.1.0/fastexcel-1.1.0.jar.asc)
\|
[sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.1.0.jar.sha1))
| [notes](https://github.com/apache/fesod/releases/tag/1.1.0) |
| 1.0.0 | 2024-12-05 |
[fastexcel-1.0.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.0.0/fastexcel-1.0.0.jar)
(
[asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.0.0/fastexcel-1.0.0.jar.asc)
\|
[sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.0.0/fastexcel-1.0.0.jar.sha1))
| [notes](https://github.com/apache/fesod/releases/tag/1.0.0) |
-## Notes
+# Verifying Apache Releases
+
+All Apache releases must be verified before use. Follow these steps to verify
the integrity and authenticity of the source release:
+
+## Download Verification Files
+
+Download the [KEYS](https://downloads.apache.org/incubator/fesod/KEYS) file
containing the public keys used for signing releases.
-* When downloading a release, please verify the OpenPGP compatible signature
(or failing that, check the SHA-512); these should be fetched from the main
Apache site.
-* The KEYS file contains the public keys used for signing release. It is
recommended that (when possible) a web of trust is used to confirm the identity
of these keys.
+## Verify Signature
-### To verify the signature of the release artifact
+1. Import the KEYS file to your GPG keyring:
-You will need to download both the release artifact and the .asc signature
file for that artifact. Then verify the signature by:
+ ```bash
+ gpg --import KEYS
+ ```
-* Download the KEYS file and the .asc signature files for the relevant release
artifacts.
-* Import the KEYS file to your GPG keyring:
+2. Download the source release, .asc signature file, and .sha512 checksum file.
+
+3. Verify the GPG signature:
```bash
-gpg --import KEYS
+gpg --verify apache-fesod-2.0.0-incubating-src.tar.gz.asc
apache-fesod-2.0.0-incubating-src.tar.gz
```
-* Verify the signature of the release artifact using the following command:
+## Verify Checksum
+
+Verify the SHA-512 checksum:
```bash
-gpg --verify <artifact>.asc <artifact>
+shasum -a 512 -c apache-fesod-2.0.0-incubating-src.tar.gz.sha512
```
-### To verify the checksum of the release artifact
-
-You will need to download both the release artifact and the .sha512 checksum
file for that artifact. Then verify the checksum by:
+Or on Linux:
```bash
-shasum -a 512 -c <artifact>.sha512
+sha512sum -c apache-fesod-2.0.0-incubating-src.tar.gz.sha512
```
diff --git a/website/docs/migration/from-fastexcel.md
b/website/docs/migration/from-fastexcel.md
index ddb79d1b..17b01c42 100644
--- a/website/docs/migration/from-fastexcel.md
+++ b/website/docs/migration/from-fastexcel.md
@@ -41,24 +41,26 @@ Replace your existing dependency with Apache Fesod
(Incubating):
| Source | GroupId | ArtifactId | Version |
|--------|---------|------------|----------|
| **cn.idev FastExcel** | cn.idev.excel | fastexcel | 1.3.0 |
-| **Apache Fesod (Incubating)** ✅ | org.apache.fesod | fesod | 1.3.0+ |
+| **Apache Fesod (Incubating)** ✅ | org.apache.fesod | fesod-sheet |
2.0.0-incubating+ |
**Maven:**
```xml
<dependency>
<groupId>org.apache.fesod</groupId>
- <artifactId>fesod</artifactId>
- <version>1.3.0</version>
+ <artifactId>fesod-sheet</artifactId>
+ <version>2.0.0-incubating</version>
</dependency>
```
**Gradle:**
```gradle
-implementation 'org.apache.fesod:fesod:1.3.0'
+implementation 'org.apache.fesod:fesod-sheet:2.0.0-incubating'
```
+> **Note**: The `fesod-sheet` module is the core module for Excel/CSV
processing. It automatically includes the necessary dependencies
(`fesod-common` and `fesod-shaded`).
+
### Step 2: Package Import Updates
Update all import statements to use the new Apache Fesod (Incubating) package
structure.
diff --git a/website/docs/quickstart/guide.md b/website/docs/quickstart/guide.md
index 8e394cef..3429bcf7 100644
--- a/website/docs/quickstart/guide.md
+++ b/website/docs/quickstart/guide.md
@@ -7,20 +7,28 @@ title: 'Guide'
## Compatibility Information
-The following table lists the minimum Java language version requirements for
each version of the Fesod library:
+The following table lists the minimum Java language version requirements for
each version of the Apache Fesod(Incubating) library:
-| Version | JDK Version Support Range | Notes |
-|---------|---------------------------|-------|
-| 1.3.x | JDK8 - JDK25 | |
-| 1.2.x | JDK8 - JDK21 | |
-| 1.1.x | JDK8 - JDK21 | |
-| 1.0.x | JDK8 - JDK21 | |
+| Version | JDK Version Support Range | Notes
|
+|-------------------|---------------------------|--------------------------------|
+| 2.0.0-incubating | JDK8 - JDK25 | First Apache Incubator
release |
+| 1.3.x | JDK8 - JDK25 | Non-Apache release
|
+| 1.2.x | JDK8 - JDK21 | Non-Apache release
|
+| 1.1.x | JDK8 - JDK21 | Non-Apache release
|
+| 1.0.x | JDK8 - JDK21 | Non-Apache release
|
-We strongly recommend using the latest version of Fesod, as performance
optimizations, bug fixes, and new features
+We strongly recommend using the latest version of Apache Fesod(Incubating), as
performance optimizations, bug fixes, and new features
in the latest version will enhance your experience.
-> Currently, Fesod uses POI as its underlying package. If your project already
includes POI-related components, you
-> will need to manually exclude POI-related jar files.
+### Dependencies
+
+Apache Fesod(Incubating) uses the following key dependencies:
+
+- **Apache POI 5.5.1** - For Excel file processing
+- **Apache Commons CSV 1.14.1** - For CSV file support
+- **Ehcache 3.9.11** - For caching functionality
+
+> If your project already includes POI-related components, you may need to
manually exclude POI-related jar files to avoid version conflicts.
## Version Update
@@ -33,20 +41,45 @@ available versions in the [Maven Central
Repository](https://mvnrepository.com/a
If you are using Maven for project building, add the following configuration
in the `pom.xml` file:
```xml
-
<dependency>
<groupId>org.apache.fesod</groupId>
- <artifactId>fesod</artifactId>
- <version>version</version>
+ <artifactId>fesod-sheet</artifactId>
+ <version>2.0.0-incubating</version>
</dependency>
```
+### Alternative: Using BOM for Version Management
+
+For better dependency management, you can use the Fesod BOM:
+
+```xml
+<dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.fesod</groupId>
+ <artifactId>fesod-bom</artifactId>
+ <version>2.0.0-incubating</version>
+ <type>pom</type>
+ <scope>import</scope>
+ </dependency>
+ </dependencies>
+</dependencyManagement>
+
+<dependencies>
+ <dependency>
+ <groupId>org.apache.fesod</groupId>
+ <artifactId>fesod-sheet</artifactId>
+ <!-- Version managed by BOM -->
+ </dependency>
+</dependencies>
+```
+
## Gradle
If you are using Gradle for project building, add the following configuration
in the `build.gradle` file:
```gradle
dependencies {
- implementation 'org.apache.fesod:fesod:version'
+ implementation 'org.apache.fesod:fesod-sheet:2.0.0-incubating'
}
```
diff --git
a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/download.md
b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/download.md
index b4cd1434..20be3008 100644
--- a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/download.md
+++ b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/download.md
@@ -3,56 +3,87 @@ id: 'download'
title: '下载'
---
-这是 Apache Fesod (Incubating)的官方下载页面。请从以下表格中选择要下载的版本。建议使用最新版本。
+这是 Apache Fesod (Incubating) 的官方下载页面。Apache Fesod 提供可从 ASF
发布站点下载的源码发布。二进制构件可通过 Maven 中央仓库获取。
-:::tip
+# 如何使用 Apache Fesod (Incubating)
-我们目前正准备进行在 Apache 孵化器下的首次发布。之前的版本并非基于 Apache 。
+## 使用 Maven 中央仓库（推荐）
-:::
+对于大多数用户，只需在项目里添加以下依赖：
-## 发布版本（非 Apache 版本）
+```xml
+<dependency>
+ <groupId>org.apache.fesod</groupId>
+ <artifactId>fesod-sheet</artifactId>
+ <version>2.0.0-incubating</version>
+</dependency>
+```
+
+浏览所有构件：[Maven 中央仓库](https://repo1.maven.org/maven2/org/apache/fesod/)
+
+## 可用模块
+
+- **fesod-sheet** - Excel/CSV 处理的核心模块（推荐大多数用户使用）
+- **fesod-bom** - 用于依赖管理的 BOM（Bill of Materials）
+- **fesod-common** - 公共工具类（会随 fesod-sheet 自动引入）
+- **fesod-shaded** - 隔离的依赖以避免冲突（会随 fesod-sheet 自动引入）
+
+# Apache 源码发布
+
+## 最新版本
+
+| 版本 | 发布日期 |
源码下载
|
版本说明 |
+|:----------------:|:----------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------:|
+| 2.0.0-incubating | 2026-01-24 |
[源码](https://downloads.apache.org/incubator/fesod/2.0.0-incubating/)
([asc](https://downloads.apache.org/incubator/fesod/2.0.0-incubating/apache-fesod-2.0.0-incubating-src.tar.gz.asc),
[sha512](https://downloads.apache.org/incubator/fesod/2.0.0-incubating/apache-fesod-2.0.0-incubating-src.tar.gz.sha512))
| [版本说明](https://github.com/apache/fesod/releases/tag/2.0.0-incubating) |
+
+# 发布版本（非 Apache 版本）
-### 最新版本
+## 历史版本
| 版本 | 发布日期 |
下载地址
| 版本说明 |
|:-----:|:----------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------:|
| 1.3.0 | 2025-08-23 |
[fastexcel-1.3.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.3.0/fastexcel-1.3.0.jar)
(
[asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.3.0/fastexcel-1.3.0.jar.asc)
\|
[sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.3.0/fastexcel-1.3.0.jar.sha1))
| [notes](https://github.com/apache/fesod/releases/tag/1.3.0) |
-### 历史版本
-
| 版本 | 发布日期 |
下载地址
| 版本说明 |
|:-----:|:----------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------:|
| 1.2.0 | 2025-04-14 |
[fastexcel-1.2.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.2.0.jar)
(
[asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.2.0.jar.asc)
\|
[sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.2.0.jar.sha1))
| [notes](https://github.com/apache/fesod/releases/tag/1.2.0) |
| 1.1.0 | 2025-01-14 |
[fastexcel-1.1.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.1.0/fastexcel-1.1.0.jar)
(
[asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.1.0/fastexcel-1.1.0.jar.asc)
\|
[sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.1.0.jar.sha1))
| [notes](https://github.com/apache/fesod/releases/tag/1.1.0) |
| 1.0.0 | 2024-12-05 |
[fastexcel-1.0.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.0.0/fastexcel-1.0.0.jar)
(
[asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.0.0/fastexcel-1.0.0.jar.asc)
\|
[sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.0.0/fastexcel-1.0.0.jar.sha1))
| [notes](https://github.com/apache/fesod/releases/tag/1.0.0) |
-## 说明
+# 验证 Apache 发布版本
+
+在使用前必须验证所有 Apache 发布版本。请按以下步骤验证源码发布的完整性和真实性：
+
+## 下载验证文件
+
+下载包含用于签署发布版本的公钥的 [KEYS](https://downloads.apache.org/incubator/fesod/KEYS) 文件。
-* 在下载版本时，请验证其符合 OpenPGP 标准的签名（如果无法验证，则需检查 SHA-512 签名）；这些文件应从 Apache 主站点获取。
-* KEYS 文件包含了用于签署发布版本的公钥。建议（在可能的情况下）采用信任网络的方式来确认这些公钥的身份。
+## 验证签名
-### 验证签名
+1. 将 KEYS 文件导入您的 GPG 密钥环：
-需要同时下载发布工件及其对应的 .asc 签名文件。然后通过以下步骤验证签名：
+ ```bash
+ gpg --import KEYS
+ ```
-* 下载相关发布版本的 KEYS 文件和 .asc 签名文件。
-* 将 KEYS 文件导入您的 GPG 密钥环：
+2. 下载源码发布包、.asc 签名文件和 .sha512 校验和文件。
+
+3. 验证 GPG 签名：
```bash
-gpg --import KEYS
+gpg --verify apache-fesod-2.0.0-incubating-src.tar.gz.asc
apache-fesod-2.0.0-incubating-src.tar.gz
```
-* 使用以下命令验证发布版本的签名:
+## 验证校验和
+
+验证 SHA-512 校验和：
```bash
-gpg --verify <artifact>.asc <artifact>
+shasum -a 512 -c apache-fesod-2.0.0-incubating-src.tar.gz.sha512
```
-### 验证发布文件的校验码
-
-您需要下载该发布包以及该包的 .sha512 校验码文件。然后通过以下方式验证校验码：
+或在 Linux 上：
```bash
-shasum -a 512 -c <artifact>.sha512
+sha512sum -c apache-fesod-2.0.0-incubating-src.tar.gz.sha512
```
diff --git
a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/migration/from-fastexcel.md
b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/migration/from-fastexcel.md
index f803b5dd..d5c849c6 100644
---
a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/migration/from-fastexcel.md
+++
b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/migration/from-fastexcel.md
@@ -41,24 +41,26 @@ keywords: [fesod, 迁移, fastexcel, apache, excel, 升级]
| 来源 | GroupId | ArtifactId | 版本 |
|-----------------------|------------------|------------|--------|
| **cn.idev FastExcel** | cn.idev.excel | fastexcel | 1.3.0 |
-| **Apache Fesod (Incubating)** ✅ | org.apache.fesod | fesod | 1.3.0+ |
+| **Apache Fesod (Incubating)** ✅ | org.apache.fesod | fesod-sheet |
2.0.0-incubating+ |
**Maven 配置:**
```xml
<dependency>
<groupId>org.apache.fesod</groupId>
- <artifactId>fesod</artifactId>
- <version>1.3.0</version>
+ <artifactId>fesod-sheet</artifactId>
+ <version>2.0.0-incubating</version>
</dependency>
```
**Gradle 配置:**
```gradle
-implementation 'org.apache.fesod:fesod:1.3.0'
+implementation 'org.apache.fesod:fesod-sheet:2.0.0-incubating'
```
+> **注意**: `fesod-sheet` 模块是 Excel/CSV 处理的核心模块。它会自动引入必要的依赖（`fesod-common` 和
`fesod-shaded`）。
+
### 步骤 2: 更新包导入
更新所有 import 语句以使用新的 Apache Fesod (Incubating) 包结构。
diff --git
a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/quickstart/guide.md
b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/quickstart/guide.md
index 026cbc08..1d9828bb 100644
---
a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/quickstart/guide.md
+++
b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/quickstart/guide.md
@@ -7,18 +7,27 @@ title: '指南'
## 兼容说明
-下表列出了各版本 Fesod 基础库对 Java 语言版本最低要求的情况：
+下表列出了各版本 Apache Fesod(Incubating) 基础库对 Java 语言版本最低要求的情况：
-| 版本 | jdk版本支持范围 | 备注 |
-|-------|--------------|----|
-| 1.3.x | jdk8 - jdk25 | |
-| 1.2.x | jdk8 - jdk21 | |
-| 1.1.x | jdk8 - jdk21 | |
-| 1.0.x | jdk8 - jdk21 | |
+| 版本 | jdk版本支持范围 | 备注 |
+|-------------------|--------------|--------------------|
+| 2.0.0-incubating | jdk8 - jdk25 | 首个 Apache 孵化器版本 |
+| 1.3.x | jdk8 - jdk25 | 非 Apache 版本 |
+| 1.2.x | jdk8 - jdk21 | 非 Apache 版本 |
+| 1.1.x | jdk8 - jdk21 | 非 Apache 版本 |
+| 1.0.x | jdk8 - jdk21 | 非 Apache 版本 |
-我们强烈建议您使用最新版本的 Fesod，因为最新版本中的性能优化、BUG 修复和新功能都会让您的使用更加方便。
+我们强烈建议您使用最新版本的 Apache Fesod(Incubating)，因为最新版本中的性能优化、BUG 修复和新功能都会让您的使用更加方便。
-> 当前 Fesod 底层使用 poi 作为基础包，如果您的项目中已经有 poi 相关组件，需要您手动排除 poi 的相关 jar 包。
+### 依赖说明
+
+Apache Fesod(Incubating) 使用了以下核心依赖：
+
+- **Apache POI 5.5.1** - 用于 Excel 文件处理
+- **Apache Commons CSV 1.14.1** - 用于 CSV 文件支持
+- **Ehcache 3.9.11** - 用于缓存功能
+
+> 如果您的项目中已经有 POI 相关组件，可能需要手动排除 POI 的相关 jar 包以避免版本冲突。
## 版本更新
@@ -31,20 +40,45 @@ title: '指南'
如果您使用 Maven 进行项目构建，请在 `pom.xml` 文件中引入以下配置：
```xml
-
<dependency>
<groupId>org.apache.fesod</groupId>
- <artifactId>fesod</artifactId>
- <version>版本号</version>
+ <artifactId>fesod-sheet</artifactId>
+ <version>2.0.0-incubating</version>
</dependency>
```
+### 可选：使用 BOM 管理版本
+
+为了更好地管理依赖版本，您可以使用 Apache Fesod(Incubating) BOM：
+
+```xml
+<dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.fesod</groupId>
+ <artifactId>fesod-bom</artifactId>
+ <version>2.0.0-incubating</version>
+ <type>pom</type>
+ <scope>import</scope>
+ </dependency>
+ </dependencies>
+</dependencyManagement>
+
+<dependencies>
+ <dependency>
+ <groupId>org.apache.fesod</groupId>
+ <artifactId>fesod-sheet</artifactId>
+ <!-- 版本号由 BOM 管理 -->
+ </dependency>
+</dependencies>
+```
+
## Gradle
如果您使用 Gradle 进行项目构建，请在 `build.gradle` 文件中引入以下配置：
```gradle
dependencies {
- implementation 'org.apache.fesod:fesod:版本号'
+ implementation 'org.apache.fesod:fesod-sheet:2.0.0-incubating'
}
```
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
