poi-tl-ext 项目使用教程

1. 项目目录结构及介绍

poi-tl-ext/
├── gradle/
│   └── wrapper/
├── src/
│   ├── main/
│   └── test/
├── .gitignore
├── .gitattributes
├── LICENSE
├── README.md
├── build.gradle
├── gradlew
├── gradlew.bat
└── settings.gradle

目录结构说明

• gradle/: 包含 Gradle 的包装器文件，用于确保项目使用一致的 Gradle 版本。
• src/: 项目的源代码目录，包含 main 和 test 两个子目录，分别用于存放主代码和测试代码。
• .gitignore: Git 忽略文件，指定哪些文件和目录不需要被 Git 追踪。
• .gitattributes: Git 属性文件，用于指定文件的 Git 行为。
• LICENSE: 项目的开源许可证文件，本项目使用 Apache-2.0 许可证。
• README.md: 项目的说明文档，包含项目的基本信息、使用方法等。
• build.gradle: Gradle 构建脚本，定义项目的依赖、任务等。
• gradlew: Gradle 包装器脚本，用于在 Unix 系统上运行 Gradle。
• gradlew.bat: Gradle 包装器脚本，用于在 Windows 系统上运行 Gradle。
• settings.gradle: Gradle 设置文件，定义项目的名称和子项目。

2. 项目的启动文件介绍

项目的主要启动文件是 build.gradle，它定义了项目的构建配置和依赖管理。以下是 build.gradle 文件的主要内容：

plugins {
    id 'java'
}

group 'io.github.draco1023'
version '0.4.18'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.apache.poi:poi:4.x'
    implementation 'com.deepoove:poi-tl:1.11'
    // 其他依赖项
}

// 其他配置项

启动文件说明

• plugins: 定义了项目使用的插件，如 java 插件。
• group 和 version: 定义了项目的组 ID 和版本号。
• repositories: 定义了依赖库的仓库，通常使用 Maven 中央仓库。
• dependencies: 定义了项目的依赖项，包括 Apache POI 和 poi-tl 等。

3. 项目的配置文件介绍

项目的配置文件主要包括 build.gradle 和 settings.gradle。

build.gradle

build.gradle 文件是项目的核心配置文件，定义了项目的构建逻辑、依赖管理、插件配置等。以下是一些常见的配置项：

sourceCompatibility = '1.8'
targetCompatibility = '1.8'

tasks.withType(JavaCompile) {
    options.encoding = 'UTF-8'
}

test {
    useJUnitPlatform()
}

settings.gradle

settings.gradle 文件定义了项目的名称和子项目：

rootProject.name = 'poi-tl-ext'

配置文件说明

• sourceCompatibility 和 targetCompatibility: 定义了 Java 编译的版本。
• tasks.withType(JavaCompile): 配置 Java 编译任务的编码为 UTF-8。
• test: 配置测试任务使用 JUnit 平台。
• rootProject.name: 定义了项目的根名称。

通过以上配置，项目可以顺利构建和运行，开发者可以根据需要进一步扩展和定制配置文件。