1. منتجات
  2.   جدول
  3.   Swift
  4.   Objects2XLSX
 
  

تصدير SwiftObjects إلى ملفات Excel عبر مكتبة Swift مجانية

مكتبة Swift مفتوحة المصدر تسمح لمطوري البرمجيات بتحويل كائنات Swift إلى ملفات Excel (.xlsx) احترافية مع تنسيق مخصص.

ما هو Objects2XLSX؟

غالبًا ما تحتاج تطبيقات Swift الحديثة على iOS و macOS والجانب الخادمي إلى تصدير البيانات المهيكلة إلى جداول بيانات Microsoft Excel. سواء كنت تقوم بإنشاء تقارير مبيعات أو قوائم جرد أو بيانات مالية أو لوحات تحليلات، فإن إنشاء ملفات Excel احترافية يدويًا يمكن أن يصبح معقدًا بسرعة. Objects2XLSX هي مكتبة Swift مفتوحة المصدر صُممت لحل هذه المشكلة. تتيح للمطورين تحويل كائنات Swift مباشرةً إلى دفاتر عمل Excel (.xlsx) باستخدام واجهة برمجة تطبيقات نظيفة، آمنة من النوع، وتصريحية. بدلاً من كتابة الصفوف والأعمدة يدويًا، يحدد المطورون ببساطة كيف تُطابق نماذج Swift الخاصة بهم أعمدة الجدول وتترك المكتبة الباقي.

تدعم المكتبة التنسيق الاحترافي، وجداول عمل متعددة، وتقرير التقدم، ومجموعة واسعة من أنواع بيانات Swift، مما يجعلها حلاً ممتازًا لإنشاء التقارير وتطبيقات الأعمال. وفقًا لتوثيق المشروع، يركز Objects2XLSX على سلامة النوع، والتنسيق، وجداول العمل المتعددة، وإنشاء Excel عالي الأداء. يزيل Objects2XLSX الكثير من الشيفرة المتكررة التي كانت مطلوبة تقليديًا لإنشاء Excel. بدلاً من إنشاء الخلايا يدويًا، وتنسيق جداول العمل، وإدارة تحويلات البيانات، يعمل المطورون مباشرةً مع كائنات Swift. تشمل بعض حالات الاستخدام الشائعة تصدير سجلات العملاء، وإنشاء التقارير المالية، وإدارة المخزون، وتصدير بيانات الموظفين، وتحليلات الأعمال، وتقرير المبيعات، وأنظمة تقييم التعليم، ولوحات الإدارة.

Previous Next

البدء مع Objects2XLSX

الطريقة الموصى بها لتثبيت Objects2XLSX هي باستخدام Swift Package Manager (SPM) أو Cocoapods. يرجى استخدام الأمر التالي لتثبيت سلس.

تثبيت Objects2XLSX عبر مدير الحزم Swift

  // 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). يتيح ذلك للمهندسين تحديد بالضبط ما هي الأوراق والأعمدة والعلاقات الهيكلية التي يجب أن توجد داخل غلاف دفتر العمل في تسلسل هرمي بصري نظيف. هذه التكوينات تحسن بشكل كبير صيانة قاعدة الشيفرة على المدى الطويل وتبسط مراجعات الشيفرة التعاونية.

كيف تقوم بتنفيذ إنشاء دفتر عمل تصريحي عبر واجهة برمجة تطبيقات 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
}

تطبيق تنسيق إكسل احترافي عبر 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 }

تطبيق تنسيق إكسل احترافي عبر 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 إمكانيات تتبع التقدم التي تسمح للمطورين بمراقبة عمليات التصدير في الوقت الفعلي. هذه الميزة مفيدة بشكل خاص في تطبيقات سطح المكتب والأنظمة المؤسسية حيث يتوقع المستخدمون ردود فعل بصرية أثناء عمليات توليد التقارير الطويلة.

 عربي