如何消除Xcode加载GIF到UIImageView的警告并优化卡顿？

一、消除同步加载警告 #

警告核心原因是在主线程使用Data(contentsOf:)同步请求网络数据，会阻塞主线程导致UI卡顿，解决方式是改用URLSession异步加载：

1. 修改UIImage扩展的GIF加载方法 #

将原同步的gifImageWithURL替换为异步带回调的版本：

extension UIImage {
    // 保留原有gifImageWithData、animatedImageWithSource等方法不变
    
    // 新的异步GIF加载方法
    public class func gifImageWithURL(_ gifUrl: String, completion: @escaping (UIImage?) -> Void) {
        guard let url = URL(string: gifUrl) else {
            print("无效的GIF URL")
            completion(nil)
            return
        }
        
        // 异步网络请求
        let task = URLSession.shared.dataTask(with: url) { data, response, error in
            guard let data = data, error == nil else {
                print("GIF数据加载失败: \(error?.localizedDescription ?? "未知错误")")
                completion(nil)
                return
            }
            
            // 在后台线程解析GIF，避免阻塞主线程
            DispatchQueue.global(qos: .userInitiated).async {
                let gifImage = self.gifImageWithData(data)
                // 回到主线程更新UI
                DispatchQueue.main.async {
                    completion(gifImage)
                }
            }
        }
        task.resume()
    }
}

2. 更新ViewController调用代码 #

在viewDidLoad中使用异步方法加载并更新UI：

class GifViewController: UIViewController {
    @IBOutlet weak var gif: UIImageView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        let gifURL = "https://mir-s3-cdn-cf.behance.net/project_modules/max_1200/5eeea355389655.59822ff824b72.gif"
        UIImage.gifImageWithURL(gifURL) { [weak self] image in
            self?.gif.image = image
        }
    }
}

二、优化GIF播放流畅度 #

原代码通过重复添加相同帧保证动画时间准确，会导致内存中帧数量暴增引发卡顿，可通过逐帧按需播放优化：

1. 给UIImageView添加GIF逐帧播放扩展 #

import UIKit
import ImageIO

extension UIImageView {
    func loadGif(from url: String) {
        guard let url = URL(string: url) else { return }
        
        URLSession.shared.dataTask(with: url) { [weak self] data, _, error in
            guard let data = data, error == nil, let source = CGImageSourceCreateWithData(data as CFData, nil) else { return }
            
            let frameCount = CGImageSourceGetCount(source)
            var frames = [UIImage]()
            var frameDelays = [Double]()
            
            // 预加载所有帧和对应延迟
            for i in 0..<frameCount {
                if let cgImage = CGImageSourceCreateImageAtIndex(source, i, nil) {
                    frames.append(UIImage(cgImage: cgImage))
                }
                frameDelays.append(UIImage.delayForImageAtIndex(i, source: source))
            }
            
            DispatchQueue.main.async {
                self?.startGifAnimation(with: frames, delays: frameDelays)
            }
        }.resume()
    }
    
    private func startGifAnimation(with frames: [UIImage], delays: [Double]) {
        guard !frames.isEmpty else { return }
        
        var currentIndex = 0
        self.image = frames[currentIndex]
        
        let displayLink = CADisplayLink(target: self, selector: #selector(updateGifFrame))
        displayLink.add(to: .main, forMode: .common)
        
        var lastFrameTime = CACurrentMediaTime()
        
        @objc func updateGifFrame() {
            let currentTime = CACurrentMediaTime()
            let elapsed = currentTime - lastFrameTime
            
            if elapsed >= delays[currentIndex] {
                lastFrameTime = currentTime
                currentIndex = (currentIndex + 1) % frames.count
                self.image = frames[currentIndex]
            }
        }
    }
}

// 保留原UIImage扩展中的delayForImageAtIndex方法不变

2. 修改ViewController调用方式 #

class GifViewController: UIViewController {
    @IBOutlet weak var gif: UIImageView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        let gifURL = "https://mir-s3-cdn-cf.behance.net/project_modules/max_1200/5eeea355389655.59822ff824b72.gif"
        gif.loadGif(from: gifURL)
    }
}

额外优化建议 #

• 移除代码中过时的自定义<运算符，Swift已支持可选值直接比较，通过if let解包后比较即可。
• 添加缓存机制，避免重复加载相同URL的GIF，减少网络请求和解析开销。
• 对于大尺寸GIF，解析时可缩小帧尺寸，降低内存占用。

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