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

Exporte SwiftObjects a archivos Excel mediante una biblioteca Swift gratuita

Biblioteca Swift de código abierto que permite a los desarrolladores de software convertir objetos Swift en archivos Excel (.xlsx) profesionales con estilo personalizado.

¿Qué es Objects2XLSX?

Las aplicaciones modernas de iOS, macOS y Swift del lado del servidor a menudo necesitan exportar datos estructurados a hojas de cálculo de Microsoft Excel. Ya sea que estés generando informes de ventas, listas de inventario, estados financieros o paneles de análisis, crear archivos Excel profesionales manualmente puede volverse rápidamente complejo. Objects2XLSX es una biblioteca Swift de código abierto diseñada para resolver este problema. Permite a los desarrolladores convertir objetos Swift directamente en libros de trabajo de Excel (.xlsx) utilizando una API limpia, segura en tipos y declarativa. En lugar de escribir filas y columnas manualmente, los desarrolladores simplemente definen cómo sus modelos Swift se asignan a las columnas de la hoja de cálculo y dejan que la biblioteca se encargue del resto.

La biblioteca admite formato profesional, múltiples hojas de cálculo, generación de informes de progreso y una amplia gama de tipos de datos Swift, lo que la convierte en una solución excelente para la generación de informes y aplicaciones empresariales. Según la documentación del proyecto, Objects2XLSX se centra en la seguridad de tipos, el estilo, múltiples hojas de cálculo y la generación de Excel de alto rendimiento. Objects2XLSX elimina gran parte del código repetitivo que tradicionalmente se requería para la generación de Excel. En lugar de crear celdas manualmente, formatear hojas de cálculo y gestionar conversiones de datos, los desarrolladores trabajan directamente con objetos Swift. Algunos casos de uso comunes incluyen la exportación de registros de clientes, la creación de informes financieros, la gestión de inventario, la exportación de datos de empleados, análisis de negocios, informes de ventas, sistemas de calificaciones educativas y paneles administrativos.

Previous Next

Comenzando con Objects2XLSX

La forma recomendada de instalar Objects2XLSX es usando Swift Package Manager (SPM) o Cocoapods. Por favor, use el siguiente comando para una instalación sin problemas.

Instalar Objects2XLSX mediante 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 a través de GitHub:

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

Puedes descargarlo directamente desde GitHub.

Construcción declarativa de libros de trabajo mediante Swift

Crear hojas de cálculo con múltiples pestañas históricamente requería scripts de lógica anidados y paso a paso que eran difíciles de escalar o refactorizar. Objects2XLSX utiliza una capa de sintaxis declarativa que imita los lenguajes de dominio específico (DSL) modernos. Esto permite a los ingenieros especificar exactamente qué hojas, columnas y relaciones estructurales deben existir dentro de un contenedor de libro de trabajo en una jerarquía visual y limpia. Esta configuración optimiza enormemente el mantenimiento a largo plazo de la base de código y simplifica las revisiones de código colaborativas.

¿Cómo realizar la construcción declarativa de libros de trabajo mediante la API de 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 estilo profesional de Excel mediante Swift

Los informes profesionales requieren más que datos sin procesar. La biblioteca de código abierto Objects2XLSX ofrece amplias capacidades de estilo, permitiendo a los desarrolladores personalizar fuentes, colores, bordes, alineaciones y la apariencia de las celdas. Esto facilita la generación de hojas de cálculo listas para el negocio sin abrir Excel posteriormente para formateo manual. El sistema de estilo está diseñado para producir libros de trabajo pulidos, adecuados para presentaciones, informes y flujos de trabajo empresariales.

¿Cómo aplicar estilos personalizados mediante la 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 estilo profesional de Excel mediante Swift

Los informes profesionales requieren más que datos sin procesar. La biblioteca de código abierto Objects2XLSX ofrece amplias capacidades de estilo, permitiendo a los desarrolladores personalizar fuentes, colores, bordes, alineaciones y la apariencia de las celdas. Esto facilita la generación de hojas de cálculo listas para el negocio sin necesidad de abrir Excel después para formateo manual. El sistema de estilo está diseñado para producir libros de trabajo pulidos, adecuados para presentaciones, informes y flujos de trabajo empresariales.

¿Cómo aplicar estilos personalizados mediante la 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 }

Seguimiento del progreso para exportaciones grandes

Generar libros de trabajo de Excel que contienen miles de registros puede llevar un tiempo notable. Objects2XLSX incluye capacidades de seguimiento de progreso que permiten a los desarrolladores monitorizar las operaciones de exportación en tiempo real. Esta característica es especialmente útil en aplicaciones de escritorio y sistemas empresariales donde los usuarios esperan retroalimentación visual durante procesos de generación de informes prolongados.

 Español