React Native应用无法显示GIF的问题求助（附配置详情）

嘿，我之前也踩过这个坑，本质就是Fresco依赖版本和你的React Native版本不兼容导致的冲突——毕竟RN本身就依赖Fresco，手动加的版本不对就会搞崩项目。下面给你一步步捋清楚解决方案：

第一步：先确认你的RN具体版本 #

先搞明白你当前用的React Native版本号，在项目根目录打开终端运行：

react-native --version

或者直接看项目根目录package.json里的react-native字段值也行。

第二步：匹配对应的Fresco版本 #

根据你的RN版本，替换成兼容的Fresco Animated GIF依赖：

• 如果RN版本是 0.57.x ~ 0.59.x：把1.8.1换成1.10.0
• 如果RN版本是 0.60.x 及以上：RN已经迁移到AndroidX了，得用支持AndroidX的Fresco版本（比如2.5.0），同时注意把compile改成implementation（Android Gradle 3.0+已经废弃compile关键字）
• 更低版本RN（0.55-0.56）：对应Fresco版本分别是1.5.0和1.6.0

修改后的android/app/build.gradle依赖示例（以RN 0.60+为例）：

dependencies {
    compile fileTree(dir: "libs", include: ["*.jar"])
    implementation "com.android.support:appcompat-v7:23.0.1" // 若已迁移AndroidX，需改成androidx.appcompat:appcompat:1.xx.x
    implementation "com.facebook.react:react-native:+" // From node_modules
    implementation 'com.facebook.fresco:animated-gif:2.5.0'
}

第三步：清理缓存并重新构建 #

依赖改完后必须清理gradle缓存，不然冲突可能还存在：

cd android
./gradlew clean
cd ..
react-native run-android

额外检查：Image组件的使用是否正确 #

确保你引用GIF的方式没出错：

• 本地GIF：用require('./assets/your-gif.gif')（把GIF放在项目根目录的assets文件夹，或者对应相对路径）
• 网络GIF：source={{uri: 'https://xxx.com/your-gif.gif'}}

如果是RN 0.60+，记得确认项目已经完成AndroidX迁移，用Android Studio的Refactor > Migrate to AndroidX工具就能一键搞定。

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