Today Widget: ano ito, mga uri at paggawa ng widget ng notification

Ano ang Today Widget

Today Widget (kilala rin bilang widget ng Notification Center) — elemento ng iOS interface na nagpapakita ng pinaikling impormasyon mula sa app nang hindi ito inilulunsad. Nakikita ng user ang widget sa pamamagitan ng pag-swipe ng screen pakaliwa sa Lock Screen o sa home screen. Maaaring magpakita ang widget ng dynamic na data — halaga ng palitan, pinakabagong balita, status ng gawain, kondisyon ng device.

Sa kasaysayan, lumitaw ang Today Widget sa iOS 8 bilang extension ng Notification Center, na ipinatupad sa pamamagitan ng Notification Center framework. Sa iOS 14, ipinakilala ng Apple ang WidgetKit — isang ganap na muling idisenyo na arkitektura na nagpapahintulot sa paglalagay ng mga widget nang direkta sa desktop. Ang Today Widget sa modernong kahulugan — isang WidgetKit widget na inilagay sa seksyong “Ngayon” (seksyon ng widget sa kaliwa ng unang screen).

Bakit kailangan ang Today Widget

Ang pangunahing layunin ay bawasan ang oras ng pag-access sa impormasyon. Sa halip na buksan ang app, mag-navigate sa menu at maghintay sa pag-load, agad na nakikita ng user ang kinakailangang data. Ayon sa Apple (2024), ang mga app na may widget ay nagpapakita ng 27% na mas mataas na pakikipag-ugnayan ng user. Mga karagdagang sitwasyon: mabilis na aksyon (markahan ang gawain bilang tapos), pagsubaybay (pulso, aktibidad) at status (pag-charge ng baterya, mga notification).

WidgetKit laban sa NCWidgetProviding

Ang Developer ng Today Widget ay may dalawang diskarte: modernong WidgetKit (iOS 14+) at legacy extension na NCWidgetProviding (iOS 8–13). Ang pagpili ay depende sa minimum na sinusuportahang bersyon ng iOS. WidgetKit ay inirerekomenda para sa mga bagong proyekto, NCWidgetProviding — para sa suporta ng mga lumang device.

Kailan gagamitin ang WidgetKit

Kung sinusuportahan ng iyong app ang iOS 14 at mas bago — gamitin ang WidgetKit. Nag-aalok ito ng mayamang kakayahan: maraming laki, configuration sa pamamagitan ng intent, redesign sa iOS 17 at malalim na link. Deklarativiti ng SwiftUI ginagawang kompakto at nababasa ang code ng widget. Ang Timeline Provider ay awtomatikong namamahala ng iskedyul ng update na isinasaalang-alang ang konsumo ng kuryente.

Kailan gagamitin ang NCWidgetProviding

Lamang kung kinakailangan ang suporta para sa iOS 9–13. Ang NCWidgetProviding ay mas simple sa implementasyon — ito ay isang ordinaryong UIViewController na may protocol. Gayunpaman, ito ay limitado: isang laki, UIKit lamang, walang configuration. Inirerekomenda ng Apple na lumipat sa WidgetKit kahit para sa mga lumang proyekto, gamit ang availability check: WidgetKit sa iOS 14+, NCWidgetProviding bilang fallback.

Mga Uri ng Today Widget

Sa modernong iOS, tatlong uri ng widget ang nakikilala ayon sa functional na layunin. Bawat uri ay lumulutas ng sarili nitong gawain at nangangailangan ng ibang diskarte sa pagdisenyo ng data at interface. Pag-uuri ay tumutulong sa pagpili ng tamang arkitektura para sa iyong app.

Mga widget ng impormasyon

Nagpapakita ng static o pana-panahong ina-update na impormasyon: panahon, petsa, halaga ng palitan, status ng server. Ang data ay ina-update ayon sa iskedyul sa pamamagitan ng Timeline Provider. Hindi nakikipag-ugnayan ang user sa widget — nagbabasa lamang. Mga widget ng impormasyon — pinakasimple sa implementasyon, hindi nangangailangan ng pagproseso ng touch event at gumagana sa background nang walang karagdagang pahintulot.

Mga interactive na widget

Mula noong iOS 17, sinusuportahan ng WidgetKit ang mga pindutan, switch at slider sa mga widget. Maaaring magsagawa ng aksyon ang user — markahan ang gawain, i-pause ang musika, i-on ang ilaw — nang hindi binubuksan ang app. Interactive Widgets ay gumagamit ng App Intents para ipadala ang aksyon sa pangunahing app. Limitasyon: sa desktop lamang, wala sa seksyong “Ngayon” hanggang iOS 18.

Mga widget na nako-configure

Inaayos ng user ang ipinapakitang data sa pamamagitan ng system interface — pumipili ng lungsod para sa panahon, account para sa pananalapi, kategorya para sa balita. Ipinapatupad sa pamamagitan ng Intents Extension at configuration sa WidgetBundle. Ang mga widget na nako-configure ay nagpapataas ng personalisasyon at kaugnayan ng impormasyon para sa bawat user.

Paggawa ng WidgetKit Widget

Tingnan natin ang proseso ng paggawa ng Today Widget sa SwiftUI gamit ang WidgetKit. Ang widget ay magpapakita ng kasalukuyang halaga ng palitan na may awtomatikong pag-update. WidgetKit ay nangangailangan ng tatlong bahagi: istraktura ng widget, Provider na may configuration at View para sa pagpapakita.

import WidgetKit
import SwiftUI

@main
struct CurrencyWidget: Widget {
    let kind: String = "CurrencyWidget"

    var body: some WidgetConfiguration {
        StaticConfiguration(kind: kind, provider: Provider()) { entry in
            CurrencyWidgetEntryView(entry: entry)
        }
        .configurationDisplayName("Currency Rate")
        .description("Current USD/RUB exchange rate")
        .supportedFamilies([.systemSmall, .systemMedium])
    }
}

Ang Provider ay responsable sa paghahanda ng data para sa pagpapakita. Ang pamamaraang getTimeline ay lumilikha ng iskedyul ng update: susunod na update sa loob ng 15 minuto. TimelineProvider ay ginagarantiyahan na ang widget ay nagpapakita ng napapanahong data nang walang patuloy na pag-poll sa server.

struct Provider: TimelineProvider {
    func getSnapshot(in context: Context,
                      completion: @escaping (CurrencyEntry) -> Void) {
        let entry = CurrencyEntry(date: Date(), rate: 92.5)
        completion(entry)
    }

    func getTimeline(in context: Context,
                     completion: @escaping (Timeline<CurrencyEntry>) -> Void) {
        let rate = CurrencyService().fetchRate()
        let entry = CurrencyEntry(date: Date(), rate: rate)
        let nextUpdate = Calendar.current.date(
            byAdding: .minute, value: 15, to: Date()
        ) ?? Date()
        let timeline = Timeline(entries: [entry], policy: .after(nextUpdate))
        completion(timeline)
    }
}

Timeline Provider at Pag-update ng Data

Timeline Provider — ang sentral na mekanismo ng WidgetKit para sa pamamahala ng data ng Today Widget. Sa halip na pana-panahong pag-update gamit ang timer (tulad ng sa lumang NCWidgetProviding), ginagamit ng WidgetKit ang konsepto ng timeline — isang pagkakasunod-sunod ng mga record na may timestamp. Ipinapakita ng system ang kasalukuyang record hanggang sa mag-expire ito, pagkatapos ay lumipat sa susunod o humiling ng bago.

Mga patakaran sa pag-update

Sinusuportahan ng timeline ang tatlong patakaran: .after(date) — susunod na update sa tinukoy na petsa; .never — ang widget ay hindi na-update hanggang sa tahasang pagtawag sa WidgetCenter.reloadAllTimelines; .atEnd — pag-update pagkatapos ipakita ang huling record. Para sa Today Widget na may halaga ng palitan, ang patakarang .after na may interval na 15–30 minuto ay optimal. Efficiency ng enerhiya — pangunahing bentahe ng WidgetKit: pinapangkat ng system ang mga update ng lahat ng widget sa isang window.

WidgetCenter: programmatic na pag-update

Kung nagbago ang data bago mag-expire ang timeline (hal. na-update ng user ang halaga ng palitan sa app), tawagan ang WidgetCenter.shared.reloadTimelines(ofKind: "CurrencyWidget"). Hihiling ito ng bagong timeline mula sa Provider at ia-update ang display. WidgetCenter ay nagpapahintulot din na i-reload ang lahat ng widget ng app sa isang command — maginhawa pagkatapos ng data synchronization.

Mga Rekomendasyon sa Disenyo ng Widget

Ang Apple ay nagtatakda ng mahigpit na kinakailangan para sa disenyo ng Today Widget: ang nilalaman ay dapat na nababasa mula sa malayo, walang labis na elemento at may malinaw na hierarchy. Ang paglabag sa mga rekomendasyon ng HIG (Human Interface Guidelines) ay dahilan ng pagtanggi sa pag-publish sa App Store. Tatlong prinsipyo: glanceability, consistency at hierarchy.

Glanceability — pagiging nababasa sa isang sulyap

Ang user ay gumugugol ng mas mababa sa isang segundo sa widget. Huwag magdagdag ng higit sa 3–4 na elemento ng data. Font — minimum na 11pt para sa mga label, 17pt para sa mga halaga. Gumamit ng bold (Semibold) para sa mga pangunahing numero. Iwasan ang pag-scroll — ang Today Widget ay hindi nag-scroll.

Pag-adapt sa mga laki

Sinusuportahan ng WidgetKit ang tatlong laki: Small (170×170pt), Medium (364×170pt), Large (364×382pt). Para sa Today Widget sa seksyong “Ngayon”, ang Medium ang pinakakaraniwang pagpipilian. Adaptive na disenyo sa pamamagitan ng EnvironmentValues: baguhin ang density ng impormasyon depende sa laki. Small — isang numero, Medium — numero + graph, Large — talahanayan.

Suporta sa dark theme at Dynamic Type

Ang widget ay dapat na maipakita nang tama sa light at dark na tema nang walang karagdagang aksyon ng developer — awtomatikong kumukuha ang WidgetKit ng mga system color. Ang Dynamic Type para sa mga widget ay limitado: ang laki ng font ay nakapirmi ngunit dapat na nababasa. UIColor.label at UIColor.systemBackground — mga pangunahing kulay para sa teksto at background sa parehong tema.