1. produkty
  2.   Tabulka
  3.   Swift
  4.   Objects2XLSX
 
  

Exportujte SwiftObjects do Excel souborů pomocí bezplatné Swift knihovny

Open source Swift knihovna, která umožňuje vývojářům převádět Swift objekty do profesionálních Excel (.xlsx) souborů s vlastním stylováním.

Co je Objects2XLSX?

Moderní iOS, macOS a serverové Swift aplikace často potřebují exportovat strukturovaná data do tabulek Microsoft Excel. Ať už generujete prodejní zprávy, seznamy zásob, finanční výkazy nebo analytické dashboardy, vytváření profesionálních Excel souborů ručně může rychle být složité. Objects2XLSX je open-source Swift knihovna navržená k řešení tohoto problému. Umožňuje vývojářům převádět Swift objekty přímo do Excel (.xlsx) sešitů pomocí čistého, typově bezpečného a deklarativního API. Místo ručního psaní řádků a sloupců vývojáři jednoduše definují, jak jejich Swift modely mapují na sloupce tabulky, a nechají knihovnu, aby se postarala o zbytek.

Knihovna podporuje profesionální formátování, více listů, hlášení postupu a širokou škálu datových typů Swift, což z ní činí vynikající řešení pro generování reportů a podnikové aplikace. Podle dokumentace projektu se Objects2XLSX zaměřuje na typovou bezpečnost, stylování, více listů a vysoce výkonné generování Excelu. Objects2XLSX odstraňuje velkou část boilerplate kódu, který byl tradičně vyžadován pro generování Excelu. Místo ručního vytváření buněk, formátování listů a správy konverzí dat pracují vývojáři přímo s objekty Swift. Mezi běžné případy použití patří export záznamů zákazníků, tvorba finančních reportů, správa zásob, export dat zaměstnanců, podniková analytika, prodejní reporty, vzdělávací systémy hodnocení a administrativní dashboardy.

Previous Next

Začínáme s Objects2XLSX

Doporučený způsob instalace Objects2XLSX je pomocí Swift Package Manager (SPM) nebo Cocoapods. Použijte prosím následující příkaz pro hladkou instalaci.

Instalace Objects2XLSX přes 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

Instalace Objects2XLSX přes GitHub:

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

Můžete si jej stáhnout přímo z GitHub.

Deklarativní tvorba sešitu pomocí Swiftu

Vytváření vícestránkových tabulek v minulosti vyžadovalo vnořené, krok za krokem psané skripty, které bylo obtížné škálovat nebo refaktorovat. Objects2XLSX používá deklarativní vrstvu syntaxe, která napodobuje moderní doménově specifické jazyky (DSL). To umožňuje inženýrům přesně definovat, jaké listy, sloupce a strukturované vztahy by měly existovat uvnitř obalu sešitu v čisté vizuální hierarchii. Toto nastavení výrazně optimalizuje dlouhodobou údržbu kódu a zjednodušuje kolektivní revize kódu.

Jak provést deklarativní tvorbu sešitu pomocí Swift API?

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
}

Použijte profesionální stylování Excelu pomocí Swiftu

Profesionální zprávy vyžadují více než jen surová data. Open‑source knihovna Objects2XLSX poskytuje rozsáhlé možnosti stylování, které umožňují vývojářům přizpůsobit písma, barvy, okraje, zarovnání a vzhled buněk. To usnadňuje generování tabulek připravených pro podnikání, aniž by bylo nutné po vytvoření otevírat Excel pro ruční formátování. Systém stylování je navržen tak, aby vytvářel vylepšené sešity vhodné pro prezentace, reportování a podnikové workflowy.

Jak použít přizpůsobené stylování pomocí Swift knihovny?

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 }

Použijte profesionální stylování Excelu pomocí Swiftu

Profesionální zprávy vyžadují více než surová data. Open source knihovna Objects2XLSX poskytuje rozsáhlé možnosti stylování, které umožňují vývojářům přizpůsobit písma, barvy, okraje, zarovnání a vzhled buněk. To usnadňuje generování tabulek připravených pro podnikání, aniž byste po vytvoření museli otevírat Excel a ručně je formátovat. Systém stylování je navržen tak, aby vytvářel vylepšené sešity vhodné pro prezentace, reportování a podnikové pracovní postupy.

Jak použít přizpůsobené stylování pomocí Swift knihovny?

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 }

Sledování průběhu velkých exportů

Generování Excel sešitů obsahujících tisíce záznamů může trvat znatelně dlouho. Objects2XLSX zahrnuje funkce sledování průběhu, které umožňují vývojářům monitorovat exportní operace v reálném čase. Tato funkce je zvláště užitečná v desktopových aplikacích a podnikových systémech, kde uživatelé očekávají vizuální zpětnou vazbu během dlouhých procesů generování zpráv.

 Čeština