Today Widget：とは何か、種類、通知ウィジェットの作成

Today Widgetとは

Today Widget（通知センターウィジェットとも呼ばれる）は、アプリを起動せずにそのアプリの要約情報を表示するiOSインターフェース要素です。ユーザーはロック画面またはホーム画面で左にスワイプしてウィジェットを表示します。ウィジェットは動的データ（為替レート、最新ニュース、タスクのステータス、デバイスの状態）を表示できます。

歴史的には、Today WidgetはiOS 8で通知センターフレームワークを介して実装された通知センター拡張機能として登場しました。iOS 14でAppleはWidgetKitを導入しました。これはウィジェットをホーム画面に直接配置できる完全に再設計されたアーキテクチャです。現代の意味でのToday Widgetは、“Today”セクション（最初の画面の左側にあるウィジェットセクション）に配置されたWidgetKitウィジェットです。

Today Widgetが必要な理由

主な目的は情報へのアクセス時間を短縮することです。アプリを開いてメニューを移動し、読み込みを待つ代わりに、ユーザーはすぐに必要なデータを確認できます。Apple（2024年）によると、ウィジェットを備えたアプリは27%高いユーザーエンゲージメントを示しています。追加のユースケース：クイックアクション（タスクを完了としてマーク）、モニタリング（心拍数、アクティビティ）、ステータス（バッテリー残量、通知）。

WidgetKit vs NCWidgetProviding

Today Widgetの開発者には2つのアプローチがあります。最新のWidgetKit（iOS 14+）とレガシーNCWidgetProviding拡張機能（iOS 8–13）です。選択は最小サポートiOSバージョンによって異なります。WidgetKitは新しいプロジェクトに推奨され、NCWidgetProvidingは古いデバイスのサポート用です。

WidgetKitを使用する場合

アプリがiOS 14以降をサポートしている場合はWidgetKitを使用してください。複数のサイズ、インテントによる設定、iOS 17でのリデザイン、ディープリンクなど、豊富な機能を提供します。SwiftUIの宣言的スタイルにより、ウィジェットコードはコンパクトで読みやすくなります。Timeline Providerは電力消費を考慮して更新スケジュールを自動管理します。

NCWidgetProvidingを使用する場合

iOS 9–13のサポートが必要な場合のみです。NCWidgetProvidingは実装が簡単です。プロトコルを持つ通常のUIViewControllerです。ただし、サイズは1つのみ、UIKitのみ、設定不可と制限があります。Appleは古いプロジェクトでもavailability checkを使用してWidgetKitに移行することを推奨しています。iOS 14+ではWidgetKit、フォールバックとしてNCWidgetProvidingを使用します。

Today Widgetの種類

最新のiOSには、機能的な目的に応じて3種類のウィジェットがあります。各タイプは独自の問題を解決し、データとインターフェースデザインに異なるアプローチを必要とします。分類はアプリに適したアーキテクチャを選択するのに役立ちます。

情報ウィジェット

静的または定期的に更新される情報（天気、日付、為替レート、サーバーステータス）を表示します。データはTimeline Providerを介してスケジュールに従って更新されます。ユーザーはウィジェットと対話せず、読み取りのみ行います。情報ウィジェットは実装が最も簡単で、タッチイベント処理が不要で、追加の権限なしでバックグラウンドで動作します。

インタラクティブウィジェット

iOS 17以降、WidgetKitはウィジェット内のボタン、トグル、スライダーをサポートしています。ユーザーはアプリを開かずに、タスクのマーク、音楽の一時停止、ライトのオンなどのアクションを実行できます。インタラクティブウィジェットはApp Intentsを使用してメインアプリにアクションを渡します。制限：ホーム画面のみで、iOS 18までは“Today”セクションでは使用できません。

設定可能なウィジェット

ユーザーはシステムインターフェースを通じて表示データをカスタマイズできます。天気の都市、金融のアカウント、ニュースのカテゴリを選択します。Intents ExtensionとWidgetBundleの設定を通じて実装されます。設定可能なウィジェットは、各ユーザーにとってのパーソナライゼーションと情報の関連性を高めます。

WidgetKitウィジェットの作成

WidgetKitを使用してSwiftUIでToday Widgetを作成するプロセスを見てみましょう。ウィジェットは自動更新で現在の為替レートを表示します。WidgetKitには3つのコンポーネントが必要です：ウィジェット構造、設定付きProvider、表示用のViewです。

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])
    }
}

Providerは表示用のデータを準備する役割を担います。getTimelineメソッドは更新スケジュールを作成します（次の更新は15分後）。TimelineProviderは、サーバーに常に問い合わせることなく、ウィジェットが最新データを表示することを保証します。

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とデータ更新

Timeline ProviderはToday Widgetのデータを管理するWidgetKitの中心的なメカニズムです。タイマーによる定期的な更新（古いNCWidgetProvidingのような）の代わりに、WidgetKitはtimelineの概念を使用します。これはタイムスタンプ付きのエントリのシーケンスです。システムは現在のエントリを期限が切れるまで表示し、その後次のエントリに切り替えるか新しいエントリを要求します。

更新ポリシー

Timelineは3つのポリシーをサポートしています：.after(date) — 指定された日時に次の更新；.never — WidgetCenter.reloadAllTimelinesが明示的に呼ばれるまでウィジェットは更新されない；.atEnd — 最後のエントリを表示した後に更新。為替レートのToday Widgetの場合、15–30分間隔の.afterポリシーが最適です。エネルギー効率はWidgetKitの重要な利点です。システムはすべてのウィジェットの更新を1つのウィンドウにグループ化します。

WidgetCenter：プログラムによる更新

timelineの期限が切れる前にデータが変更された場合（例えば、ユーザーがアプリでレートを更新した場合）、WidgetCenter.shared.reloadTimelines(ofKind: “CurrencyWidget”)を呼び出します。これによりProviderから新しいtimelineが要求され、表示が更新されます。WidgetCenterは1つのコマンドでアプリのすべてのウィジェットをリロードすることもできます。データ同期後に便利です。

ウィジェットデザインガイドライン

AppleはToday Widgetのデザインに厳しい要件を課しています。コンテンツは一目で読める必要があり、不要な要素がなく、明確な階層構造が必要です。HIG（ヒューマンインターフェースガイドライン）の推奨事項に違反すると、App Storeでの公開時に却下される可能性があります。3つの原則：一見性、一貫性、階層性。

一見性 — 一目で読めること

ユーザーがウィジェットに費やす時間は1秒未満です。3–4つ以上のデータ要素を追加しないでください。フォントはラベルに最低11pt、値に17ptを使用します。主要な数値には太字（Semibold）を使用します。スクロールは避けてください。Today Widgetはスクロールしません。

サイズへの適応

WidgetKitは3つのサイズをサポートしています：小（170×170pt）、中（364×170pt）、大（364×382pt）。“Today”セクションのToday Widgetでは、中サイズが最も一般的な選択です。EnvironmentValuesによるアダプティブデザイン：サイズに応じて情報密度を変更します。小は1つの数値、中は数値＋グラフ、大は表を表示します。

ダークモードとDynamic Typeのサポート

ウィジェットは開発者の追加作業なしでライトテーマとダークテーマの両方で正しく表示される必要があります。WidgetKitは自動的にシステムカラーを取得します。ウィジェットのDynamic Typeは制限されています。フォントサイズは固定ですが、読みやすい必要があります。UIColor.labelとUIColor.systemBackgroundは、両方のテーマでテキストと背景の基本色です。