On-Demand Resources: ce este, mecanismul de solicitare și stocarea resurselor

Ce sunt On-Demand Resources în iOS

On-Demand Resources (ODR) „este un sistem de gestionare a conținutului încorporat în iOS, tvOS și macOS”. Acesta permite dezvoltatorului să împartă resursele aplicației în obligatorii (incluse în pachetul de instalare) și încărcabile la cerere (stocate în App Store și descărcate la necesitate).

Concepte de bază ODR

Sistemul ODR operează cu trei entități cheie: etichete, pachete de resurse și solicitări. O etichetă este un șir de caractere identificator care unește un grup de fișiere. Un pachet de resurse este un set de date asociat cu o etichetă. O solicitare este un apel programatic NSBundleResourceRequest care inițiază încărcarea pachetului.

Ciclul de viață al solicitării unei resurse

Încărcarea resursei trece prin mai multe etape: inițializarea solicitării cu specificarea etichetelor, verificarea disponibilității în stocarea locală, descărcarea de pe serverele Apple în absență, notificarea aplicației despre pregătire și eliberarea resursei după utilizare. Sistemul gestionează automat memorarea în cache și ștergerea resurselor neutilizate.

Cum funcționează ODR în iOS

Mecanismul ODR se bazează pe un serviciu de fundal care gestionează solicitările de resurse din stocarea cloud App Store. Când aplicația solicită o etichetă, sistemul verifică dacă resursa există în cache-ul local. Dacă nu „ începe descărcarea printr-o sesiune URL de fundal cu suport pentru reluare în caz de întrerupere a conexiunii.

Gestionarea solicitărilor prin NSBundleResourceRequest

import Foundation

class ResourceManager {
    let odrRequest = NSBundleResourceRequest(tags: ["level-3"])

    func loadLevel3() {
        odrRequest.conditionallyBeginAccessingResources { available in
            if available {
                self.startLevel3()
            } else {
                self.odrRequest.beginAccessingResources { error in
                    guard error == nil else { return }
                    self.startLevel3()
                }
            }
        }
    }

    func releaseResources() {
        odrRequest.endAccessingResources()
    }
}

Metoda conditionallyBeginAccessingResources verifică disponibilitatea resursei în cache fără încărcare imediată. Dacă indicatorul de disponibilitate este pozitiv „ aplicația continuă lucrul fără întârziere. Dacă resursa lipsește, beginAccessingResources pornește descărcarea cu indicarea progresului prin proprietatea progress.

Descărcare în fundal și priorități

Sistemul iOS gestionează singur prioritățile de încărcare a resurselor ODR în funcție de activitatea curentă a aplicației. Dacă aplicația este în prim-plan, încărcarea se face cu prioritate ridicată. În fundal, iOS poate amâna încărcarea sau o poate suspenda la baterie scăzută.

• Prioritate ridicată „încărcare imediată pentru resursele necesare imediat”
• Prioritate scăzută „încărcare întârziată pentru prefetching și cache preliminar”
• Fundal „încărcare doar cu Wi-Fi activ și suficientă baterie”

Tipuri de resurse și etichete ODR

Resursele ODR pot include imagini, videoclipuri, fișiere audio, sprite-uri, datele nivelurilor și orice alte fișiere necritice pentru lansarea aplicației. Fiecare resursă este legată de una sau mai multe etichete care determină apartenența sa la un bloc funcțional.

Etichetarea conținutului în Xcode

În Xcode, etichetele se configurează prin inspectorul Resource Tags din fila Target Membership. Dezvoltatorul specifică pentru fiecare fișier din proiect dacă face parte din pachetul principal sau este încărcat prin etichetă. Un fișier poate aparține mai multor etichete, permițând reutilizarea resurselor între diferite secțiuni ale aplicației.

<!-- Exemplu de configurare Resource Tags în Info.plist -->
<key>NSBundleResourceRequestTags</key>
<dict>
    <key>level-3</key>
    <array>
        <string>levels/level3.scnassets</string>
        <string>textures/level3_tex.png</string>
    </array>
</dict>

Categorii de etichete după durata de viață

Apple distinge trei categorii de etichete ODR în funcție de cât timp trebuie păstrată resursa pe dispozitiv. Initial Install Tags se încarcă odată cu aplicația și nu sunt niciodată șterse de sistem. Prefetch Tag Order determină ordinea încărcării de fundal imediat după instalare. Etichetele principale se încarcă la cerere și pot fi șterse de iOS la lipsă de spațiu.

Pe lângă categorii, fiecare etichetă poate avea o prioritate de încărcare. Etichetele cu prioritate ridicată se încarcă înaintea celor cu prioritate scăzută, chiar dacă au fost solicitate mai târziu. Aceasta permite dezvoltatorului să gestioneze ordinea apariției conținutului: mai întâi resursele critice pentru ecranul principal, apoi materialele suplimentare pentru secțiunile profunde ale aplicației.

• Initial install tags „se încarcă la instalarea inițială, nu sunt șterse de sistem”
• Prefetched tags „se descarcă în fundal după instalare pentru îmbunătățirea UX”
• On-demand tags „se solicită programatic, pot fi șterse de iOS la lipsă de spațiu”

Configurarea On-Demand Resources în Xcode

Configurarea ODR în Xcode include trei etape: categorisirea resurselor pe etichete, configurarea parametrilor de încărcare în Info.plist și implementarea programatică a solicitărilor prin NSBundleResourceRequest. Majoritatea muncii se face în partea de construire a proiectului.

Categorisirea în Target Membership

// Verificarea stării și monitorizarea progresului ODR
func monitorODRProgress(tag: String) {
    let request = NSBundleResourceRequest(tags: [tag])
    let observer = request.progress.observe(\.fractionCompleted) { progress, _ in
        DispatchQueue.main.async {
            let percent = Int(progress.fractionCompleted * 100)
            print("ODR: \(percent)% încărcat")
        }
    }
}

Progresul încărcării este urmărit prin proprietatea progress a clasei NSProgress cu suport de observare KVO. Aplicația poate afișa un indicator de progres utilizatorului în timpul descărcării resurselor. După finalizarea încărcării, resursele sunt disponibile în pachetul principal al aplicației prin mecanismele standard FileManager și NSDataAsset.

Parametrii cotelor și limitărilor

Cotele ODR depind de versiunea iOS. Începând cu iOS 13, dispozitivul poate stoca până la 20 GB de resurse încărcate la cerere pe un cont. Acest volum este distribuit între toate aplicațiile instalate pe dispozitiv „ dacă o aplicație ocupă mult spațiu, altora le rămâne mai puțin.

Monitorizarea spațiului ocupat se face prin NSBundleResourceRequest. Aplicația poate verifica spațiul de stocare ODR disponibil și în funcție de aceasta decide ce resurse să încarce primele. Se recomandă implementarea unui mecanism de fallback: dacă spațiul ODR este plin, să se utilizeze resurse din pachetul principal de calitate redusă.

Dezvoltatorul trebuie să ia în considerare că iOS poate oricând decide ștergerea resurselor On-Demand „ aplicația trebuie să gestioneze corect situația în care o resursă încărcată anterior devine brusc indisponibilă. Se recomandă interceptarea erorilor de acces la resurse și re-solicitarea lor prin beginAccessingResources. Pentru resursele critice fără de care aplicația nu poate funcționa, utilizați Initial Install Tags care nu sunt șterse de sistem.

Avantaje și limitări ale ODR

On-Demand Resources oferă dezvoltatorului un instrument flexibil de gestionare a dimensiunii aplicației, dar impune o serie de limitări legate de disponibilitatea rețelei și politicile de stocare iOS.

Avantajele utilizării ODR

Principalul avantaj al ODR „ reducerea radicală a dimensiunii instalării inițiale. Jocurile cu mai multe niveluri, aplicațiile cu conținut video sau seturi mari de imagini pot încărca conținutul porționat. Utilizatorul obține acces la funcționalitatea de bază imediat, iar resursele suplimentare se descarcă în fundal.

Limitările tehnologiei

ODR necesită conexiune permanentă la internet pentru încărcarea resurselor la prima accesare. Utilizatorul într-o zonă cu acoperire slabă poate întâmpina întârzieri și erori de încărcare. În plus, Apple nu garantează că resursele încărcate vor rămâne pe dispozitiv „ la lipsă de spațiu, iOS poate șterge etichetele On-Demand fără avertisment.

• Necesitatea rețelei „prima solicitare a resursei necesită conexiune la internet”
• Ștergere automată „iOS poate curăța cache-ul la lipsă de spațiu pe dispozitiv”
• Dificultatea depanării „reproducerea problemelor de încărcare necesită simularea diferitelor condiții de rețea”
• Dimensiunea etichetei „Apple recomandă să nu depășească 512 MB per etichetă pentru performanță optimă”
• Gestionarea erorilor „aplicația trebuie să gestioneze corect erorile de încărcare și să reia solicitările”