快速开始

本文将为您介绍使用 GcExcel 所需的 Java 环境配置及基本操作步骤，帮助您快速完成初始设置并开始使用 GcExcel。

环境配置

在使用 GcExcel 之前，请确保您的开发环境满足以下要求：

Java 开发工具包（JDK）8.0 或更高版本。
任意 Java 集成开发环境（IDE），例如 IntelliJ、Eclipse等。
命令行构建工具，例如 Gradle 或 Maven。

为提升安全性并增强对 JDK 8 的兼容性，GcExcel 从 v6.0.0 版本起不再支持 JDK 7 及更早版本。如果您计划将 GcExcel 应用程序升级到 JDK 8，请务必移除对 gcexcel.extension 包的依赖，并删除与该扩展包相关的 *.class 和 *.jar 文件。
低于 v5.1.1 版本的 GcExcel 无法在 JDK 17 或更高版本中运行。

操作步骤

步骤一：创建 Gradle 或者 Maven 工程

打开IntelliJ IDEA，在顶部菜单栏，依次选择 File > New > Project。
在 New Project 对话框，设置项目名称，选择 Build system 为 Gradle 或者Maven，然后单击 Create。

步骤二：配置项目依赖

Gradle 项目

打开 build.gradle 文件，在 dependencies 块中添加以下内容，其中，x.x.x表示您使用的 GcExcel 的版本号。

implementation 'com.grapecitysoft.documents:gcexcel:x.x.x'
implementation 'com.grapecitysoft.documents:gcexcel:x.x.x:javadoc'

Maven 项目

打开 pom.xml 文件，在 dependencies 节点中添加以下内容，其中，x.x.x表示您使用的 GcExcel 的版本号。

<dependency>
   <groupId>com.grapecitysoft.documents</groupId>
   <artifactId>gcexcel</artifactId>
   <version>x.x.x</version>
</dependency>
<dependency>
    <groupId>com.grapecitysoft.documents</groupId>
    <artifactId>gcexcel</artifactId>
    <version>x.x.x</version>
    <classifier>javadoc</classifier>
    <scope>provided</scope>
</dependency>

配置完成后，GcExcel 的 jar 包将作为依赖自动引入，您可以在项目中直接引用 GcExcel 提供的所有类。更多类的详细信息，请参见 GcExcel 依赖。

步骤三：创建基础应用

在项目的 src/main/java 目录下，新建一个 Main.java 文件，导入以下命名空间。
```
import com.grapecity.documents.excel.*;
import com.grapecity.documents.excel.drawing.*;
```

新建一个工作簿并访问默认工作表。

// 新建工作簿。
Workbook workbook = new Workbook();

// 获取默认工作表。
IWorksheet worksheet = workbook.getWorksheets().get(0);

// 设置默认行高和列宽。
worksheet.setStandardHeight(20);
worksheet.setStandardWidth(50);

指定文件名和路径保存工作簿。
```
workbook.save("GcExcelDemo.xlsx");
```

步骤四：构建并运行项目

完成上述所有步骤后，构建并运行您的项目。运行成功后，会在指定的路径下生成名为 GcExcelDemo.xlsx 的 Excel 文件。

GcExcel Maven 迁移

自 v7.0.0 起，GcExcel 的 maven 地址迁移至 GcExcel Maven，引用的名字更改为 com.grapecitysoft.documents 。您可以通过以下方式将工程升级。

下载GcExcel 官方网站的安装包，获取迁移工具（路径为：gcexcel-java-x.x.x/Migration_Tool）。
按照工具界面上的指引操作，迁移工具会自动将 Gradle 项目的 build.gradle 和 Maven 项目的 pom.xml 中的 GcExcel 依赖替换为新 maven 地址的依赖。

如有特殊依赖或自定义配置，请根据实际需求手动调整。