iOS 16 WidgetKit锁屏GIF动画显示问题求助

你当前的代码用UIImage(data:)加载GIF只会得到静态的第一帧，因为UIImage默认不会解析并构建GIF的动画帧序列。要在iOS16+的锁屏Widget中显示动画GIF，需要按以下步骤处理：

1. 解析GIF的动画帧和延迟时间 #

借助ImageIO框架解析GIF的所有帧以及每帧的延迟时长，创建包含完整动画序列的UIImage。添加如下工具方法：

import ImageIO

extension UIImage {
    static func animatedGIF(from url: URL) -> UIImage? {
        guard let source = CGImageSourceCreateWithURL(url as CFURL, nil) else { return nil }
        let frameCount = CGImageSourceGetCount(source)
        
        var frames = [UIImage]()
        var delays = [TimeInterval]()
        
        for index in 0..<frameCount {
            guard let cgImage = CGImageSourceCreateImageAtIndex(source, index, nil) else { continue }
            frames.append(UIImage(cgImage: cgImage))
            
            // 获取帧延迟时间
            guard let properties = CGImageSourceCopyPropertiesAtIndex(source, index, nil) as? [String: Any],
                  let gifProperties = properties[kCGImagePropertyGIFDictionary as String] as? [String: Any],
                  let delayTime = gifProperties[kCGImagePropertyGIFDelayTime as String] as? TimeInterval else {
                delays.append(0.1) // 默认延迟时长
                continue
            }
            delays.append(delayTime)
        }
        
        // 计算动画总时长
        let totalDuration = delays.reduce(0, +)
        return UIImage.animatedImage(with: frames, duration: totalDuration)
    }
}

2. 修改Widget的EntryView #

用上面的工具方法加载GIF，替换原有的gif属性实现：

struct AnimatedGIFWidgetEntryView : View {
    var entry: Provider.Entry

    var gif: UIImage? {
        guard let url = Bundle.main.url(forResource: "test2", withExtension: "gif") else { return nil }
        return UIImage.animatedGIF(from: url)
    }
    
    var body: some View {
        if let gifImage = gif {
            Image(uiImage: gifImage)
        } else {
            Color.gray // GIF加载失败时的占位视图
        }
    }
}

3. 注意WidgetKit的动画限制 #

• 仅iOS16及以上版本的锁屏Widget支持GIF动画，需确保Widget配置的最低系统版本正确。
• 动画仅在systemSmall尺寸的锁屏Widget上稳定生效，部分系统版本可能支持更大尺寸，但小尺寸兼容性最佳。
• 系统会对Widget动画做功耗限制，设备锁定一段时间后动画可能暂停，解锁后恢复播放。

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