CoreXLSX：纯Swift实现的Excel解析库教程

CoreXLSX：纯Swift实现的Excel解析库教程

CoreXLSXExcel spreadsheet (XLSX) format parser written in pure Swift项目地址:https://gitcode.com/gh_mirrors/co/CoreXLSX

1. 项目目录结构及介绍

CoreXLSX 的源代码目录结构如下：

CoreXLSX
├── Sources      // 主要的源码目录，包含库的核心实现
│   └── CoreXLSX  // 子目录，包含了所有关于XLSX解析的类和结构体
├── Tests        // 测试代码目录，用于验证库的功能
│   ├── Example   // 示例项目，展示了如何使用库来读取XLSX文件
│   └── ...
├── Package.swift // 包定义文件，描述了项目依赖和版本信息
└── ...            // 其他辅助文件，如LICENSE、README等

Sources/ 目录是核心源代码所在的地方，其中 CoreXLSX 文件夹包含用于解析XLSX文件的所有类型和函数。

Tests/ 目录下的 Example 子目录是一个简单的项目，你可以参考它来了解如何在实践中集成和使用CoreXLSX。

2. 项目的启动文件介绍

CoreXLSX 是一个库，没有传统意义上的启动文件。然而，如果你想要创建一个简单的程序来测试或展示其功能，可以参考 Tests/Example 中的 main.swift 或 ViewController.swift 文件。这些文件展示了如何初始化 XLSXFile 对象并访问XLSX文件的内容。

例如，在 ViewController.swift 中，可能有一个类似于以下的代码片段用于打开并读取工作表：

import UIKit
import CoreXLSX

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        
        let path = Bundle.main.path(forResource: "example", ofType: "xlsx")!
        let file = try! XLSXFile(path: path)
        let sheet = file.workbook.firstSheet ?? ""
        
        print("First Sheet Name: \(sheet)")
        // 更多读取操作...
    }
}

这里，XLSXFile 初始化了一个指向XLSX文件对象，并通过 workbook 访问其包含的工作表。

3. 项目的配置文件介绍

该项目使用 Package.swift 作为Swift Package Manager（SPM）的配置文件，定义了项目的基本元数据、依赖以及构建规则。以下是关键部分的概述：

// Package.swift

import PackageDescription

let package = Package(
    name: "CoreXLSX",
    products: [
        .library(name: "CoreXLSX", targets: ["CoreXLSX"]),
    ],
    dependencies: [],
    targets: [
        .target(
            name: "CoreXLSX",
            dependencies: []),
    ]
)

name 属性指定了库的名字，而 products 定义了产品的结构，这里是 CoreXLSX 库。dependencies 列出了外部依赖，对于CoreXLSX来说，它是一个纯Swift库，所以无需外部依赖。最后，targets 部分定义了实际编译的目标，即 CoreXLSX 目标。

如果你想在其他项目中添加CoreXLSX作为依赖，只需在你的项目 Package.swift 文件中引用它，或者使用Xcode的UI进行设置（如果是CocoaPods，就在Podfile中声明依赖）。

CoreXLSXExcel spreadsheet (XLSX) format parser written in pure Swift项目地址:https://gitcode.com/gh_mirrors/co/CoreXLSX