إنشاء دفتر عمل Excel، إضافة أوراق وصور عبر مكتبة Swift مجانية
مكتبة Swift مفتوحة المصدر تسمح للمطورين بإنشاء وتصدير دفتر عمل Excel. إضافة أوراق عمل جديدة، تضمين صور بدقة البكسل، بيانات CSV/TSV، تطبيق تنسيق وتنسيق الخلايا مجانًا.
ما هو XLKit؟
في عالم تطوير iOS سريع الوتيرة، الكفاءة هي الملك. كتابة نفس الشيفرات النمطية للمهام الشائعة مثل الشبكات المتجاوبة، اكتشاف الجهاز، أو رد فعل اللمس يمكن أن يبطئ حتى أكثر المطورين خبرة. هنا يأتي XLKit، حزمة Swift مفتوحة المصدر أنشأها Amitabh Pandey تهدف إلى تعزيز سير عمل SwiftUI الخاص بك بأدوات ملحقة قوية ومنسقة. إحدى الميزات البارزة في XLKit هي واجهة برمجة التطبيقات السهلة. صُممت مع مراعاة تجربة المطور، وتوفر واجهة سلسة وقابلة للسلسلة تجعل شفرتك نظيفة، قابلة للقراءة، وقابلة للصيانة العالية. وداعًا للصياغة المعقدة ومرحبًا بطريقة أكثر طبيعية لبناء جداول البيانات الخاصة بك.
XLKit هي مكتبة Swift حديثة ومفتوحة المصدر صُممت لتبسيط إنشاء ومعالجة ملفات Excel (.xlsx) على macOS و iOS. بواجهة برمجة تطبيقات سلسة وقابلة للسلسلة، تضمين صور، استيراد/تصدير CSV/TSV، تنسيق آمن من حيث النوع، وتوافق عالي مع Excel، تمكن XLKit المطورين من إنتاج جداول بيانات ذات جودة احترافية بسهولة. تم بناءها بلغة Swift النقية (Swift 6.0+) مستهدفة macOS 12+ و iOS 15+، وتُعطي الأولوية للأمان، الأداء، وتصميم قابل للصيانة. XLKit شهادة على قوة المجتمع المفتوح المصدر في حل التحديات الشائعة للتطوير. لا تحاول أن تكون إطار عمل شامل ضخم بل تركز على تقديم مجموعة من الأدوات المصممة جيدًا والعملية التي سيستخدمها مطورو SwiftUI يوميًا.
البدء مع XLKit
الطريقة الموصى بها لتثبيت XLKit هي استخدام CocoaPods. يرجى استخدام الأمر التالي لتثبيت سلس.
تثبيت XLKit عبر CocoaPods
// Add XLKit to your Package.swift dependencies:
dependencies: [
.package(url: "https://github.com/TheAcharya/XLKit.git", from: "1.0.8")
]
تثبيت XLKit عبر GitHub
git clone https://github.com/TheAcharya/XLKit.git
يمكنك تنزيله مباشرةً من GitHub.
إنشاء والعمل مع جداول بيانات Excel عبر Swift
توفر مكتبة XLKit المفتوحة المصدر ميزات قوية لإنشاء وإدارة ملفات جداول Excel داخل تطبيقات Swift. أولاً تحتاج إلى إنشاء كائن Workbook، الذي سيحتوي على جميع أوراق العمل الخاصة بك. يمكن للدفتر أن يحتوي على عدة أوراق عمل. يمكنك إنشاء واحدة والبدء في إضافة البيانات بطريقة تشبه الشبكة باستخدام مصفوفة ثنائية الأبعاد ([[Cell]]). المثال التالي يوضح مدى سهولة إنشاء دفتر عمل جديد ثم إضافة أوراق عمل داخله باستخدام كود Swift.
كيف تنشئ دفتر عمل Excel جديد وتضيف ورقة عمل داخله عبر مكتبة Swift؟
import XLKit
// Create a new Excel workbook
let workbook = Workbook()
// Add a worksheet named "Sales Report"
let sheet = workbook.addWorksheet("Sales Report")
// Define your data as a 2D array of Cell objects
let data: [[Cell]] = [
[Cell("Product"), Cell("Q1 Sales"), Cell("Q2 Sales"), Cell("Total")],
[Cell("Widget A"), Cell(2450), Cell(3105), Cell(5555)],
[Cell("Widget B"), Cell(1800), Cell(2100), Cell(3900)],
[Cell("Widget C"), Cell(975), Cell(1225), Cell(2200)]
]
// Add the data to the worksheet starting at cell A1
try? sheet.addData(data, startCell: CellReference(column: 0, row: 0))
تضمين صور بدقة البكسل عبر Swift
ترتقي مكتبة XLKit بمعالجة الصور إلى المستوى التالي بفضل قدراتها المثالية على تضمين الصور. فهي تحافظ تلقائيًا على نسبة العرض إلى الارتفاع لصورك، مما يضمن ظهورها حادة ومهنية في جداولك. والأفضل من ذلك، تتميز المكتبة بميزة تعديل حجم الخلايا تلقائيًا، التي تعدل عرض الأعمدة وارتفاع الصفوف لتناسب صورك بشكل مثالي. المثال التالي يوضح مدى سهولة تضمين صورة GIF في خلية جدول بيانات باستخدام واجهة برمجة تطبيقات Swift.
كيف تضمّن صورة GIF داخل خلية جدول بيانات عبر مكتبة Swift؟
let gifData = try Data(contentsOf: URL(fileURLWithPath: "alice.gif"))
try await sheet.embedImageAutoSized(gifData, at: "B2", of: workbook)
تنسيق خلايا شامل عبر مكتبة Swift
تتعلق الجداول ذات المظهر المهني بالتفاصيل. توفر مكتبة XLKit مجموعة غنية من ميزات تنسيق الخلايا، مما يتيح للمطورين التحكم في كل شيء من ألوان الخطوط وتعبئة الخلفية إلى الحدود ومحاذاة النص. هذا يمكن المستخدمين من إنشاء تقارير وتصديرات بيانات جذابة بصريًا وسهلة القراءة. إليكم مثالًا مفيدًا يوضحكيفية تطبيق التنسيق على خلية ورقة عمل داخل تطبيقات Swift.
كيف تطبق التنسيق على خلايا الورقة داخل تطبيقات Swift؟
sheet.setCell("A1", string: "Name", format: CellFormat.header())
sheet.setCell("B1", string: "Photo", format: CellFormat.header())
sheet.setCell("C1", string: "Age", format: CellFormat.coloredText(color: "#FF0000"))
استيراد وتصدير بيانات CSV/TSV عبر مكتبة Swift
في عالم اليوم القائم على البيانات، القدرة على التعامل مع صيغ البيانات المتنوعة أمر حاسم. تضمّن مكتبة XLKit المفتوحة المصدر عدة ميزات مهمة لتحميل والعمل مع بيانات CSV وTSV باستخدام أوامر Swift. تأتي المكتبة بدعم مدمج لاستيراد وتصدير بيانات CSV وTSV، مما يجعل من السهل جدًا دمج سير عمل Excel الخاص بك مع مصادر البيانات والتطبيقات الأخرى.
