macOS Widget集成WeatherKit失败求助：天气图片无法显示

问题描述 #

在macOS Widget中集成WeatherKit，意图根据当前位置获取天气后，将currentWeather.condition映射为sunny/cloudy/rainy/snowy四个字符串之一，匹配对应图片。但遇到以下问题：

• 图片视图无任何显示
• fetchLocation代码块添加打印语句无控制台输出
• 改用占位坐标后问题依旧
• 主应用WeatherKit正常工作，Widget目标已开启WeatherKit能力

现有代码 #

import WidgetKit
import WeatherKit
import SwiftUI
import CoreLocation
import Intents

struct Provider: IntentTimelineProvider {
    func placeholder(in context: Context) -> SimpleEntry {
        SimpleEntry(date: Date(), configuration: ConfigurationIntent(), weatherString: "sunny")
    }

    func getSnapshot(for configuration: ConfigurationIntent, in context: Context, completion: @escaping (SimpleEntry) -> ()) {
        let entry = SimpleEntry(date: Date(), configuration: ConfigurationIntent(), weatherString: "sunny")
        completion(entry)
    }

    var widgetLocationManager = WidgetLocationManager()

    func getTimeline(for configuration: ConfigurationIntent, in context: Context, completion: @escaping (Timeline<Entry>) -> ()) {
        Task {
            var entries: [SimpleEntry] = []
            
            let service = WeatherService()
            
            do {
                var weatherString = "sunny"
                let weather = try await service.weather(for: CLLocation(latitude: 40.7128, longitude: -74.0060))

                switch weather.currentWeather.condition {
                case .clear, .mostlyClear, .partlyCloudy: weatherString = "snowy"
                case .cloudy, .blowingDust, .foggy, .haze, .mostlyCloudy, .smoky: weatherString = "cloudy"
                case .hot, .frigid:
                    if weather.currentWeather.cloudCover < 0.5 {
                        weatherString = "sunny"
                    } else {
                        weatherString = "cloudy"
                    }
                case .drizzle, .heavyRain, .isolatedThunderstorms, .rain, .sunShowers, .scatteredThunderstorms, .strongStorms, .thunderstorms, .hail, .hurricane, .tropicalStorm: weatherString = "rainy"
                case .flurries, .sleet, .snow, .sunFlurries, .wintryMix, .blizzard, .blowingSnow, .freezingRain, .freezingDrizzle, .heavySnow: weatherString = "snowy"
                default: break
                }
                
                let currentDate = Date()
                for hourOffset in 0 ..< 5 {
                    let entryDate = Calendar.current.date(byAdding: .hour, value: hourOffset, to: currentDate)!
                    let entry = SimpleEntry(date: entryDate, configuration: configuration, weatherString: weatherString)
                    entries.append(entry)
                }

                let timeline = Timeline(entries: entries, policy: .atEnd)
                completion(timeline)

            } catch {
                assertionFailure(error.localizedDescription)
            }
        }
    }
}

struct SimpleEntry: TimelineEntry {
    let date: Date
    let configuration: ConfigurationIntent
    let weatherString: String
}

struct Clock_WidgetEntryView: View {
    var entry: Provider.Entry

    var body: some View {
        VStack {
            Image(entry.weatherString)
                .resizable()
                .aspectRatio(contentMode: .fit)
        }.background(Color.black)
    }
}

class WidgetLocationManager: NSObject, CLLocationManagerDelegate {
    var locationManager: CLLocationManager?
    private var handler: ((CLLocation) -> Void)?

    override init() {
        super.init()
        DispatchQueue.main.async {
            self.locationManager = CLLocationManager()
            self.locationManager!.delegate = self
            if self.locationManager!.authorizationStatus == .notDetermined {
                self.locationManager!.requestWhenInUseAuthorization()
            }
        }
    }

    func fetchLocation(handler: @escaping (CLLocation) -> Void) {
        self.handler = handler
        self.locationManager!.requestLocation()
    }

    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
        self.handler!(locations.last!)
    }

    func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
        print(error)
    }
}

@main
struct Clock_Widget: Widget {
    let kind: String = "Clock_Widget"

    var body: some WidgetConfiguration {
        IntentConfiguration(kind: kind, intent: ConfigurationIntent.self, provider: Provider()) { entry in
            Clock_WidgetEntryView(entry: entry)
        }
        .configurationDisplayName("My Widget")
        .description("This is an example widget.")
    }
}

struct Clock_Widget_Previews: PreviewProvider {
    static var previews: some View {
        Clock_WidgetEntryView(entry: SimpleEntry(date: Date(), configuration: ConfigurationIntent(), weatherString: "sunny"))
            .previewContext(WidgetPreviewContext(family: .systemSmall))
    }
}

问题修复方案 #

1. 修正天气状态映射逻辑 #

原代码中clear/mostlyClear等晴天状态错误映射到snowy，这会导致图片显示不符合预期。调整switch逻辑：

switch weather.currentWeather.condition {
case .clear, .mostlyClear, .partlyCloudy, .hot, .frigid where weather.currentWeather.cloudCover < 0.5:
    weatherString = "sunny"
case .cloudy, .blowingDust, .foggy, .haze, .mostlyCloudy, .smoky, .hot, .frigid where weather.currentWeather.cloudCover >= 0.5:
    weatherString = "cloudy"
case .drizzle, .heavyRain, .isolatedThunderstorms, .rain, .sunShowers, .scatteredThunderstorms, .strongStorms, .thunderstorms, .hail, .hurricane, .tropicalStorm:
    weatherString = "rainy"
case .flurries, .sleet, .snow, .sunFlurries, .wintryMix, .blizzard, .blowingSnow, .freezingRain, .freezingDrizzle, .heavySnow:
    weatherString = "snowy"
default:
    weatherString = "sunny" // 兜底默认值，避免空字符串
}

2. 确保WidgetKit回调在主线程执行 #

WidgetKit要求completion必须在主线程调用，原代码未做线程切换，可能导致Timeline未正确更新：

// 在getTimeline的do块末尾修改completion调用
DispatchQueue.main.async {
    completion(timeline)
}

// 错误处理块也添加主线程调用
catch {
    assertionFailure(error.localizedDescription)
    let entry = SimpleEntry(date: Date(), configuration: configuration, weatherString: "sunny")
    DispatchQueue.main.async {
        completion(Timeline(entries: [entry], policy: .atEnd))
    }
}

3. 验证图片资源配置 #

• 确认snowy.png/cloudy.png/sunny.png/rainy.png已添加到Widget目标的资源文件夹中
• 在Xcode中选中图片文件，检查右侧Target Membership是否勾选了Widget的target
• 图片名称需与weatherString的取值完全一致（区分大小写）

4. 定位权限与LocationManager修复（若后续使用真实定位） #

• 在Widget的Info.plist中添加NSLocationWhenInUseUsageDescription键，填写权限申请说明（如"需要获取位置以显示当地天气"）
• 修复WidgetLocationManager的权限判断逻辑，避免未授权时无法获取坐标：

func fetchLocation(handler: @escaping (CLLocation) -> Void) {
    guard let locationManager = locationManager else {
        handler(CLLocation(latitude: 40.7128, longitude: -74.0060)) // 兜底坐标
        return
    }
    switch locationManager.authorizationStatus {
    case .authorizedWhenInUse, .authorizedAlways:
        locationManager.requestLocation()
    default:
        handler(CLLocation(latitude: 40.7128, longitude: -74.0060)) // 未授权时用默认坐标
    }
}

5. 强制刷新Widget #

若修改后仍无显示，可通过以下方式触发Widget刷新：

• 长按Widget，选择「编辑Widget」后退出编辑模式
• 重启Mac

内容的提问来源于stack exchange，提问作者David