1. Produtos
  2.   Planilha
  3.   Swift
  4.   XlsxReaderWriterSwift
 
  

Biblioteca Swift grátis para ler e escrever arquivos Excel XLSX

Biblioteca robusta Swift 5 de código aberto que capacita desenvolvedores a criar e ler arquivos XLSX, copiar, remover planilhas, aplicar estilos e formatação e assim por diante gratuitamente.

O que é XlsxReaderWriterSwift?

Cansado de lutar com formatos de planilha complexos em seus projetos Swift? Imagine um cenário em que seu app precise gerar um relatório detalhado, importar dados de usuário a partir de um modelo ou até criar um modelo financeiro dinâmico — tudo diretamente no ecossistema iOS. Analisar arquivos CSV manualmente é limitante, e depender de serviços externos para lidar com arquivos XLSX é ineficiente. É aqui que entra o XlsxReaderWriterSwift, uma biblioteca poderosa e nativa de código aberto, que oferece aos desenvolvedores Swift um kit de ferramentas intuitivo e robusto para ler e escrever o formato .xlsx moderno da Microsoft Excel, diretamente nos seus aplicativos iOS, macOS e visionOS.

XlsxReaderWriterSwift é uma biblioteca robusta Swift 5 que capacita desenvolvedores a criar e ler arquivos XLSX, o padrão para planilhas Excel modernas. A biblioteca oferece diversos recursos importantes para trabalhar com arquivos Microsoft Excel XLSX, como leitura de arquivos XLSX, criação de novos arquivos XLSX, aplicação de estilos e formatação em células, inserção e gerenciamento de imagens nas células, geração de relatórios, incorporação de planilhas e muito mais. Construída sobre a biblioteca C libxlsxwriter, ela traz um conjunto completo de recursos para o ecossistema Apple. Isso significa que você pode gerar arquivos Excel totalmente funcionais e 100% compatíveis diretamente a partir de seu aplicativo iOS ou macOS.

Previous Next

Começando com XlsxReaderWriterSwift

A maneira recomendada de instalar XlsxReaderWriterSwift é usando CocoaPods. Por favor, use o comando abaixo para uma instalação tranquila.

Instale XlsxReaderWriterSwift via CocoaPods

 pod "XlsxReaderWriterSwift"

pod install

Instale XlsxReaderWriterSwift via GitHub

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

Você pode baixá-lo diretamente do GitHub.

Criar e escrever em um novo arquivo XLSX via Biblioteca Swift

Criar um novo arquivo do zero e preenchê-lo com dados é igualmente fácil. A biblioteca de código aberto XlsxReaderWriterSwift oferece suporte completo para criar e gerenciar novas planilhas Excel XLSX dentro de aplicações Swift. Os desenvolvedores podem criar uma nova planilha, renomear planilhas existentes, copiar dados da planilha, salvar o documento em um local específico e assim por diante. O exemplo a seguir demonstra como os desenvolvedores podem criar uma nova planilha Excel XLSX usando a biblioteca Swift.

Como criar uma nova planilha Excel XLSX via 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 avançado de célula via Swift

Uma planilha não se trata apenas de dados; a apresentação importa. A API de código aberto XlsxReaderWriterSwift fornece controle extensivo sobre a formatação de células. Vai além da simples inserção de dados. Você pode aplicar uma ampla variedade de opções de formatação, incluindo alinhamento de célula e formatação numérica, criação de novas células, criação de novos estilos, acesso a estilos existentes, aplicação de bordas a um intervalo de células, e assim por diante. Aqui está um exemplo simples que mostra como os desenvolvedores podem aplicar estilos avançados a células do Excel usando comandos Swift.

Como aplicar estilos avançados a células Excel usando a 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
}

Lendo um arquivo XLSX via Biblioteca Swift

A biblioteca de código aberto XlsxReaderWriterSwift permite que os desenvolvedores manipulem dados dentro de planilhas Excel usando a API Swift. A biblioteca permite executar várias operações de manipulação de dados, como classificação, filtragem e cálculo de valores dentro das planilhas Excel. Isso a torna uma ferramenta ideal para tarefas como análise de dados e geração de relatórios. Além disso, os desenvolvedores podem extrair facilmente dados de células, linhas ou colunas específicas dentro de uma planilha Excel usando a API Swift. Isso é extremamente útil ao lidar com grandes conjuntos de dados e precisar apenas de informações específicas.

Como ler dados de um arquivo Excel XLSX com 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)")
        }
    }
}

 Português