Експортирайте SwiftObjects в Excel файлове чрез безплатна Swift библиотека

Отворена Swift библиотека, която позволява на софтуерните разработчици да конвертират Swift обекти в професионални Excel (.xlsx) файлове с персонализирано стилизиране.

Какво е Objects2XLSX?

Съвременните iOS, macOS и сървърни Swift приложения често се нуждаят от експортиране на структурирани данни в електронни таблици на Microsoft Excel. Независимо дали генерирате отчети за продажби, списъци с инвентар, финансови отчети или аналитични табла, създаването на професионални Excel файлове ръчно може бързо да се окаже сложно. Objects2XLSX е отворена Swift библиотека, създадена за решаване на този проблем. Тя позволява на разработчиците да конвертират Swift обекти директно в Excel (.xlsx) работни книги, използвайки чист, типово безопасен и декларативен API. Вместо да пишете редове и колони ръчно, разработчиците просто дефинират как техните Swift модели се съпоставят със колоните в електронната таблица и оставят библиотеката да се погрижи за останалото.

Библиотеката поддържа професионално форматиране, множество работни листове, отчитане на напредъка и широк набор от типове данни на Swift, което я прави отлична решение за генериране на отчети и бизнес приложения. Според документацията на проекта, Objects2XLSX се фокусира върху безопасността на типове, стилизирането, множество работни листове и високопроизводително генериране на Excel. Objects2XLSX премахва голяма част от шаблонния код, традиционно необходим за генериране на Excel. Вместо ръчно създаване на клетки, форматиране на работни листове и управление на преобразуванията на данни, разработчиците работят директно с Swift обекти. Някои чести случаи на употреба включват експортиране на клиентски записи, създаване на финансови отчети, управление на инвентара, експортиране на данни за служители, бизнес аналитика, отчитане на продажби, образователни системи за оценяване и административни табла.

Previous Next

Започване с Objects2XLSX

Препоръчителният начин за инсталиране на Objects2XLSX е чрез Swift Package Manager (SPM) или CocoaPods. Моля, използвайте следната команда за гладка инсталация.

Инсталиране на Objects2XLSX чрез 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

Инсталиране на Objects2XLSX чрез GitHub:

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

Можете да го изтеглите директно от GitHub.

Декларативно създаване на работна книга чрез Swift

Създаването на електронни таблици с множество листове исторически изискваше вложени, стъпка по стъпка логически скриптове, които бяха трудни за мащабиране или рефакториране. Objects2XLSX използва декларативен слой за синтаксис, който имитира съвременни домейн-специфични езици (DSL). Това позволява на инженерите точно да определят какви листове, колони и структурни връзки трябва да съществуват в обвивката на работната книга в чиста визуална йерархия. Тази конфигурация значително оптимизира дългосрочната поддръжка на кодовата база и опростява съвместните прегледи на кода.

Как да извършим декларативно създаване на работна книга чрез 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
}

Прилагане на професионален Excel стил чрез Swift

Професионалните отчети изискват повече от сурови данни. Отворената библиотека Objects2XLSX предоставя обширни възможности за стилизиране, позволявайки на разработчиците да персонализират шрифтове, цветове, граници, подравнявания и външния вид на клетките. Това улеснява създаването на бизнес-готови електронни таблици без необходимост от отваряне на Excel за ръчно форматиране. Системата за стилизиране е проектирана да произвежда изискано оформени работни книги, подходящи за презентации, отчитане и корпоративни работни процеси.

Как да приложите персонализирано стилизиране чрез 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 }

Прилагане на професионален Excel стил чрез Swift

Професионалните отчети изискват повече от сурови данни. Отворената библиотека Objects2XLSX предоставя обширни възможности за стилизиране, позволявайки на разработчиците да персонализират шрифтове, цветове, граници, подравнявания и външния вид на клетките. Това улеснява създаването на бизнес‑готови електронни таблици без да се отваря Excel след това за ръчно форматиране. Системата за стилизиране е проектирана да създава полирани работни книги, подходящи за презентации, отчитане и корпоративни работни процеси.

Как да приложите персонализирано стилизиране чрез 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 }

Проследяване на напредъка при големи експорти

Създаването на Excel работни книги, съдържащи хиляди записи, може да отнеме забележително време. Objects2XLSX включва възможности за проследяване на напредъка, които позволяват на разработчиците да наблюдават операциите по експортиране в реално време. Тази функция е особено полезна в настолни приложения и корпоративни системи, където потребителите очакват визуална обратна връзка по време на продължителни процеси на генериране на отчети.

 Български