ייצא 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. כמה מקרים נפוצים כוללים ייצוא רשומות לקוחות, יצירת דוחות פיננסיים, ניהול מלאי, ייצוא נתוני עובדים, ניתוח עסקי, דיווח מכירות, מערכות דירוג חינוכיות ולוחות מחוונים מנהליים.
התחלה עם 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 משתמשת בשכבת תחביר דקלרטיבית המדמה שפות תחום‑ספציפיות מודרניות (DSLs). זה מאפשר למהנדסים לציין בדיוק אילו גיליונות, עמודות וקשרים מבניים צריכים להיות בתוך עטיפת חוברת עבודה במבנה חזותי נקי. תצורה זו משפרת משמעותית את תחזוקת הקוד בטווח הארוך ומפשטת ביקורות קוד משותפות.
איך לבצע בניית חוברת עבודה דקלרטיבית באמצעות 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
}
החלת עיצוב מקצועי של 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 כוללת יכולות מעקב התקדמות המאפשרות למפתחים לנטר את פעולות הייצוא בזמן אמת. תכונה זו שימושית במיוחד ביישומי שולחן עבודה ובמערכות ארגוניות שבהן המשתמשים מצפים לקבל משוב חזותי במהלך תהליכי יצירת דוחות ארוכים.