1. Productos
  2.   Hoja de cálculo
  3.   Swift
  4.   XlsxReaderWriterSwift
 
  

Biblioteca Swift gratuita para leer y escribir archivos Excel XLSX

Biblioteca Swift 5 de código abierto y robusta que permite a los desarrolladores crear y leer archivos XLSX, copiar, eliminar hojas, aplicar estilos y formato, entre otras cosas, de forma gratuita.

¿Qué es XlsxReaderWriterSwift?

¿Cansado de lidiar con formatos complejos de hojas de cálculo en tus proyectos Swift? Imagina un escenario donde tu aplicación necesita generar un informe detallado, importar datos de usuarios desde una plantilla o incluso construir un modelo financiero dinámico, todo directamente dentro del ecosistema iOS. Analizar manualmente archivos CSV es limitante, y depender de servicios externos para manejar archivos XLSX es ineficiente. Aquí es donde XlsxReaderWriterSwift, una biblioteca potente y nativa de código abierto, viene al rescate. Proporciona a los desarrolladores Swift un conjunto de herramientas intuitivo y robusto para leer y escribir sin problemas el formato .xlsx moderno de Microsoft Excel, directamente dentro de tus aplicaciones iOS, macOS y visionOS.

XlsxReaderWriterSwift es una biblioteca Swift 5 robusta que permite a los desarrolladores de software crear y leer archivos XLSX, el estándar para hojas de cálculo Excel modernas. La biblioteca ofrece varias características importantes para trabajar con archivos Microsoft Excel XLSX, como leer archivos XLSX, crear nuevos archivos XLSX, aplicar estilo y formato a celdas, agregar y gestionar imágenes en celdas, generar informes, incrustar hojas de cálculo y mucho más. Construida sobre la biblioteca C libxlsxwriter, aporta un conjunto integral de funciones al ecosistema Apple. Esto significa que puedes generar archivos Excel totalmente funcionales y 100% compatibles directamente desde tu aplicación iOS o macOS.

Previous Next

Comenzando con XlsxReaderWriterSwift

La forma recomendada de instalar XlsxReaderWriterSwift es usando CocoaPods. Por favor, use el siguiente comando para una instalación sin problemas.

Instalar XlsxReaderWriterSwift vía CocoaPods

 pod "XlsxReaderWriterSwift"

pod install

Instalar XlsxReaderWriterSwift vía GitHub

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

Puedes descargarlo directamente desde GitHub.

Crear y escribir en un nuevo archivo XLSX a través de la biblioteca Swift

Crear un nuevo archivo desde cero y poblarlo con datos es igualmente fácil. La biblioteca de código abierto XlsxReaderWriterSwift ha proporcionado soporte completo para crear y gestionar nuevas hojas de cálculo Excel XLSX dentro de aplicaciones Swift. Los desarrolladores de software pueden crear una nueva hoja de trabajo, renombrar una hoja existente, copiar datos de la hoja, guardar el documento en un lugar específico, etc. El siguiente ejemplo muestra cómo los desarrolladores de software pueden crear una nueva hoja de trabajo Excel XLSX usando la biblioteca Swift.

¿Cómo crear una nueva hoja de trabajo Excel XLSX mediante la biblioteca 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)")
}

Aplicar estilo avanzado a celdas mediante Swift

Una hoja de cálculo no se trata solo de datos; la presentación es importante. La API de código abierto XlsxReaderWriterSwift brinda un control amplio sobre el estilo de las celdas. Va más allá de la simple entrada de datos. Puedes aplicar una amplia gama de opciones de formato, incluyendo alineación de celdas y formato de números, crear nuevas celdas, crear nuevos estilos, acceder a estilos existentes, aplicar un borde a un rango de celdas, etc. Aquí hay un ejemplo sencillo que muestra cómo los desarrolladores de software pueden aplicar estilos avanzados a celdas de Excel usando comandos Swift.

¿Cómo aplicar estilos avanzados a celdas de Excel usando la biblioteca 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
}

Leer un archivo XLSX mediante la biblioteca Swift

La biblioteca de código abierto XlsxReaderWriterSwift permite a los desarrolladores de software manipular datos dentro de hojas de cálculo Excel usando la API Swift. La biblioteca permite realizar diversas operaciones de manipulación de datos, como ordenar, filtrar y calcular valores dentro de las hojas de Excel. Esto la convierte en una herramienta ideal para tareas como análisis de datos e informes. Además, los desarrolladores de software pueden extraer fácilmente datos de celdas, filas o columnas específicas dentro de una hoja de Excel usando la API Swift. Esto es increíblemente útil cuando se trabaja con conjuntos de datos grandes y solo se necesita información específica.

¿Cómo leer datos de un archivo Excel XLSX con la API Swift gratuita?

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)")
        }
    }
}

 Español