ספריית Swift חינמית לקריאה וכתיבה של מסמכי DOCX
API Swift קוד פתוח המאפשר למפתחים ב‑iOS וב‑macOS לקרוא, לכתוב ולנהל קבצי .docx עם טיפול חכם בגופנים, תמיכה בפסקאות וכותרות.
מהי ספריית DOCX?
עבודה עם מסמכי Microsoft Word ב‑Swift הייתה מסורתית אתגר למפתחי תוכנה עקב תמיכה מקומית מוגבלת. עם זאת, API ה‑DOCX Swift קוד פתוח מציע פתרון מעשי וקל משקל. ספרייה זו המבוססת על Swift מאפשרת למפתחים ליצור, לקרוא, לשנות ולנהל קובצי .docx באופן תכנותי מבלי להסתמך על Microsoft Office או כלים חיצוניים. בניגוד לחבילות אוטומציה משרדיות כבדות או פתרונות מסמכי Word מבוססי ענן, הספרייה הזאת משמרת את הפשטות והיעילות, ולכן היא מתאימה ליצירת מסמכים קלים על iOS, iPadOS, macOS ובאפליקציות Swift בצד השרת. היא תומכת בתכונות מרכזיות כגון הוספת פסקאות, רצפי טקסט, כותרות, תמונות ועיצוב פשוט.
API ה‑DOCX Swift קוד פתוח מאפשר למפתחים ב‑Swift לשלב יצירת מסמכי Word ישירות באפליקציות שלהם. ה‑API מספק מספר יתרונות כגון תאימות跨‑פלטפורמה של Swift, משקל קל וללא תלויות, יצירת DOCX במצב לא מקוון ועוד. אחת מהיתרונות המרכזיים של API ה‑DOCX Swift קוד פתוח היא הטבע הקוד פתוח שלו, מה שאומר שלמפתחים יש גישה מלאה לקוד המקור ויכולים לשנותו בהתאם לצרכיהם הספציפיים. רמת התאמה אישית זו מאפשרת למפתחים להתאים את ה‑API לדרישותיהם הייחודיות, ולדאוג שהאפליקציות שלהם מצוידות בתכונות וביכולות הדרושות כדי להתבלט בשוק תחרותי. עם API זה, משתמשים יכולים בקלות לקרוא, לכתוב ולנהל קבצי DOCX, מה שמאפשר להם לגשת ולשנות את תוכן המסמכים בדיוק ובגמישות.
התחלת עבודה עם DOCX
הדרך המומלצת לשלב את DOCX בפרויקט שלך היא באמצעות GitHub. אנא השתמש בפקודה הבאה להתקנה חלקה.
התקנת ספריית DOCX באמצעות CocoaPods
Install DOCX via GitHub התקנת DOCX באמצעות GitHub
go get github.com/shinjukunian/DocX.git יצירת מסמכי DOCX מאפס
באמצעות ספריית DocX Swift קוד פתוח, מפתחי תוכנה יכולים ליצור קבצי .docx מהיסוד בקלות. זה כולל הוספת פסקאות, כותרות, תמונות, סגנונות ואלמנטים טקסטיים משולבים. ניתן להגדיר בקלות את מבנה התוכן באמצעות API אינטואיטיבי, טבעי ל‑Swift. הקוד הבא מדגים כיצד ליצור מסמך Word חדש ולהוסיף פסקה פשוטה עם הטקסט "Hello from DocX Swift!" בתוך אפליקציות Swift.
איך ליצור מסמך Word חדש עם פסקה פשוטה באמצעות API של Swift?
import DocX
let doc = Document()
let p = Paragraph()
p.appendChild(Text("Hello from DocX Swift!"))
doc.appendChild(p)
try doc.save(to: URL(fileURLWithPath: "MyDocument.docx"))
טיפול חכם בגופנים ובקרת פריסת העמוד
כדי להבטיח תאימות跨‑פלטפורמה, המפתחים יכולים להגדיר את DocX להשתמש בגופני עיבוד Word סטנדרטיים במקום לשבץ שמות גופנים ספציפיים. זה מונע בעיות שבהן המסמך עשוי להיראות שונה במכונה שאין בה את הגופן המקורי מותקן. בנוסף, עם PageDefinition ניתן לציין את גודל העמוד והשוליים של המסמך. הספרייה כוללת ערכות קבועות עבור גדלים סטנדרטיים כמו A4 ו‑US Letter, אך גם מאפשרת ממדים ושוליים מותאמים אישית לחלוטין, מה שמעניק שליטה מדויקת על הפריסה הסופית. הנה דוגמה פשוטה שמראה כיצד להגדיר גודל עמוד מותאם אישית בתוך אפליקציות Swift.
איך להגדיר גודל עמוד מותאם אישית באמצעות API של Swift?
import Foundation
// 1. Your attributed string
let string = NSAttributedString(string: "This content will be on a custom-sized page.")
// 2. Define a custom page layout
let customPage = PageDefinition(
pageSize: .init(
width: Measurement(value: 8, unit: .inches),
height: Measurement(value: 5, unit: .inches)
),
pageMargins: .init(
top: .init(value: 0.5, unit: .inches),
bottom: .init(value: 0.5, unit: .inches),
left: .init(value: 1, unit: .inches),
right: .init(value: 1, unit: .inches)
)
)
// 3. Apply the page definition via DocXOptions
var options = DocXOptions()
options.pageDefinition = customPage
// 4. Write the document
let url = URL(fileURLWithPath: "/path/to/your/CustomPage.docx")
try string.writeDocX(to: url, options: options)
תמיכה מקיפה בתכונות
ספריית Swift DocX תומכת במגוון רחב של תכונות טקסט, ומבטיחה שהטקסט העשיר והמעודן שלך יוצג נאמנה בקובץ .docx הסופי. זה כולל גופנים וצבעים, סגנונות פסקאות, סגנונות תווים, הטמעת תמונות ועוד רבים. היא גם תומכת בתכונת Furigana (הסברים בטקסט Ruby) שהיא תכונה בולטת עבור מפתחים העובדים עם טקסט יפני, שכן היא מציגה באופן נכון את ההסברים הפונטיים.
