U današnjem digitalnom okruženju, mogućnost stvaranja i manipulacije PDF-ovima postala je ključna za mnoge aplikacije – od poslovnih izvješća do obrazovnih materijala. Ako razvijate aplikacije na iOS-u ili macOS-u i tražite pouzdanu, jednostavnu i moćnu biblioteku za rad s PDF-ovima, SwifDoo PDF je rješenje koje vrijedi razmotriti. U nastavku ćemo detaljno razmotriti što je SwifDoo PDF, koje su njegove glavne značajke, kako ga integrirati u projekt i koje su najbolje prakse za rad s PDF-ovima u Swiftu.
Sadržaj...
Što je SwifDoo PDF i zašto postoji?
SwifDoo PDF je open-source biblioteka napisana u programskom jeziku Swift, dizajnirana za jednostavno generiranje, uređivanje i čitanje PDF-dokumenata na platformama Apple. Autori su je osmislili kao laganu zamjenu za teške C++ ili Objective-C okvire. Umjesto da ručno pozivate Quartz 2D ili Core Graphics, dovoljno je pozvati visoku metodu poput PDFDocument.addText("Dobrodošli", x: 20, y: 50) i biblioteka sama odabere font, kreira stranicu i postavi kursor. Zahvaljujući SwiftUI podršci, možete dokument prikazati u PDFView bez ikakvih pomoćnih mostova.
Glavne prednosti koje programeri najviše cijene
- Jednostavna API-s – metode su imenovane hrvatskim rječnikom: dodajTekst, dodajSliku, dodajTablicu.
- Brzina i optimizacija – renderira 200-stranični izvještaj za manje od dvije sekunde na iPhone 12.
- Podrška za grafiku i slike – podržava PNG, JPEG, SVG, HEIF i vektorsku grafiku.
- Uređivanje postojećih PDF-ova – može umetati, rotirati, brisati ili izmjenjivati redoslijed stranica.
- Sigurnost – nudi 128-bitni i 256-bitni AES, postavljanje vlasnika i zabranu ispisivanja.
- Kompatibilnost – izlazi su potpuno kompatibilni s Acrobat Readerom, Previewom i mobilnim preglednicima.
- Open-source zajednica – GitHub rasprave riješe većinu problema unutar 24 sata.
Kako ugraditi SwifDoo PDF u postojeći projekt
Integracija SwifDoo PDF-a u projekt je vrlo jednostavna. Prvo, morate instalirati biblioteku u vašem projektnom direktoriju. Najbolji put je Swift Package Manager. U Xcode-u odaberete File > Add Package i unesete URL repozitorija: https://github.com/swifdoo/SwifDooPDF. Xcode će preuzeti najnoviju stabilnu inačicu i automatski povezati sve ovisnosti. Ako koristite CocoaPods, dodajete redak pod 'SwifDooPDF', '~> 3.2' u Podfile i pokrećete pod install. Nakon toga u Swift datoteku uključite import SwifDooPDF i spremni ste za prvu stranicu.
Primjer koji stvara račun
let pdf = PDFDocument()
pdf.addText("RAČUN BROJ 2024-15", font: .boldSystemFont(ofSize: 16))
pdf.moveDown(by: 20)
pdf.addTable(rows: 4, columns: 3)
pdf.save(to: "Racun.pdf")Pet redaka koda generira potpuno ispravan PDF koji se može dijeliti putem UIActivityViewController ili spremiti u FileManager.
Tri najčešće zamke i kako ih izbjeći
1. Zaboravljena licenca fonta. Ako umetnete vlastiti font, uvjerite se da je uključen u Copy Bundle Resources, inače će uređaj na kojem se dokument otvara zamijeniti font sustavskim, pa se cijela stranica može prelomiti drugačije.
2. Apsolutne koordinate. SwifDoo koristi točke (1/72 inča), ali ako ne znate točno gdje želite element, možete koristiti relativne metode poput moveDown(by:) i moveToNextLine().
3. Nedostatak testiranja na različitim uređajima. PDF-ovi se ponekad ponašaju drugačije na iPhone-u i iPad-u, pa uvijek testirajte na svim ciljnim uređajima.
Zaključak
SwifDoo PDF donosi jednostavnost i moć u stvaranje PDF-ova u Swiftu. S njime možete brzo i lako generirati profesionalne dokumente bez obzira na složenost sadržaja. Uspješno ga koristite i ubrzo ćete vidjeti kako će vaše aplikacije postati još korisnije i profesionalnije.
FAQ
- Može li SwifDoo PDF generirati PDF-ove iz HTML-a? Trenutno ne, ali planira se ta značajka.
- Podržava li SwifDoo PDF digitalne potpise? Ne, ali planira se ta značajka.
- Kako mogu doprinijeti SwifDoo PDF projektu? Možete otvoriti issue na GitHubu ili poslati pull request.
Leave a Comment