کتابخانه رایگان Swift برای خواندن، نوشتن و تبدیل فایل‌های Excel XLSX

ایجاد، ویرایش، دستکاری و تبدیل صفحه‌گسترده Excel XLSX، اعمال استایل و استخراج داده‌ها به‌صورت مستقیم بر روی دستگاه‌های موبایل با استفاده از کتابخانه منبع باز Swift.

SwiftXLSX چیست؟

در دنیای توسعه‌ی نرم‌افزار مدرن، توانایی کار با فرمت‌های مختلف فایل ضروری است. یکی از پرکاربردترین فرمت‌های فایل در کسب‌وکار و تجزیه‌وتحلیل داده‌ها، صفحه‌گسترده Excel است. چه در حال پردازش داده‌ها باشید، چه گزارش تولید کنید یا صرفاً نیاز به تعامل با فایل‌های Excel در برنامه‌ی Swift خود داشته باشید، کتابخانه‌ی SwiftXLSX ابزار ارزشمندی در جعبه‌ابزار شماست. این کتابخانه یک کتابخانه‌ی متن‌باز Swift است که برای ساده‌سازی فرایند خواندن و نوشتن فایل‌های Excel در فرمت XLSX طراحی شده است. اگر شما یک توسعه‌دهنده‌ی Swift هستید که وظیفه‌ی پردازش داده‌ها، تولید گزارش‌ها یا مدیریت فایل‌های Excel در برنامه‌تان را دارید، SwiftXLSX می‌تواند به‌طرز بسیار مؤثری این کارها را برای شما آسان کند.

SwiftXLSX به گونه‌ای طراحی شده است که استفاده از آن آسان بوده و به‌صورت یکپارچه در پروژه‌های Swift شما ادغام می‌شود. این کتابخانه فرایند کار با فایل‌های Excel را ساده می‌کند و کارهایی مانند استخراج داده، دستکاری و تولید گزارش را به‌صورت روانی انجام می‌دهد. ویژگی‌های مهمی که در این کتابخانه موجود است شامل خواندن و نوشتن اسناد Excel XLSX، استخراج داده از سلول‌های مشخص، ردیف‌ها یا ستون‌ها، مرتب‌سازی داده‌ها، فیلتر کردن داده‌ها و محاسبه مقادیر درون شیت‌های Excel، اعمال قالب‌بندی و استایل به سلول‌ها و بسیاری موارد دیگر می‌باشد. کتابخانه برای کار در پلتفرم‌های مختلف مانند iOS، macOS و Linux طراحی شده است.

کتابخانه SwiftXLSX ابزاری قدرتمند و چندمنظوره برای توسعه‌دهندگان Swift است که نیاز به کار با فایل‌های Excel دارند. چون به زبان Swift نوشته شده، این کتابخانه به‌صورت یکپارچه با پایه کد Swift موجود شما ترکیب می‌شود. این به معنای این است که می‌توانید تمام قابلیت‌های زبان برنامه‌نویسی Swift را در حین کار با فایل‌های Excel به‌کار بگیرید. چه در حال ساختن ابزار تحلیل داده باشید، چه ویژگی گزارش‌گیری یا صرفاً نیاز به تعامل با فایل‌های Excel در برنامه‌تان داشته باشید، این کتابخانه فرآیند را ساده می‌کند و مجموعه‌ای محکم از ویژگی‌ها را برای مدیریت کارهای مرتبط با Excel ارائه می‌دهد. با سادگی استفاده، پشتیبانی چندپلتفرمی و یکپارچگی قوی با Swift، افزونۀ ارزشمندی برای جعبه‌ابزار هر توسعه‌دهنده Swift است.

در یک نگاه

نمای کلی ویژگی‌های SwiftXLSX.

Features Overview

خواندن XLSX
نوشتن XLSX
ایجاد گزارش‌های XLSX
استخراج داده‌ها
مرتب‌سازی داده‌ها
افزودن تصاویر
افزودن نظرات
محدوده‌های سلول
افزودن ردیف‌ها
مدیریت جدول‌ها
رمزگذاری Excel
محاسبه فرمول
فیلتر داده‌ها

SwiftXLSX

SwiftXLSX از فرمت‌های محبوب Spreadsheet که در زیر لیست شده‌اند، پشتیبانی می‌کند.

Reader

XLSX

Writer

TXT, XLS, HTML

SwiftXLSX

استقلال پلتفرم

SwiftXLSX فقط به .NET Framework 4.5 یا بالاتر و Swift 5.1 و نسخه‌های بعدی نیاز دارد.

شروع کار با SwiftXLSX

روش پیشنهادی برای نصب SwiftXLSX استفاده از CocoaPods است. لطفاً برای نصب روان، دستور زیر را اجرا کنید.

نصب SwiftXLSX از طریق CocoaPods

 pod "SwiftXLSX"

pod install
 می‌توانید آن را مستقیماً از GitHub دانلود کنید.

خواندن و نوشتن فایل‌های Excel از طریق API Swift

کتابخانه منبع باز SwiftXLSX به توسعه‌دهندگان نرم‌افزار اجازه می‌دهد با فقط چند خط کد Swift یک فایل جدید از ابتدا ایجاد کنند. توسعه‌دهندگان می‌توانند به‌سادگی داده‌ها را از فایل‌های Excel موجود بارگذاری و بخوانند. ویژگی‌های مهم دیگری نیز در این کتابخانه وجود دارد، از جمله وارد کردن فایل‌های Excel، استخراج داده‌ها از فایل‌های موجود، انجام تغییرات و ذخیره نتایج به‌صورت فرمت Excel به‌راحتی. مثال زیر نشان می‌دهد چگونه می‌توان داده‌ها را از یک فایل Excel با استفاده از کتابخانه SwiftXLSX خواند.

چگونه داده‌ها را از یک فایل Excel با استفاده از API Swift بخوانیم؟

import SwiftXLSX
import SwiftXLSX

do {
    let filePath = "path/to/your/excel-file.xlsx"
    let file = try XLSXFile(filepath: filePath)
    for path in try file.parseWorksheetPaths() {
        let ws = try file.parseWorksheet(at: path)
        for row in ws.data?.dropFirst() ?? [] {
            for cell in row {
                print(cell)
            }
        }
    }
} catch {
    print("Error reading Excel file: \(error)")
}

اعمال استایل و قالب‌بندی به فایل Excel از طریق Swift

استفاده از کتابخانه SwiftXLSX برای اعمال استایل و قالب‌بندی به فایل‌های Excel به شما امکان می‌دهد ظاهر شیت‌های Excel خود را سفارشی کنید و آن‌ها را جذاب‌تر و اطلاعاتی‌تر کنید. توسعه‌دهندگان نرم‌افزار می‌توانند سلول‌ها را قالب‌بندی کنند، تنظیمات قلم را تغییر دهند، حاشیه‌ها اعمال کنند و رنگ پس‌زمینه تنظیم کنند تا داده‌های خاصی برجسته شوند. در ادامه نحوهٔ اعمال استایل و قالب‌بندی به یک فایل Excel در داخل برنامه‌های Swift را مشاهده می‌کنید.

چگونه استایل و قالب‌بندی را به یک Worksheet Excel با استفاده از Swift اعمال کنیم؟

import SwiftXLSX

// Create a new Excel file
let file = XLSXFile()

do {
    let ws = try file.parseWorksheet(at: 0) // Replace 0 with the index of the worksheet you want to format
} catch {
    print("Error parsing worksheet: \(error)")
}

// Font Settings

let font = Font(family: .roman, bold: true, size: 12)
ws.cell(at: CellReference("A1")).style.font = font

// Background Color:

ws.cell(at: CellReference("B2")).style.fill = Fill(patternType: .solid, fgColor: Color(.yellow))

// Borders:
let border = Border(style: .thin, color: Color(.black))
ws.cell(at: CellReference("C3")).style.borders = Borders(left: border, right: border, top: border, bottom: border)

// Number Format:

ws.cell(at: CellReference("D4")).style.numberFormat = .number

//Save the File:

let savePath = "path/to/save/your/excel-file.xlsx"
do {
    try file.save(to: savePath)
} catch {
    print("Error saving Excel file: \(error)")
}

استخراج و دستکاری داده‌ها از طریق API Swift

کتابخانه منبع باز SwiftXLSX به توسعه‌دهندگان نرم‌افزار امکان می‌دهد داده‌ها را داخل صفحات Excel با استفاده از API سوئیفت دستکاری کنند. این کتابخانه می‌تواند عملیات مختلفی مانند مرتب‌سازی، فیلتر کردن و محاسبه مقادیر داخل شیت‌های Excel را انجام دهد. این ویژگی‌ها آن را به ابزاری ایده‌آل برای تحلیل داده‌ها و گزارش‌گیری تبدیل می‌کند. علاوه بر این، توسعه‌دهندگان می‌توانند به راحتی داده‌ها را از سلول‌ها، ردیف‌ها یا ستون‌های خاص یک شیت Excel استخراج کنند با استفاده از API سوئیفت. این قابلیت در مواجهه با مجموعه‌های داده بزرگ و نیاز به اطلاعات خاص بسیار مفید است.