如何解决Kivy Popup中GIF图片无法显示的问题？

问题根源 #

终端报错Unknown <gif> type, no loader found，说明Kivy默认图像加载器不支持GIF格式，需要添加额外依赖或使用专门的GIF处理组件。

解决方案一：通过Pillow添加GIF支持 #

Pillow是Python主流图像处理库，Kivy可借助它实现GIF加载：

1. 安装Pillow依赖：

pip install pillow

2. 在Python代码开头导入Pillow（确保Kivy能检测到其加载器）：

from PIL import Image

3. 修正GIF文件路径，避免相对路径问题：

import os
# ...
def show_popup(self):
    self.pop_up = Factory.PopupBox()
    self.pop_up.update_pop_up_text('''Please Wait...\n...Be Patient''')
    # 使用绝对路径定位GIF文件
    gif_path = os.path.join(os.path.dirname(__file__), 'wait.gif')
    self.pop_up.update_pop_up_image(gif_path)
    self.pop_up.open()

解决方案二：使用Kivy Garden的GIFImage组件（推荐用于动画GIF） #

如果需要GIF动画正常播放，建议使用专门的GIFImage组件：

1. 安装Garden组件：

garden install gifimage

2. 在Python代码中导入组件：

from kivy.garden.gifimage import GIFImage

3. 修改KV文件，替换AsyncImage为GIFImage：

<PopupBox>:
    pop_up_text: _pop_up_text
    pop_up_image: _pop_up_image

    background_color: '#38B6FF'
    background: 'white'
    size_hint: 1, 1
    auto_dismiss: True
    title: 'FOOTBALL PREDICTOR'
    title_size: '15dp'
    title_font: 'fonts/Bungee-Regular.ttf'
    BoxLayout:
        orientation: "vertical"
        Label:
            id: _pop_up_text
            text: ''
            font_name: 'fonts/Bungee-Regular.ttf'
            font_size: '30dp'
            color: 1, 0.4, 0.769, 1 
        GIFImage:
            id: _pop_up_image
            source: ''

4. 同样使用绝对路径定位GIF文件（参考方案一的路径写法）。

额外注意事项 #

• 检查wait.gif文件是否完好，可通过系统图片查看器验证文件能否正常打开。
• 弹窗关闭时的报错可能是GIF资源未加载完成就被销毁，可在弹窗dismiss前确保资源加载完成，或在关闭逻辑中处理资源释放。

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