如何处理 iOS 14 小部件中的 API 故障

Question

我正在构建一个小部件，它显示从 API 获得的简单预订列表。我已经从 getTimeline 方法设置了 API 调用，如大量教程中所示，但是没有一个涵盖调用出现问题时该怎么做。

func getTimeline(for configuration: ConfigurationIntent, in context: Context, completion: @escaping (Timeline<Entry>) -> ()) {
    
    NetworkManager().getTimelineEntries { result in
        switch result {
        case .success(let entries):
            let timeline = Timeline(entries: entries, policy: .atEnd)
            completion(timeline)
        case .failure(let error):
            print(error.localizedDescription)
        }
    }

我们正在使用存储在钥匙串中的登录凭据，如果用户未登录（凭据为空），我想显示一个静态视图。如果用户已登录但请求失败或返回零条目，我还想显示一个静态视图。

由于 API 调用当前是在 getTimeline 方法中执行的，我不确定处理这些情况的最佳方法。我可以返回一个配置为显示自定义消息的时间线条目，但这似乎不是最好的方法，必须有更好的方法来处理这个问题。对于未登录的用户，当我们知道它会失败时尝试 API 调用似乎是错误的，那么有没有办法在时间线提供程序之外处理这个问题？

Answer 1

最简单的方法是返回带有单个空状态/占位符/“哎呀，出了点问题！”的Timeline。 Entry 并在 15 分钟后请求新的时间线（您可以在较短的间隔后请求刷新，例如 5 分钟，但 Apple may ignore depending on your refresh budget, users' device usage & widget location）：

func getTimeline(for configuration: ConfigurationIntent, in context: Context, completion: @escaping (Timeline<Entry>) -> ()) {
    
    NetworkManager().getTimelineEntries { result in
        switch result {
        case .success(let entries):
            let timeline = Timeline(entries: entries, policy: .atEnd)
            completion(timeline)
        case .failure(let error):
            let currentDate = Date()
            let entries = [Entry(date: currentDate, yourData: nil)] //Could include error here, to display on widget UI
            let policy = .after(Calendar.current.date(byAdding: .minute, value: 15, to: currentDate) ?? currentDate.addingTimeInterval(900))
            let timeline = Timeline(entries: entries, policy: policy)
            completion(timeline)
        }
    }
}