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

Exportar SwiftObjects para Arquivos Excel via Biblioteca Swift Gratuita

Biblioteca Swift de Código Aberto que permite a desenvolvedores de software converter objetos Swift em arquivos Excel (.xlsx) profissionais com estilo personalizado.

O que é Objects2XLSX?

Aplicações modernas de iOS, macOS e Swift no lado do servidor frequentemente precisam exportar dados estruturados para planilhas Microsoft Excel. Seja gerando relatórios de vendas, listas de inventário, demonstrações financeiras ou painéis analíticos, criar arquivos Excel profissionais manualmente pode rapidamente se tornar complexo. Objects2XLSX é uma biblioteca Swift de código aberto projetada para resolver esse problema. Ela permite que os desenvolvedores convertam objetos Swift diretamente em pastas de trabalho Excel (.xlsx) usando uma API limpa, segura em termos de tipos e declarativa. Em vez de escrever manualmente linhas e colunas, os desenvolvedores simplesmente definem como seus modelos Swift mapeiam para as colunas da planilha e deixam a biblioteca cuidar do resto.

A biblioteca oferece formatação profissional, múltiplas planilhas, relatórios de progresso e uma ampla variedade de tipos de dados Swift, tornando-a uma solução excelente para geração de relatórios e aplicações empresariais. De acordo com a documentação do projeto, o Objects2XLSX foca em segurança de tipos, estilização, múltiplas planilhas e geração de Excel de alto desempenho. O Objects2XLSX elimina grande parte do código boilerplate tradicionalmente necessário para a geração de Excel. Em vez de criar células manualmente, formatar planilhas e gerenciar conversões de dados, os desenvolvedores trabalham diretamente com objetos Swift. Alguns casos de uso comuns incluem exportação de registros de clientes, criação de relatórios financeiros, gerenciamento de inventário, exportação de dados de funcionários, análise de negócios, relatórios de vendas, sistemas de avaliação educacional e painéis administrativos.

Previous Next

Começando com Objects2XLSX

A maneira recomendada de instalar o Objects2XLSX é usando o Swift Package Manager (SPM) ou Cocoapods. Por favor, use o comando a seguir para uma instalação tranquila.

Instalar Objects2XLSX via Swift Package Manager

  // Add Objects2XLSX to your Package.swift dependencies:

dependencies: [ .package(url: "https://github.com/fatbobman/Objects2XLSX.git", from: "1.3.0") ]

// Import the package
import Objects2XLSX

Instalar Objects2XLSX via GitHub:

 git clone https://github.com/fatbobman/Objects2XLSX.git

Você pode baixá-lo diretamente de GitHub.

Construção Declarativa de Pastas de Trabalho via Swift

Construir planilhas com várias abas historicamente exigia scripts de lógica aninhados e passo a passo, difíceis de escalar ou refatorar. Objects2XLSX usa uma camada de sintaxe declarativa que imita linguagens de domínio específico (DSLs) modernas. Isso permite que os engenheiros declarem exatamente quais planilhas, colunas e relações estruturais devem existir dentro de um contêiner de workbook em uma hierarquia visual limpa. Essa configuração otimiza significativamente a manutenção de longo prazo do código e simplifica revisões de código colaborativas.

Como Executar a Construção Declarativa de Pastas de Trabalho via API Swift?

import Objects2XLSX
import Foundation

struct UserAccount: Sendable { let username: String; let rank: String }
struct LogEntry: Sendable { let timestamp: Date; let action: String }

func generateSystemWorkbook(users: [UserAccount], logs: [LogEntry]) -> Workbook {
    // Declarative assembly definition organizing multi-sheet data structures
    let workbook = Workbook(
        sheets: [
            Sheet(title: "Active Users", columns: [
                Column(header: "User Profile ID", keyPath: \.username),
                Column(header: "Access Group", keyPath: \.rank)
            ]).addRows(users),
            
            Sheet(title: "Security Audits", columns: [
                Column(header: "Event Time", keyPath: \.timestamp),
                Column(header: "Operation Details", keyPath: \.action)
            ]).addRows(logs)
        ]
    )
    return workbook
}

Aplicar Estilização Profissional do Excel via Swift

Relatórios profissionais exigem mais do que dados brutos. A biblioteca de código aberto Objects2XLSX oferece amplas capacidades de estilização, permitindo que os desenvolvedores personalizem fontes, cores, bordas, alinhamentos e a aparência das células. Isso facilita a geração de planilhas prontas para negócios sem precisar abrir o Excel posteriormente para formatação manual. O sistema de estilização foi projetado para produzir workbooks polidos adequados para apresentações, relatórios e fluxos de trabalho corporativos.

Como aplicar estilos personalizados via biblioteca Swift?

import Objects2XLSX
import CoreGraphics

// Define customized visual presets matching enterprise documentation needs
let boldHeaderStyle = Style()
    .font(.system(size: 11, weight: .bold))
    .alignment(.center)
    .background(.color(red: 0.12, green: 0.53, blue: 0.90)) // Corporate Blue

let currencyColumnStyle = Style()
    .numberFormat("$#,##0.00")
    .alignment(.right)

let customizedColumn = Column(
    header: "Gross Revenue", 
    keyPath: \FinancialRow.revenue,
    headerStyle: boldHeaderStyle,
    cellStyle: currencyColumnStyle,
    width: 22.0
)

struct FinancialRow: Sendable { let revenue: Double }

Aplicar Estilização Profissional do Excel via Swift

Relatórios profissionais exigem mais do que dados brutos. A biblioteca de código aberto Objects2XLSX oferece amplas capacidades de estilização, permitindo que os desenvolvedores personalizem fontes, cores, bordas, alinhamentos e a aparência das células. Isso facilita a geração de planilhas prontas para negócios sem precisar abrir o Excel posteriormente para formatação manual. O sistema de estilização foi projetado para produzir pastas de trabalho polidas, adequadas para apresentações, relatórios e fluxos de trabalho corporativos.

Como aplicar estilos personalizados via biblioteca Swift?

import Objects2XLSX
import CoreGraphics

// Define customized visual presets matching enterprise documentation needs
let boldHeaderStyle = Style()
    .font(.system(size: 11, weight: .bold))
    .alignment(.center)
    .background(.color(red: 0.12, green: 0.53, blue: 0.90)) // Corporate Blue

let currencyColumnStyle = Style()
    .numberFormat("$#,##0.00")
    .alignment(.right)

let customizedColumn = Column(
    header: "Gross Revenue", 
    keyPath: \FinancialRow.revenue,
    headerStyle: boldHeaderStyle,
    cellStyle: currencyColumnStyle,
    width: 22.0
)

struct FinancialRow: Sendable { let revenue: Double }

Acompanhamento de Progresso para Grandes Exportações

Gerar pastas de trabalho Excel contendo milhares de registros pode levar um tempo perceptível. O Objects2XLSX inclui recursos de acompanhamento de progresso que permitem aos desenvolvedores monitorar as operações de exportação em tempo real. Esse recurso é especialmente útil em aplicativos de desktop e sistemas corporativos onde os usuários esperam feedback visual durante processos longos de geração de relatórios.

 Português