Rorkで作ったアプリのiOSウィジェットが「古いまま」になる本当の原因 — App Group共有とタイムライン更新の設計を見直す

// SharedStorage.swift — 親アプリとWidget Extensionの両方に追加する
import Foundation
import WidgetKit
 
enum SharedStorage {
    // App Group ID は両ターゲットで同じものを指す必要がある
    private static let suiteName = "group.com.example.myapp.shared"
 
    static var defaults: UserDefaults {
        // 共有コンテナを取得。失敗するとnilを返すので必ずunwrapを安全に行う
        guard let d = UserDefaults(suiteName: suiteName) else {
            // 失敗するときはApp Groupの設定が両ターゲットで揃っていない
            assertionFailure("App Group \(suiteName) is not configured")
            return .standard
        }
        return d
    }
 
    // 親アプリ側 — 最新の壁紙メタデータを書き込む
    static func saveWallpaper(id: String, title: String, date: Date) {
        let data: [String: Any] = [
            "id": id,
            "title": title,
            "date": date.timeIntervalSince1970
        ]
        defaults.set(data, forKey: "currentWallpaper")
        // 書き込み直後にウィジェットへ通知
        WidgetCenter.shared.reloadTimelines(ofKind: "DailyWallpaperWidget")
    }
 
    // ウィジェット側 — 取り出す
    static func loadWallpaper() -> (id: String, title: String, date: Date)? {
        guard let d = defaults.dictionary(forKey: "currentWallpaper"),
              let id = d["id"] as? String,
              let title = d["title"] as? String,
              let ts = d["date"] as? TimeInterval else {
            return nil
        }
        return (id, title, Date(timeIntervalSince1970: ts))
    }
}

// modules/shared-storage/ios/SharedStorageModule.swift
import ExpoModulesCore
import WidgetKit
 
public class SharedStorageModule: Module {
    public func definition() -> ModuleDefinition {
        Name("SharedStorage")
 
        // JS側から呼ぶためのメソッドを公開する
        AsyncFunction("saveWallpaper") { (id: String, title: String, dateMs: Double) in
            // 受け取った値をSwift側のSharedStorageへ
            let date = Date(timeIntervalSince1970: dateMs / 1000.0)
            SharedStorage.saveWallpaper(id: id, title: title, date: date)
        }
 
        AsyncFunction("reloadWidgets") { () in
            // 明示的にタイムライン更新を要求するエンドポイント
            WidgetCenter.shared.reloadAllTimelines()
        }
    }
}

// app/services/shared-storage.ts
import * as SharedStorageModule from "expo-modules-core";
import { requireNativeModule } from "expo-modules-core";
 
const NativeSharedStorage = requireNativeModule("SharedStorage");
 
export async function publishCurrentWallpaper(wallpaper: {
  id: string;
  title: string;
  date: Date;
}) {
  // ネイティブ側へ最新メタデータを渡す。dateはミリ秒に揃える
  await NativeSharedStorage.saveWallpaper(
    wallpaper.id,
    wallpaper.title,
    wallpaper.date.getTime()
  );
}
 
export async function refreshWidgets() {
  // 親アプリ起動時やバックグラウンド復帰時に明示呼び出し
  await NativeSharedStorage.reloadWidgets();
}
 
// 期待される動作:
//  - publishCurrentWallpaper を呼ぶと App Group へデータが書き込まれ、
//    WidgetKit が次回のタイムライン更新でその値を読む。
//  - refreshWidgets を呼ぶと WidgetCenter.reloadAllTimelines() が走り、
//    システムが「次の機会」にタイムラインを再評価する。

// DailyWallpaperWidget.swift — Widget Extension側
struct WallpaperProvider: TimelineProvider {
    func placeholder(in context: Context) -> WallpaperEntry {
        WallpaperEntry(date: Date(), title: "Today's Wallpaper", id: "placeholder")
    }
 
    func getSnapshot(in context: Context, completion: @escaping (WallpaperEntry) -> Void) {
        completion(loadEntry())
    }
 
    func getTimeline(in context: Context, completion: @escaping (Timeline<WallpaperEntry>) -> Void) {
        let entry = loadEntry()
 
        // 翌日0時に次の更新を予約。これがないと日付が変わってもウィジェットが動かない
        let nextMidnight = Calendar.current.nextDate(
            after: Date(),
            matching: DateComponents(hour: 0, minute: 0),
            matchingPolicy: .nextTime
        ) ?? Date().addingTimeInterval(60 * 60 * 24)
 
        let timeline = Timeline(entries: [entry], policy: .after(nextMidnight))
        completion(timeline)
    }
 
    private func loadEntry() -> WallpaperEntry {
        if let w = SharedStorage.loadWallpaper() {
            return WallpaperEntry(date: w.date, title: w.title, id: w.id)
        }
        return WallpaperEntry(date: Date(), title: "—", id: "empty")
    }
}

// app/screens/home.tsx
import { useEffect } from "react";
import { fetchTodayWallpaper } from "../api/wallpaper";
import { publishCurrentWallpaper, refreshWidgets } from "../services/shared-storage";
 
export default function HomeScreen() {
  useEffect(() => {
    (async () => {
      const w = await fetchTodayWallpaper();
      // ① 共有コンテナへ書く
      await publishCurrentWallpaper(w);
      // ② ウィジェットへ更新依頼を送る
      await refreshWidgets();
    })();
  }, []);
  // ...
}

// 共有コンテナ上のファイルパスを取得するヘルパー
extension SharedStorage {
    static var sharedContainerURL: URL? {
        FileManager.default.containerURL(
            forSecurityApplicationGroupIdentifier: suiteName
        )
    }
 
    static func saveWallpaperImage(data: Data, name: String) throws {
        guard let dir = sharedContainerURL else { return }
        let url = dir.appendingPathComponent(name)
        try data.write(to: url, options: .atomic)
    }
 
    static func loadWallpaperImageURL(name: String) -> URL? {
        sharedContainerURL?.appendingPathComponent(name)
    }
}

// 値が変わったときだけreloadする小さなガード
extension SharedStorage {
    static func publishIfChanged(id: String, title: String, date: Date) {
        let defaults = UserDefaults(suiteName: suiteName)
        let prevId = defaults?.string(forKey: "wallpaper.id")
        guard prevId != id else { return }   // 同じ壁紙なら何もしない
        saveWallpaper(id: id, title: title, date: date)
        WidgetCenter.shared.reloadTimelines(ofKind: "DailyWallpaperWidget")
    }
}

import AppIntents
import WidgetKit
 
struct NextWallpaperIntent: AppIntent {
    static var title: LocalizedStringResource = "次の壁紙へ"
 
    func perform() async throws -> some IntentResult {
        // 共有コンテナの状態を進める（例: インデックスを1つ進める）
        SharedStorage.advanceToNextWallpaper()
        // perform完了後、システムが該当ウィジェットを自動で再描画する
        return .result()
    }
}

struct DailyWallpaperWidgetView: View {
    var entry: WallpaperEntry
    var body: some View {
        VStack {
            Text(entry.title)
            Button(intent: NextWallpaperIntent()) {
                Image(systemName: "arrow.right.circle")
            }
        }
        .containerBackground(.fill.tertiary, for: .widget)
    }
}

// Widget Extension側 — 表示中の壁紙IDをURLに載せる
DailyWallpaperWidgetView(entry: entry)
    .widgetURL(URL(string: "myapp://wallpaper/\(entry.id)"))

// app/_layout.tsx などの最上位で
import * as Linking from "expo-linking";
import { useEffect } from "react";
import { router } from "expo-router";
 
export function useWidgetDeepLink() {
  useEffect(() => {
    const handle = (url: string | null) => {
      if (!url) return;
      const { hostname, path } = Linking.parse(url);
      // myapp://wallpaper/<id>
      if (hostname === "wallpaper" && path) {
        router.push(`/wallpaper/${path}`);
      }
    };
    // 起動時（コールドスタート）に渡されたURL
    Linking.getInitialURL().then(handle);
    // 起動中（ウォーム）に届いたURL
    const sub = Linking.addEventListener("url", ({ url }) => handle(url));
    return () => sub.remove();
  }, []);
}