WidgetKit — এটি কী, উইজেট ফ্রেমওয়ার্ক এবং SwiftUI

WidgetKit কী এবং এটি কীভাবে কাজ করে?

WidgetKit হল একটি Apple ফ্রেমওয়ার্ক যা Apple ডিভাইসের সিস্টেম স্ক্রিনে বিষয়বস্তু প্রদর্শনকারী উইজেট তৈরি করার জন্য। একটি উইজেট হল আপনার অ্যাপের একটি ক্ষুদ্র উপস্থাপনা যা ব্যবহারকারী জিগল মোডে হোম স্ক্রিনে রাখে। WidgetKit-এর আগে বিদ্যমান watchOS কমপ্লিকেশনের বিপরীতে, নতুন ফ্রেমওয়ার্কটি একটি একক SwiftUI API-এর মাধ্যমে সমস্ত Apple প্ল্যাটফর্মের জন্য উইজেট তৈরি একীভূত করেছে।

WidgetKit-এর কার্যনির্বাহী নীতি TimelineProvider-এর উপর ভিত্তি করে — একটি অবজেক্ট যা TimelineEntry-এর একটি ক্রমবদ্ধ অ্যারে তৈরি করে, যেখানে প্রতিটি এন্ট্রিতে একটি Snapshot (একটি নির্দিষ্ট সময়ে উইজেটের নির্দিষ্ট অবস্থা) থাকে। সিস্টেম ক্রমান্বয়ে এন্ট্রিগুলি প্রদর্শন করে, টাইমলাইনে পরবর্তী এন্ট্রিতে যাওয়ার সময় উইজেট আপডেট করে। এন্ট্রিগুলির মধ্যে, WidgetKit অ্যাপ কোড কল করে না — শুধুমাত্র একটি নতুন Timeline তৈরি করার সময় CPU সময় ব্যয় হয়।

WWDC 2024 সেশন “WidgetKit: What’s new” অনুসারে, গড় iOS ব্যবহারকারীর হোম স্ক্রিনে 8–12টি উইজেট থাকে এবং সবচেয়ে জনপ্রিয় বিভাগগুলি হল আবহাওয়া, সময়, ক্যালেন্ডার, ফিটনেস এবং অর্থ। WidgetKit রিয়েল-টাইম আপডেটের পরিবর্তে নির্ধারিত আপডেটের কারণে সাধারণ ব্যবহারে প্রতিদিন 1% এরও কম ব্যাটারি চার্জ খরচ করে।

কী WidgetKit-কে পুরানো Today Extensions থেকে আলাদা করে

iOS 14-এর আগে, উইজেটগুলি কেবল Today View হিসাবে বিদ্যমান ছিল — একটি প্যানেল যা প্রথম স্ক্রিন থেকে বামে সোয়াইপ করে অ্যাক্সেসযোগ্য। Today Extensions-এর গুরুতর সীমাবদ্ধতা ছিল: এগুলি কেবল “Today” স্ক্রিনে উপলব্ধ ছিল, বিষয়বস্তু আপডেট করার জন্য অ্যাপ খোলার প্রয়োজন ছিল এবং আকার সমর্থন সীমিত ছিল। WidgetKit সম্পূর্ণরূপে Today Extensions প্রতিস্থাপন করেছে, হোম স্ক্রিন, লক স্ক্রিন (iOS 16+) এবং Mac ডেস্কটপে উইজেট প্রদান করেছে।

• শুধুমাত্র Today View-এ নয়, হোম স্ক্রিনে উইজেট
• TimelineProvider-এর মাধ্যমে স্বায়ত্তশাসিত আপডেট, অ্যাপ না খুলেই
• একটির পরিবর্তে তিনটি পূর্বনির্ধারিত আকার
• Smart Rotate এবং Smart Stack — সিস্টেম দ্বারা স্বয়ংক্রিয় উইজেট রোটেশন
• সমস্ত Apple প্ল্যাটফর্মের জন্য একীভূত SwiftUI API

WidgetKit আর্কিটেকচার: TimelineProvider এবং Entry

WidgetKit আর্কিটেকচার তিনটি মূল প্রোটোকলের উপর নির্মিত: TimelineProvider, TimelineEntry, এবং Widget। TimelineEntry হল একটি ডেটা মডেল যা একটি নির্দিষ্ট সময়ে উইজেটের অবস্থা উপস্থাপন করে। TimelineProvider এই ধরনের এন্ট্রিগুলির একটি অ্যারে (Timeline) তৈরি করে, প্রতিটির জন্য সক্রিয়করণ তারিখ নির্দিষ্ট করে। Widget হল এন্ট্রি পয়েন্ট যা প্রদানকারীকে SwiftUI ভিউ-এর সাথে সংযুক্ত করে।

Timeline পদ্ধতি getTimeline প্রথমবার উইজেট যোগ করার সময় সিস্টেম দ্বারা কল করা হয় এবং তারপর পর্যায়ক্রমে — সাধারণত প্রদানকারীর প্রকারের উপর নির্ভর করে প্রতি 1–6 ঘন্টায়। একটি Timeline ঘন্টা বা দিন আগের এন্ট্রি ধারণ করতে পারে, যা উইজেটকে আপডেটের মধ্যে অ্যাপ কোড কল না করেই কাজ করতে দেয়। যদি জরুরি উইজেট আপডেটের প্রয়োজন হয় (যেমন, মুদ্রার হার পরিবর্তিত হয়েছে), অ্যাপ জোর করে WidgetCenter.shared.reloadAllTimelines() কল করতে পারে।

মৌলিক TimelineProvider

struct SimpleEntry: TimelineEntry {
    let date: Date
    let value: Double
}

struct Provider: TimelineProvider {
    typealias Entry = SimpleEntry
    
    func placeholder(in context: Context) -> Entry {
        Entry(date: Date(), value: 0)
    }
    
    func getSnapshot(
        in context: Context,
        completion: @escaping (Entry) -> Void
    ) {
        Entry(date: Date(), value: 42.5)
    }
    
    func getTimeline(
        in context: Context,
        completion: @escaping (Timeline<Entry>, Error?) -> Void
    ) {
        let entry = Entry(date: Date(), value: fetchLatestValue())
        let nextUpdate = Calendar.current
            .date(byAdding: .hour, value: 1, to: Date())!
        let timeline = Timeline(entries: [entry], policy: .after(nextUpdate))
        completion(timeline, nil)
    }
}

Widget Family: small, medium, large

WidgetKit তিনটি উইজেট আকার সমর্থন করে, প্রতিটি নির্দিষ্ট অনুপাত সহ। Small (iPhone-এ 170×170 pt) কম্প্যাক্ট তথ্য প্রদর্শন করে — একটি মান, আইকন বা ছোট টেক্সট। Medium (364×170 pt) small-এর থেকে দ্বিগুণ চওড়া এবং মানের জোড়া বা মিনি-চার্ট প্রদর্শনের জন্য উপযুক্ত। Large (364×382 pt) উল্লম্বভাবে প্রায় অর্ধেক স্ক্রিন নেয় এবং টেবিল, তালিকা বা বিস্তারিত ডেটা প্রদর্শনের অনুমতি দেয়।

ডেভেলপারকে কমপক্ষে দুটি আকার সমর্থন করতে হবে — Apple small + medium সুপারিশ করে। Large উইজেট কেবল তখনই প্রয়োজন যদি অ্যাপে সেই ভলিউম পূরণ করার মতো পর্যাপ্ত বিষয়বস্তু থাকে। প্রতিটি আকার তার নিজস্ব SwiftUI View পায়, যা WidgetKit সিস্টেম স্ক্রিনে রেন্ডার করে। গুরুত্বপূর্ণভাবে, WidgetKit কাস্টম আকার সমর্থন করে না — কেবল তিনটি নির্দিষ্ট আকার, যা ইন্টারফেসের সামঞ্জস্য নিশ্চিত করে।

WidgetConfiguration-এর মাধ্যমে আকার কনফিগারেশন

struct WeatherWidget: Widget {
    let kind: String = "WeatherWidget"
    
    var body: some WidgetConfiguration {
        StaticConfiguration(kind: kind, provider: Provider()) { entry in
            WeatherWidgetView(entry: entry)
        }
        .configurationDisplayName("Weather")
        .description("Current temperature and forecast")
        .supportedFamilies([.systemSmall, .systemMedium])
    }
}

উইজেট কনফিগারেশন প্রকার: Static এবং Intent

WidgetKit দুটি কনফিগারেশন প্রকার অফার করে — StaticConfiguration এবং IntentConfiguration। StaticConfiguration সেই উইজেটগুলির জন্য উপযুক্ত যা সমস্ত ব্যবহারকারীর জন্য একই বিষয়বস্তু প্রদর্শন করে: মুদ্রার হার, আবহাওয়া, ক্যালেন্ডার। IntentConfiguration ব্যবহারকারীকে Siri ইন্টেন্ট সিস্টেমের মাধ্যমে উইজেন্ট যোগ করার সময় এটি কাস্টমাইজ করতে দেয় — উদাহরণস্বরূপ, আবহাওয়ার জন্য একটি নির্দিষ্ট শহর বা স্টক মূল্যের জন্য একটি নির্দিষ্ট টিকার নির্বাচন করা।

IntentConfiguration INWidgetIntent ব্যবহার করে — SiriKit থেকে INIntent-এর একটি উপশ্রেণী। যখন ব্যবহারকারী একটি উইজেট যোগ করে এবং প্যারামিটার নির্বাচন করে (যেমন, শহর), সিস্টেম এই ইন্টেন্টটি সংরক্ষণ করে এবং প্রতিটি আপডেটে এটি TimelineProvider-এ পাস করে। প্রদানকারী getTimeline পদ্ধতিতে ইন্টেন্টটি গ্রহণ করে এবং বিষয়বস্তু গঠনের জন্য এর প্যারামিটার ব্যবহার করে। IntentConfiguration ব্যক্তিগতকৃত উইজেটগুলির জন্য পছন্দের পদ্ধতি কারণ এটি Siri এবং Shortcuts-এর সাথে একীভূত হয়।

প্যারামিটার নির্বাচন সহ IntentConfiguration

struct WeatherWidgetEntryView: View {
    var entry: WeatherEntry
    
    var body: some View {
        VStack(alignment: .leading) {
            Text(entry.cityName)
                .font(.caption)
                .foregroundColor(.secondary)
            Text("\(entry.temperature)°C")
                .font(.largeTitle)
        }
    }
}

struct WeatherWidget: Widget {
    var body: some WidgetConfiguration {
        IntentConfiguration(
            kind: "WeatherWidget",
            intent: WeatherConfigIntent.self,
            provider: WeatherTimelineProvider()
        ) { entry in
            WeatherWidgetEntryView(entry: entry)
        }
    }
}

SwiftUI-এ উইজেট তৈরি: ধাপে ধাপে উদাহরণ

একটি উইজেট তৈরি শুরু হয় Xcode-এ Widget Extension Target যোগ করার মাধ্যমে: File → New → Target → Widget Extension। Xcode স্বয়ংক্রিয়ভাবে TimelineEntry, TimelineProvider এবং WidgetConfiguration সহ একটি কাঠামো তৈরি করে। ডেভেলপারকে কেবল ডেটা প্রদর্শনের জন্য SwiftUI View বাস্তবায়ন করতে হবে এবং সঠিক আপডেট সময়সূচীর জন্য প্রদানকারীকে কনফিগার করতে হবে।

নীচে বর্তমান Bitcoin মূল্য প্রদর্শনের জন্য একটি সাধারণ উইজেটের সম্পূর্ণ উদাহরণ দেওয়া হল: Provider URLSession-এর মাধ্যমে হার লোড করে এবং প্রতি ঘন্টায় আপডেট সহ একটি Timeline তৈরি করে। WidgetSwiftUIView বড় ফন্টে হার এবং ছোট ফন্টে শেষ আপডেটের সময় প্রদর্শন করে।

struct BTCPriceEntry: TimelineEntry {
    let date: Date
    let price: Double
    let change24h: Double
}

struct BTCWidgetEntryView: View {
    var entry: BTCPriceEntry
    
    var body: some View {
        VStack {
            Text("BTC/USD").font(.caption)
            Text("$\(entry.price, specifier: "%.0f")")
                .font(.title2).fontWeight(.bold)
            Text(entry.change24h > 0 ? "+" : "")
        }
    }
}

iOS 16+ লক স্ক্রিন উইজেট

iOS 16-এর সাথে, WidgetKit লক স্ক্রিন — iPhone লক স্ক্রিন —-তে সমর্থন বাড়িয়েছে। লক স্ক্রিন উইজেট দুই ধরনের হয়: inline (ঘড়ির নীচে টেক্সটের এক লাইন) এবং rectangular (একটি আয়তক্ষেত্রাকার ক্ষেত্র)। হোম স্ক্রিন উইজেটের বিপরীতে, লক স্ক্রিন উইজেট আরও ঘন ঘন আপডেট হয় — সিস্টেম ট্রিগার ফোন আনলক না করেই বর্তমান তথ্য প্রদর্শনের জন্য প্রতি 15–30 মিনিটে আপডেটের অনুমতি দেয়।

লক স্ক্রিন উইজেটগুলির accessoryFamilies সহ WidgetConfiguration-এর মাধ্যমে পৃথক কনফিগারেশন প্রয়োজন: accessoryCircular, accessoryRectangular, accessoryInline। এই পরিবারগুলির কঠোর আকার এবং বিষয়বস্তুর সীমাবদ্ধতা রয়েছে — তারা ছবি, অ্যানিমেশন বা কাস্টম ফন্ট সমর্থন করে না। Apple লক স্ক্রিন উইজেটের জন্য শুধুমাত্র টেক্সট তথ্য এবং SF Symbols সিস্টেম আইকন ব্যবহার করার পরামর্শ দেয়।

• accessoryCircular — ঘড়ির নীচের ক্ষেত্রের জন্য কম্প্যাক্ট বৃত্তাকার উইজেট
• accessoryRectangular — ঘড়ির উপরের ক্ষেত্রের জন্য আয়তক্ষেত্রাকার উইজেট
• accessoryInline — সময়ের নীচে এক-লাইন টেক্সট, ন্যূনতম আকার
• সীমাবদ্ধতা: শুধুমাত্র টেক্সট, SF Symbols, গ্রেডিয়েন্ট; কোনো ছবি বা ভিডিও নয়

WidgetKit সেরা অনুশীলন এবং সীমাবদ্ধতা

উইজেট ডেভেলপ করার সময়, WidgetKit-এর সীমাবদ্ধতা বিবেচনা করা গুরুত্বপূর্ণ। উইজেটগুলি শুধুমাত্র-পঠনযোগ্য ভিউ: তারা টাচ ইভেন্ট পরিচালনা করে না (ট্যাপ ছাড়া যা অ্যাপ খোলে)। উইজেটগুলি অ্যানিমেশন, ভিডিও, কীবোর্ড ইনপুট, স্ক্রোলিং বা ইন্টারেক্টিভ উপাদান সমর্থন করে না। প্রতিটি উইজেট একটি নির্দিষ্ট সময়ে ডেটার একটি স্থির স্ন্যাপশট, এবং ইন্টারঅ্যাকটিভিটি যোগ করার চেষ্টা করলে App Store থেকে অ্যাপ প্রত্যাখ্যান হবে।

সেরা অনুশীলনের মধ্যে রয়েছে জোরপূর্বক আপডেটের জন্য Widget Center ব্যবহার করা, দ্রুত প্রতিক্রিয়ার জন্য TimelineProvider স্তরে ডেটা ক্যাশিং করা এবং প্রাথমিক অবস্থার জন্য placeholder ব্যবহার করা। একাধিক আকার সমর্থন করাও গুরুত্বপূর্ণ — ব্যবহারকারীরা আশা করেন যে উইজেটটি small এবং medium উভয় ভেরিয়েন্টেই উপলব্ধ হবে। ভুল বা পুরানো ডেটা প্রদর্শন করা কঠোরভাবে এড়িয়ে চলুন — ব্যবহারকারীরা উইজেট থেকে ভুল তথ্য দীর্ঘ সময় ধরে মনে রাখে।

WidgetKit সীমাবদ্ধতার টেবিল