Android API 22中如何播放GIF？Glide及GifViewer组件使用遇阻

一、先搞定Gradle构建失败问题 #

API 22（Android 5.1）属于旧版本系统，大部分新版库会提升最低API要求，必须选兼容的库版本：

1. Glide依赖配置 #

选择适配minSdk 22的Glide版本（推荐4.12.0，这是支持minSdk 14的最后一个稳定大版本）：

dependencies {
    // Glide核心库（Support库环境）
    implementation 'com.github.bumptech.glide:glide:4.12.0'
    // 注解处理器（必须加，否则Glide注解无法生效）
    annotationProcessor 'com.github.bumptech.glide:compiler:4.12.0'
}

如果项目已迁移到AndroidX，依赖换成：

implementation 'com.github.bumptech.glide:glide:4.12.0'
annotationProcessor 'com.github.bumptech.glide:compiler:4.12.0'
// 补充AndroidX兼容库（若未自动引入）
implementation 'androidx.annotation:annotation:1.1.0'

2. GifViewer依赖配置 #

以常用的Cutta GifView为例，选兼容API 22的版本（1.1版本支持minSdk 16）：

implementation 'com.github.Cutta:GifView:1.1'

注意：使用其他GifViewer组件时，先确认其minSdkVersion≤22。

3. Gradle插件与构建工具适配 #

API 22项目建议用较低版本的Gradle插件，避免兼容性问题：
项目根目录build.gradle设置：

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        // 适配API 22的Gradle插件版本（3.6.4支持minSdk 14）
        classpath 'com.android.tools.build:gradle:3.6.4'
    }
}

对应Gradle wrapper版本（gradle-wrapper.properties）：

distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.4-all.zip

4. 解决依赖冲突 #

若构建时报Duplicate class或Manifest merger failed：

• 检查是否同时引入AndroidX和Support库，API 22项目建议统一用Support库，或全量迁移到AndroidX（迁移成本较高）。
• 用./gradlew dependencies查看依赖树，排除冲突库，比如：

implementation('com.github.Cutta:GifView:1.1') {
    exclude group: 'com.android.support'
}

二、构建成功后，修复GIF不显示问题 #

1. Glide加载GIF的正确姿势 #

Glide默认会把GIF当成静态图加载，必须显式调用asGif()：

// 加载本地drawable中的GIF
Glide.with(this)
     .asGif() // 关键：指定加载GIF
     .load(R.drawable.your_gif_file)
     .into(imageView);

// 加载网络GIF
Glide.with(this)
     .asGif()
     .load("https://example.com/your.gif")
     .into(imageView);

注意：加载网络GIF需在Manifest中添加权限：

<uses-permission android:name="android.permission.INTERNET"/>

2. GifViewer组件的正确用法 #

以Cutta GifView为例：
布局文件添加组件：

<com.cunoraz.gifview.library.GifView
    android:id="@+id/gif_view"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>

代码中设置GIF资源：

GifView gifView = findViewById(R.id.gif_view);
// 加载本地资源
gifView.setGifResource(R.drawable.your_gif_file);
// 加载网络资源
gifView.setGifUrl("https://example.com/your.gif");

3. 排查其他可能原因 #

• 资源问题：确保GIF文件未损坏，资源名全小写（Android资源名不允许大写），放在res/drawable或res/raw目录。
• 内存限制：API 22设备内存较小，大尺寸GIF可能加载失败，尝试用工具压缩GIF到合适大小。
• 硬件加速问题：部分旧设备硬件加速会导致GIF渲染异常，在布局中给组件禁用硬件加速：

<ImageView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:hardwareAccelerated="false"/>

或在Activity的Manifest中全局禁用：

<activity android:name=".YourActivity"
          android:hardwareAccelerated="false"/>

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