• Widget Extension: Uygulamanıza eklenen ayrı bir hedeftir. Widget'ınızın kodunu ve kaynaklarını içerir.
• WidgetEntryKind: Widget'ınızın benzersiz kimliğidir.
• WidgetConfiguration: Widget'ınızın türünü (Statik veya Niyet Tabanlı) ve temel özelliklerini tanımlar.
• TimelineProvider: Widget'ınızın ne zaman güncelleneceğini ve hangi veriyi göstereceğini belirleyen protokoldür. Geçmiş, şimdiki ve gelecekteki girişleri sağlar.
• WidgetEntryView: TimelineProvider tarafından sağlanan veriyi kullanarak widget'ın kullanıcı arayüzünü oluşturan SwiftUI görünümüdür.

• Küçük (Small): Tek bir önemli bilgiye odaklanan, genellikle bir ikona eşlik eden minimal widget'lar. Örn: Hava durumu sıcaklığı.
• Orta (Medium): Daha fazla bilgi gösterebilen ve bazen grafikler içerebilen, daha detaylı widget'lar. Örn: Üç günlük hava tahmini.
• Büyük (Large): En fazla bilgiyi sunan ve karmaşık düzenlere sahip olabilen widget'lar. Örn: Detaylı takvim görünümü.
• Kilit Ekranı Widget'ları (Lock Screen Widgets): iOS 16 ile tanıtılan bu widget'lar, Kilit Ekranı'nda saatin altına veya üstüne yerleştirilebilir. Genellikle küçük ve minimaldirler.
• Bekleme Modu Widget'ları (StandBy Widgets): iOS 17 ile gelen bu özellik, iPhone şarj olurken yatay konumda iken tam ekran widget'ların görüntülenmesini sağlar.

protocol TimelineProvider {
    associatedtype Entry: TimelineEntry

    func getSnapshot(in context: Context, completion: @escaping (Entry) -> Void)
    func getTimeline(in context: Context, completion: @escaping (Timeline<Entry>) -> Void)
    func placeholder(in context: Context) -> Entry
}

• placeholder(in context: Context) -> Entry: Widget henüz ilk verisini yüklemeden önce veya önizleme amacıyla gösterilen varsayılan içeriği sağlar. Kullanıcının widget'ı eklerken neye benzeyeceğini görmesi için önemlidir.
• getSnapshot(in context: Context, completion: @escaping (Entry) -> Void): Widget'ın hızlı bir şekilde tek bir anlık görünümünü sağlar. Özellikle galeri görünümünde veya widget eklendiğinde kullanılır.
• getTimeline(in context: Context, completion: @escaping (Timeline<Entry>) -> Void): En kritik metottur. Bu, widget'ınızın gelecekteki güncellemelerini planlar. Bir dizi TimelineEntry ve bir TimelineReloadPolicy döndürür. ReloadPolicy, widget'ın bir sonraki ne zaman güncellenmesi gerektiğini belirtir (örneğin, belirli bir tarihte, belirli bir süre sonra veya hiçbir zaman manuel tetiklenene kadar).

"Veri yönetimi, başarılı bir widget'ın anahtarıdır. Kullanıcıya her zaman güncel ve ilgili bilgi sunmalıyız."

Genişletmek için tıkla ...

struct MyWidgetEntryView: View {
    var entry: Provider.Entry

    var body: some View {
        Text(entry.date, style: .time)
            .widgetURL(URL(string: "myapp://detail?id=\(entry.itemId)"))
    }
}

• Yeni Bir Widget Extension Ekleme: Xcode projenizde 'File -> New -> Target...' seçeneğini kullanarak 'Widget Extension' şablonunu seçin.
• Shared App Group Yapılandırması: Uygulamanız ve widget'ınız arasında veri paylaşımı yapmak için bir 'App Group' oluşturun ve her iki hedefe de ekleyin. Bu, kullanıcı ayarları veya güncel veri gibi bilgileri aktarmanın standart yoludur.
• TimelineEntry Tanımlama: Widget'ınızın göstereceği veriyi temsil eden bir struct oluşturun ve TimelineEntry protokolüne uymasını sağlayın. Bu struct, mutlaka bir date özelliğine sahip olmalıdır.
• TimelineProvider Uygulama: TimelineProvider protokolünü uygulayan bir sınıf veya struct oluşturun. placeholder, getSnapshot ve getTimeline metodlarını doldurun. Özellikle getTimeline metodunda, gelecek güncellemeleri planlayacak TimelineEntry dizisini ve TimelineReloadPolicy'yi doğru bir şekilde ayarlamak önemlidir.
• WidgetEntryView Oluşturma: SwiftUI kullanarak TimelineEntry'nizdeki veriyi görselleştirecek görünümü tasarlayın. Burada Text, Image, VStack, HStack gibi SwiftUI bileşenlerini kullanacaksınız. Widget'ın boyutuna ve türüne göre farklı görünümler sağlamak için @Environment(.widgetFamily) kullanabilirsiniz.
• Widget Yapılandırması: Widget dosyanızın en üstünde yer alan WidgetConfiguration'ı düzenleyin. Statik bir widget için StaticConfiguration'ı, kullanıcıdan girdi alması gereken bir widget (örneğin, belirli bir şehir için hava durumu) için IntentConfiguration'ı kullanın. IntentConfiguration, SiriKit Intention'ları aracılığıyla yapılandırma sağlar.
• Widget Bundle Oluşturma: Birden fazla widget türünüz veya boyuttan bağımsız widget'larınız varsa, bunları bir WidgetBundle içinde gruplayabilirsiniz. Bu, kodunuzu daha düzenli hale getirir.

• Performans Odaklı Olun: Widget'lar sınırlı kaynaklara sahiptir. Ağ isteklerini minimumda tutun, ağır hesaplamalardan kaçının ve verilerinizi verimli bir şekilde önbelleğe alın. getTimeline metodunu çok sık çağırmaktan kaçının.
• Gizliliğe Önem Verin: Widget'larda hassas kişisel verileri göstermekten kaçının veya bunu yaparken kullanıcının açık iznini alın. Kilit Ekranı'nda görünen widget'lar için bu daha da kritiktir.
• Anlaşılır ve Öz Olun: Widget'lar anlık bilgi sağlamak içindir. Karmaşık arayüzlerden kaçının, en önemli bilgiyi vurgulayın ve gereksiz detayları eleyin.
• Erişilebilirliği Unutmayın: Widget'larınızı VoiceOver ve diğer erişilebilirlik özellikleri için optimize edin. Kullanıcıların farklı ihtiyaçlara sahip olabileceğini göz önünde bulundurun.
• Önizlemeler (Previews) Kullanın: Xcode'daki önizlemeleri kullanarak farklı boyutlarda ve cihazlarda widget'ınızın nasıl göründüğünü test edin. Bu, geliştirme sürecini hızlandırır.
• Yerel Verileri Tercih Edin: Uygulamanızın kaydettiği yerel verileri widget'ta kullanmak, ağ gecikmelerini ortadan kaldırır ve performansı artırır. App Group'lar aracılığıyla verileri paylaşın.
• Deep Link'leri Akıllıca Kullanın: Kullanıcının widget'tan uygulamaya geçtiğinde tam olarak nereye gitmek istediğini düşünün. Genel bir ana sayfa yerine, doğrudan ilgili içeriğe yönlendirme yapın.