1. Produkty
  2.   Arkusz
  3.   Swift
  4.   Objects2XLSX
 
  

Eksportuj obiekty Swift do plików Excel za pomocą darmowej biblioteki Swift

Otwarta biblioteka Swift, która umożliwia programistom konwertowanie obiektów Swift na profesjonalne pliki Excel (.xlsx) z niestandardowym formatowaniem.

Czym jest Objects2XLSX?

Nowoczesne aplikacje iOS, macOS oraz Swift po stronie serwera często muszą eksportować ustrukturyzowane dane do arkuszy kalkulacyjnych Microsoft Excel. Niezależnie od tego, czy generujesz raporty sprzedaży, listy inwentarzowe, sprawozdania finansowe czy pulpity analityczne, ręczne tworzenie profesjonalnych plików Excel może szybko stać się skomplikowane. Objects2XLSX to otwarto‑źródłowa biblioteka Swift zaprojektowana w celu rozwiązania tego problemu. Umożliwia programistom konwertowanie obiektów Swift bezpośrednio na skoroszyty Excel (.xlsx) przy użyciu czystego, typowo‑bezpiecznego i deklaratywnego API. Zamiast ręcznie pisać wiersze i kolumny, programiści po prostu definiują, jak ich modele Swift mapują się na kolumny arkusza i pozwalają bibliotece zająć się resztą.

Biblioteka obsługuje profesjonalne formatowanie, wiele arkuszy, raportowanie postępu oraz szeroką gamę typów danych Swift, co czyni ją doskonałym rozwiązaniem do generowania raportów i aplikacji biznesowych. Zgodnie z dokumentacją projektu, Objects2XLSX koncentruje się na bezpieczeństwie typów, stylizacji, wielu arkuszach oraz wydajnym generowaniu plików Excel. Objects2XLSX usuwa dużą część kodu szablonowego tradycyjnie wymaganego przy generowaniu Excel. Zamiast ręcznego tworzenia komórek, formatowania arkuszy i zarządzania konwersjami danych, programiści pracują bezpośrednio z obiektami Swift. Niektóre typowe przypadki użycia obejmują eksport rekordów klientów, tworzenie raportów finansowych, zarządzanie zapasami, eksport danych pracowników, analitykę biznesową, raportowanie sprzedaży, systemy oceniania edukacyjnego oraz pulpity administracyjne.

Previous Next

Rozpoczęcie pracy z Objects2XLSX

Zalecanym sposobem instalacji Objects2XLSX jest użycie Swift Package Manager (SPM) lub Cocoapods. Proszę użyć poniższego polecenia, aby przeprowadzić płynną instalację.

Zainstaluj Objects2XLSX za pomocą 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

Zainstaluj Objects2XLSX przez GitHub:

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

Możesz pobrać go bezpośrednio z GitHub.

Deklaratywne tworzenie skoroszytu w Swift

Budowanie arkuszy kalkulacyjnych z wieloma kartami historycznie wymagało zagnieżdżonych, krok po kroku skryptów logicznych, które były trudne do skalowania lub refaktoryzacji. Objects2XLSX używa warstwy składni deklaratywnej, która naśladuje nowoczesne języki specyficzne dla domen (DSL). Pozwala to inżynierom dokładnie określić, jakie arkusze, kolumny i relacje strukturalne powinny istnieć wewnątrz opakowania skoroszytu w czystej, wizualnej hierarchii. Ta konfiguracja znacznie optymalizuje długoterminowe utrzymanie bazy kodu i upraszcza współpracę przy przeglądach kodu.

Jak wykonać deklaratywne tworzenie skoroszytu przy użyciu 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
}

Zastosuj profesjonalne formatowanie Excela w Swift

Profesjonalne raporty wymagają więcej niż surowe dane. Biblioteka open source Objects2XLSX zapewnia rozbudowane możliwości stylizacji, pozwalając programistom dostosować czcionki, kolory, obramowania, wyrównania i wygląd komórek. Dzięki temu łatwo generować arkusze gotowe do użytku biznesowego bez konieczności otwierania Excela w celu ręcznego formatowania. System stylizacji został zaprojektowany tak, aby tworzyć dopracowane skoroszyty odpowiednie do prezentacji, raportowania i przepływów pracy w przedsiębiorstwach.

Jak zastosować spersonalizowane style za pomocą biblioteki 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 }

Zastosuj profesjonalne formatowanie Excela w Swift

Profesjonalne raporty wymagają czegoś więcej niż surowych danych. Biblioteka open source Objects2XLSX oferuje rozbudowane możliwości stylizacji, pozwalając programistom dostosować czcionki, kolory, obramowania, wyrównania i wygląd komórek. Dzięki temu łatwo generować arkusze kalkulacyjne gotowe do użytku biznesowego, bez konieczności późniejszego otwierania Excela w celu ręcznego formatowania. System stylizacji został zaprojektowany tak, aby tworzyć dopracowane skoroszyty odpowiednie do prezentacji, raportowania i procesów korporacyjnych.

Jak zastosować spersonalizowane style za pomocą biblioteki 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 }

Śledzenie postępu przy dużych eksportach

Tworzenie skoroszytów Excel zawierających tysiące rekordów może zająć zauważalny czas. Objects2XLSX zawiera funkcje śledzenia postępu, które pozwalają programistom monitorować operacje eksportu w czasie rzeczywistym. Ta funkcja jest szczególnie przydatna w aplikacjach desktopowych i systemach korporacyjnych, gdzie użytkownicy oczekują wizualnej informacji zwrotnej podczas długotrwałych procesów generowania raportów.

 Polski