BGTaskScheduler: ce este, sarcini de fundal iOS

Ce este BGTaskScheduler?

BGTaskScheduler — este framework-ul de sistem Apple, introdus în iOS 13, care gestionează centralizat executarea sarcinilor de fundal. Înainte de apariția sa, dezvoltatorii foloseau UIApplication backgroundTasks, performFetch și gestionarea evenimentelor în appDelegate, ceea ce ducea la fragmentarea codului și comportament imprevizibil.

Framework-ul funcționează pe principiul planificării întârziate: aplicația înregistrează sarcini cu identificatori unici, iar iOS determină singur momentul optim pentru executarea lor. Sistemul ia în considerare nivelul bateriei, activitatea utilizatorului, starea rețelei și alți factori.

Capabilitățile principale includ lucrul atât cu operații scurte, cât și cu cele lungi de fundal. Spre deosebire de AlarmManager din Android, BGTaskScheduler nu garantează un timp exact de execuție — sistemul își rezervă dreptul de a amâna sarcina dacă condițiile sunt nefavorabile.

Cum funcționează BGTaskScheduler în iOS?

BGTaskScheduler utilizează o arhitectură bazată pe handlere. Aplicația înregistrează un handler pentru fiecare tip de sarcină, iar sistemul îl apelează când sosește momentul potrivit. Framework-ul nu execută sarcina direct — doar notifică aplicația că a sosit timpul să o pornească.

Procesul de înregistrare a sarcinii

Înregistrarea începe cu declararea identificatorului sarcinii în Info.plist prin tabloul BGTaskSchedulerPermittedIdentifiers. Apoi, în codul aplicației, se apelează metoda registerHandler(forTaskWithIdentifier:) cu un closure-handler.

import BackgroundTasks

let taskID = "com.example.app.refresh"

BGTaskScheduler.shared.registerHandler(
    forTaskWithIdentifier: taskID,
    using: DispatchQueue.global()
) { task in
    task.expirationHandler = {
        // apelat la forțarea încheierii
    }
    processBackgroundTask(task as! BGAppRefreshTask)
}

Planificarea executării

După înregistrare, aplicația trebuie să solicite explicit executarea sarcinii prin submitTaskRequest. Cererea conține identificatorul sarcinii și data celei mai devreme posibile porniri. Sistemul salvează cererea și o procesează când consideră condițiile potrivite.

let request = BGAppRefreshTaskRequest(
    identifier: taskID
)
request.earliestBeginDate = Date(timeIntervalSinceNow: 3600)

do {
    try BGTaskScheduler.shared.submit(request)
} catch {
    print("Eroare de planificare: \(error)")
}

Tipuri de sarcini de fundal BGTaskScheduler

BGTaskScheduler oferă două tipuri principale de sarcini, fiecare destinat propriului scenariu de utilizare. Alegerea tipului corect influențează direct probabilitatea executării cu succes a sarcinii de către sistem.

BGAppRefreshTask

BGAppRefreshTask este destinată actualizărilor scurte de conținut în fundal: încărcarea datelor noi, sincronizarea cu serverul, actualizarea widget-urilor. Timpul de execuție este limitat la 30 de secunde, după care sistemul forțează încheierea sarcinii. Acest tip de sarcini este executat mai frecvent decât BGProcessingTask și are o prioritate mai mare.

BGProcessingTask

BGProcessingTask este destinată operațiilor mai lungi: procesarea fișierelor media, indexarea datelor Core Data, crearea copiilor de rezervă. Sarcina poate dura până la câteva minute, dar sistemul o pornește mai rar și doar în condiții favorabile — conectare la alimentare, Wi-Fi stabil și sarcină redusă a dispozitivului.

Înregistrarea și planificarea sarcinilor

Înregistrarea corectă — este o condiție obligatorie pentru funcționarea BGTaskScheduler. Dacă sarcina nu este înregistrată în Info.plist, sistemul va ignora orice cerere de executare a acesteia.

Înregistrarea în Info.plist

În fișierul Info.plist se adaugă un tablou BGTaskSchedulerPermittedIdentifiers cu o listă de identificatori text. Fiecare identificator trebuie să fie unic în cadrul aplicației. Apple recomandă utilizarea notației inverse de domeniu.

<key>BGTaskSchedulerPermittedIdentifiers</key>
<array>
    <string>com.example.app.refresh</string>
    <string>com.example.app.processing</string>
</array>

Planificarea și anularea

Pentru planificare se folosește metoda submitTaskRequest. Dacă sarcina nu mai este necesară, poate fi anulată prin cancelTaskRequest sau cancelAllTaskRequests. Sistemul anulează automat sarcinile la ștergerea aplicației sau resetarea datelor.

Monitorizarea stării sarcinilor

BGTaskScheduler oferă posibilitatea de a urmări starea sarcinilor planificate prin getPendingTaskRequests. Această metodă returnează o listă a tuturor cererilor active cu informații despre tipul, identificatorul și earliestBeginDate. Pentru fiecare cerere se poate verifica dacă a fost deja executată sau anulată și se poate lua o decizie de replanificare.

Este important de reținut că sistemul nu oferă un Callback direct despre succesul executării sarcinii de fundal — handler-ul însuși trebuie să raporteze rezultatul prin proprietățile task. setTaskCompleted permite marcarea sarcinii ca finalizată cu succes, după care sistemul poate porni următoarea sarcină planificată de acest tip. Dacă sarcina nu a apelat setTaskCompleted, sistemul o consideră finalizată la expirarea timpului sau la forțarea încheierii.

Pentru diagnosticarea problemelor se recomandă utilizarea OSLog în handler și vizualizarea logurilor prin Console.app pe Mac. Apple oferă și instrumentul MetricKit pentru analiza performanței sarcinilor de fundal — acesta colectează date despre timpul de execuție, consumul de energie și frecvența pornirilor, care pot fi folosite pentru optimizare.

// Anularea sarcinii specifice
BGTaskScheduler.shared.cancel(taskRequestWithIdentifier: taskID)

// Anularea tuturor sarcinilor
BGTaskScheduler.shared.cancelAllTaskRequests()

// Verificarea sarcinilor planificate
BGTaskScheduler.shared.getPendingTaskRequests { requests in
    print("Planificate \(requests.count) sarcini")
}

Limitări și recomandări

BGTaskScheduler impune restricții stricte asupra muncii în fundal. Sistemul poate amâna sarcina pe o perioadă nedeterminată dacă condițiile sunt nefavorabile. Dezvoltatorul trebuie să înțeleagă că framework-ul nu este destinat sarcinilor în timp real.

Printre limitările cheie: sistemul nu garantează executarea sarcinii la timpul specificat, numărul maxim de sarcini simultane este limitat, iar consumul de energie este strict controlat. Pornirea mai multor sarcini consecutiv poate duce la contopirea sau anularea acestora.

Pentru a crește probabilitatea de executare, se recomandă setarea earliestBeginDate nu mai devreme de 1 oră pentru BGProcessingTask și 15 minute pentru BGAppRefreshTask. De asemenea, este important de gestionat expirationHandler — dacă sarcina nu se încadrează în limită, sistemul apelează acest handler pentru finalizarea corectă. Replanificarea ar trebui să aibă loc în interiorul handler-ului pentru a menține un ciclu continuu de lucru în fundal.

O altă limitare importantă se referă la cererile de rețea. BGTaskScheduler nu garantează existența unei conexiuni active de rețea în timpul executării sarcinii. Aplicația trebuie să verifice singură disponibilitatea rețelei prin NWPathMonitor și să amâne procesarea dacă conexiunea lipsește. Aceasta diferă de Android JobScheduler, care poate activa sarcina doar la conectarea la o rețea de un anumit tip. În practică, dezvoltatorii combină adesea BGTaskScheduler cu sesiuni URL de fundal NSURLSession pentru încărcarea fiabilă a datelor.

Compatibilitatea cu macOS și watchOS

Începând cu macOS Catalina, BGTaskScheduler este disponibil și pe Mac. Acest lucru permite crearea de sarcini de fundal cross-platform pentru aplicațiile UIKit rulate pe Apple Silicon. Pe watchOS, framework-ul funcționează limitat — sunt disponibile doar BGAppRefreshTask scurte pentru actualizarea complication și sincronizarea datelor cu iPhone. Dezvoltatorii trebuie să țină cont de diferențele de platformă la planificarea arhitecturii de fundal.

Instrumente de depanare și diagnosticare

Pentru depanarea BGTaskScheduler, Apple oferă mai multe instrumente. Comanda e -l objc -- (void)[[BGTaskScheduler sharedScheduler] _simulateLaunchForTaskWithIdentifier:@"com.example.task"] în lldb forțează pornirea sarcinii de fundal, ignorând restricțiile sistemului. În Xcode este disponibil flag-ul Simulate Background Fetch în meniul Debug, care emulează o actualizare scurtă de fundal. Pentru analiza performanței se folosește MetricKit — acesta colectează informații despre frecvența pornirilor, durata de execuție și consumul de energie al fiecărei sarcini. Aceste date ajută la optimizarea frecvenței de planificare și alegerea tipului corect de sarcină.

În practică, BGTaskScheduler este potrivit pentru actualizarea datelor widget-urilor, sincronizarea iCloud, procesarea notificărilor push cu conținut și indexarea căutării Spotlight. Nu este potrivit pentru trimiterea de analitică în timp real, aplicații de chat sau orice sarcini care necesită executare imediată.