Crear libro de Excel, agregar hojas e imágenes con la biblioteca Swift gratuita
Biblioteca Swift de código abierto que permite a los desarrolladores crear y exportar libros de Excel. Agregar nuevas hojas de cálculo, incrustar imágenes Pixel-Perfect, datos CSV/TSV, aplicar formato y estilo a celdas de forma gratuita.
¿Qué es XLKit?
En el mundo de desarrollo de iOS, la eficiencia es primordial. Escribir el mismo código base para tareas comunes como cuadrículas adaptables, detección de dispositivos o retroalimentación háptica puede ralentizar incluso a los desarrolladores más experimentados. Aparece XLKit, un paquete Swift de código abierto creado por Amitabh Pandey que busca potenciar tu flujo de trabajo SwiftUI con un conjunto poderoso y curado de extensiones y componentes. Una de las características más destacadas de XLKit es su API sin esfuerzo. Diseñada pensando en la experiencia del desarrollador, ofrece una interfaz fluida y encadenable que hace que tu código sea limpio, legible y altamente mantenible. Di adiós a la sintaxis confusa y hola a una forma más natural de crear tus hojas de cálculo.
XLKit es una biblioteca Swift moderna y de código abierto diseñada para simplificar la creación y manipulación de archivos Excel (.xlsx) en macOS e iOS. Con una API fluida y encadenable, inserción de imágenes, importación/exportación CSV/TSV, formato seguro por tipos y alta compatibilidad con Excel, XLKit permite a los desarrolladores crear hojas de cálculo de calidad profesional con facilidad. Está construida en Swift puro (Swift 6.0+) dirigida a macOS 12+ e iOS 15+, y prioriza la seguridad, el rendimiento y un diseño mantenible. XLKit es un testimonio del poder de la comunidad de código abierto para resolver desafíos de desarrollo comunes. No intenta ser un marco enorme y abarcador, sino que se centra en proporcionar un conjunto de herramientas bien diseñadas y prácticas que los desarrolladores SwiftUI realmente usarán cada día.
Comenzando con XLKit
La forma recomendada de instalar XLKit es mediante CocoaPods. Por favor, use el siguiente comando para una instalación sin problemas.
Instalar XLKit vía CocoaPods
// Add XLKit to your Package.swift dependencies:
dependencies: [
.package(url: "https://github.com/TheAcharya/XLKit.git", from: "1.0.8")
]
Instalar XLKit vía GitHub
git clone https://github.com/TheAcharya/XLKit.git
Puede descargarlo directamente desde GitHub.
Crear y trabajar con hojas de cálculo de Excel vía Swift
La biblioteca de código abierto XLKit ofrece potentes funciones para crear y gestionar archivos de hojas de cálculo Excel dentro de aplicaciones Swift. Primero debe crear un objeto Workbook, que contendrá todas sus hojas de cálculo. Un workbook puede contener varias hojas. Puede crear una y comenzar a añadir datos en forma de cuadrícula usando una matriz bidimensional ([[Cell]]). El siguiente ejemplo muestra lo fácil que es para los desarrolladores crear un nuevo workbook y luego añadir hojas dentro de él usando código Swift.
¿Cómo crear un nuevo libro de Excel y agregar una hoja dentro de él mediante la biblioteca Swift?
import XLKit
// Create a new Excel workbook
let workbook = Workbook()
// Add a worksheet named "Sales Report"
let sheet = workbook.addWorksheet("Sales Report")
// Define your data as a 2D array of Cell objects
let data: [[Cell]] = [
[Cell("Product"), Cell("Q1 Sales"), Cell("Q2 Sales"), Cell("Total")],
[Cell("Widget A"), Cell(2450), Cell(3105), Cell(5555)],
[Cell("Widget B"), Cell(1800), Cell(2100), Cell(3900)],
[Cell("Widget C"), Cell(975), Cell(1225), Cell(2200)]
]
// Add the data to the worksheet starting at cell A1
try? sheet.addData(data, startCell: CellReference(column: 0, row: 0))
Incrustación de imágenes Pixel-Perfect vía Swift
La biblioteca XLKit lleva el manejo de imágenes al siguiente nivel con sus capacidades perfectas de incrustación de imágenes. Conserva automáticamente la proporción de aspecto de sus imágenes, asegurando que se vean nítidas y profesionales en sus hojas de cálculo. Además, la biblioteca cuenta con ajuste automático de celdas, que adapta automáticamente el ancho de columnas y la altura de filas para ajustarse perfectamente a sus imágenes. El siguiente ejemplo muestra lo fácil que es para los desarrolladores incrustar un GIF en una celda de hoja de cálculo utilizando la API Swift.
¿Cómo incrustar una imagen GIF en una celda de hoja de cálculo mediante la biblioteca Swift?
let gifData = try Data(contentsOf: URL(fileURLWithPath: "alice.gif"))
try await sheet.embedImageAutoSized(gifData, at: "B2", of: workbook)
Formato de celda integral vía biblioteca Swift
Una hoja de cálculo con apariencia profesional depende de los detalles. La biblioteca XLKit proporciona un rico conjunto de funciones de formateo de celdas, permitiendo a los desarrolladores controlar todo, desde colores de fuente y rellenos de fondo hasta bordes y alineación de texto. Esto permite a los usuarios crear informes y exportaciones de datos visualmente atractivos y fáciles de leer. Aquí hay un ejemplo útil que muestra cómo aplicar formato a una celda de hoja de cálculo dentro de aplicaciones Swift.
¿Cómo aplicar formato a las celdas de la hoja dentro de aplicaciones Swift?
sheet.setCell("A1", string: "Name", format: CellFormat.header())
sheet.setCell("B1", string: "Photo", format: CellFormat.header())
sheet.setCell("C1", string: "Age", format: CellFormat.coloredText(color: "#FF0000"))
Importar y exportar datos CSV/TSV vía biblioteca Swift
En el mundo actual impulsado por los datos, la capacidad de trabajar con varios formatos de datos es crucial. La biblioteca de código abierto XLKit ha incluido varias funciones importantes para cargar y trabajar con datos CSV y TSV mediante comandos Swift. La biblioteca incluye soporte integrado para importar y exportar datos CSV y TSV, lo que facilita enormemente integrar tus flujos de trabajo de Excel con otras fuentes y aplicaciones de datos.
