Безкоштовна Swift бібліотека для читання та запису файлів Excel XLSX

Відкрита, надійна бібліотека Swift 5, що дозволяє розробникам створювати та читати файли XLSX, копіювати, видаляти листи, застосовувати стилі та форматування тощо безкоштовно.

Що таке XlsxReaderWriterSwift?

Втомилися боротися зі складними форматами електронних таблиць у своїх проектах на Swift? Уявіть ситуацію, коли ваш додаток повинен генерувати детальний звіт, імпортувати дані користувачів із шаблону або навіть створювати динамічну фінансову модель — все це безпосередньо в екосистемі iOS. Ручний парсинг CSV‑файлів обмежений, а використання зовнішніх сервісів для обробки XLSX‑файлів неефективне. Саме тут на допомогу приходить XlsxReaderWriterSwift, потужна рідна бібліотека з відкритим кодом. Вона надає розробникам Swift інтуїтивний та надійний інструментарій для безперешкодного читання та запису у сучасний формат .xlsx Microsoft Excel безпосередньо в вашіх додатках для iOS, macOS та visionOS.

XlsxReaderWriterSwift — це надійна бібліотека Swift 5, яка дає змогу розробникам програмного забезпечення створювати та читати файли XLSX, стандарт для сучасних електронних таблиць Excel. Бібліотека пропонує кілька важливих функцій для роботи з файлами Microsoft Excel XLSX, таких як читання XLSX‑файлів, створення нових XLSX‑файлів, застосування стилів та форматування до клітинок, додавання та керування зображеннями в клітинках, генерація звітів, вбудовування електронних таблиць тощо. Побудована на базі C‑бібліотеки libxlsxwriter, вона приносить широкий набір можливостей у екосистему Apple. Це означає, що ви можете генерувати повнофункціональні, на 100 % сумісні Excel‑файли безпосередньо зі свого додатку для iOS або macOS.

Previous Next

Початок роботи з XlsxReaderWriterSwift

Рекомендований спосіб встановлення XlsxReaderWriterSwift — використання CocoaPods. Будь ласка, скористайтеся наступною командою для плавної інсталяції.

Встановити XlsxReaderWriterSwift через CocoaPods

 pod "XlsxReaderWriterSwift"

pod install

Встановити XlsxReaderWriterSwift через GitHub

git clone https://github.com/mehulparmar4ever/XlsxReaderWriterSwift.git

Ви можете завантажити його безпосередньо з GitHub.

Створення та запис у новий файл XLSX за допомогою Swift бібліотеки

Створення нового файлу з нуля та заповнення його даними настільки ж просто. Відкрита бібліотека XlsxReaderWriterSwift забезпечує повну підтримку створення та управління новими електронними таблицями Excel XLSX у Swift‑додатках. Розробники можуть створювати нові аркуші, перейменовувати існуючі, копіювати дані аркуша, зберігати документ у конкретному місці тощо. Наведений нижче приклад показує, як розробники можуть створити новий аркуш Excel XLSX за допомогою Swift‑бібліотеки.

Як створити новий лист Excel XLSX за допомогою Swift бібліотеки?

import XlsxReaderWriterSwift

// 1. Create a new, empty document
let document = BRAOfficeDocumentPackage()

// 2. Get the first worksheet and give it a name
guard let worksheet = document.workbook.worksheets.first as? BRAWorksheet else {
    return
}
worksheet.name = "User Data"

// 3. Write different types of data to cells
worksheet.cell(forCellReference: "A1", shouldCreate: true).stringValue = "Name"
worksheet.cell(forCellReference: "B1", shouldCreate: true).stringValue = "Score"
worksheet.cell(forCellReference: "A2", shouldCreate: true).stringValue = "Alice"
worksheet.cell(forCellReference: "B2", shouldCreate: true).integerValue = 95
worksheet.cell(forCellReference: "A3", shouldCreate: true).stringValue = "Bob"
worksheet.cell(forCellReference: "B3", shouldCreate: true).integerValue = 87

// 4. Define a file path to save the document
let documentsDirectory = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
let fileURL = documentsDirectory.appendingPathComponent("NewReport.xlsx")

// 5. Save the document to the specified path
do {
    let data = document.save()
    try data?.write(to: fileURL)
    print("Spreadsheet saved successfully at: \(fileURL.path)")
} catch {
    print("Failed to save spreadsheet: \(error)")
}

Застосування розширеного стилювання клітинок за допомогою Swift

Електронна таблиця — це не лише дані; важливий і вигляд. API відкритого коду XlsxReaderWriterSwift надає широкий контроль над стилізацією клітинок. Воно виходить за межі простого вводу даних. Ви можете застосовувати різноманітні параметри форматування, включаючи вирівнювання клітинок та форматування чисел, створення нових клітинок, створення нових стилів, доступ до існуючих стилів, застосування рамки до діапазону клітинок тощо. Ось простий приклад, який показує, як розробники можуть застосовувати розширені стилі до клітинок Excel за допомогою Swift‑команд.

Як застосувати розширені стилі до клітинок Excel за допомогою Swift бібліотеки?

// ... (after creating a worksheet and cell)

// Get or create a cell
let headerCell = worksheet.cell(forCellReference: "A1", shouldCreate: true)
headerCell.stringValue = "Sales Report"

// Access the cell's style
let style = headerCell.cellStyle()

// Configure the style
style.font.bold = true
style.font.size = 18
style.fill.foregroundColor = .blue // Background color
style.fill.patternType = .solid
style.alignment.horizontal = .center

// Apply a border to a range of cells
let borderStyle = BRABorderStyle()
borderStyle.lineStyle = .medium
borderStyle.color = .darkGray

let dataRange = worksheet.cells(inRows: 1...3, columns: 1...2)
for cell in dataRange {
    (cell as? BRACell)?.cellStyle().bottomBorder = borderStyle
}

Читання файлу XLSX за допомогою Swift бібліотеки

Відкрита бібліотека XlsxReaderWriterSwift дозволяє розробникам маніпулювати даними в електронних таблицях Excel за допомогою Swift API. Бібліотека дозволяє виконувати різноманітні операції маніпуляції даними, такі як сортування, фільтрування та обчислення значень у листах Excel. Це робить її ідеальним інструментом для завдань, як-от аналіз даних та створення звітів. Крім того, розробники можуть легко витягати дані з конкретних клітинок, рядків або колонок у листі Excel, використовуючи Swift API. Це надзвичайно корисно при роботі з великими наборами даних і коли потрібна лише певна інформація.

Як прочитати дані з файлу Excel XLSX за допомогою безкоштовного Swift API?

import XlsxReaderWriterSwift
// 1. Locate the .xlsx file in your app's bundle
guard let filePath = Bundle.main.path(forResource: "SampleData", ofType: "xlsx") else {
    print("File not found!")
    return
}

// 2. Create a BRAOfficeDocumentPackage object from the file
let document = BRAOfficeDocumentPackage.open(filePath)

// 3. Get the first worksheet
guard let worksheet = document.workbook.worksheets.first as? BRAWorksheet else {
    print("No worksheets found!")
    return
}

// 4. Read data from specific cells
if let cellA1 = worksheet.cell(forCellReference: "A1") {
    let stringValue = cellA1.stringValue() // Gets the value as a String
    print("A1: \(stringValue)")
}

if let cellB2 = worksheet.cell(forCellReference: "B2") {
    let numberValue = cellB2.floatValue() // Gets the value as a Float
    print("B2: \(numberValue)")
}

// 5. Iterate over a range of cells
for row in 1...5 {
    for column in 1...3 {
        let cellReference = "\(UnicodeScalar(64 + column)!)\(row)" // Creates refs like A1, B1, etc.
        if let cell = worksheet.cell(forCellReference: cellReference),
           let value = cell.stringValue() {
            print("\(cellReference): \(value)")
        }
    }
}

 Українська