コントロールセンターに壁紙シャッフルを置く — Rork(Expo) アプリの ControlWidget 実装と iOS 26 での作り直し

import AppIntents
import WidgetKit
 
struct ShuffleWallpaperIntent: AppIntent {
    static var title: LocalizedStringResource = "壁紙をシャッフル"
    static var description = IntentDescription("次の壁紙を選びます")
 
    // コントロールセンターから直接実行するので、アプリ起動は不要
    static var openAppWhenRun: Bool = false
 
    func perform() async throws -> some IntentResult {
        guard let store = UserDefaults(
            suiteName: WallpaperControlKind.appGroup
        ) else {
            return .result()
        }
        let total = max(store.integer(forKey: "wallpaperCount"), 1)
        let current = store.integer(forKey: "wallpaperIndex")
        let next = (current + 1) % total
 
        store.set(next, forKey: "wallpaperIndex")
        store.set(Date().timeIntervalSince1970, forKey: "lastShuffledAt")
 
        // コントロールの見た目（番号など）を更新したいときに必要
        ControlCenter.shared.reloadControls(
            ofKind: WallpaperControlKind.shuffle
        )
        return .result()
    }
}

import WidgetKit
import SwiftUI
import AppIntents
 
struct WallpaperShuffleControl: ControlWidget {
    var body: some ControlWidgetConfiguration {
        StaticControlConfiguration(
            kind: WallpaperControlKind.shuffle
        ) {
            ControlWidgetButton(action: ShuffleWallpaperIntent()) {
                Label("壁紙シャッフル", systemImage: "shuffle")
            }
        }
        .displayName("壁紙シャッフル")
        .description("コントロールセンターから次の壁紙を選びます")
    }
}
 
@main
struct WallpaperControlBundle: ControlWidgetBundle {
    var body: some ControlWidget {
        WallpaperShuffleControl()
    }
}

import AppIntents
import SwiftUI
import WidgetKit
 
struct DailyShuffleValueProvider: ControlValueProvider {
    // コントロールギャラリーやアクションボタン設定に出る見本の値
    let previewValue = true
 
    func currentValue() async throws -> Bool {
        let store = UserDefaults(suiteName: WallpaperControlKind.appGroup)
        return store?.bool(forKey: "dailyShuffleEnabled") ?? false
    }
}
 
struct SetDailyShuffleIntent: SetValueIntent {
    static var title: LocalizedStringResource = "日替わりシャッフルを切り替え"
 
    // SetValueIntent は value という名前の @Parameter が必須
    @Parameter(title: "オン") var value: Bool
 
    func perform() async throws -> some IntentResult {
        UserDefaults(suiteName: WallpaperControlKind.appGroup)?
            .set(value, forKey: "dailyShuffleEnabled")
        return .result()
    }
}
 
struct DailyShuffleControl: ControlWidget {
    var body: some ControlWidgetConfiguration {
        StaticControlConfiguration(
            kind: WallpaperControlKind.dailyShuffle,
            provider: DailyShuffleValueProvider()
        ) { isOn in
            ControlWidgetToggle(
                "日替わりシャッフル",
                isOn: isOn,
                action: SetDailyShuffleIntent()
            ) { isOn in
                Label(
                    isOn ? "オン" : "オフ",
                    systemImage: isOn ? "shuffle.circle.fill" : "shuffle.circle"
                )
            }
        }
    }
}

struct WallpaperWidgetView: View {
    @Environment(\.widgetRenderingMode) private var renderingMode
    let image: Image
 
    var body: some View {
        switch renderingMode {
        case .accented:
            // 色は system 側で塗り替えられるので、形で伝わる表現に寄せる
            Label("今日の1枚", systemImage: "photo.on.rectangle.angled")
        default:
            image.resizable().scaledToFill()
        }
    }
}

// Before（手作業・prebuild で消える）
1. Xcode で File > New > Target > Widget Extension
2. Signing & Capabilities で App Group を手で追加
3. prebuild を走らせると ios/ が再生成され、1〜2 が消える
4. 毎リリースで同じ作業を繰り返す

// After（app.config.js で宣言・prebuild で再現される）
const { withEntitlementsPlist } = require("expo/config-plugins");
 
const withWallpaperAppGroup = (config) => {
  return withEntitlementsPlist(config, (cfg) => {
    cfg.modResults["com.apple.security.application-groups"] = [
      "group.design.dolice.wallpaper",
    ];
    return cfg;
  });
};
 
module.exports = {
  name: "wallpaper",
  ios: { bundleIdentifier: "design.dolice.wallpaper" },
  plugins: [withWallpaperAppGroup],
};

// 壁紙ライブラリを読み込んだ直後に総数を共有
import { NativeModules } from "react-native";
 
const { WallpaperBridge } = NativeModules;
 
export async function syncWallpaperCount(count) {
  // App Group の UserDefaults に総数を書く
  await WallpaperBridge.setSharedInt("wallpaperCount", count);
}