UIDocumentPickerViewController — iOS da hujjatlar bilan ishlash

UIDocumentPickerViewController nima?

UIDocumentPickerViewController — hujjatlarni tanlash uchun tizim interfeysini taqdim etuvchi UIKit boshqaruvchisidir. U UIKit frameworkiga kiradi va iOS 8 dan boshlab mavjud. Boshqaruvchi mahalliy saqlash, iCloud Drive va ro'yxatdan o'tgan uchinchi tomon bulut xizmatlarini o'z ichiga olgan fayl brauzerini ko'rsatadi.

Boshqaruvchi asinxron ishlaydi: present chaqiruvidan so'ng foydalanuvchi tizim dialogini ko'radi, faylni tanlaydi va natija delegat orqali qaytariladi. Ilova tanlangan faylga kirish uchun maxsus ruxsat talab qilmaydi — tizim pikeri avtomatik ravishda URI ga vaqtinchalik kirishni ta'minlaydi.

UIDocumentPickerViewController iPad ni UIPopoverPresentationController orqali va iPhone uchun adaptiv interfeysni qo'llab-quvvatlaydi. iOS 14 dan boshlab boshqaruvchi yangilangan dizayn va iPadOS da sidebar navigatsiya qo'llab-quvvatlashini oldi.

Ish rejimlari: import va export

UIDocumentPickerViewController ikkita asosiy rejimda ishlaydi, ularning har biri ilova faylga qanday kirishini belgilaydi. Rejim vazifaga qarab forOpeningContentTypes yoki forExporting parametri orqali o'rnatiladi.

Import rejimi (forOpeningContentTypes) tanlangan faylni ilova sandboxiga nusxalaydi. Ilova faylning faqat o'ziga tegishli nusxasiga URL oladi. Bu xavfsiz rejim: boshqa ilovaning fayli o'zgartirilmaydi va nusxa joriy ilova tomonidan to'liq boshqariladi.

Export rejimi (forExporting) nusxalamasdan asl faylga URL taqdim etadi. Ilova faylni link orqali o'qishi mumkin, ammo o'zgarishlar orqaga yozilmaydi. Bu rejim faylni boshqa ilovaga uzatish yoki pochta orqali yuborish kerak bo'lganda ishlatiladi. O'zgarishlarni yozish uchun security-scoped URL bilan open rejimi ishlatiladi.

Pikerni sozlash va UTI bo'yicha filtrlash

UTI (Uniform Type Identifier) — Apple ekotizimida kontent turlarini identifikatsiya qilish tizimidir. UIDocumentPickerViewController ko'rsatilgan fayllarni forOpeningContentTypes orqali uzatilgan UTI massiviga ko'ra filtrlaydi. UTI ko'rsatilmagan bo'lsa, picker barcha fayl turlarini ko'rsatadi.

• PDF — com.adobe.pdf. Picker faqat PDF hujjatlarni ko'rsatadi.
• Tasvirlar — public.image. JPEG, PNG, HEIC va boshqa formatlarni o'z ichiga oladi.
• Matn — public.plain-text. .txt, .csv va boshqa matn fayllarini ko'rsatadi.
• Audio — public.audio. MP3, AAC, WAV va Lossless formatlarini o'z ichiga oladi.
• Video — public.movie. MP4, MOV, AVI va boshqa video formatlarini ko'rsatadi.

Bir nechta turni tanlash uchun [UTType.pdf, UTType.image] massivi uzatiladi. iOS 14 dan boshlab Apple satr konstantalari o'rniga UTType dan foydalanishni tavsiya qiladi. UIDocumentPickerViewController tanlangan provayder o'zgarganda ko'rsatiladigan turlar ro'yxatini avtomatik yangilaydi.

Kod namunasi: Swift da hujjat tanlash

Implementatsiya Swift da UIDocumentPickerViewController minimal: UTI turlari bilan boshqaruvchi namunasini yarating, delegatni o'rnating va present ni chaqiring. Fayl tanlangandan so'ng delegat didPickDocumentsAt metodida URL massivini oladi. Har bir URL startAccessingSecurityScopedResource chaqiruvini talab qiladigan security-scoped linkdir.

let picker = UIDocumentPickerViewController(
    forOpeningContentTypes: [.pdf, .image],
    asCopy: true
)
picker.delegate = self
picker.allowsMultipleSelection = false
present(picker, animated: true)

// MARK: - UIDocumentPickerDelegate
func documentPicker(
    _ controller: UIDocumentPickerViewController,
    didPickDocumentsAt urls: [URL]
) {
    guard let url = urls.first else { return }
    url.startAccessingSecurityScopedResource()
    defer { url.stopAccessingSecurityScopedResource() }
    // faylni url dan o'qish
}

Security-scoped resurslar

Security-scoped URL o'qishdan oldin startAccessingSecurityScopedResource chaqiruvini talab qiladi. Bu metod tizimga ilova sandboxdan tashqaridagi faylga vaqtinchalik kirish olayotganini bildiradi. Ish tugagandan so'ng albatta stopAccessingSecurityScopedResource ni chaqiring, aks holda tizim kirishni bloklashi mumkin.

UIDocumentPickerDelegate va natijalarni boshqarish

UIDocumentPickerDelegate fayl tanlash natijalarini ikki metod orqali oladi: didPickDocumentsAt muvaffaqiyat holatida va didPickDocumentsAt bekor qilinganda. iOS foydalanuvchi pickerni tanlovsiz yopgan bo'lsa, avtomatik ravishda bekor qilish metodini chaqiradi.

Xatolarni boshqarish URL mavjudligini tekshirishni o'z ichiga oladi. Agar foydalanuvchi iCloud Drive dan fayl tanlagan bo'lsa, lekin qurilma oflayn bo'lsa, URL mavjud bo'lmasligi mumkin. O'qishdan oldin FileManager.default.isReadableFile ni tekshirish va foydalanuvchiga tushunarli xato xabarini ko'rsatish tavsiya etiladi.

iOS 14+ uchun URL massivi bilan yangi documentPicker:didPickDocumentsAt metodi mavjud. Eski didPickDocumentAt (yakka) metodi deprecated. allowsMultipleSelection o'chirilgan bo'lsa ham har doim massivni boshqaring — Apple yagona handlerdan foydalanishni tavsiya qiladi.

iPad da UIDocumentPickerViewController

iPad UIDocumentPickerViewController uchun maxsus konfiguratsiyani talab qiladi. iPad da picker popover sifatida ko'rsatiladi va to'g'ri joylashtirish uchun sourceView ko'rsatilishi kerak. SourceView bo'lmasa, boshqaruvchi iPadOS da exception bilan ishdan chiqishi mumkin.

Popover uchun popoverPresentationController xususiyatidan foydalaniladi. Tugma yoki jadval katakchasiga bog'lash uchun sourceView va sourceRect ni belgilang. iPhone da bu kod ta'sir qilmaydi — iOS avtomatik pickerni to'liq ekranda ko'rsatadi. iPadOS 16 dan boshlab boshqaruvchi yaxshilangan navigatsiya uchun sidebar va split view ni qo'llab-quvvatlaydi.

UIDocumentPickerViewController ning adaptiv dizayni avtomatik ravishda full-screen (iPhone) va popover (iPad) o'rtasida o'tadi. Dasturchi turli qurilmalar uchun alohida boshqaruvchilarni amalga oshirishi shart emas — iPad uchun popoverPresentationController ni to'g'ri sozlash kifoya.