Claude Code で作るiOS 18 ウィジェット & App Intents 実装ガイド

import AppIntents
 
// 基本的な AppIntent
struct ShowTodayTasksIntent: AppIntent {
    static var title: LocalizedStringResource = "今日のタスクを確認"
    static var description = IntentDescription(
        "今日の未完了タスクをリストアップします",
        categoryName: "タスク管理"
    )
    
    // Siri で使える場合のフレーズ例（Shortcuts.strings で管理）
    static var openAppWhenRun: Bool = true
    
    @MainActor
    func perform() async throws -> some IntentResult & ReturnsValue<String> {
        let tasks = await fetchTodayTasks()
        let summary = tasks.isEmpty
            ? "今日のタスクはすべて完了しています"
            : "残り\(tasks.count)件: \(tasks.prefix(3).map(\.title).joined(separator: "、"))"
        
        return .result(value: summary)
    }
    
    private func fetchTodayTasks() async -> [Task] {
        // データ取得ロジック
        return []
    }
}
 
// パラメーターを持つ AppIntent
struct AddTaskIntent: AppIntent {
    static var title: LocalizedStringResource = "タスクを追加"
    
    @Parameter(title: "タスク名", requestValueDialog: "追加するタスク名を教えてください")
    var taskTitle: String
    
    @Parameter(title: "期限", default: nil)
    var deadline: Date?
    
    @Parameter(title: "優先度", default: .medium)
    var priority: TaskPriority
    
    func perform() async throws -> some IntentResult & ShowsSnippetView {
        let newTask = Task(title: taskTitle, deadline: deadline, priority: priority)
        try await TaskRepository.shared.add(newTask)
        
        // スニペットビューで確認を表示
        return .result {
            VStack {
                Image(systemName: "checkmark.circle.fill")
                    .foregroundStyle(.green)
                Text("「\(taskTitle)」を追加しました")
            }
        }
    }
}
 
// AppEnum（Siri が理解できる列挙型）
enum TaskPriority: String, AppEnum {
    case high = "高"
    case medium = "中"
    case low = "低"
    
    static var typeDisplayRepresentation: TypeDisplayRepresentation = "優先度"
    static var caseDisplayRepresentations: [TaskPriority: DisplayRepresentation] = [
        .high: "高",
        .medium: "中",
        .low: "低"
    ]
}
 
// App Shortcuts（Siri が自動的に提案するショートカット）
struct MyAppShortcuts: AppShortcutsProvider {
    static var appShortcuts: [AppShortcut] {
        AppShortcut(
            intent: ShowTodayTasksIntent(),
            phrases: [
                "今日のタスクを確認",
                "\(.applicationName)で今日のタスクを見せて",
                "今日やることを確認"
            ],
            shortTitle: "今日のタスク",
            systemImageName: "checklist"
        )
        
        AppShortcut(
            intent: AddTaskIntent(),
            phrases: [
                "\(.applicationName)に\(.title)を追加して",
                "タスクを追加: \(.title)"
            ],
            shortTitle: "タスク追加",
            systemImageName: "plus.circle"
        )
    }
}

// ❌ ウィジェットからアクセスできない
UserDefaults.standard.set(count, forKey: "taskCount")
 
// ✅ App Group 経由でアクセスできる
let sharedDefaults = UserDefaults(suiteName: "group.com.yourapp.shared")\!
sharedDefaults.set(count, forKey: "taskCount")
 
// アプリ側でデータを更新したらウィジェットに通知する
WidgetCenter.shared.reloadTimelines(ofKind: "TaskWidget")
// 全ウィジェットを一括リロードする場合
WidgetCenter.shared.reloadAllTimelines()

// ❌ iOS 17+ で必要な containerBackground が抜けている
struct TaskWidgetView: View {
    var body: some View {
        VStack { /* ... */ }
            .padding()
        // containerBackground がないとインタラクションが無効になる場合がある
    }
}
 
// ✅ containerBackground を追加する
struct TaskWidgetView: View {
    var body: some View {
        VStack { /* ... */ }
            .padding()
            .containerBackground(.fill.tertiary, for: .widget)
    }
}

// ❌ AppShortcutsProvider に phrases が少なすぎる or applicationName を含まない
AppShortcut(
    intent: ShowTodayTasksIntent(),
    phrases: ["タスクを見せて"]  // アプリ名がない
)
 
// ✅ アプリ名を含む phrases を複数用意する
AppShortcut(
    intent: ShowTodayTasksIntent(),
    phrases: [
        "今日のタスクを確認",           // Spotlight 向け
        "\(.applicationName)でタスク確認",  // Siri 向け（必須）
        "\(.applicationName)で今日やることを教えて"
    ],
    shortTitle: "タスク確認",
    systemImageName: "checklist"
)

<\!-- メインアプリの Info.plist -->
<key>NSSupportsLiveActivities</key>
<true/>
 
<\!-- ⚠️ Widget Extension の Info.plist にも追加が必要な場合がある -->
<key>NSSupportsLiveActivities</key>
<true/>

## Widget Extension
 
### App Group
- Identifier: group.com.yourcompany.yourapp
- UserDefaults suite: UserDefaults(suiteName: "group.com.yourcompany.yourapp")
- データ共有: taskCount, completionRate, nextDeadline, completedTaskIds
 
### Widget 種類
- TaskWidget: 静的ウィジェット（Small/Medium対応）
- BuildWidget: Live Activity（Dynamic Island対応）
 
### 制約事項
- ネットワーク通信不可（スナップショット・タイムライン取得時）
- UserDefaults.standard は使用禁止（必ず App Group 経由）
- containerBackground は必須（iOS 17+）
- インタラクティブウィジェットは iOS 17+ のみ
 
### 更新トリガー
- アプリ側でデータ変更時: WidgetCenter.shared.reloadTimelines(ofKind: "TaskWidget")
- バックグラウンドタスク: BGAppRefreshTask でタイムラインを再生成

enum WidgetKind { case clock, dailyWallpaper, calendar }
 
// ❌ 一律15分刻み（バジェットを浪費する）
// let timeline = Timeline(entries: entries, policy: .atEnd)
 
// ✅ コンテンツの性質に応じて更新間隔を変える
func makeTimeline(for kind: WidgetKind, entry: WallpaperEntry) -> Timeline<WallpaperEntry> {
    let now = Date()
    switch kind {
    case .clock:
        // 時刻は Text(date, style: .time) を使えばシステム側が自動更新する
        // → タイムラインを刻む必要はなく、1時間に1回の再生成で十分
        return Timeline(entries: [entry], policy: .after(now.addingTimeInterval(3600)))
    case .dailyWallpaper:
        // 「本日のおすすめ」は日付が変わるときだけ切り替わればよい
        let nextMidnight = Calendar.current.nextDate(
            after: now,
            matching: DateComponents(hour: 0, minute: 0),
            matchingPolicy: .nextTime
        )!
        return Timeline(entries: [entry], policy: .after(nextMidnight))
    case .calendar:
        // カレンダーも日付の境界でのみ更新する
        let nextMidnight = Calendar.current.nextDate(
            after: now,
            matching: DateComponents(hour: 0, minute: 0),
            matchingPolicy: .nextTime
        )!
        return Timeline(entries: [entry], policy: .after(nextMidnight))
    }
}

import UIKit
import ImageIO
 
// ウィジェット表示サイズに合わせて画像をダウンサンプリングする。
// フルサイズ画像を UIImage(contentsOfFile:) でそのまま読むと、
// デコード後のビットマップがメモリを圧迫し 30MB 制限を超えてしまう。
func downsampledImage(at url: URL, pointSize: CGSize, scale: CGFloat) -> UIImage? {
    let sourceOpts = [kCGImageSourceShouldCache: false] as CFDictionary
    guard let source = CGImageSourceCreateWithURL(url as CFURL, sourceOpts) else {
        return nil
    }
    let maxDimension = max(pointSize.width, pointSize.height) * scale
    let downsampleOpts = [
        kCGImageSourceCreateThumbnailFromImageAlways: true,
        kCGImageSourceShouldCacheImmediately: true,        // デコードをこの場で行う
        kCGImageSourceCreateThumbnailWithTransform: true,
        kCGImageSourceThumbnailMaxPixelSize: maxDimension
    ] as CFDictionary
    guard let cgImage = CGImageSourceCreateThumbnailAtIndex(source, 0, downsampleOpts) else {
        return nil
    }
    return UIImage(cgImage: cgImage)
}

// ❌ 画像バイナリを UserDefaults に入れる（読み込み時にメモリを圧迫する）
// sharedDefaults.set(imageData, forKey: "wallpaperImage")  // 数MB を毎回展開
 
// ✅ 共有コンテナ内のファイル名だけを共有する
let containerURL = FileManager.default
    .containerURL(forSecurityApplicationGroupIdentifier: "group.com.yourapp.shared")!
let imageURL = containerURL.appendingPathComponent("today.jpg")
let sharedDefaults = UserDefaults(suiteName: "group.com.yourapp.shared")!
sharedDefaults.set(imageURL.lastPathComponent, forKey: "wallpaperFileName")
// ウィジェット側では downsampledImage(at:) を使って読み込む